4. Regla de Oro para Añadir Componentes¶
Antes de incorporar cualquier pieza nueva al sistema se aplica una checklist de seis preguntas. Si la respuesta a cualquiera es desfavorable, la pieza no entra.
La checklist¶
1. ¿Rompe algún principio fundamental?¶
Los 12 principios inmutables no son negociables. Si el componente requiere exposición a internet sin pasar por NetBird, o depende de un servicio externo que no puede cachearse → rechazado.
2. ¿Añade complejidad sin un beneficio claro?¶
El beneficio debe ser concreto. "Mejora la experiencia" no sirve. "La familia puede buscar entre todas sus fotos por texto libre" sí sirve.
3. ¿Es realmente imprescindible para alguien?¶
Identifica al menos un perfil de usuario concreto (familia, empresa, finca) que lo usaría al menos una vez por semana. Si solo lo usa el admin "para probar" → no entra.
4. ¿Cabe dentro del presupuesto de complejidad?¶
Consulta la tabla de Presupuesto de Complejidad. ¿El tier tiene espacio? Si está al límite, ¿qué servicio se retira?
5. ¿Tiene definido su consumo energético?¶
Consumo en reposo y en carga. ¿Depende de Horus (GPU (procesador gráfico para IA)) o solo de Ra (CPU)? Alimenta el cálculo de autonomía para los Perfiles de Energía.
6. ¿Está documentado su despliegue y su recuperación?¶
Antes de producción debe tener:
- Playbook Ansible en ansible-playbooks/
- Entrada en el inventario (LXC (contenedor ligero de Proxmox) ID, IP, recursos)
- Ficha en docs/fichas/
- Dashboard en Grafana
- Monitor en Uptime Kuma
- Entrada en Caddy (si tiene web)
Sin playbook no existe de forma sostenible. Sin dashboard no se puede diagnosticar.
La regla en una frase¶
"Quiero añadir X. ¿Rompe algo? ¿Merece la pena? ¿Quién lo usa? ¿Dónde lo meto? ¿Cuánto consume? ¿Está documentado?"
Si la respuesta a cualquiera es "no sé", la respuesta a "¿lo añado?" es "no".
Relaciones¶
- Presupuesto de Complejidad: la pregunta 4 consulta directamente esa tabla
- Contratos de Datos: si consume datos externos, necesita contrato
- Perfiles de Energía: la pregunta 5 alimenta el modelo energético
- Separación de Documentos: la documentación del nuevo componente va al inventario
Añadir es fácil. Lo difícil es no añadir. La Regla de Oro no frena la innovación: garantiza que cada pieza nueva hace el sistema mejor, no solo más grande.