O Prescripta é um produto demonstrativo de portfólio healthtech para organizar contexto, checar regras rastreáveis e documentar revisão de prescrições. A v8.6.0 consolida backend, frontend, catálogo, dose, psicotrópicos, policy, IA assistiva, relatórios e auditoria em uma experiência mais coesa e transparente.
Aviso educacional: não é dispositivo médico, não possui validação clínica e não deve ser usado para atendimento real. Não substitui médico, farmacêutico, enfermagem, bula, protocolo, autoridade sanitária, análise jurídica ou decisão institucional. Use somente dados fictícios.
- O que é e que problema resolve
- Públicos e funcionamento
- Módulos
- Motores clínicos
- IA, relatórios e auditoria
- Demonstração visual
- Instalação e primeiro uso
- Arquitetura, segurança e limites
É uma aplicação web com API FastAPI, frontend React e persistência SQLAlchemy. Ela reúne dados fictícios do paciente, exposição informada, regras determinísticas, evidências, orientações e trilha de auditoria. A inteligência artificial é opcional, minimizada e substituível por fallback local.
O tour do produto percorre os fluxos principais. O índice Documentação do Prescripta conecta guias clínicos, técnicos e por audiência.
Uma checagem não é apenas comparar um número: unidade, frequência, via, peso, altura, histórico, medicamentos concomitantes, fonte e vigência mudam a interpretação. O Prescripta torna essas dependências visíveis, separa incerteza de bloqueio e registra por que um alerta apareceu.
- Leigos e avaliadores: entender o fluxo e os limites de um protótipo healthtech.
- Médicos: revisar contexto, dose, interações e dados faltantes sem falsa segurança.
- Enfermagem: registrar e visualizar contexto, orientação e escalonamento permitido.
- Administração: manter usuários, catálogo, fontes, IA e políticas demo.
- Auditoria/TI: reconstruir decisão, hash, provider, source IDs, integrações e fallback.
O usuário escolhe paciente e medicamento fictícios, informa dose, frequência, via e duração. O backend aplica regras cadastradas e devolve resultado geral, Dose Intelligence, sinais psicotrópicos, policy do prescritor, lacunas e fontes. IA pode explicar o pacote já calculado, mas não muda a decisão. Tudo relevante fica auditado.
Paciente + medicamento + exposição
↓
Contexto e dados faltantes
↓
Risco determinístico ─ Dose ─ Psicotrópicos ─ Policy
↓
Revisão humana + orientação + relatório
↓
EvidenceBundle, hash e auditoria
| Módulo | O que o usuário vê | O que significa |
|---|---|---|
| Dashboard | volume, alertas e qualidade do catálogo | transparência operacional, não cobertura clínica |
| Pacientes | perfil, fatores, documentos e timeline | contexto disponível e lacunas |
| Medicamentos | DCB, aliases, fonte, dose, policy e counseling | dado cadastrado com status de revisão |
| Checagem | resultado clínico e drawer/detalhes técnicos | revisão assistida, não prescrição automática |
| Protocolos | versões, etapas, fontes e execução | fluxo demonstrativo auditado |
| Importações | lotes e reconciliação item a item | dado externo não é aplicado silenciosamente |
| Relatórios | preview, PDF/JSON/CSV, evidência e hash | representação do bundle no momento da geração |
| Auditoria | filtros server-side, timeline e evidência | reconstrução de ações e decisões |
| IA assistiva | provider, modelo, fallback e limitação | explicação/extração, nunca decisão |
Mostra pacientes, medicamentos, checagens, alertas e indicadores reais de curadoria: princípios ativos, itens pendentes, demo, sem fonte, sem regra de dose, sem policy e com counseling. Um número alto de medicamentos não significa catálogo completo.
Cadastro fictício com antropometria, alergias, condições, medicamentos atuais, saúde mental, fatores reprodutivos e perfil funcional. Dados ausentes aparecem como ausentes; não viram “não”.
Documentos textuais/metadados recebem hash, fonte e revisão. Duplicatas pela chave paciente + hash
- tipo + data + origem geram conflito explícito. Extrações por IA/fallback ficam pendentes até revisão humana. Não há OCR ou storage binário produtivo.
O catálogo é centrado em princípio ativo e aceita aliases/produtos. Fonte, jurisdição e status acompanham o registro. Seeds são artificiais; regras sem curadoria não são mostradas como validadas.
A checagem cruza alergia, interação, exposição, condições, histórico e regras específicas. A visão clínica é padrão. Detalhes técnicos aparecem apenas para perfis adequados e incluem fórmulas, JSON, source IDs, graph e evidências.
Calcula referência fixa, por peso real/ideal/ajustado, massa magra ou superfície corporal quando a regra tem fonte e status. Separa dose por administração, diária, procedimento e acumulada; valida unidade, rota e inputs. Nunca escolhe a dose final.
Sinais determinísticos cobrem serotoninérgicos, mania/psicose, convulsão, sedação, álcool, depressão respiratória, QT, lítio, valproato, carbamazepina, lamotrigina, clozapina, metadona, antipsicóticos e carga anticolinérgica. A chave estável evita duplicação por alias. Sinal é risco a revisar, não diagnóstico.
Separa autorização de sistema, regra legal/regulatória documentada, policy institucional,
recomendação clínica e demo. Exibe fonte, versão, vigência, instituição, segunda revisão e condição
de override. CRM/RQE demo permanece demo_unverified; nenhuma consulta externa é feita.
Protocolos versionados podem receber paciente opcional, registrar etapas e gerar relatório. IA explica apenas estrutura e fontes fornecidas; não cria dose, etapa ou conduta.
Adapters mock aceitam formatos FHIR-like, JSON e CSV. Cada item é comparado ao contexto local e só é aplicado após decisão humana auditada. Integração real exige API oficial, contrato, segurança e base legal.
Prescription, patient guidance, reconciliation, audit e protocol usam GeneratedReport quando
aplicável, com target, versão, template, hash, provider/modelo, fallback e anonimização. Narrativa
inválida ou com fonte inexistente é rejeitada.
Filtros de usuário, paciente, medicamento, princípio ativo, protocolo, policy, especialidade, dose, IA, fallback, fonte, jurisdição e data são aplicados no banco com ordenação e paginação. SQLite ainda limita consultas estruturadas profundas em JSON.
Providers configuráveis incluem fallback, OpenAI, Gemini, Ollama e compatíveis com OpenAI. A chave
fica no backend e nunca em localStorage. Structured output e source locking protegem módulos
clínicos. Falha externa mantém fallback e auditoria; a IA não valida regra nem altera dose/risco.
A visão clínica reduz ruído e prioriza ação humana. A técnica apresenta fórmula, inputs, JSON, policy, fontes, hash e metadados. Enfermagem não recebe o seletor técnico da checagem; autorização real continua no backend.
Consulte contratos, mapeamento, segurança/LGPD e payloads fictícios.
Capturas feitas na aplicação v8.6.0 rodando localmente com banco temporário e seeds fictícios. Cada arquivo foi gerado novamente; o checker rejeita hashes duplicados nesta versão.
 |  |
