Ir para o conteúdo

Tutorial: Avaliação externa do Anotae por revisor clínico

Neste tutorial você vai instalar o Anotae, explorar suas principais funcionalidades usando dados sintéticos e responder às perguntas de conformidade mais comuns — tudo sem tocar em dados reais de pacientes.

O que você vai construir: uma visão prática e fundamentada do Anotae para decidir se a ferramenta é adequada para adoção na sua UBS ou equipe de APS.

Perfil do revisor: médico(a), enfermeiro(a) ou farmacêutico(a) avaliando o Anotae como potencial ferramenta de apoio à digitação em unidades do SUS.

Tempo estimado: 30 minutos.

Pré-requisitos

  • Computador com Windows 10/11, macOS 12+ ou Ubuntu 20.04+
  • Python 3.12 ou superior instalado (python.org/downloads)
  • Conexão com internet apenas para o download inicial (o Anotae roda 100% offline após instalado)
  • Importante: use exclusivamente dados sintéticos ou fictícios durante toda a avaliação. Nunca insira dados reais de pacientes nesta sessão de teste.

Passo 1: Entender o que o Anotae é — e o que não é

Antes de qualquer instalação, um alinhamento de escopo é fundamental para uma avaliação justa.

O Anotae é:

  • Uma ferramenta de apoio à digitação para profissionais de saúde do SUS
  • Um editor que permite escrever a nota SOAP uma única vez e injetar os dados automaticamente em sistemas oficiais (e-SUS APS PEC, SISREG III) via extensão de navegador
  • Um app 100% local/offline — nenhum dado sai do computador
  • Um auxiliar opt-in de IA local (Smart Compose, transcrição de consulta, análise de laudo) — todos os recursos de IA são desativados por padrão

O Anotae NÃO é:

  • Um prontuário eletrônico oficial (PEP) — o registro autêntico permanece no e-SUS
  • Um dispositivo médico (SaMD) regulado pela ANVISA — é auxiliar de digitação
  • Uma ferramenta de auto-diagnóstico ou auto-prescrição — o julgamento clínico é sempre do profissional
  • Uma solução em nuvem — não existe "modo sync" ou "conta online"

Analogia útil: o Anotae está para o e-SUS assim como o Excel está para o sistema contábil da prefeitura — ajuda a organizar e digitar, mas o sistema oficial é a fonte de verdade.

Passo 2: Instalar o Anotae

Instalação via pip (recomendada para avaliação)

pip install anotae

Verifique a instalação:

anotae version

Saída esperada (exemplo fictício):

Anotae v0.15-3
Python 3.12.3  |  PySide6 6.7.1  |  SQLite 3.45.1
Vault: não configurado

Abrindo o aplicativo

anotae

Na primeira execução, o assistente de configuração inicial será exibido. Ele guia você na criação do vault e definição da senha-mestra.

Senha-mestra: escolha uma senha forte que você consiga lembrar. Ela é usada para derivar a chave criptográfica que protege todos os dados locais. Não existe recuperação remota — se esquecer a senha, os dados são irrecuperáveis (isso é uma característica de segurança, não um bug).

Passo 3: Criar um paciente de teste (PAC-TESTE)

Para a avaliação, vamos usar um paciente fictício com dados sintéticos.

  1. Na janela principal, pressione Ctrl+P (ou clique em Pacientes na barra lateral).

  2. Clique em Novo paciente.

  3. Preencha os campos com dados completamente fictícios:

Campo Valor de teste
Nome completo PAC-TESTE Avaliação
Data de nascimento 01/01/1980
CNS 111 111 111 111 111
CPF 000.000.000-00
Sexo Feminino
Município Qualquer

Atenção: o campo CNS 111 111 111 111 111 e o CPF 000.000.000-00 são inválidos por design — o Anotae os aceita em modo de teste para facilitar avaliações sem gerar dados que se assemelhem a registros reais.

  1. Clique em Salvar.

O paciente PAC-TESTE aparece agora na lista de pacientes.

Passo 4: Escrever uma nota SOAP com template

Vamos registrar uma consulta de rotina usando um dos templates curados por especialidade.

  1. Com PAC-TESTE selecionado, pressione Ctrl+N para criar um novo atendimento.

  2. No campo Template, clique no seletor e observe as opções disponíveis. Templates com o símbolo ★ são templates curados por especialidade APS. Selecione ★ Consulta de rotina — MFC.

  3. O editor SOAP é preenchido automaticamente com a estrutura do template:

