Introducción

Bienvenido a la 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:#000

---

Glosario

• 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 .sc en 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.sc apunta a Pi-hole, que resuelve a la IP correcta independientemente del nodo donde esté alojado. Fundamento: ADR-007.

---

← Servicios   |   1. Los 12 Principios →