farmOS — Cuaderno de campo digital¶

Registraría cultivos, cosechas, tratamientos, observaciones de fauna y análisis de suelo. El centro de la trazabilidad de la finca. Funcionaría sin cobertura y sincroniza al volver.

Como usuario¶

Qué podrás hacer¶

Registrar actividades de campo (siembra, cosecha, tratamientos)
Llevar inventario de cultivos y animales
Geolocalizar cada activo (árbol, parcela, colmena)
Registrar observaciones por voz (transcripción automática)
Trazabilidad completa del campo a la mesa
Funcionar offline sin cobertura

Cómo se accederá¶

Navegador	Ubuntu	Android	FireTV
https://farmos.sc (equipo de finca)	Navegador	Navegador (interfaz responsive)	No aplica

Primeros pasos (previstos)¶

Abre https://farmos.sc desde el móvil y añade un acceso directo a la pantalla de inicio (funciona como una app). Registraría tu primera parcela o cultivo. Activa el modo offline para usarlo sin cobertura en el campo.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Node-RED	Sensores de campo → registros automáticos
Mosquitto	Datos MQTT (protocolo de mensajería ligera para IoT)
Grafana	Dashboards de finca
n8n	Automatización de registros
Ollama	Asistente IA de finca
Drupal Commerce	Tienda con trazabilidad
Forgejo	Repositorio ciencia abierta
BirdNET	Detecciones de aves
Frigate	Detecciones de fauna
Odoo	📋 Planificado — las cosechas registradas en farmOS actualizarán automáticamente el inventario de Odoo vía n8n
Hermes Agent	Notas de voz del campo transcritas con faster-whisper local y registradas automáticamente como observaciones en farmOS
iNaturalist	API de identificación de especies por imagen. Las observaciones manuales de biodiversidad (foto → IA → especie) se registran automáticamente en farmOS como observaciones de flora y fauna, actualizando el calendario de floración y polen

Servicios que lo hacen posible¶

Docker — farmos/farmos:latest + PostgreSQL + PostGIS
PostGIS — extensión geoespacial para PostgreSQL
Caddy — proxy inverso (intermediario que recibe peticiones y las deriva) con TLS (cifrado de comunicaciones)
Authentik — autenticación Proxy (grupo finca)

Para el administrador (diseño previsto)

Datos	Valor
LXC (contenedor ligero de Proxmox)	162
IP	10.10.30.162
Tier	B
Impacto	🔴 Crítico (contiene todo el registro de la finca)

ZFS (sistema de archivos con integridad de datos) persistente: rpool/datos/farmos → /opt/farmos/
Docker: farmos/farmos:latest + PostgreSQL + PostGIS
Healthcheck: curl https://farmos.sc
Logs: docker logs farmos
Backup: PBS (sistema de copias de seguridad de Proxmox) diario + dump SQL
Problemas comunes:
- "No sincroniza tras estar offline" → verificar conectividad

Para el arquitecto (diseño previsto)

graph LR
    FO[farmOS]
    NR[Node-RED]
    MQ[Mosquitto]
    GD[Grafana]
    N8[n8n]
    OL[Ollama]
    DC[Drupal Commerce]
    BN[BirdNET]
    FG[Frigate]
    NR -->|sensores| MQ
    MQ --> FO
    FO --> GD
    N8 --> FO
    OL --> FO
    FO --> DC
    BN --> FO
    FG --> FO

Red: vmbr3 (IoT/finca)
Puerto: 80
Pi-hole: farmos.sc → 10.10.30.162
Caddy: forward_auth + reverse_proxy
Authentik: provider Proxy, grupo finca
Modo offline: farmOS guarda datos localmente en el navegador y sincroniza al volver
PostGIS: datos geoespaciales para cultivos, parcelas y activos
Orquestación:

Componente	Recurso
Rol Ansible	`roles/farmos/`
Playbook	`deploy-farmos.yml`
Módulo OpenTofu	`modules/farmos/`
Semaphore	✓
Forgejo Actions	✓
Repo	`ansible/playbooks/deploy-farmos.yml`

Flujo IA de apicultura¶

📋 Planificado. El flujo previsto para registrar automáticamente las inspecciones de colmenas:

El apicultor graba una nota de voz en el móvil: "Colmena 7, cría irregular, he visto varroa"
Hermes Agent transcribe el audio a texto con faster-whisper local
Ollama analiza la transcripción: identifica la colmena, clasifica la observación, extrae entidades (varroa, cría irregular)
Node-RED estructura los datos y los publica en MQTT
farmOS registra automáticamente la entrada en el historial de la colmena 7
Si procede, n8n crea una tarea de tratamiento y notifica al apicultor

Este flujo elimina el papeleo manual y garantiza que cada inspección quede documentada con trazabilidad completa.