Documentación, configuración e infraestructura de SmallCountry — mkdocs + IaC

HTML 100%

Find a file

Tonatiuh 313272d140 Some checks failed i18n Parity Check / check-translations (push) Failing after 2s Details docs: ficha Hermes Agent — ubicación Chapinería/Garganta, sin Docker Via: Hermes Agent		2026-05-15 02:12:05 +02:00
.forgejo	feat: README completo + LICENSE + plantillas de incidencias	2026-05-15 00:52:22 +02:00
_templates	v1.68 — Internacionalización pt_BR	2026-05-14 18:01:10 +02:00
docs	docs: ficha Hermes Agent — ubicación Chapinería/Garganta, sin Docker	2026-05-15 02:12:05 +02:00
overrides	docs: banner renovado + Chapinería y Garganta la Olla en portada	2026-05-15 01:24:10 +02:00
.gitignore	Estado inicial de la documentación SmallCountry	2026-05-09 16:19:06 +02:00
LICENSE	feat: README completo + LICENSE + plantillas de incidencias	2026-05-15 00:52:22 +02:00
mkdocs.yml	feat: fichas con despliegue real — opencode, hermes, forgejo, postgresql	2026-05-15 01:51:14 +02:00
README.md	feat: README completo + LICENSE + plantillas de incidencias	2026-05-15 00:52:22 +02:00

README.md

SmallCountry — infra-core

Documentación, configuración e infraestructura como código de SmallCountry.

SmallCountry es una declaración de independencia digital: un ecosistema autoalojado que devuelve a las personas el control sobre sus datos, su trabajo y su tierra. Este repositorio contiene la documentación viva del proyecto, generada con MkDocs Material y publicada en tres idiomas.

📖 Documentación en vivo: smallcountry.sc

Filosofía

No somos clientes. No somos productos. Somos soberanos.

Soberanía absoluta — tus datos bajo tu techo, no en la nube de nadie
Software libre — cada línea de código es abierta, auditable y tuya
Resiliencia — diseñado para sobrevivir a cortes, fallos y desastres
Transparencia radical — documentación exhaustiva, ciencia abierta, trazabilidad completa

🌍 Idiomas

Idioma	Cobertura	Build
🇪🇸 Español	100% (191 archivos)	✅
🇬🇧 English	0.5% (1 archivo) — ayúdanos a traducir	✅ con fallback a ES
🇧🇷 Português (Brasil)	98.4% (188 archivos)	✅

El plugin mkdocs-static-i18n con fallback_to_default: true permite que las páginas no traducidas muestren automáticamente la versión en español. Sin errores, sin prisas.

🚀 Construir localmente

# Instalar dependencias
pip install mkdocs-material mkdocs-static-i18n

# Construir (los 3 idiomas)
mkdocs build

# Servir en local con recarga automática
mkdocs serve

El sitio se genera en site/, site/en/ y site/pt_BR/.

📂 Estructura

.
├── docs/                  # Documentación en español (idioma por defecto)
│   ├── index.md           # Landing page
│   ├── manifiesto/        # Siete principios fundacionales
│   ├── compromisos/       # Compromisos con usuarios, agricultores, empresas
│   ├── proyectos/         # Proyectos que usan SmallCountry (El Salto, Corral del Viento…)
│   ├── manual/            # Arquitectura: principios, mecanismos, roles, runbooks
│   ├── fichas/            # Catálogo técnico: programas, stacks, sistemas
│   ├── legal/             # Aviso legal, RGPD, normativas sectoriales
│   └── operaciones/       # Inventario de servicios, versiones bloqueadas, diario
├── docs/en/               # 🇬🇧 Traducción al inglés (en progreso)
├── docs/pt_BR/            # 🇧🇷 Traducción al portugués brasileño
├── overrides/             # Personalización del tema (banner trilingüe)
├── _templates/            # Plantillas para nuevas páginas
├── .forgejo/workflows/    # CI/CD — i18n parity check
└── mkdocs.yml             # Configuración del sitio

🐛 Reportar un fallo o proponer una mejora

Usamos el vocabulario de Forgejo. Abre una incidencia con el tipo que corresponda:

Tipo	Significado
🐛 Bug	Algo está roto o no funciona
💡 Mejora	Propuesta para cambiar o añadir algo
❓ Pregunta	Duda, consulta o aclaración

También puedes enviar una solicitud de cambio si ya tienes el código listo.

🧪 CI/CD

Cada push a main ejecuta i18n Parity Check — una verificación automática de que las traducciones no se desincronizan del idioma principal.

📋 Proyectos de SmallCountry

Proyecto	Tipo	Estado
⛰️ El Salto	Finca matriz regenerativa en Garganta la Olla	📋 Definido
🌾 Agricultura Regenerativa	Frutales ecológicos de montaña	📋 Definido
🐝 Corral del Viento	Miel artesanal con trazabilidad QR	📋 Definido
🐔 Gallinero	Recuperación de 5 razas de gallinas autóctonas	💡 Conceptual
🌦️ Proyecto Clima	Monitorización meteorológica de la finca	💡 Conceptual
🔬 Ciencia Abierta	Datos FAIR con DOI y anonimización	📋 Definido
🌱 La Semilla Violeta	Cooperativa de formación docente	💡 Conceptual
🧠 Clínica Fernanda Bocco	Consulta de psicología con privacidad absoluta	📋 Definido

🛠 Stack técnico

Capa	Herramientas
Documentación	MkDocs Material, mkdocs-static-i18n, Mermaid
Infraestructura	Proxmox VE, ZFS, Docker, Debian Trixie
Automatización	Ansible, OpenTofu, n8n, Node-RED
Monitorización	Grafana, VictoriaMetrics, Prometheus, Grafana Alloy
Identidad	Authentik, Vaultwarden, NetBird, WireGuard
Campo	farmOS, ESP32, LoRa, Mosquitto MQTT

Infraestructura como código (roles Ansible, módulos OpenTofu, stacks Docker Compose) próximamente en este repositorio.

📄 Licencia

El código original de SmallCountry es software libre. Esta documentación se comparte bajo licencia MIT. Los datos de ciencia abierta se publican con CC BY 4.0.

«Porque vivir conectado no debería significar ser el producto.»