Índice
-
En cada momento el sistema está en uno de varios estados. Y sabe transitar entre ellos.
¿Qué estados tiene SmallCountry?
Operación normal, modo degradado, emergencia y recuperación. Cada estado tiene condiciones de entrada y salida documentadas, umbrales de activación y procedimientos asociados. El sistema monitoriza sus propias métricas y transita automáticamente entre estados cuando se superan los umbrales. Ver estados operativos.
-
Cuando algo falla, no improvisas. Sigues un procedimiento que ya está escrito.
¿Qué hago si se cae algo?
Hay runbooks para los cuatro escenarios más críticos: VPN caída, servicio caído, bomba del sótano (inundación del rack) y backup fallido. Cada runbook está escrito para que un administrador con acceso y sin pánico pueda ejecutarlo paso a paso. Incluyen comandos exactos, verificaciones y criterios de vuelta a la normalidad. Ver todos los runbooks.
-
Cada servicio que corre en SmallCountry está inventariado. Sin excepciones.
¿Cuántos servicios hay y dónde está cada uno?
El inventario lista todos los servicios desplegados con su estado actual, el LXC o contenedor donde se ejecutan, su dirección IP, el tier de criticidad (S/A/B/C/D) y el impacto de una caída. Es la fuente canónica para saber qué hay corriendo, dónde y en qué estado. Ver inventario.
-
Bitácora cronológica. Cada intervención queda registrada.
¿Cómo sé qué se hizo ayer?
El diario registra cada despliegue, cada incidencia, cada mantenimiento y cada decisión operativa con fecha y contexto. Es la memoria institucional del sistema: si alguien reinició un servicio, actualizó una versión o detectó un comportamiento anómalo, aquí está escrito. Seguir el avance.
-
El sistema avisa antes de que te enteres por las malas.
¿Qué alertas dispara SmallCountry?
El diccionario de alertas cataloga todas las señales que el sistema puede generar: qué las dispara, a quién se notifica (ntfy, Matrix, Telegram), con qué urgencia y cómo se resuelven. Cubre desde alertas de infraestructura (disco lleno, servicio caído) hasta alertas de campo (electrovalla caída, temperatura anómala en gallinero). Ver diccionario.
-
:material-tag-lock:{ .lg .middle } Versiones bloqueadas
Aquí no vuela nada con
:latest. Cada versión está fijada y documentada.¿Por qué no usáis latest como todo el mundo?
Porque
latestrompe la reproducibilidad. Si reconstruyes el sistema desde cero, necesitas saber exactamente qué versión de cada servicio estaba corriendo. La lista de versiones documenta la versión concreta de cada servicio, la fecha de bloqueo y el procedimiento de actualización. Es parte del compromiso de infraestructura declarativa: todo versionado, todo explícito. Ver versiones. -
Para que cuando digas «tier» o «Zona Cero», todos entendamos lo mismo.
¿Qué significan todas estas palabras raras?
SLO, RTO, Tier, LXC, ZFS, MQTT, Zona Cero, dominio .sc... SmallCountry tiene su propia jerga. El glosario define cada término de forma canónica para mantener un lenguaje común entre administradores y documentación. Si ves una palabra que no entiendes, probablemente esté aquí. Ver glosario.
-
18 personas-tipo que operan SmallCountry. Cada una con sus herramientas.
¿Quién hace qué dentro del sistema?
Desde el campo hasta la arquitectura: Jano gestiona la identidad, Argos vigila la observabilidad, Deméter cultiva la tierra, Melissa cuida las abejas, Hefesto mantiene la infraestructura como código, Terminus garantiza que el sistema sobreviva, Mnemósine custodia los backups, Vesta usa las herramientas desde casa. Ver todos los roles.
Documentación técnica oficial de 
SmallCountry¶
Este manual recoge las decisiones arquitectónicas del diseño del ecosistema. SmallCountry es un sistema soberano, reproducible y gobernable mediante código, pensado para operar de forma autónoma en una finca regenerativa, sin dependencia de servicios externos y con la resiliencia física como prioridad absoluta.
Bloques del manual¶
1. Los 12 Principios Inmutables¶
Fundamentos del sistema. El qué y el por qué. No dependen de herramientas concretas ni versiones.
2. Mecanismos de Defensa Operativa¶
Cómo sobreviven los principios bajo presión real: emergencias, recursos escasos, fallos en cadena.
3. Estados Operativos del Sistema¶
Condiciones operativas en las que el sistema se encuentra en cada momento y cómo transita entre ellas.
4. Gobernanza, SLOs y Límites de Evolución¶
Reglas del juego: quién decide, con qué criterios y cómo se audita el cumplimiento.
5. Los Roles de SmallCountry¶
Quién usa el sistema y cómo se relacionan las personas con la tecnología. Dieciocho roles, desde el campo hasta la arquitectura.
6. Runbooks de Emergencia¶
Qué hacer cuando algo falla. Procedimientos paso a paso para que un administrador pueda actuar sin pensar.
flowchart TD
subgraph Control [Control y verdad]
direction TB
P1[1 Fuente única de verdad]
P2[2 Reconstruibilidad total]
P7[7 Soberanía operativa]
end
subgraph Seguridad [Seguridad y resiliencia]
direction TB
P3[3 Aislamiento del núcleo]
P4[4 Segmentación de red]
P5[5 Resiliencia física]
P11[11 Contención de recursos]
end
subgraph Operacion [Operación técnica]
direction TB
P6[6 Arquitectura por capas]
P8[8 Observabilidad integral]
P9[9 Silencio operativo]
end
subgraph Humano [Interacción humana]
direction TB
P10[10 Asistencia supervisada]
P12[12 Conocimiento compartido]
end
Control --> Seguridad --> Operacion --> Humano
P1 --> P2 --> P7
P1 --> P8
P1 --> P12
P2 --> P7
P3 --> P4
P5 --> P11
P6 --> P5
P6 --> P8
P8 --> P9
P9 --> P10
P10 --> P12
P11 --> P6
P12 --> P1
style P1 fill:#f9a8d4,stroke:#c2185b,color:#000
style P2 fill:#f48fb1,stroke:#c2185b,color:#000
style P7 fill:#f48fb1,stroke:#c2185b,color:#000
style P3 fill:#90caf9,stroke:#1565c0,color:#000
style P4 fill:#64b5f6,stroke:#1565c0,color:#000
style P5 fill:#42a5f5,stroke:#1565c0,color:#000
style P11 fill:#42a5f5,stroke:#1565c0,color:#000
style P6 fill:#a5d6a7,stroke:#2e7d32,color:#000
style P8 fill:#81c784,stroke:#2e7d32,color:#000
style P9 fill:#66bb6a,stroke:#2e7d32,color:#000
style P10 fill:#ffe082,stroke:#f57f17,color:#000
style P12 fill:#ffcc80,stroke:#f57f17,color:#000Glosario¶
- SLO (Service Level Objective): objetivo cuantificable de nivel de servicio que una métrica debe cumplir.
- RTO (Recovery Time Objective): tiempo objetivo para recuperar el sistema tras un desastre.
- Tier: nivel de criticidad de un servicio (S = supervivencia, A = crítico, B = importante, C = conveniente, D = experimental).
- LXC (contenedor ligero de Proxmox): contenedor ligero del sistema operativo.
- ZFS (sistema de archivos con integridad de datos): sistema de archivos con integridad de datos y snapshots.
- MQTT (protocolo de mensajería ligera para IoT): protocolo ligero de mensajería para dispositivos IoT.
- Zona Cero: enclave externo aislado para servicios con visibilidad pública, sincronizado de forma unidireccional desde el núcleo.
- .sc: dominio interno de SmallCountry. Se usa
.scen lugar de.sc.<nodo>para que los nombres de los servicios no dependan del nodo físico donde se ejecutan (Ra, Horus, Geb). Un servicio puede migrar de un nodo a otro sin que los usuarios tengan que cambiar la URL:servicio.scapunta a Pi-hole, que resuelve a la IP correcta independientemente del nodo donde esté alojado. Fundamento: ADR-007.