| Dashboard clínico | Dashboard administrativo |
 |  |
| Pacientes | Histórico e documentos |
 |  |
| Catálogo farmacológico | Fila de curadoria |
 |  |
| Visão clínica | Visão técnica |
 |  |  |
| Dose | Psicotrópicos | Policy |
 |  |  |
| Protocolos | Importações | Relatórios |
 |  |  |
| Auditoria | IA assistiva | Usuários e especialidades |
 |  |
| 390 × 844 | 768 × 1024 |
Também estão disponíveis fluxos clínico, administrativo, auditoria e mobile.
Windows:
powershell -ExecutionPolicy Bypass -File scripts/setup-dev.ps1
powershell -ExecutionPolicy Bypass -File scripts/dev.ps1Linux/macOS:
./scripts/setup-dev.sh
./scripts/dev.shRequer Python 3.12+, Node 24+ e npm. Copie .env.example para .env, troque segredos de demo se
necessário e siga o setup local. Backend usa porta 8000 e
frontend 5173 por padrão.
- Entre como admin e confirme status da IA.
- Abra um paciente fictício e revise dados/documentos.
- Escolha uma checagem de exemplo.
- Compare visão clínica e técnica.
- Gere relatório e abra auditoria.
| Perfil | Senha | |
|---|---|---|
| Admin | admin@prescripta.local |
Admin@12345 |
| Médico geral | médico@prescripta.local |
Médico@12345 |
| Anestesiologia | anestesia@prescripta.local |
Anestesia@12345 |
| Psiquiatria | psiquiatria@prescripta.local |
Psiquiatria@12345 |
| Auditoria | auditor@prescripta.local |
Auditor@12345 |
| Enfermagem | enfermagem@prescripta.local |
Enfermagem@12345 |
Somente admin salva/testa/ativa provider ou modelo. Sem chave e chamadas externas desabilitadas, o fallback é esperado. Nunca capture a tela com chave preenchida.
cd backend
..\.venv\Scripts\python -m ruff check . --no-cache
..\.venv\Scripts\python -m pytest
cd ..\frontend
npm run lint
npm run build
cd ..
powershell -ExecutionPolicy Bypass -File scripts/check-text-quality.ps1
git diff --checkRegras determinísticas ficam em services, contratos em domain/schemas, SQLAlchemy em database e repositories, integrações em ports/adapters e relatórios em EvidenceBundles. Rotas coordenam casos de uso; React não decide risco. Consulte a visão de módulos e a auditoria v0.8.5.
backend/app/ API, domínio, serviços, banco, IA, RAG, relatórios e integrações
backend/tests/ testes unitários e de API
frontend/src/ páginas, componentes, configurações, serviços e tipos
docs/ produto, arquitetura, públicos, auditorias e assets
examples/ payloads estritamente fictícios
scripts/ instalação, execução, smoke test e qualidade
Não use dados reais. Segredos ficam no backend, dados enviados à IA são minimizados, identificadores são mascarados/hasheados quando aplicável e ações relevantes são auditadas. A demo não faz scraping agressivo nem autenticação em portal institucional.
Leia limitações conhecidas e a matriz de aceite. Catálogo, policy e regras de dose são demonstrativos/pendentes quando indicado. Assets v0.8.4 não são usados como evidência v0.8.5.
A v0.9.0 prevê Docker, PostgreSQL, Alembic, deploy demo, storage, backup/restore e hardening de ambiente. Consulte o ROADMAP.
Licenciado sob Apache License 2.0.