Ecoinfo AES - CI build
0.1.0 - ci-build

!!Ecoinfo AES - CI build - Compilação de desenvolvimento local (v0.1.0) construída pelas ferramentas de compilação FHIR (HL7® FHIR® Standard). Veja o Diretório de versões publicadas

Início

Official URL: https://fhir.ecoinfo.ipes.tech/fhir/ImplementationGuide/Ecoinfo Version: 0.1.0
Draft as of 2025-08-06 Computable Name: Ecoinfo

Este guia de implementação foi desenvolvido no contexto do Projeto Ecossistema de Informação da Atenção Especializada em Saúde (EcoInfoAES), uma plataforma de análise e visualização de dados de Atenção Especializada em Saúde (AES), construída sobre repositórios normalizados em HL7 FHIR.

Ele permite:

  • Visualização e monitoramento das filas de espera de procedimentos especializados.

  • Análise e acompanhamento do processo regulatório.

  • Registro da realização de procedimentos dos pacientes na Rede de Atenção à Saúde (RAS), especialmente os vinculados às Ofertas de Cuidados Integrados (OCI).

  • Relacionamento entre OCI priorizadas, filas de espera informadas e estabelecimentos contratualizados, conforme os Planos de Ação Regional (PAR) do PMAE.

O EcoInfoAES é uma ferramenta essencial para a análise e visualização de informações relacionadas à Atenção Especializada em Saúde (AES). O EcoInfoAES estrutura um ambiente baseado em interoperabilidade, com repositórios de dados normalizados em HL7 FHIR, ferramentas de análise, lago de dados e painéis de visualização.

Neste ambiente, dados estruturantes e transacionais são integrados, interoperados, enriquecidos e qualificados para gerar modelos implementados e testados. Estes modelos promovem a evolução dos diferentes mecanismos de captação, processamento, análise, visualização, gestão e governança das informações relacionadas à AES.

O EcoInfoAES foi concebido para atender objetivos imediatos e de longo prazo. Inicialmente, ele instrumentalizar a monitoração do Programa Agora tem Especialistas, uma iniciativa do Ministério da Saúde e do Governo Federal que tem como principal objetivo reduzir o tempo de espera por atendimentos no Sistema Único de Saúde - SUS. A ação faz parte das políticas da Secretaria de Atenção Especializada à Saúde – SAES que busca promover um atendimento mais ágil e eficiente para a população.

No contexto dos modelos financeiros do FHIR, o EcoInfoAES utiliza recursos como Claim e ClaimResponse, que permitem gerenciar autorizações e pagamentos de procedimentos de alta complexidade por meio de mensagens padronizadas. Esses recursos asseguram que as solicitações de serviços e suas respostas estejam alinhadas aos processos financeiros do SUS, garantindo interoperabilidade entre sistemas locais e nacionais.

Além disso, o EcoInfoAES também utiliza os recursos Task, Appointment e ServiceRequest para gerenciar os fluxos operacionais da regulação assistencial. O recurso Task é empregado para coordenar as atividades relacionadas às solicitações de serviço, garantindo rastreabilidade e execução eficiente. Já o Appointment possibilita o agendamento estruturado de serviços na Rede de Atenção à Saúde, facilitando o acompanhamento e a alocação de recursos. Por sua vez, o ServiceRequest é o recurso central para registrar e detalhar solicitações clínicas e não clínicas, assegurando que informações essenciais sejam capturadas e comunicadas de forma padronizada.

De forma continuada, o EcoInfoAES produzirá informações individualizadas, anonimizadas e agregadas provenientes de diferentes sistemas de informação. Esses dados serão utilizados para o planejamento, monitoramento e avaliação de ações em saúde.

Arquitetura da solução

O EcoInfoAES funciona como um Data Lake centralizado para a Atenção Especializada em Saúde, suportando desde a ingestão bruta até camadas de dados refinados e análises avançadas .

1. Fontes de Dados

  • Sistemas Municipais (MS): exportação de CSVs
  • CNES, OCI, PAR, APAC: arquivos CSV hospedados
  • REDSHIFT RNDS (RIRA): extração via queries SQL
  • APIs: SISREG e CNS para solicitações em tempo real

2. Ingestão e Staging

  1. ETL via Spark

    • Cada fonte é carregada em tabelas de estágio:

      • TB_CNES_STAGE, TB_OCI_STAGE, TB_PAR_STAGE, TB_APAC_STAGE
      • TB_TASK_SERVREQ_STAGE, TB_PATIENT_STAGE
  2. Master Patient Index (MPI)

    • Consolida e deduplica pacientes antes da camada final
  3. Adaptadores FHIR

    • Convertem dados de OCI, PAR, Claim e Task em Bundles FHIR

3. Camadas de Dados

  • Raw Zone: tabelas de estágio com dados originais
  • Curated Zone: tabelas organizadas por entidade FHIR:

    • TB_ORGANIZATION, TB_PRACTITIONER, TB_PRACTITIONER_ROLE
    • TB_CLAIM, TB_CLAIM_PROCEDURE, TB_CLAIM_RESPONSE
    • TB_TASK, TB_SERVICE_REQUEST, TB_APPOINTMENT, TB_PATIENT
  • Analytics Zone: tabelas otimizadas para consultas de indicadores e relatórios

4. Publicação de Recursos FHIR

A camada final produz recursos FHIR versionados que alimentam:

  • Admin (Organization, PractitionerRole)
  • Interp (PlanDefinition, OperationDefinition)
  • Recursos clínicos: CNES, OCI, PAR, APAC (original e processada), Regulação (RIRA), CNS
  • Fluxos financeiros/operacionais: Claim, Procedure, ClaimResponse, Task, ServiceRequest, Appointment, Patient

5. Consumo e Dashboards

  • Bulk Data API ($export) para extração em lote
  • Measure/MeasureReport para indicadores como tempo de espera, taxa de conclusão de APAC
  • Dashboards em Grafana, Power BI ou Metabase para visualização dos KPIs