Architecture Decision Records (ADRs)¶
Registro das decisões arquiteturais significativas tomadas ao longo do desenvolvimento da plataforma AMia.
O que é um ADR?¶
Um ADR documenta uma decisão de arquitetura importante, incluindo o contexto que levou à decisão, a decisão em si e suas consequências. ADRs são imutáveis — quando uma decisão é revisada, o ADR original é marcado como depreciado e um novo ADR é criado.
Status possíveis¶
| Status | Significado |
|---|---|
| 🟡 Proposto | Decisão em análise — ainda não ratificada pelo time |
| ✅ Aceito | Decisão ratificada e em vigor |
| ❌ Depreciado | Decisão substituída por um ADR mais recente |
Registro de ADRs¶
| ADR | Título | Status | Data |
|---|---|---|---|
| ADR-001 | Uso de Mermaid para diagramas de arquitetura | ✅ Aceito | 2026-06-10 |
| ADR-002 | MkDocs com tema Material para documentação | ✅ Aceito | 2026-06-10 |
| ADR-003 | Prompt As Code — prompts versionados em repositório Git | ✅ Aceito | 2026-06-10 |
| ADR-004 | Azure Static Web Apps para hospedagem da documentação | ✅ Aceito | 2026-06-10 |
| ADR-005 | amIA-Ingest: serviço dedicado de ingestão e busca vetorial | ✅ Aceito | 2026-06-12 |
| ADR-006 | Schema ams no PostgreSQL para isolamento de contexto de módulos |
✅ Aceito | 2026-06-12 |
| ADR-007 | Agentic RAG como estratégia de recuperação de contexto no Chat de Atendimento | 🟡 Proposto | 2026-06-30 |
| ADR-008 | amIA-Integration: gateway dedicado para integração de chamados externos (ServiceNow) | 🟡 Proposto | 2026-07-01 |
| ADR-009 | Refinamento técnico iterativo de tasks via agente de chat | ✅ Aceito | 2026-08-07 |
Como adicionar um novo ADR¶
- Copie o template
_template.mddesta pasta - Nomeie o arquivo
adr-NNN-titulo-kebab-case.md - Preencha todas as seções
- Adicione a entrada na tabela acima
- Atualize o
mkdocs.ymlcom a nova página