Visão técnica

Documentação técnica do ProntuAI

Este guia técnico descreve a arquitetura, integrações e configurações do ProntuAI, servindo como referência para desenvolvimento, suporte e operação.

Pipeline técnico

Fluxo de processamento

Recepção

Entrada de PDFs e criação do lote de processamento.

OCR

Extração de texto, identificação de exames e metadados.

BRNET

Consulta dos exames obrigatórios por CPF.

Comparação inteligente e geração de justificativas.

Checagem

Revisão humana com decisão final registrada.

Stack principal

Tecnologias

Front-end

Next.js 15 (App Router)

React 19 + TypeScript

Tailwind CSS 4 + shadcn/ui

NextAuth (Google OAuth)

Back-end

FastAPI (Python 3.11+)

OpenAI API + FAISS

Docling / AWS Textract (opcional)

Gunicorn + Uvicorn workers

Integrações

Serviços externos

OpenAI

Geração de análises, embeddings e validações por IA.

BRNET

Requisitos obrigatórios por CPF para comparação dos exames.

OCR

Docling como padrão e Textract como fallback opcional.

Rotas

Rotas principais (Front e API)

Alterne entre a visão de navegação do produto e os endpoints principais da API.

Interface (Front-end)

Navegação

/login

Público

Autenticação via Google OAuth.

Parâmetros

—

Exemplo

/login

/docs

Guia de uso

Público

Documentação funcional do produto.

Parâmetros

—

Exemplo

/docs

/docs-tecnica

Docs técnica

Time interno

Manutenção e arquitetura do sistema.

Parâmetros

—

Exemplo

/docs-tecnica

/anexar-prontuario

Envio de documentos

Clínica (Enviador) + Admin

Upload, processamento e acompanhamento do lote.

Parâmetros

view=processing (abre tela de progresso)

Exemplo

/anexar-prontuario?view=processing

/pendentes

Pendências

Clínica (Enviador) + Admin

Fila de documentos rejeitados que aguardam correção.

Parâmetros

—

Exemplo

/pendentes

/checagem

Checagem

Time interno BR MED + Admin

Validação manual e decisão final do time interno.

Parâmetros

—

Exemplo

/checagem

/historico

Histórico

Admin

Arquivo final de processamentos concluídos.

Parâmetros

—

Exemplo

/historico

/insights

Insights

Admin

Indicadores operacionais e visão de performance.

Parâmetros

—

Exemplo

/insights

Auth

Autenticação e autorização

Front-end com NextAuth e Google OAuth corporativo.

Backend com JWT para sessões e validações.

Deploy

Deploy e runtime

Serviço backend em Render com runtime Python.

Build: pip install + requirements.txt.

Start: gunicorn main:app com Uvicorn workers.

Região padrão: Oregon.

Observabilidade

Logs e auditoria

Logs automáticos com timestamp para auditoria.

Histórico de decisões e justificativas por documento.

Trilha de auditoria com usuário, data e ação.

Segurança

Boas práticas

Criptografia em trânsito (HTTPS/TLS).

Criptografia em repouso (AES-256).

Acesso granular por perfis e ações.

Retenção e backup conforme requisitos legais.