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 (plantilla en el repo docs-standard).
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. Los tres de abajo son retroactivos.
- ADRs nuevos: toda decisión de arquitectura tomada a partir de ahora se registra en el momento, dentro del mismo commit/PR que la implementa.
Índice¶
| ADR | Título | Estado |
|---|---|---|
| 0001 | Las redes remotas empujan métricas por remote_write; Prometheus no las scrapea |
aceptado |
| 0002 | Loki single-binary sobre filesystem con retención de 30 días | aceptado |
| 0003 | Deploy por git pull + hot-reload, con imágenes latest |
aceptado |
| 0004 | cAdvisor para métricas por contenedor, una instancia por VM | aceptado |
| 0005 | Criterios de alertado: severidad por target, umbrales con historia, test por alerta, sin certificados ni Watchdog | aceptado |
| 0006 | Exporters de servicio junto a cada servicio, en la red de la app y publicados en la IP interna | aceptado |
| 0007 | Un tablero de detalle por componente y uno de operación por producto | aceptado |