Decisiones (ADRs)¶
Las Architecture Decision Records son la fuente canónica de decisiones técnicas de ZEngine. Cada ADR usa la plantilla MADR y, una vez aceptado, no se reescribe en silencio: se supersede con un ADR nuevo.
Índice¶
| ID | Título | Estado |
|---|---|---|
| 0001 | Compute: Lambda + API Gateway HTTP | Aceptado |
| 0002 | Tenancy híbrida (logical + physical) | Aceptado |
| 0003 | Persistencia: DDB + RDS Postgres | Aceptado |
| 0004 | Eventing: EventBridge + outbox | Aceptado |
| 0005 | Auth: Cognito + JWT + PKCE | Aceptado |
| 0006 | IaC Terraform + CI/CD GitHub Actions OIDC | Aceptado |
| 0007 | Strategy Pattern para connectors | Aceptado |
| 0008 | Observabilidad: Powertools + X-Ray | Aceptado |
| 0009 | Migración / cutover desde legacy | Aceptado |
| 0010 | Secretos en Secrets Manager + KMS CMK | Aceptado |
| 0011 | Descomposición en 10 servicios | Aceptado |
| 0012 | Parity Gate como cutover gate | Aceptado |
| 0013 | Handler sync para webchat | Aceptado |
| 0014 | Extensiones V1.1 de strategies | Aceptado |
Cómo proponer un ADR nuevo¶
- Crea
docs/adr/00NN-titulo-kebab.mdusando la plantilla MADR. - PR con tag
adr. - Discusión en el PR; al merge a
mainqueda Aceptado. - Para revertir/cambiar: nuevo ADR que supersede al anterior, link bidireccional.
Regla del Documentarian: nunca reescribir en silencio un ADR aceptado. Supersede con uno nuevo.