ADRs — Architecture Decision Records¶
Los ADRs (Architecture Decision Records) son la memoria causal del sistema. No documentan qué hace SmallCountry — documentan por qué se tomaron las decisiones que le dieron forma. Son el registro de racionalidad que permite que, dentro de años, alguien entienda por qué el sistema es como es sin tener que reabrir debates ya resueltos.
ADRs fundacionales¶
| # | Título | Fecha | Estado |
|---|---|---|---|
| 001 | MQTT (protocolo de mensajería ligera para IoT) como bus de sensores | 2026-05 | aceptado |
| 002 | Tiers de criticidad (S/A/B/C/D) | 2026-05 | aceptado |
| 003 | Operación offline-first | 2026-05 | aceptado |
| 004 | Dos orquestadores: Node-RED + n8n | 2026-05 | aceptado |
| 005 | NetBird + WireGuard como estrategia de acceso | 2026-05 | aceptado |
| 006 | ZFS como base de almacenamiento | 2026-05 | aceptado |
| 007 | Dominio interno .sc sin sufijo de nodo | 2026-05-12 | aceptado |
Formato¶
Cada ADR sigue la plantilla. Un ADR:
- Es breve (1-2 páginas máximo)
- Captura racionalidad, no implementación
- Documenta tradeoffs y limitaciones aceptadas
- Puede ser reemplazado por otro ADR (nunca se borra, se marca como
reemplazado) - No busca ser perfecto — busca preservar memoria causal
← Inicio