Documentação de um sistema web de triagem odontológica com odontograma de 32 elementos, registro de avaliações e histórico de pacientes.
Versão documental: 1.0 — 10/09/2026.
Especificação proposta a partir do PDF do projeto e do prompt 1.1. Nenhum código do aplicativo foi fornecido ou validado.
- Índice completo
- Pendências clínicas e técnicas
- Requisitos e histórias
- Modelagem e diagramas
- Roadmap dos três MVPs
- Verificação e limites
- Scripts de manutenção
| Etapa | Objetivo |
|---|---|
| MVP 1 — Mínimo | Triagem mínima rastreável e preservação do histórico. |
| MVP 2 — Intermediário | Produtividade, comparação e supervisão condicionada à validação. |
| MVP 3 — Avançado | Evolução institucional e integrações condicionadas à aprovação do escopo. |
As faixas A/B/C e outras regras clínicas ainda precisam de validação. O pacote não estabelece limites clínicos aprovados para classificação.
- Documentação organizada em Markdown.
- Requisitos, histórias, critérios de aceite e casos de teste.
- Modelagem de dados, dicionário e propostas de migrações SQL.
- Contrato de API em OpenAPI.
- Diagramas editáveis e respectivas imagens.
- Decisões arquiteturais e avaliação de design patterns.
- Protocolos de validação e procedimentos operacionais.
- Roadmap com três MVPs.
As versões consolidadas ficam em exports/. Este pacote não contém uma aplicação executável.
- Crie uma branch com um nome relacionado à alteração.
- Faça alterações com um objetivo definido.
- Atualize os documentos e diagramas relacionados, mantendo a rastreabilidade.
- Confira os links e execute as verificações pertinentes, conforme os scripts de manutenção.
- Abra um Pull Request explicando o que mudou, por quê e como foi verificado.
Ao alterar requisitos, mantenha seus identificadores e revise os vínculos com casos de uso, diagramas, testes e roadmap. Identifique propostas e pendências; regras clínicas exigem validação do responsável pelo domínio.
Use o formato:
tipo: descrição curta da alteração
| Tipo | Finalidade | Exemplo |
|---|---|---|
feat |
Nova funcionalidade | feat: adiciona cadastro de pacientes |
fix |
Correção de erro | fix: corrige salvamento da avaliação |
docs |
Documentação | docs: adiciona diagrama de sequência da triagem |
refactor |
Reorganização do código sem alterar o comportamento | refactor: reorganiza serviço de avaliações |
style |
Formatação do código | style: padroniza indentação do backend |
test |
Criação ou ajuste de testes | test: adiciona testes de cadastro de pacientes |
perf |
Melhoria de desempenho | perf: otimiza consulta ao histórico |
build |
Dependências e processo de build | build: atualiza dependências do frontend |
ci |
Automação de integração e entrega | ci: adiciona verificação de testes |
chore |
Manutenção geral | chore: atualiza arquivo gitignore |
revert |
Reversão de alteração | revert: desfaz alteração na busca de pacientes |
O escopo é opcional e indica a área afetada:
feat(pacientes): adiciona busca por nome
fix(triagem): impede envio de nota inválida
docs(modelagem): atualiza diagrama de classes
docs(roadmap): detalha critérios de entrega do MVP 1
Use o mesmo padrão no título do Pull Request. Evite o tipo genérico update: escolha o tipo conforme a finalidade da atualização.
- Alteração: o que foi criado ou modificado.
- Motivo: problema ou necessidade atendida.
- Verificação: como a alteração foi conferida.
- Vínculos: requisitos, tarefas ou documentos relacionados.
- Pendências: pontos que ainda precisam de decisão ou validação, quando houver.
GitHub: integrar o conteúdo após revisão, preservando os arquivos existentes no repositório.
Drive: enviar DOCX, PDF e ZIP à pasta escolhida e conferir a importação.
Mantenha as versões consolidadas sincronizadas com os arquivos-fonte.
A licença final depende da definição do titular do projeto, registrada como pendência P08.