[S] Subjetivo
Queixa principal:
HMA:
Histórico relevante:

[O] Objetivo
PA: ___ × ___ mmHg  |  FC: ___ bpm  |  Peso: ___ kg  |  Altura: ___ m
Exame físico:

[A] Avaliação
CIAP-2:
CID-10:
Impressão clínica:

[P] Plano
Conduta:
Retorno:
SIGTAP:
Medicamentos:

  1. Preencha os campos com dados fictícios, por exemplo:

  2. [S] — "Paciente refere cefaleia ocasional. Sem outras queixas."

  3. [O] — "PA: 130 × 85 mmHg | FC: 72 bpm | Peso: 68 kg | Altura: 1,65 m"
  4. [A] — Digite K86 no campo CIAP-2 para ver o auto-complete semântico sugerir "Hipertensão não complicada".

  5. [P] — "Manter medicação atual. Retorno em 3 meses."

  6. Pressione Ctrl+S para salvar o atendimento.

Dica: no campo SIGTAP, comece a digitar "consulta" para ver os procedimentos SIGTAP disponíveis para APS (~120 itens). O auto-complete funciona por sinônimos — "consulta médica", "consulta enfermagem", etc.

Passo 5: Explorar os protocolos PCDT (Ctrl+K)

O Anotae inclui um navegador de protocolos clínicos baseado nos PCDTs do Ministério da Saúde e nas Cadernos de Atenção Básica.

  1. Pressione Ctrl+K para abrir o painel de protocolos.

  2. Observe a lista de protocolos disponíveis com badges de vigência:

  3. ✓ Vigente — protocolo dentro do prazo de revisão
  4. ⚠ Revisar — prazo de revisão próximo

  5. ✗ Vencido — protocolo pode ter sido atualizado pelo MS

  6. Selecione, por exemplo, PCDT — Hipertensão Arterial Sistêmica (2022).

  7. O painel exibe um resumo do protocolo com data de vigência, autoridade emissora e link para o PDF original (armazenado localmente).

  8. Clique em Inserir referência no plano para adicionar a citação do PCDT automaticamente na seção [P] do atendimento aberto.

O que avaliar aqui: o painel Ctrl+K serve como referência clínica de consulta rápida durante o atendimento. Os PDFs são armazenados localmente; a ferramenta não acessa a internet para buscar protocolos.

Passo 6: Usar a calculadora clínica (Ctrl+L) — PHQ-9

O Anotae inclui seis calculadoras clínicas para triagem e estratificação de risco em APS, todas determinísticas e 100% locais.

  1. Pressione Ctrl+L para abrir o painel de calculadoras.

  2. Selecione PHQ-9 — Rastreamento de Depressão.

  3. A calculadora exibe as 9 perguntas do instrumento PHQ-9. Responda com valores fictícios para fins de teste (ex.: 0 para todos os itens = "nenhuma vez").

  4. Clique em Calcular.

  5. O resultado é exibido com:

  6. Pontuação total
  7. Classificação de severidade (mínima / leve / moderada / grave)
  8. Trecho pronto para inserção na seção [A] do SOAP

Exemplo de saída fictícia:

PHQ-9: 0/27 — Mínima (sem sintomas significativos)
[AVISO CFM 2.454/2026: resultado gerado por ferramenta auxiliar.
 Interpretação clínica é responsabilidade exclusiva do profissional.]
  1. Clique em Inserir no SOAP para adicionar o resultado à seção de avaliação do atendimento aberto.

Calculadoras disponíveis: PHQ-9, GAD-7, AUDIT-C, CAGE, eGFR CKD-EPI 2021 e Framingham 2008. Todas seguem o mesmo fluxo.

Passo 7: Entender o disclaimer de IA e a conformidade com o CFM

O Anotae inclui recursos de IA local (Smart Compose, Consulta Ao Vivo, Análise de Laudo). Todos são opt-in e desativados por padrão.

Quando ativados, todo rascunho gerado por IA recebe automaticamente um cabeçalho de rastreabilidade antes de ser salvo:

[IA-ASSISTIDA] Rascunho gerado por Anotae Smart Compose em 2026-05-19 09:15.
Revisado e aprovado por: Dr(a). [nome do profissional]
CFM 2.454/2026 — O profissional retém responsabilidade integral pelo conteúdo.

