Registro de decisiones (ADR)¶
Un ADR registra una decisión técnica vigente y su contexto, para que no se re-discuta sin conocer por qué se tomó. Formato: MADR simplificado — usar 0000-plantilla.md.
Reglas¶
- Numeración: secuencial de 4 dígitos (
0001-,0002-, ...). No se reusan números. - Un ADR no se edita para cambiar la decisión: se escribe uno nuevo que lo reemplaza y el viejo
pasa a estado
reemplazado por ADR-NNNN. - ADRs retroactivos: solo decisiones que siguen costando dinero re-discutir. Límite estricto: 3 por repositorio.
- ADRs nuevos: toda decisión de arquitectura tomada a partir de ahora se registra en el momento, dentro del mismo PR que la implementa.
Índice¶
| ADR | Título | Estado |
|---|---|---|
| 0001 | Build en GitHub Actions e imagen en GHCR; deploy en runners self-hosted | aceptado |
| 0002 | Migraciones y bootstrap dentro de start.sh, al arrancar el contenedor |
aceptado |
| 0003 | Aprobación de producción vía workflow_dispatch manual |
reemplazado por ADR-0004 |
| 0004 | Producción se despliega por tag v*, no por workflow_dispatch |
aceptado |
| 0005 | Variables de entorno en GCP Secret Manager como fuente única | aceptado |
| 0006 | Pedido después del pago para los medios confirmados por terceros (Bancard QR y vPOS); transferencia con pedido primero | aceptado |