PLATAFORMA TRAUMA
Página Inicial / Documentação / Documentação Técnica

Documentação Técnica

Visão geral da arquitetura, serviços e integrações que sustentam a Plataforma TRAUMA.

Arquitetura

O TRAUMA processa notificações de causas externas em um pipeline com quatro etapas principais: (1) ingestão de arquivos vindos do SINAN, do GPSUS/E-SUS Urgências e de sistemas hospitalares; (2) enfileiramento e processamento assíncrono desses arquivos; (3) qualificação algorítmica e ontologização dos registros, incluindo reclassificação assistida por machine learning; e (4) consolidação em uma base unificada, consumida pelos dashboards e pela API.

Serviços

API Gateway Ponto único de entrada para autenticação, roteamento e limites de uso das APIs internas e externas.
Banco de Dados (PostgreSQL) Armazena a base unificada de registros já qualificados, utilizada por dashboards e exportações.
Fila de Processamento Gerencia o processamento assíncrono dos arquivos recebidos, com reprocessamento automático em caso de falha.
Armazenamento de Arquivos Guarda os arquivos brutos recebidos das origens antes e depois do processamento, para auditoria.
Ontologizador / Qualificação Serviço de padronização semântica que mapeia texto livre para termos controlados e códigos CID-10.

Principais Integrações

Sistema Tipo de Integração Frequência Formato
SINAN Importação de notificações Diária CSV
GPSUS / E-SUS Urgências Importação de atendimentos de urgência Diária (lotes) JSON
Sistemas Hospitalares (HIAE e parceiros) Envio de boletins e prontuários Diária / sob demanda XML / CSV
Datasus / ConectSUS Sincronização de acesso nacional aos dados consolidados Contínua API REST
CONASS / CONASEMS Ampliação de fontes e locais de coleta Sob demanda CSV / API

Endpoints da API (exemplo)

Método Endpoint Descrição
GET /api/v1/registros Lista registros unificados de causas externas, com filtros por período, UF e status.
GET /api/v1/registros/{id} Retorna o detalhe de um registro específico.
POST /api/v1/reclassificacao/{id} Registra a decisão do revisor sobre a reclassificação sugerida pelo modelo.
POST /api/v1/ontologizador/mapear Recebe um texto livre e retorna termos padronizados sugeridos com grau de confiança.
GET /api/v1/arquivos Lista arquivos processados, com status de ingestão e origem.
POST /api/v1/arquivos/{id}/reprocessar Reenvia um arquivo específico para a fila de processamento.