Por que isso existe?

A Resolução CFM 2.454/2026 exige que o uso de inteligência artificial no apoio a registros médicos seja documentado e que a responsabilidade clínica permaneça com o profissional. O Anotae implementa esse requisito automaticamente.

Nenhum rascunho de IA é salvo sem revisão explícita do profissional. O fluxo sempre exige que o profissional revise, edite se necessário, e pressione Ctrl+S para confirmar o salvamento.

Passo 8: Perguntas de conformidade respondidas

LGPD (Lei Geral de Proteção de Dados — Lei 13.709/2018)

Os dados de pacientes saem do computador? Não. O Anotae é 100% local. Não há servidor central, não há transmissão de dados clínicos para qualquer destino externo.

Como os dados são protegidos em repouso? O vault é cifrado com ChaCha20-Poly1305 (SQLite3 Multiple Ciphers) e a chave é derivada da senha-mestra via Argon2id. Campos clínicos têm cifra adicional em nível de coluna (Migration 010).

Há log de auditoria? Sim. Todo evento de criação, edição e exclusão é registrado em um log append-only com cadeia de hash SHA-256 (tamper-evident). O DPO/Encarregado pode auditar o log via anotae backup verify (veja o tutorial Auditar a integridade do vault).

Quem é o controlador dos dados? O profissional de saúde ou a unidade que opera o Anotae. A Anthropic (criadora do Claude, tecnologia subjacente a alguns recursos) não tem acesso aos dados — os modelos de IA rodam localmente via llama.cpp/whisper.cpp.

CFM (Conselho Federal de Medicina)

O Anotae é um prontuário eletrônico oficial? Não. O registro oficial permanece no e-SUS PEC. O Anotae é uma ferramenta auxiliar de digitação — equivalente a um bloco de notas estruturado.

O uso de IA está em conformidade com a Resolução CFM 2.454/2026? Sim. Toda nota assistida por IA inclui cabeçalho de rastreabilidade, identificação do profissional revisor e disclaimer de responsabilidade. Nenhuma decisão clínica é automatizada sem revisão humana obrigatória.

ANVISA

O Anotae é um Software como Dispositivo Médico (SaMD)? Não, segundo a avaliação do risco regulatório documentada em docs/PRIVACY-IMPACT-ASSESSMENT.md. O Anotae não realiza diagnóstico, não prescreve e não substitui o julgamento clínico — é uma ferramenta de produtividade administrativa.

Recomendação: para uso institucional formal, submeta a avaliação de impacto à privacidade (docs/PRIVACY-IMPACT-ASSESSMENT.md) ao setor jurídico da unidade ou da Secretaria de Saúde antes da implantação. O Anotae é open-source (AGPL-3.0) — o código-fonte pode ser auditado por qualquer especialista.

Próximos passos para o revisor

Caso a avaliação seja positiva:

  1. Leia o guia de implantação em produção: docs/how-to/verificar-prontidao-clinica.md
  2. Configure a extensão de navegador para integração com o e-SUS PEC: docs/how-to/configurar-extensao.md (how-to)
  3. Revise o modelo de ameaças e o RIPD com o DPO da instituição: docs/THREAT-MODEL.md e docs/PRIVACY-IMPACT-ASSESSMENT.md
  4. Submeta questões clínicas ou regulatórias via issue no repositório do projeto (etiqueta clinical-review)

O que aprendemos

Ao final deste tutorial você:

  1. Compreendeu o escopo do Anotae — auxiliar de digitação, não PEP oficial.
  2. Instalou e configurou o vault com senha-mestra local.
  3. Criou um paciente de teste com dados sintéticos, sem risco de mistura com dados reais.
  4. Registrou uma nota SOAP usando template curado por especialidade APS, com auto-complete de CIAP-2 e SIGTAP.
  5. Explorou o navegador de protocolos PCDT (Ctrl+K) com badges de vigência.
  6. Calculou um PHQ-9 e inseriu o resultado no SOAP, observando o disclaimer CFM obrigatório.
  7. Entendeu como o rastreamento de IA funciona e por que a revisão humana é obrigatória no fluxo.
  8. Respondeu às principais dúvidas de conformidade (LGPD, CFM, ANVISA).

O Anotae é um projeto open-source em desenvolvimento ativo. Contribuições, relatos de uso clínico e revisões externas são bem-vindos — veja CONTRIBUTING.md na raiz do repositório.