Conector e adaptador resolvem movimentos diferentes
A sessão de 2 de outubro começa pela direção da busca para explicar duas estratégias de integração com sistemas que não oferecem FHIR nativamente.
| Aspecto | Conector | Adaptador |
|---|---|---|
| Iniciativa | Agente próximo à origem busca, processa e envia | A plataforma consulta ou media a origem quando precisa |
| Distribuição | Pode existir por hospital, sistema, modelo ou carga | Tende a residir na camada de integração central |
| Tecnologia mostrada | Aplicação Java/Spring com extratores e modelos | Mediação no ecossistema WSO2 |
| Escala operacional | Adequado a múltiplas origens heterogêneas | Útil para acesso centralizado e integração sob demanda |
| Observabilidade | Estado, progresso, lotes, respostas e logs próprios | Chamadas, políticas, mediações e logs da plataforma |
Extrator e modelo desacoplam origem e saída
O desenho demonstrado separa como o dado é lido de como o artefato interoperável é produzido.
Banco de origem ↓ consultas por janela Arquivos intermediários por classe ↓ correlação pelo registro principal Documento lógico de um atendimento ↓ transformação + validação OpenEHR / recurso ou documento FHIR ↓ envelope, autenticação e envio HU Digital ↓ resposta validada Estado + auditoria + próxima janela
No caso apresentado, várias consultas retornam partes administrativas e clínicas. O conector percorre os relacionamentos e reúne as linhas pertencentes ao mesmo registro antes de transformar o conteúdo. Essa etapa evita misturar dados de atendimentos diferentes.
Transformações e validações variam por modelo. RAC e Sumário de Alta preservam templates openEHR e depois são envelopados para a transação de documentos; outros casos produzem recursos FHIR ou anexos com regras próprias.
Cada fluxo mantém seu próprio avanço
O conector precisa continuar cargas periódicas, retomar após reinício e impedir que a falha de um modelo paralise todos os demais.
- 1Definir a janela
Datas mínima e máxima delimitam o lote de cada modelo e evitam reler toda a origem.
- 2Extrair
Consultas materializam apenas os registros candidatos daquela janela.
- 3Processar por documento
O agrupamento separa cada atendimento ou resultado antes da transformação.
- 4Enviar e validar
A resposta é classificada segundo o contrato do modelo; sucesso técnico e aceitação clínica não são confundidos.
- 5Persistir o avanço
O estado por modelo é salvo para que reinícios retomem do ponto controlado.
- 6Publicar progresso
Auditoria e métricas permitem comparar o que foi lido, enviado, aceito e rejeitado.
| Modo | Objetivo | Risco a controlar |
|---|---|---|
| Tempo real/periódico | Avançar continuamente sobre novos registros | Atraso silencioso e janela presa em erro |
| Carga histórica | Processar intervalo passado até uma data de corte | Duplicação, versão incorreta e competição por recursos |
| Reprocessamento | Reenviar o que foi corrigido ou evoluiu de versão | Sobrescrever versão mais nova ou repetir efeito |
| Instância dedicada | Isolar fluxo de alto volume | Divergência de configuração e observabilidade fragmentada |
Cinco famílias de informação demonstradas
O repasse compara modelos nacionais mais formais com casos institucionais construídos sobre recursos FHIR e anexos.
| Família | Representação apresentada | Particularidade operacional |
|---|---|---|
| RAC | Documento clínico estruturado em openEHR, transportado no fluxo documental | Grande volume ambulatorial e muitas classes correlacionadas |
| Sumário de Alta | Template openEHR e envelope documental | Resumo da alta, não reprodução integral da internação |
| Documentos assinados | DocumentReference e conteúdo HTML/PDF como anexo | Autoria, tipo e versão orientam consulta e reprocessamento |
| Agendamentos/teleconsulta | Modelo institucional progressivamente alinhado a Appointment | Dados de sala, vínculo e evento podem vir de fontes diferentes |
| Resultados de exames | DiagnosticReport, ServiceRequest, códigos e laudo anexo | Liberação parcial, vocabulários locais e obtenção complementar do PDF |
A separação entre cadastro demográfico e conteúdo clínico aparece como controle de redução de exposição: o documento usa uma referência de paciente e a correlação identificável fica no serviço de identidade clínica.
Em exames, o workshop mostra a coexistência de códigos locais, SIGTAP e LOINC. Preservar códigos disponíveis pode apoiar conciliação futura, mas não transforma automaticamente terminologias diferentes em equivalentes.
Triagem orientada por etapa
Uma falha do conector deve ser localizada antes de qualquer reprocessamento.
| Etapa | Evidência mínima | Pergunta de diagnóstico |
|---|---|---|
| Seleção | Janela, contagem e chave técnica | O registro era elegível e estava no intervalo? |
| Extração | Resultado de cada classe e ausência de erro de conexão | A origem retornou todas as partes obrigatórias? |
| Correlação | Quantidade de documentos lógicos produzidos | Linhas do mesmo registro foram reunidas corretamente? |
| Transformação | Versão do modelo e validação estrutural | O conteúdo respeita cardinalidade, tipo e terminologia? |
| Identidade | Resultado mascarado da correlação no MPI | O paciente correto foi resolvido sem ambiguidade? |
| Envio | Status, categoria de resposta e tempo | A autenticação e o contrato aceitaram a requisição? |
| Estado | Último avanço confirmado por modelo | É seguro avançar, repetir ou isolar o item? |
| Auditoria | Evento no índice e métrica correspondente | A visão operacional concorda com o backend receptor? |
Capítulos para revisão dirigida
Abra as quatro gravações pelo Guia do repasse e use os timestamps abaixo.
| Sessão | Timestamp | Assunto |
|---|---|---|
| 02/10 | 00:02:48 | Conector versus adaptador |
| 02/10 | 00:49:58 | Abstração extrator + modelo |
| 02/10 | 01:20:47 | Extrator PostgreSQL do AGHU |
| 03/10 | 00:21:51 | Anonimização e depuração |
| 03/10 | 01:11:01 | Validação openEHR |
| 03/10 | 02:28:30 | Pipeline do Sumário de Alta |
| 09/10 | 00:13:35 | Modelo de anexo reutilizado |
| 09/10 | 01:02:37 | Conectores de agendamento |
| 10/10 | 00:30:56 | DiagnosticReport e transformação |
| 10/10 | 01:08:27 | Pipeline e regras de carga |
| 10/10 | 01:45:01 | Complementação do laudo pela API |