Ir para o conteúdo

Como lançar relatório de paciente em SEI/DF via Anotae

Esta guia cobre o fluxo end-to-end APS/DF: você atendeu o paciente, registrou no Anotae em SOAP, e agora precisa lançar um relatório no SEI/DF com os dados desse atendimento. O Anotae preenche o editor; você revisa, assina e tramita.

Pré-requisitos

  • Anotae 0.9.0-beta2 rodando com vault aberto
  • Extensão Anotae instalada e conectada (ver configurar-extensao.md)
  • Acesso à sua conta no SEI/DF (sei.df.gov.br)
  • Pelo menos um atendimento salvo no vault, com S/O/A/P preenchidos

Passo a passo

1. Crie o atendimento no Anotae

  1. Abra o Anotae e seu vault
  2. Clique em Novo (Ctrl+N)
  3. Preencha:
  4. CNS Profissional (validado)
  5. Função (MFC, ENF, etc)
  6. ID Paciente (handle local — não use nome real)
  7. Tipo (primeira_consulta, retorno, etc)
  8. CIAP-2 e CID-10 (com auto-complete)
  9. S, O, A, P (texto livre)
  10. Salve com Ctrl+S

2. Abra o SEI/DF

Pelo Anotae: menu Integrações → Abrir SEI/DF — Lançar relatório. O navegador padrão abre direto na tela de login do SEI/DF.

Se você quer usar uma URL diferente (sub-instância, login institucional federado), edite ~/.anotae/config.toml, seção [integracoes], campo sei_df_url. Reinicie o Anotae.

3. Crie o documento no SEI

  1. Faça login normalmente
  2. Inicie um novo processo (ou abra processo existente)
  3. Clique em Incluir Documento
  4. Escolha o tipo (ex: "Relatório", "Relatório Médico", conforme a unidade)
  5. O editor de documento (CKEditor) abre — uma janela/aba nova com o iframe de edição
  6. Não comece a digitar — você vai injetar o texto pelo Anotae

4. Injete o texto pelo Anotae

  1. No SEI/DF, com o editor aberto, clique no ícone da extensão Anotae na barra do navegador (canto superior direito)
  2. O popup mostra os atendimentos do vault — selecione o atendimento criado no passo 1
  3. Clique em Injetar em SEI/DF
  4. Dialog de confirmação aparece com:
  5. Pré-visualização exata do texto que será injetado
  6. Disclaimer sobre humano-no-loop e revisão obrigatória
  7. Checkbox que você precisa marcar para liberar o botão "Injetar no SEI"
  8. Confirme — o texto aparece no editor do SEI

5. Revise, edite, assine e tramite

A partir daqui é fluxo SEI normal:

  1. Revise o conteúdo — leia tudo, corrija o que for específico do caso
  2. Ajuste formatação (negrito, listas) se quiser
  3. Salve o documento no SEI
  4. Assine quando for o momento certo
  5. Tramite/inclua no processo

O que o Anotae faz e o que NÃO faz

Faz NÃO faz
Abre o navegador na URL do SEI/DF Faz login por você
Renderiza um template determinístico (sem IA) com seu encounter Inventa texto que você não escreveu
Injeta o HTML resultante no iframe do CKEditor Salva o documento no SEI
Mostra uma confirmação obrigatória antes de injetar Assina ou tramita por você
Registra (em audit_log do encounter) que houve injeção Envia qualquer dado para fora da sua máquina

Esse desenho é proposital. Ver docs/explanation/postura-integracao.md para a fundamentação ética/regulatória.

Personalizar o template

O template do relatório fica em anotae/core/templates/relatorio_ses_df.md (no source). É Markdown puro com placeholders no formato {{caminho.do.campo}}.

Variáveis disponíveis no contexto:

encounter.encounter_date       (ISO yyyy-mm-dd)
encounter.encounter_type
encounter.professional_cns
encounter.professional_role    (MFC, GO, PED, ENF...)
encounter.patient_id_local
encounter.soap.subjective
encounter.soap.objective
encounter.soap.assessment
encounter.soap.plan
encounter.ciap2_codes          (lista, vira "N95, K86")
encounter.cid10_codes          (lista, vira "G44.2, I10")
app.version

Para personalizar o cabeçalho com o nome da sua unidade ou adicionar campos específicos, edite o .md e reinicie o Anotae. (UI gráfica de customização vem na Onda 2.)

Troubleshooting

"Editor de documento não foi detectado"

  • Causa: você clicou no popup antes do CKEditor terminar de carregar.
  • Solução: aguarde a tela do editor aparecer completa (toolbar visível) e clique de novo.

Texto aparece mas com formatação estranha

  • Causa: SEI usa CKEditor 4, que tem regras próprias de sanitização HTML.
  • Solução: abra o "Modo Texto" (</> na toolbar do SEI) e ajuste manualmente. Reporte o caso em suporte@anot.ae para melhorarmos o template.

"Hostname X não é SEI conhecido"

  • Causa: você está em uma instância SEI fora dos hosts catalogados (sei.df.gov.br, *.df.gov.br/sei/*).
  • Solução: abra issue no GitHub com o hostname para incluirmos em extension/chrome/manifest.json e em SEI_INSTANCES (extension/src/content/sei-mapping.ts). Cobertura de outras instâncias (MS, Anvisa, demais estados) está mapeada na RFC-002 e entra na Onda 2+.

Quero usar a integração no SEI/MS, SEI/Anvisa, ou outro

Hoje o Anotae cobre apenas SEI/DF (piloto APS/DF). Para outras instâncias, acompanhe RFC-002 em docs/rfc/RFC-002-sei-multi-instancia.md.

Limitações conhecidas (0.9.0-beta2)

  • Apenas SEI/DF (CKEditor 4). Outras instâncias e CK5 vêm em ondas futuras.
  • Sem auto-complete de tipos de documento (você escolhe manualmente).
  • Sem sincronização com processos do SEI (Anotae não lê processos; só preenche editor).
  • Template único por instância. Múltiplos templates por usuário/contexto vêm com RFC-004 (editor único).

Mais