5. Separación de Principios, Inventario y Roadmap¶
La constitución del sistema —los principios— no debe mezclarse con las listas de servidores, las versiones concretas ni los planes de futuro. Cada cosa vive en su propio documento, con su propio ciclo de actualización y su propia audiencia.
Las cuatro capas¶
1. Principios — el qué y el por qué¶
Documento: manual/principios/ — los 12 principios inmutables.
Reglas de diseño que no dependen de herramientas concretas. "Todo cambio debe nacer como modificación en un repositorio versionado", no "Usamos Forgejo".
Actualización: solo cuando cambia la filosofía del sistema. Muy esporádicamente.
2. Inventario — el qué hay ahora¶
Documento: fichas/ — las fichas de servicios.
Qué está desplegado, en qué LXC (contenedor ligero de Proxmox), con qué recursos, qué versión, qué estado.
Actualización: cada vez que se despliega, actualiza o retira un servicio.
3. Catálogo de la despensa — el qué consumimos¶
Documento: contratos de datos en Forgejo.
Todas las fuentes externas con sus fichas técnicas, frecuencias y SLAs.
Actualización: cuando se añade, modifica o retira una fuente.
4. Hoja de ruta — el hacia dónde vamos¶
Documento: integrado en gobernanza.
Qué está planificado, en qué fase, con qué prioridad, qué bloquea cada cosa.
| Estado | Significado |
|---|---|
| ✅ Implementado | En producción, verificado, con SLO (objetivo de nivel de servicio) |
| 🔧 En construcción | Playbook existe, en testing |
| 📋 Planificado | Diseñado, esperando fase |
| ⏸️ Aplazado | Decidido no hacer ahora, con motivo |
| ❌ Descartado | Evaluado y rechazado, con motivo |
Por qué esta separación importa¶
Cambiar de herramienta no rompe los principios¶
Si Forgejo dejara de existir: los principios no cambian, el inventario se actualiza, la hoja de ruta se ajusta. Nada requiere reescribir la constitución.
El inventario siempre refleja la realidad¶
Es el documento más consultado por el administrador. Debe ser preciso y actualizado. Separado de los principios, se mantiene útil.
Las decisiones son trazables¶
Cuando algo se descarta o aplaza, queda registrado con el motivo. "¿Por qué no usamos X?" → la respuesta está documentada, no en la memoria.
Relaciones¶
- Regla de Oro: la pregunta 6 exige documentar en el inventario
- Presupuesto de Complejidad: se aplica sobre el inventario, no sobre los principios
- Contratos de Datos: el catálogo de la despensa es una extensión del inventario
Los principios duran años. El inventario cambia cada semana. La hoja de ruta evoluciona cada trimestre. Juntos son ruido. Separados son herramientas.