🐝 Corral del Viento¶
Proyecto de Producto — Miel con Trazabilidad Completa¶
Dos hermanos, extremeños de adopción. Las solanas de Gredos, La Vera, Cáceres.
Tratamientos ecológicos y respetuosos. Transparencia radical.
Proyecto hijo de ⛰️ El Salto.
Versión 1.0 · Mayo 2026
1. Resumen Ejecutivo¶
Corral del Viento es una marca de miel artesanal producida por dos hermanos en las solanas de Gredos, en la comarca de La Vera, Cáceres. El nombre es un topónimo antiguo: un corral de piedra que en tiempos protegió colmenas de corcho de los animales silvestres y el ganado. Hoy, ese mismo espíritu —proteger, cuidar, preservar— da nombre al proyecto.
Sus colmenas se trabajarán con tratamientos exclusivamente ecológicos y respetuosos con las abejas, y toda la operación quedará registrada de forma exhaustiva y verificable.
El diferencial del producto no será solo la calidad — será la demostración pública de esa calidad. Cada tarro llevará un código QR que abrirá una página con el historial completo del colmenar de origen: inspecciones, tratamientos ecológicos, datos ambientales, floración, métricas de sensores y mucho más.
La identidad visual de la marca girará en torno a su logo: una flor de cantueso (Lavandula stoechas subsp. pedunculata) con una abeja a punto de posarse, vista de lado. El cantueso es una de las flores silvestres emblemáticas de las solanas de Gredos, y conecta directamente con la flora de la que se alimentan las abejas de estos hermanos.
Visión: Vender no solo miel — vender confianza, historia y transparencia. Cada tarro será una ventana al colmenar.
2. La Marca¶
2.1 Nombre y concepto¶
Corral del Viento evoca un lugar real: un antiguo corral de piedra en las solanas de Gredos que durante generaciones protegió colmenas de corcho del ganado y la fauna salvaje. El nombre habla de refugio, de tradición, de un vínculo con la tierra que viene de lejos. El viento de Gredos que baja por las solanas y lleva el aroma del cantueso, el tomillo y la retama hasta las abejas.
2.2 Logo¶
Una flor de cantueso (Lavandula stoechas subsp. pedunculata) con una abeja a punto de posarse, vista de perfil. No es lavanda, no es espliego: es cantueso, la flor silvestre de las solanas de Gredos. La composición transmite:
- Conexión directa con la flora local — lo que comen las abejas es lo que hay en el logo
- Movimiento y vida — la abeja no está estática, está llegando
- Elegancia sobria, sin excesos decorativos
- Reconocibilidad inmediata en formato pequeño (etiqueta, QR, redes)
2.3 Los productores¶
Dos hermanos asentados en Garganta la Olla, que contagian su pasión por las abejas y la apicultura. Inquietos y voraces aprendices, han volcado en la apicultura y en la agricultura todos sus conocimientos, combinando el amor por la naturaleza, por la artesanía, la biología y la conservación de los saberes agroecológicos, con la vanguardia de la tecnología y el software libres.
Su apicultura se rige por los principios de la agroecología y la agricultura regenerativas.
El mayor es biólogo y apicultor experto. Conoce sus colmenares por nombre. Sabe leer lo que las abejas cuentan. Imparte cursos de apicultura en la Universidad de Alcalá y próximamente en la propia finca. Él es quien encarna el rol de Melissa en SmallCountry.
El menor es el técnico. Mantiene la infraestructura de SmallCountry, configura los sensores, programa los flujos de n8n, despliega los dashboards de Grafana, escribe la documentación y hace que todo funcione en silencio. Encarna los roles de Hefesto y Terminus. Sin él, Melissa no tendría herramientas.
Hacen una apicultura transparente, registrando cada observación y cada intervención, de modo que realmente cada cucharada de miel tenga el historial del colmenar de origen.
La producción será familiar, artesanal y totalmente documentada. Cada decisión que tomen quedará registrada.
2.4 Territorio y entorno¶
La comarca de La Vera, al norte de Cáceres, en las estribaciones de la Sierra de Gredos. Las colmenas se sitúan en las solanas —las laderas orientadas al sur— donde el sol calienta antes y las flores despiertan pronto.
El entorno ofrece una riqueza floral excepcional:
- Cantueso (Lavandula stoechas subsp. pedunculata), la flor del logo, y Retama blanca, tapizando las laderas en primavera
- Tomillo, Romero y otras aromáticas de monte
- Jaras, alfombrando el sotobosque mediterráneo
- Riberas y bosques de ribera: sauces, hiedra, zarzamoras
- Cerezos y Castaños, los árboles que enmarcan los colmenares
- Flora de alta montaña con escasa presión agrícola
Este entorno será parte del producto. El análisis geoespacial de la finca documentará y comunicará exactamente qué flores tendrán disponibles las abejas en cada época del año.
El roble melojo (Quercus pyrenaica) es la quercínea dominante en las solanas de Gredos. No produce néctar, pero sus bellotas alimentan a la fauna y sus exudados de savia —junto con los de la encina y el alcornoque— son la base del mielato de roble: una miel oscura, densa, menos dulce, con notas maltosas y un contenido mineral excepcionalmente alto. El melojo es también un indicador de salud del ecosistema: su presencia marca el límite altitudinal del bosque mediterráneo y su floración tardía (mayo-junio) coincide con el pico de actividad de las colmenas.
2.5 Modelo de producción¶
- Tratamientos exclusivamente ecológicos y respetuosos — sin productos químicos sintéticos
- Gestión respetuosa del enjambre y la reina
- Registro exhaustivo de cada intervención
- Producción orientada a calidad, no a volumen
Estas prácticas son la aplicación concreta de los principios de agroecología y agricultura regenerativa que rigen el proyecto.
3. Propuesta de Valor¶
3.1 El problema que resuelve¶
La industria de la miel tiene uno de los índices de adulteración más altos del sector alimentario. Los consumidores no pueden verificar el origen, los tratamientos, ni las condiciones de producción. La confianza es escasa y el precio premia más el marketing que la calidad real.
En el mercado ecológico, el sello de certificación dice qué no se ha hecho — pero no muestra lo que sí se hizo. Corral del Viento irá un paso más allá: lo mostrará todo.
3.2 La solución que propone¶
- Registro exhaustivo de cada colmena: inspecciones, tratamientos ecológicos, movimientos de marcos, cosechas, historia de reinas
- Datos ambientales vinculados: temperatura, humedad, peso de colmena, horas de sol, flora circundante, meteorología
- Código QR en cada tarro con acceso a la historia completa de ese lote y ese colmenar
- Vídeos reales en YouTube: sin narración, sin música, solo el trabajo y el sonido de las abejas
- Presencia digital honesta: sin efectos, sin palabrería, solo realidad
3.3 Público objetivo¶
- Consumidores gourmet que buscan producto de origen verificable
- Compradores que valoran la apicultura ecológica y quieren poder comprobarlo
- Personas con necesidades dietéticas específicas que necesitan conocer el origen exacto
- Compradores de regalo que quieren un producto con historia y presentación cuidada
- Restaurantes y tiendas especializadas que valoran la trazabilidad para sus propias comunicaciones
- Turistas de La Vera y Extremadura como canal de venta directo y de difusión
4. Sistema Tecnológico¶
El sistema está diseñado para funcionar en infraestructura local propia (filosofía isla/offline-first), con los datos bajo control total y sin dependencia de servicios en la nube externos.
4.1 Gestión de colmenas: FarmOS + módulo farm_bee¶
FarmOS será la plataforma central de registro. Software libre, open source, web-based, con API (interfaz de programación) JSON (formato de intercambio de datos) completa. Se desplegará en infraestructura local.
El módulo farm_bee se usará como base y se extenderá con campos personalizados para cubrir el flujo de inspección completo:
| Elemento | Detalle |
|---|---|
| Plataforma base | FarmOS (módulo farm_bee extendido) |
| Activos registrados | Colmenas nombradas, reinas, apiarios, equipamiento, fenotipos de abejas |
| Tipos de registros | Inspecciones, tratamientos ecológicos, cosechas, movimientos de marcos, eventos sanitarios |
| Campos de reina | Nacimiento, fecundación, inicio de puesta, rendimiento, sustitución |
| API (interfaz de programación) | JSON:API completa para integración con todos los sistemas |
| Despliegue | Self-hosted en infraestructura local |
4.2 Pipeline de audio a registro¶
El apicultor grabará su inspección en voz durante el trabajo, sin interrumpir. El sistema lo convertirá automáticamente en un registro estructurado en FarmOS:
🎙️ Grabación en campo (español) vía Telegram
↓
🔊 [**Hermes Agent**](/fichas/programas/hermes-agent/) con faster-whisper local → transcripción de texto
↓
🤖 [**Ollama**](/fichas/stacks/ollama-qdrant/) → extracción de campos → JSON estructurado
↓
📋 [**FarmOS**](/fichas/programas/farmos/) API → log de inspección creado
↓
📡 **OpenTelemetry** → todo el pipeline trazado y observable
Campos que se extraerán: colmena, fecha, estado general, presencia y estado de la reina, estado de la cría, reservas de miel y polen, comportamiento, tratamientos aplicados, observaciones libres.
4.3 Automatización: N8N¶
n8n actuará como orquestador entre sistemas. Open source y self-hosteable. Sus flujos principales:
- Sincronización FarmOS → Odoo (ERP futuro)
- Notificaciones de eventos críticos: colmena sin reina, tratamiento pendiente, cosecha disponible
- Actualización automática de páginas públicas de trazabilidad QR
- Integración con datos del Proyecto Clima: meteorología de la finca, predicción de floración según grados-día acumulados
4.4 Sensórica de colmenas¶
Solo una selección de colmenas tendrá sensores. Los datos se correlacionarán con las inspecciones manuales y con los datos meteorológicos del Proyecto Clima (temperatura, humedad, viento, precipitación):
| Sensor | Utilidad |
|---|---|
| Peso de la colmena | Indicador de flujo de néctar y producción de miel |
| Temperatura interior | Salud de la cría, comportamiento de invernada |
| Humedad interior | Control de maduración de la miel |
| Sonido / vibración | Detección temprana de enjambres o estrés |
| Temperatura exterior | Contexto ambiental correlacionado |
Los datos irán a Victoria Metrics y se visualizarán en Grafana.
4.5 Análisis geoespacial: QGIS → FarmOS¶
Cada colmena y apiario se mapeará con precisión en QGIS. El análisis enriquecerá los datos con el contexto territorial de las solanas de Gredos y La Vera:
- Elevación e inclinación del terreno
- Análisis de sombreado (shadow analysis)
- Horas de sol por ubicación y época del año
- Flora circundante: especies florales por radio y temporada
- Fauna y biodiversidad local
- Zonas de influencia: agua, masas forestales, cultivos vecinos
- Capas cartográficas de La Vera y la Sierra de Gredos
Estos datos se exportarán desde QGIS y se vincularán a los registros de FarmOS vía API, enriqueciendo el historial de cada colmena con su contexto geográfico completo.
4.6 Observabilidad: OpenTelemetry + Grafana Stack¶
Todo el sistema estará instrumentado con OpenTelemetry para visibilidad completa de cada componente:
| Componente | Herramienta |
|---|---|
| Recolección de métricas y trazas | Grafana Alloy |
| Almacenamiento de métricas | Victoria Metrics |
| Almacenamiento de logs | Victoria Logs |
| Trazas distribuidas | Tempo |
| Analítica web (escaneos QR, visitas) | Por definir (open source) |
| Visualización | Grafana (dashboards embebidos en FarmOS) |
Dos niveles de dashboard:
- Vista global del apiario: estado de todas las colmenas, alertas activas, métricas de producción, datos ambientales agregados
- Vista individual por colmenar: historial de inspecciones, evolución de sensores, timeline de reinas, tratamientos, cosechas, datos geoespaciales
4.7 El clima al servicio de las abejas¶
Doce fuentes meteorológicas alimentan un sistema que traduce datos en decisiones apícolas. No se trata de acumular números: se trata de que el apicultor sepa qué mirar, cuándo actuar y por qué.
Lectura del tiempo para apicultura¶
Cada dato meteorológico tiene una lectura apícola concreta:
| El dato | Lo que le dice al apicultor | Acción |
|---|---|---|
| Temp > 10°C sostenida (2-3h) | Las abejas empiezan a volar | Abrir colmenas para inspección |
| Temp 15-25°C, sin lluvia ni viento | Condiciones ideales de pecoreo | Día de máxima actividad |
| Temp > 38°C sin viento | Riesgo de golpe de calor | Ventilar, sombrear, añadir agua |
| Precipitación acumulada + sol | Floración inminente | Preparar alzas |
| 5 días sin lluvia + ET₀ > 20mm | Estrés hídrico, menos néctar | Preparar alimentación suplementaria |
| Viento > 30 km/h | Abejas no salen | No abrir colmenas |
| NDVI bajando en satélite | Vegetación pierde vigor | Valorar movimiento de colmenas |
| Polen de encina/roble alto | Posible mielato | Esperar antes de cosechar miel monofloral |
Alertas automáticas¶
El sistema genera alertas vía ntfy sin consultar ningún panel:
| Alerta | Condición |
|---|---|
| 🥵 Golpe de calor | >38°C sin viento |
| 📦 Ventana de inspección | Mañana sin lluvia, >12°C, viento <25 km/h |
| 🐝 Riesgo de enjambrazón | 20-30°C + humedad >60% + tras lluvia |
| 🌸 Floración inminente | Suma térmica acumulada alcanza umbral |
| 💧 Estrés hídrico | 5 días sin lluvia + ET₀ acumulada >20mm |
| 🌾 Ventana de cosecha | Peso estable 3-5 días + previsión 3 días seco |
| ❄️ Helada tardía | Temp < 2°C en abril-mayo |
De dónde vienen los datos¶
| Fuente | Qué aporta | Chapinería | Garganta |
|---|---|---|---|
| AEMET | Predicción oficial España | ✅ | ✅ |
| Open-Meteo | Forecast global, ET₀, suelo | ✅ | ✅ |
| SIAR (MAPA) | Evapotranspiración oficial agrícola | — | ✅ |
| Meteoblue | ET₀ horaria, temperatura de piel | ✅ | ✅ |
| OpenWeatherMap | Forecast + calidad del aire | ✅ | ✅ |
| Palinocam | Polen medido real, 20+ tipos | ✅ | — |
| CAMS | Predicción polen 5 días | ✅ | ✅ |
| Sentinel Hub | NDVI satélite, salud vegetación | — | ✅ |
| Meteoclimatic | 31 estaciones amateur Extremadura | — | ✅ |
Todas gratuitas y abiertas. Los datos se integran en Grafana y FarmOS.
El año apícola según el clima¶
| Mes | La colmena está... | Datos clave |
|---|---|---|
| Ene – Feb | Invernando | Temp mínima, rachas de viento |
| Mar – Abr | Despertando | Temp >10°C, polen temprano, heladas |
| May – Jun | Plena floración | Polen, ET₀, NDVI, enjambrazón |
| Jul – Ago | Produciendo | Golpe de calor, estrés hídrico, peso |
| Sep – Oct | Preparando invierno | Reservas, ET₀ bajando |
| Nov – Dic | Entrando en invernada | Temp mínima, viento, humedad |
4.8 Observación manual de biodiversidad en campo¶
Además de los sistemas automáticos (BirdNET, Frigate, sensores IoT), cualquier persona en la finca puede documentar lo que ve. Si encuentras una flor nueva, un ave que no habías visto o un insecto polinizador, el sistema lo registra:
📸 Móvil → foto de la especie
→ Telegram o app web → [Hermes Agent](/fichas/programas/hermes-agent/)
→ [Ollama](/fichas/stacks/ollama-qdrant/) + iNaturalist API identifican la especie
→ Se registra en [FarmOS](/fichas/programas/farmos/) como observación de biodiversidad
→ Si es una floración: actualiza automáticamente el calendario de polen en [Grafana](/fichas/programas/grafana/)
→ Si es una especie nueva: se añade al inventario de [El Salto](/proyectos/el-salto/)
→ Si tiene interés científico: se publica en [Ciencia Abierta](/proyectos/ciencia-abierta/) con formato Darwin Core
Las observaciones manuales enriquecen los datos recogidos en las Islas de Biodiversidad de la finca y complementan el monitoreo automático con el ojo humano — que sigue siendo el mejor detector de biodiversidad que existe.
5. El Producto: La Miel¶
5.1 Producción y calidad¶
- Apicultura ecológica y respetuosa, documentada al 100%
- Tratamientos exclusivamente ecológicos — registrados con fecha, producto, dosis y resultado
- Colmenas con nombre e identidad propia
- Historia completa de cada reina: nacimiento, fecundación, inicio de puesta, rendimiento
- Conservación de la Abeja Negra Ibérica (Apis mellifera subsp. iberiensis): las colmenas de Corral del Viento aseguran la supervivencia, la conservación y la selección de esta subespecie autóctona, adaptada durante milenios a la península ibérica
- Selección por morfometría alar: análisis de la venación de las alas para identificar y seleccionar los ejemplares que mantienen la pureza de la raza. Se publicarán tanto los análisis de las colmenas y reinas seleccionadas como los de aquellas colonias y reinas que se descarten para el programa de cría, bien por sufrir hibridación con abejas introducidas, bien por no alcanzar la calidad esperada
- Fenotipos documentados: cada colmenar tendrá registradas las características morfológicas y de comportamiento de sus abejas como parte del corpus de ciencia abierta
5.2 Las mieles de Corral del Viento¶
Cada miel refleja la floración dominante de su momento y lugar en las solanas de Gredos:
| Miel | Floración | Carácter |
|---|---|---|
| Retama | Primavera temprana | Dulce, floral, clara |
| Cantueso | Primavera | Aromática, la flor del logo |
| Tomillo | Primavera-Verano | Herbácea, intensa, oscura |
| Roble | Verano | De bosque, profunda, mineral. Mielato del melojo (Quercus pyrenaica), la quercínea emblemática de las solanas de Gredos |
| Castaño | Verano | Oscura, fuerte, amarga elegante |
| Brezo | Verano tardío (altitud) | Muy oscura, densa, intensa |
Cada miel será analizada para correlacionar su espectro polínico con el paisaje floral de las solanas de Gredos, garantizando la autenticidad del origen florístico y geográfico. La calidad, la trazabilidad y la transparencia hacen de esta artesanía alimentaria una estrecha relación entre la creación de un alimento y su disfrute.
5.3 Analíticas de la miel¶
La autenticidad de una miel se demuestra en el laboratorio. Corral del Viento incorporará análisis del espectro polínico de cada cosecha:
- Melisopalinología: identificación y conteo de los granos de polen presentes en la miel, que revelan exactamente de qué flores se alimentaron las abejas
- Correlación con el paisaje: los resultados del análisis polínico se cruzarán con los datos geoespaciales (QGIS) y el mapa de flora de las solanas de Gredos, confirmando que la miel refleja fielmente el territorio
- Autenticidad verificada: el comprador no solo verá la declaración del apicultor — verá la prueba de laboratorio que la respalda
Además de los fenotipos documentados en el programa de cría (ver sección 5.1), se registrarán las características de comportamiento de cada población como un indicador más de la diversidad y la adaptación local de las colonias a su entorno. La abeja también habla del lugar.
Estos datos enriquecerán el corpus de ciencia abierta y añadirán una capa más de evidencia a la trazabilidad del producto.
5.4 Trazabilidad QR — lo que verá el comprador¶
Al escanear el QR del tarro, el comprador accederá a una página pública con:
- Colmenar de origen con nombre e historial completo
- Fecha de cosecha y condiciones del día
- Floración dominante durante el periodo de producción
- Tratamientos ecológicos realizados en el año previo a la cosecha
- Datos meteorológicos de la temporada en La Vera
- Métricas del colmenar: peso, temperatura, actividad (si tiene sensores)
- Historia de la reina de esa colmena
- Análisis de morfometría alar de las colmenas del colmenar — pureza de la Abeja Negra Ibérica
- Mapa del apiario con datos geoespaciales de las solanas de Gredos
- Estado actual del colmenar — métricas en tiempo real si sigue activo
- Espectro polínico de la cosecha — el certificado de autenticidad floral
El comprador podrá ver si el colmenar sigue activo, qué tiempo hace ahora mismo en las solanas de Gredos, la pureza genética de sus abejas y cuándo fue la última inspección. Esto no tendrá precedente en el mercado.
La trazabilidad será por colmenar (apiario), no por colmena individual: es el nivel viable con los recursos actuales. La trazabilidad por colmena —asignar un QR único a cada colmena individual— se estudiará como evolución futura del sistema.
5.5 Packaging y etiqueta¶
Sobrio, honesto, sin excesos. La etiqueta será mínima — el QR hará el resto.
Elementos de la etiqueta:
- Doble sello: El Salto (finca) + Corral del Viento (producto)
- Logo: flor de cantueso con abeja a punto de posarse
- Nombre del colmenar de origen
- Año de cosecha y floración principal
- La Vera, Cáceres
- Código QR con URL única por lote
- Peso neto y datos legales obligatorios
- Indicación de producción ecológica
- Sin afirmaciones de marketing vacías
6. Formación y Divulgación¶
La formación será una parte fundamental del proyecto. Corral del Viento no solo producirá miel: transmitirá conocimiento.
6.1 Curso universitario¶
El hermano mayor —biólogo y apicultor experto— imparte actualmente un curso sobre apicultura en la Universidad de Alcalá (UAH). Este curso es el germen del proyecto formativo: conocimiento académico combinado con práctica real de campo.
6.2 Cursos presenciales en El Salto¶
En breve se pondrán en marcha cursos presenciales en El Salto, la finca que acoge el proyecto, en la Casa Paraíso, Garganta la Olla. Los alumnos convivirán con las colmenas durante jornadas completas:
- Días vivenciales de inmersión apícola
- Cursos de iniciación para nuevos apicultores
- Cursos de perfeccionamiento en manejo ecológico
- Visitas guiadas al apiario y al entorno de La Vera
6.3 Recuperación de métodos tradicionales¶
Corral del Viento mantendrá y estudiará todos los tipos de colmena conocidos, tanto modernos como tradicionales. El objetivo no es solo producir — es preservar un patrimonio cultural en peligro de extinción.
Se mantendrán al menos dos colmenas funcionando en cada tipo:
| Tipo | Colmenas | Material |
|---|---|---|
| Modernas | Langstroth, Dadant | Madera estándar |
| Tradicionales | Tronco hueco, corcho, esparto | Materiales naturales |
| Alternativas | Kenya (top-bar), Warre | Diseños de bajo impacto |
| Experimentales | Cualquier diseño histórico o innovador | A estudiar |
Cada tipo de colmena tendrá su ficha en FarmOS, sus sensores cuando corresponda y su historial completo de manejo, producción y comportamiento. El registro sistemático de esta diversidad generará un corpus de conocimiento único sobre apicultura comparada.
6.4 Ciencia abierta¶
Toda la actividad —productiva y formativa— quedará documentada y publicada bajo el paraguas de El Salto. Corral del Viento aplicará los mismos estándares que usan las grandes instituciones científicas (CERN, Harvard, GBIF (red mundial de datos de biodiversidad)) para publicar datos de investigación:
Estándares que seguirá:
| Estándar | Para qué |
|---|---|
| FAIR (principios de datos científicos) | Los 15 principios de datos científicos: Findable, Accessible, Interoperable, Reusable |
| DataCite | Metadatos de citación y DOI (identificador único de publicación) único por dataset |
| Dublin Core | Metadatos bibliográficos universales |
| Darwin Core | Estándar de biodiversidad de GBIF para datos de aves, fauna y flora |
| CC BY 4.0 | Licencia de los datos — atribución requerida, uso libre |
| CC0 | Licencia de los metadatos — dominio público para máxima interoperabilidad |
Lo que se publicará:
- Vídeos en YouTube: sin narración, sin música, solo el trabajo y las abejas
- Datasets mensuales en InvenioRDM: métricas de colmenas (peso, temperatura, humedad), biodiversidad (detecciones BirdNET y Frigate en formato Darwin Core), datos meteorológicos, espectro polínico
- Datasets de morfometría alar: análisis de venación de alas de Abeja Negra Ibérica, tanto de ejemplares seleccionados como descartados
- Scripts de análisis en Forgejo (Python, R) replicables por cualquier investigador
- Material didáctico versionado con MkDocs: guías de manejo por tipo de colmena, protocolos de inspección, criterios de selección genética
- Hallazgos sobre métodos tradicionales documentados y publicados para cualquier apicultor, investigador o estudiante del mundo
Pipeline de publicación (automático):
Día 1 de cada mes:
Sensores + farmOS + BirdNET
↓
n8n: extraer, formatear, empaquetar
↓
API POST → InvenioRDM (nuevo dataset, metadatos FAIR, DOI)
↓
Notificación al biólogo → revisar → aprobar
↓
Dataset público en datos.sc, indexado en Google Dataset Search
Los servicios concretos de SmallCountry que harán posible esta publicación se detallan en la sección 8.
→ Ciencia abierta en SmallCountry — guía completa de estándares y metodología
6.5 Curso: Varroa y tratamientos ecológicos¶
La varroa (Varroa destructor) es el principal problema sanitario de la apicultura mundial. Este curso enseña a convivir con ella sin recurrir a acaricidas de síntesis química, respetando la certificación ecológica y la salud de la colonia.
Temario:
- Ciclo biológico de varroa: cómo se reproduce, cuándo ataca, por qué colapsa la colmena
- Métodos de monitoreo: conteo en fondo, prueba de azúcar glass, lavado con alcohol
- Tratamientos ecológicos permitidos en producción ecológica:
- Ácido oxálico: aplicación por goteo en ausencia de cría (invierno) o sublimación
- Ácido fórmico: evaporadores de larga duración (verano, con cría)
- Timol: aplicación en gel, temperatura-dependiente
- Tratamientos combinados: rotación de principios activos para evitar resistencias
- Criterios de decisión: cuándo tratar y cuándo no (umbrales de infestación)
- Registro en FarmOS: trazabilidad completa del tratamiento
- La IA de SmallCountry como asistente: «¿qué colmena necesita tratamiento esta semana?»
Formato: presencial en El Salto, 1-2 días de inmersión práctica en colmenar.
6.6 Curso: Apicultura antigua — colmenas de corcho y fijistas¶
Antes del invento de los cuadros móviles (Langstroth, 1852), las abejas vivían en corchos, troncos huecos, cañizos y vasos de esparto. Este curso recupera ese conocimiento milenario — no por nostalgia, sino porque estos manejos tienen lecciones que la apicultura moderna ha olvidado.
Temario:
- Historia de la apicultura ibérica: desde las pinturas rupestres de la Araña de Bicorp hasta los corchos de Gredos
- Colmenas de corcho: construcción, manejo, cosecha sin cuadros móviles
- Fijismo vs movilismo: ventajas ecológicas del panal natural (las abejas construyen a su medida)
- Colmenas tradicionales del mundo: tronco hueco (España), skep (norte de Europa), top-bar (África)
- Manejo específico: enjambrazón natural, renovación de cera, control de enfermedades sin tratamientos
- Cosecha tradicional: extracción por presión, miel virgen de panal completo
- Conservación del patrimonio: por qué mantener colmenas tradicionales junto a las modernas
Formato: presencial en El Salto, 2 días. Incluye visita a colmenas de corcho activas y taller práctico de construcción.
6.7 Curso: Apicultura de traspatio — claves para empezar con pocas colmenas¶
Para quien quiere tener 2-5 colmenas de autoconsumo, sin gastos excesivos, sin complicaciones técnicas y sin el agobio de «hacerlo todo bien». Una apicultura a escala humana, respetuosa con las abejas y sostenible económicamente.
Temario:
- Lo mínimo necesario: equipo imprescindible y lo que NO hace falta comprar
- Elección del emplazamiento: orientación, protección del viento, acceso al agua
- La colmena adecuada: Langstroth, Dadant o Layens — ventajas de cada una para el pequeño apicultor
- Conseguir las abejas: enjambres, paquetes, núcleos — cómo y cuándo
- Manejo año por año: el primer año de una colmena, mes a mes
- Sanidad sin químicos: prevención, observación, actuación mínima
- Cosecha artesanal: extracción sin extractor (prensado, decantación)
- Registro sencillo: qué anotar sin agobiarse — FarmOS simplificado
- Errores típicos del principiante y cómo evitarlos
Formato: presencial en El Salto, 1 día intensivo. Incluye sesión práctica en colmenar y kit de inicio documentado.
7. Presencia Digital¶
7.1 Canal de YouTube¶
El canal mostrará el trabajo apícola real en las solanas de Gredos. Un vídeo será para mostrar, no para explicar.
- Inspecciones de colmenas en todos los tipos y materiales
- Seguimiento de reinas y crías
- Cosechas y procesado de miel
- Cambios estacionales en los apiarios
- El paisaje de La Vera, las flores, el cantueso, el entorno
Sin música de fondo. Sin voz en off. Sin efectos. Solo el trabajo y el sonido de las abejas.
Este contenido construirá confianza, atraerá compradores que valoran la autenticidad, documentará el trabajo para el archivo histórico y servirá como material complementario para los cursos de formación.
7.2 Web y páginas de trazabilidad¶
Dos funciones:
- Presentación de la marca para nuevos compradores
- Páginas de trazabilidad por lote/colmena accesibles vía QR — generadas dinámicamente desde FarmOS y Victoria Metrics, públicas y sin login, bajo el dominio de El Salto
7.3 Analítica web¶
Solución open source para medir escaneos de QR por lote, visitas a páginas de trazabilidad y comportamiento de compradores. Datos visibles en Grafana junto al resto de métricas del sistema.
7.4 Canales de venta¶
- Venta directa en El Salto (Casa Paraíso)
- Turismo de La Vera (canal natural de visibilidad y venta directa)
- Tiendas especializadas y delicatesen
- Venta online con envío
- Restaurantes que valoran el producto de proximidad verificable
8. Integración con SmallCountry¶
Corral del Viento será el primer proyecto externo que se apoye en la infraestructura de SmallCountry. No se trata de un servicio más del catálogo — es un cliente real, con necesidades concretas, que pondrá a prueba la arquitectura en un escenario productivo.
8.1 Roles de SmallCountry implicados¶
En este proyecto conviven dos roles de SmallCountry (los perfiles completos de los productores están en la sección 2.3):
| Rol | Hermano | Función |
|---|---|---|
| Melissa | El mayor — biólogo | Abejas, inspecciones, cosecha, cursos, divulgación, conocimiento tradicional |
| Hefesto + Terminus | El menor — técnico | Infraestructura, sensores, QR, IA, web, documentación, la parte invisible |
8.2 Servicios que usará¶
Servicios de SmallCountry que usará:
| Recurso | Para qué |
|---|---|
| FarmOS | Registro de colmenas, reinas, inspecciones, cosechas y tratamientos |
| Hermes Agent + Ollama | Pipeline de voz a registro: el apicultor graba en Telegram, Hermes transcribe con faster-whisper local, Ollama estructura |
| n8n | Orquestación: sincronización FarmOS↔Odoo, notificaciones, páginas QR |
| Grafana + Victoria Metrics | Dashboards de colmenas: peso, temperatura, producción, sensores |
| NetBird / WireGuard | Acceso desde las solanas de Gredos a la infraestructura |
| MQTT + Node-RED | Datos de sensores de colmenas en tiempo real |
| QGIS + PostGIS | Análisis geoespacial del entorno y flora de La Vera |
| Drupal Commerce | Tienda online con trazabilidad QR por lote |
| Forgejo | Ciencia abierta: datasets, scripts de análisis, material didáctico |
| MkDocs | Documentación del proyecto y material formativo |
| Zona Cero | Páginas públicas de trazabilidad (sin exponer el núcleo) |
El éxito de este proyecto validará que SmallCountry no es solo documentación: es una plataforma que resuelve problemas reales para personas reales.
8.3 Cuaderno de explotación digital y ciencia abierta apícola¶
Inspirado en el referente español Tierras Apícolas (APIGEST) y en el proyecto open source alemán Hiveeyes, Corral del Viento incorporará un cuaderno de explotación digital compatible con la normativa española (REGA), una API pública de datos apícolas abiertos y un asistente IA especializado en apicultura.
Cuaderno de explotación digital (REGA)¶
El apicultor registrará sus actividades desde el móvil, sin formularios complejos, mediante una conversación con Hermes Agent vía Telegram:
Apicultor: /inspeccion
Hermes: ¿En qué colmenar?
Apicultor: Solana baja
Hermes: Describe lo que has observado.
Apicultor: Colmena 4, cría operculada abundante, reina vista,
sin varroa en fondo. Marco de miel operculada añadido.
Hermes: Registrado. ¿Alguna otra observación?
El pipeline es:
📱 Telegram → Hermes Agent (NL → datos estructurados)
↓
🧠 Ollama → extrae campos: colmena, fecha, estado cría, reina, varroa, miel
↓
🗄️ PostGIS → tabla apicola.registros (schema Darwin Core extendido)
↓
🌾 FarmOS → sincronización bidireccional
↓
📄 Generador PDF (Markdown → PDF con Pandoc) → listo para inspecciones
Ventajas sobre APIGEST (Tierras Apícolas): - 100% open source. Los datos son del apicultor, no de una plataforma comercial - Integrado con sensores reales: al registrar una inspección, Hermes ya tiene temperatura, humedad y peso de esa colmena del Proyecto Clima y los sensores - Ciencia abierta: los registros son publicables con DOI vía InvenioRDM (anonimizados) - Sin dependencia de un tercero: si la plataforma externa cierra, los datos y el sistema siguen funcionando
API pública de datos apícolas abiertos¶
A diferencia de Tierras Apícolas —cuyo observatorio es cerrado— y de Hiveeyes —que no agrega datos entre apicultores—, SmallCountry ofrecerá una API REST pública para que cualquier apicultor, investigador o plataforma pueda consumir datos apícolas verificados de campo:
| Endpoint | Datos | Formato |
|---|---|---|
api.elsalto.sc/v1/apicola/sensores |
Peso, temperatura, humedad de colmenas | JSON + GeoJSON (coord. redondeadas) |
api.elsalto.sc/v1/apicola/flora |
NDVI, floración, polen | JSON + GeoJSON |
api.elsalto.sc/v1/apicola/bioacustica |
Detecciones BirdNET | Darwin Core |
api.elsalto.sc/v1/apicola/inspecciones |
Registros de inspección anonimizados | Darwin Core + CSV |
Cada trimestre se publica un dataset completo con DOI en InvenioRDM. Esto posiciona a SmallCountry como fuente de datos abiertos verificados para el sector apícola — un papel que ninguna plataforma actual cumple.
Asistente IA apícola especializado¶
Hermes Agent incorporará una skill apicultura con conocimiento específico:
- Calendario apícola de Garganta la Olla (~800 m, clima mediterráneo de montaña)
- Flora apícola de la Sierra de Gredos: cantueso, retama, tomillo, romero, castaño, brezo
- Protocolos de tratamiento de varroa (ácido oxálico, ácido fórmico, timol)
- Legislación apícola española (REGA, distancias mínimas, registro de explotación)
- Buenas prácticas de manejo ecológico
- Integración con sensores: respuestas contextuales basadas en datos reales de temperatura, humedad y peso de las colmenas
A diferencia de Apibot (Tierras Apícolas), Hermes tiene acceso a los datos reales de las colmenas en tiempo real. Si el apicultor pregunta «¿qué Colmenar necesita atención esta semana?», Hermes cruza peso, temperatura, última inspección y condiciones meteorológicas para dar una respuesta fundamentada, no genérica.
Sensorización de colmenas con LoRa¶
Inspirado en la arquitectura de Hiveeyes, que usa LoRa RFM95 para transmitir datos de sensores a larga distancia (7+ hectáreas), Corral del Viento adoptará radio LoRa para los sensores de colmena:
| Ventaja de LoRa sobre WiFi | Detalle |
|---|---|
| Alcance | 2-5 km en campo abierto (vs 50-100 m de WiFi) |
| Consumo | Batería con panel solar dura meses (vs WiFi que agota en días) |
| Penetración | Atraviesa vegetación densa mejor que WiFi 2.4 GHz |
| Topología | Estrella: todas las colmenas → un gateway LoRa → MQTT |
Stack de sensorización adaptado de Hiveeyes:
Colmena: ESP32 + RFM95 LoRa + HX711 (peso) + DHT22 (temp/hum)
↓ LoRa (Bencode o JSON comprimido)
Gateway: ESP32 + RFM95 → serial → MQTT (Mosquitto)
↓
MQTT → Victoria Metrics (series temporales)
↓
Grafana + mqttwarn (dashboards + alertas)
SmallCountry sustituye InfluxDB por Victoria Metrics —más eficiente en recursos, compatible con PromQL, y ya integrado en el stack—, y añade Victoria Logs y Tempo para trazabilidad completa del pipeline de datos.
Schwarmalarm: detección de enjambrazón¶
Hiveeyes implementó el Schwarmalarm: un sistema que detecta automáticamente la enjambrazón (salida de un enjambre) analizando la pérdida súbita de peso de la colmena. En mayo de 2016 documentaron un evento donde la colmena perdió ~500 g en 15 minutos — el peso de un enjambre completo.
Corral del Viento implementará el mismo principio:
- mqttwarn monitoriza la serie temporal de peso en Victoria Metrics
- Si detecta una caída >400 g en <30 minutos → alerta inmediata vía ntfy al móvil del apicultor
- El dashboard de Grafana marca el evento con una anotación automática
- El apicultor puede correr a recuperar el enjambre antes de que se marche
Báscula de colmena open hardware¶
Hiveeyes publicó el diseño de su báscula de colmena asimétrica con célula de carga Bosche H30A. Es un diseño probado, open hardware (CERN OHL), documentado y replicable. Corral del Viento adoptará este diseño para sus colmenas instrumentadas, adaptando el microcontrolador a ESP32 + LoRa RFM95.
Estrategia: complementariedad, no competencia¶
| Dimensión | Tierras Apícolas | SmallCountry |
|---|---|---|
| Cuaderno explotación | ✅ APIGEST (propietario) | ✅ Hermes → FarmOS (open source) |
| Comunidad | ✅ 1.000+ apicultores | 🟡 Grupo Telegram |
| Observatorio | ✅ Datos colectivos (cerrados) | ✅ API pública + DOI |
| Sensores IoT | ❌ | ✅ ESP32 + LoRa |
| GIS + mapas | ❌ | ✅ QGIS + PostGIS |
| Ciencia abierta | ❌ | ✅ InvenioRDM + FAIR |
| Software libre | ❌ (parcial) | ✅ 100% |
No se trata de competir: se trata de ser la fuente de datos abiertos que Tierras Apícolas no es, y de ofrecer a los apicultores una alternativa soberana. Si la colaboración es posible, los datos de SmallCountry pueden enriquecer el observatorio de Tierras Apícolas. Si no, SmallCountry funciona de forma independiente.
Para el administrador
Datos de los servicios¶
| Servicio | LXC | IP | Tier | Impacto |
|---|---|---|---|---|
| FarmOS + Módulo farm_bee | Por asignar | Por asignar | B — Importante | 🟡 Caída = sin registro de colmenas |
| Hermes Agent | Por asignar | Por asignar | C — Conveniente | 🟢 Caída = el apicultor usa notas escritas |
| n8n | Por asignar | Por asignar | B — Importante | 🟡 Caída = las automatizaciones se detienen |
| Grafana + Victoria Metrics | Por asignar | Por asignar | B — Importante | 🟡 Caída = dashboards no disponibles |
| Victoria Logs | Por asignar | Por asignar | C — Conveniente | 🟢 Caída = logs no consultables |
| MQTT + Node-RED | Por asignar | Por asignar | B — Importante | 🟡 Caída = sensores no transmiten datos |
| QGIS + PostGIS | Por asignar | Por asignar | C — Conveniente | 🟢 Caída = análisis geoespacial offline |
| Drupal Commerce | Por asignar | Por asignar | B — Importante | 🟡 Caída = tienda online no funciona |
| Forgejo | Por asignar | Por asignar | C — Conveniente | 🟢 Caída = ciencia abierta no se actualiza |
| MkDocs | Por asignar | Por asignar | C — Conveniente | 🟢 Caída = documentación no se publica |
Almacenamiento persistente¶
| ZFS dataset | Montaje en LXC | Subdirectorios | Backup |
|---|---|---|---|
rpool/datos/corral-del-viento/farmos |
/opt/farmos/ |
config/ data/ modules/farm_bee/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/mysql |
/var/lib/mysql/ |
farmOS/ postgis/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/grafana |
/opt/grafana/ |
config/ data/ dashboards/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/victoria-metrics |
/opt/victoria-metrics/ |
data/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/n8n |
/opt/n8n/ |
config/ data/ workflows/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/drupal |
/var/www/drupal/ |
sites/ modules/ themes/ |
PBS diario + ZFS snapshot @15min |
rpool/datos/corral-del-viento/forgejo |
/opt/forgejo/ |
config/ data/ repos/ |
PBS diario + ZFS snapshot @15min |
Healthchecks¶
# FarmOS
curl -s https://farm.corraldelviento.sc/api | jq .
# Hermes Agent
hermes status
# n8n
curl -s https://n8n.corraldelviento.sc/healthz
# Grafana
curl -s https://grafana.corraldelviento.sc/api/health
# Victoria Metrics
curl -s https://victoria.corraldelviento.sc/health
# MQTT / Mosquitto
mosquitto_sub -t '$SYS/broker/uptime' -C 1
# Node-RED
curl -s https://nodered.corraldelviento.sc/health
# PostGIS
docker exec postgis pg_isready -U postgres
# Drupal Commerce
curl -s https://tienda.corraldelviento.sc/admin/reports/status
# Forgejo
curl -s https://forgejo.corraldelviento.sc/api/v1/version
Logs y diagnóstico¶
# FarmOS
docker logs --tail 100 farmos
# Hermes Agent
journalctl -u hermes-agent --since "1 hour ago"
# n8n
docker logs --tail 100 n8n
# Grafana
docker logs --tail 100 grafana
# Victoria Metrics
journalctl -u victoria-metrics --since "1 hour ago"
# Mosquitto
journalctl -u mosquitto --since "1 hour ago"
# Node-RED
docker logs --tail 100 nodered
# Drupal Commerce
docker logs --tail 100 drupal
tail -100 /var/www/drupal/sites/default/files/logs/drupal.log
Backups¶
- PBS: Backup completo diario de todos los LXC del proyecto Corral del Viento, retención 30 días
- ZFS snapshots: Cada 15 minutos para
rpool/datos/corral-del-viento, retención 24h - MySQL (farmOS + PostGIS): dump diario antes del backup de PBS, retención 90 días
- Verificación: restauración de prueba mensual de un backup aleatorio en entorno aislado
Dashboard en Grafana¶
Panel de control específico para Corral del Viento con:
- Apiario global: estado de todas las colmenas (vivas, enjambradas, huérfanas), alertas activas, métricas de producción agregadas
- Sensores en tiempo real: peso, temperatura interior/exterior, humedad por colmena instrumentada
- Trazabilidad QR: escaneos por lote, páginas visitadas, compradores recurrentes
- Datos ambientales: meteorología de La Vera, floración, índices de polen
- Salud del sistema: CPU, RAM, disco, estado de backups, uptime de cada servicio
- Producción: cosechas por colmenar y temporada, comparativa interanual, ingresos
Problemas comunes¶
| Síntoma | Causa probable | Solución |
|---|---|---|
| FarmOS no carga | FarmOS o MySQL caídos | docker restart farmos, verificar MySQL |
| Hermes no transcribe en Telegram | Hermes Agent detenido o token expirado | hermes gateway restart, verificar token |
| n8n no ejecuta flujos | n8n caído o workflows con error | docker restart n8n, revisar ejecuciones fallidas |
| Dashboards sin datos | Victoria Metrics caído o Alloy sin enviar | docker restart victoria-metrics, verificar Alloy |
| Sensores sin datos | Mosquitto caído o ESP32 sin conexión | systemctl restart mosquitto, verificar WiFi del ESP32 |
| QR de trazabilidad no funciona | Drupal caído o DNS mal | docker restart drupal, verificar Zona Cero |
| Geoespacial no actualiza | PostGIS caído o QGIS no sincroniza | docker restart postgis, verificar cron de sincronización |
Para el arquitecto
Relaciones entre servicios¶
flowchart TB
subgraph Campo["🌿 Campo — Gredos"]
Sensores[Sensores<br/>ESP32/Shelly]
Apicultor[Apicultor<br/>voz Telegram]
Colmena[Colmenas<br/>Langstroth/Dadant/corcho]
end
subgraph Edge["⚡ Edge — Tiempo real"]
Mosquitto[Mosquitto<br/>MQTT]
NodeRED[Node-RED<br/>reglas edge]
end
subgraph Nucleo["🧠 Núcleo — SmallCountry"]
Hermes[Hermes Agent<br/>voz→registro]
Ollama[Ollama<br/>LLMs en Horus/GPU]
n8n[n8n<br/>orquestación]
FarmOS[FarmOS<br/>+ farm_bee]
PostGIS[(PostGIS<br/>geoespacial)]
QGIS[QGIS Server]
end
subgraph Visualizacion["📊 Visualización"]
Grafana[Grafana<br/>dashboards]
VictoriaMetrics[Victoria Metrics<br/>series temporales]
VictoriaLogs[Victoria Logs]
Tempo[Tempo<br/>trazas]
Alloy[Grafana Alloy<br/>recolector]
end
subgraph Publico["🌐 Público"]
ZonaCero[Zona Cero<br/>trazabilidad]
Drupal[Drupal Commerce<br/>tienda]
end
subgraph Conocimiento["📚 Conocimiento"]
Forgejo[Forgejo<br/>ciencia abierta]
MkDocs[MkDocs<br/>docs + formación]
InvenioRDM[InvenioRDM<br/>datasets DOI]
end
subgraph Seguridad["🔐 Seguridad"]
Authentik[Authentik]
Caddy[Caddy TLS]
NetBird[NetBird VPN]
end
Sensores -->|MQTT| Mosquitto
Apicultor -->|Telegram| Hermes
Mosquitto -->|MQTT| NodeRED
NodeRED -->|MQTT| VictoriaMetrics
NodeRED -->|API| n8n
Hermes -->|consulta IA| Ollama
Hermes -->|transcribe| FarmOS
n8n -->|API| FarmOS
n8n -->|API| Drupal
n8n -->|envía| InvenioRDM
n8n -->|notifica| Apicultor
FarmOS -->|datos| PostGIS
QGIS -->|capas| PostGIS
PostGIS -->|WMS/WFS| QGIS
FarmOS -->|métricas| Alloy
Alloy -->|push| VictoriaMetrics
Alloy -->|push| VictoriaLogs
Alloy -->|push| Tempo
VictoriaMetrics -->|PromQL| Grafana
VictoriaLogs -->|LogQL| Grafana
Tempo -->|traces| Grafana
Drupal -->|QR público| ZonaCero
Forgejo -->|publica| ZonaCero
Caddy -->|TLS| FarmOS
Caddy -->|TLS| Grafana
Caddy -->|TLS| Drupal
Caddy -->|TLS| Forgejo
Authentik -->|OAuth2/OIDC| FarmOS
Authentik -->|OAuth2/OIDC| Grafana
Authentik -->|OAuth2/OIDC| Drupal
Authentik -->|OAuth2/OIDC| Forgejo
NetBird -->|VPN| Caddy
Fase 1 — Infraestructura base¶
| Paso | Acción | Herramienta | Verificación |
|---|---|---|---|
| 1.1 | Desplegar FarmOS con módulo farm_bee extendido: LXC Debian 12 + Apache + PHP 8.2 + MySQL | Ansible role farmos |
curl farm.corraldelviento.sc/api responde JSON |
| 1.2 | Extender farm_bee: añadir campos personalizados (fenotipo abeja, tipo colmena, morfometría alar) | FarmOS config UI + drush | Los campos aparecen en el formulario de inspección |
| 1.3 | Desplegar Hermes Agent: conectar con Ollama en Horus, configurar skill farmOS-inspection |
Ansible role hermes-agent |
hermes status muestra OK, Telegram responde |
| 1.4 | Implementar pipeline voz→registro: Hermes → faster-whisper → Ollama → extraer campos → JSON → FarmOS API | n8n workflow voice-to-farmos |
Grabar inspección de prueba y ver registro creado en FarmOS |
| 1.5 | Desplegar stack de observabilidad: Victoria Metrics, Victoria Logs, Tempo, Grafana Alloy, Grafana | Ansible roles del stack | Dashboards de Grafana muestran métricas de todos los servicios |
| 1.6 | Crear dashboards de colmenas: panel global del apiario + paneles individuales por colmenar | Grafana dashboards via JSON | Paneles cargan con datos de prueba de FarmOS |
Fase 2 — Enriquecimiento de datos¶
| Paso | Acción | Depende de |
|---|---|---|
| 2.1 | Desplegar QGIS Server + PostGIS: base de datos espacial, servidor de mapas | FarmOS |
| 2.2 | Mapear colmenares en QGIS: geolocalizar cada colmena y apiario, cargar capas de La Vera | — |
| 2.3 | Vincular PostGIS → FarmOS: exportar datos geoespaciales a registros de FarmOS vía API | QGIS, FarmOS |
| 2.4 | Instalar sensores en colmenas piloto: peso, temperatura, humedad, sonido | ESP32, Shelly |
| 2.5 | Desplegar Mosquitto + Node-RED: bus MQTT, reglas edge para sensores | Sensores |
| 2.6 | Conectar APIS públicas: meteorología AEMET, informe de polen → cache local vía n8n | n8n |
| 2.7 | Preparar Casa Paraíso para cursos presenciales | — |
| 2.8 | Montar colmenas de todos los tipos: mínimo 2 por tipo (Langstroth, Dadant, tronco, corcho, Kenya, Warre) | — |
Fase 3 — Producto y trazabilidad¶
| Paso | Acción | Depende de |
|---|---|---|
| 3.1 | Desplegar Drupal Commerce: tienda online con módulos de trazabilidad QR | n8n, FarmOS |
| 3.2 | Diseñar páginas de trazabilidad QR: generación dinámica desde FarmOS, servidas en Zona Cero | FarmOS, Victoria Metrics |
| 3.3 | Primera cosecha con trazabilidad: documentar todo el proceso, cosechar, envasar con QR | Todos los sistemas |
| 3.4 | Packaging: etiqueta con doble sello (El Salto + Corral del Viento), QR por lote | — |
| 3.5 | Lanzar canal de YouTube: primeros vídeos del trabajo apícola | — |
| 3.6 | Primeras ventas y cursos presenciales: validar el sistema en operación real | Tienda, Casa Paraíso |
Fase 4 — Escala y futuro¶
| Paso | Acción | Depende de |
|---|---|---|
| 4.1 | Publicar corpus de conocimiento: apicultura comparada de todos los tipos de colmena en Forgejo+MkDocs | Varias temporadas de datos |
| 4.2 | Desplegar InvenioRDM: repositorio de ciencia abierta con DOI | Forgejo, n8n |
| 4.3 | Automatizar publicación mensual de datasets: sensores → n8n → InvenioRDM | InvenioRDM |
| 4.4 | Explorar certificación ecológica oficial: los datos de trazabilidad como evidencia | Registros en FarmOS |
| 4.5 | Evaluar trazabilidad por colmena individual como evolución del sistema | Trazabilidad por colmenar validada |
Configuración de red¶
| Bridge | Rango IP | Servicios | Acceso desde |
|---|---|---|---|
vmbr0 (management) |
Por asignar | Proxmox, SSH | WireGuard (admin) |
vmbr1 (servicios internos) |
Por asignar | FarmOS, n8n, Grafana, Victoria Metrics, PostGIS, Forgejo, MkDocs | Caddy :443 → Internet (via NetBird) |
vmbr2 (edge/iot) |
Por asignar | Mosquitto, Node-RED | Solo interna, aislada |
vmbr3 (público) |
Por asignar | Drupal Commerce, Zona Cero (páginas QR) | Caddy :443 → Internet (público, sin auth) |
vmbr4 (datos) |
Por asignar | MySQL, PBS | Solo interna |
Segmentación: los servicios del apiario operan en bridges independientes de los servicios del hogar y de otros proyectos. Principio de segmentación estricta con denegación por defecto.
Zona Cero: enclave externo aislado y unidireccional para páginas públicas de trazabilidad. Sin acceso de retorno al núcleo.
En Pi-hole¶
farm.corraldelviento.sc → IP_LXC_FarmOS
grafana.corraldelviento.sc → IP_LXC_Grafana
n8n.corraldelviento.sc → IP_LXC_n8n
forgejo.corraldelviento.sc → IP_LXC_Forgejo
docs.corraldelviento.sc → IP_LXC_MkDocs
tienda.corraldelviento.sc → IP_LXC_Drupal
datos.corraldelviento.sc → IP_ZonaCero
En Caddy¶
farm.corraldelviento.sc {
forward_auth authentik:9000
reverse_proxy IP_LXC_FarmOS:80
}
grafana.corraldelviento.sc {
forward_auth authentik:9000
reverse_proxy IP_LXC_Grafana:3000
}
n8n.corraldelviento.sc {
forward_auth authentik:9000
reverse_proxy IP_LXC_n8n:5678
}
forgejo.corraldelviento.sc {
forward_auth authentik:9000
reverse_proxy IP_LXC_Forgejo:3000
}
tienda.corraldelviento.sc {
forward_auth authentik:9000
reverse_proxy IP_LXC_Drupal:443
}
# Zona Cero — público, sin auth, unidireccional
datos.corraldelviento.sc {
reverse_proxy IP_ZonaCero:80
}
En Authentik¶
| Provider | Tipo | Grupos asignados |
|---|---|---|
| FarmOS | OAuth2/OIDC | corral-admin, corral-apicultor |
| Grafana | OAuth2/OIDC | corral-admin, corral-apicultor |
| n8n | OAuth2/OIDC | corral-admin |
| Drupal Commerce | OAuth2/OIDC | corral-admin |
| Forgejo | OAuth2/OIDC | corral-admin, corral-apicultor |
Orquestación¶
| Componente | Path / Nombre |
|---|---|
| Rol Ansible | roles/corral-del-viento/ (farmos, n8n, grafana, victoria, mosquitto, nodered, drupal, forgejo) |
| Playbook | deploy-corral-del-viento.yml |
| Módulo OpenTofu | modules/corral-del-viento/ |
| Semaphore | Proyecto corral-del-viento, Template deploy |
| Forgejo Actions | .forgejo/workflows/corral-del-viento.yml |
| Repo Forgejo | infra-core/ |
| Ficha versionada | docs/proyectos/corral-del-viento.md |
9. Hoja de Ruta¶
Fase 1 — Infraestructura base¶
- [ ] Desplegar FarmOS con módulo farm_bee extendido
- [ ] Implementar pipeline: audio Telegram → Hermes Agent (faster-whisper) → LLM → JSON → FarmOS
- [ ] Configurar stack de observabilidad (Alloy, Victoria Metrics, Tempo, Grafana)
- [ ] Primeros dashboards de colmenas
Fase 2 — Enriquecimiento de datos¶
- [ ] Análisis geoespacial de las solanas de Gredos en QGIS → FarmOS
- [ ] Instalación de sensores en colmenas piloto
- [ ] Conexión de APIs públicas: meteorología, informe de polen
- [ ] Configurar n8n para orquestación de flujos
- [ ] Preparar Casa Paraíso para cursos presenciales
- [ ] Montar colmenas de todos los tipos (mínimo 2 por tipo) con sensores
Fase 3 — Producto y trazabilidad¶
- [ ] Diseñar y publicar páginas públicas de trazabilidad QR
- [ ] Primera cosecha con trazabilidad completa documentada
- [ ] Packaging con doble sello (El Salto + Corral del Viento) y QR único por lote
- [ ] Lanzamiento del canal de YouTube
- [ ] Primeras ventas y primeros cursos presenciales
Fase 4 — Escala y futuro¶
- [ ] Consolidar el sistema con datos de varias temporadas
- [ ] Publicar el corpus de conocimiento sobre apicultura comparada (todos los tipos de colmena)
- [ ] Explorar certificación ecológica oficial
- [ ] Evaluar si el sistema tecnológico tiene valor para otros apicultores
- [ ] Mercados premium, exportación y colaboraciones
10. Notas Finales¶
Este proyecto nace de una convicción: un producto bueno merece ser demostrado, no solo declarado.
La trazabilidad completa no será un truco de marketing — será la consecuencia natural de trabajar bien y registrarlo todo. La tecnología no será el producto. Será la infraestructura que hará posible la confianza.
El producto será la miel, el trabajo, las abejas y las solanas de Gredos.
Próximo paso: Desplegar FarmOS, extender farm_bee con los campos necesarios e implementar el primer flujo de inspección por voz.
Corral del Viento · El Salto, Garganta la Olla, Cáceres · Mayo 2026
Voluntariado¶
Corral del Viento está abierto a recibir voluntarios interesados en apicultura. No se necesita experiencia previa — solo ganas de aprender y respeto por las abejas.
| Si te interesa... | Puedes colaborar en... |
|---|---|
| Manejo de colmenas | Inspecciones de primavera y verano, identificación de reinas, control de enjambrazón |
| Sanidad apícola | Monitoreo de varroa, aplicación de tratamientos ecológicos, registro sanitario |
| Cosecha y producción | Extracción de miel, procesado de cera, envasado, etiquetado |
| Apicultura tradicional | Mantenimiento de colmenas de corcho, construcción de nuevas, documentación de técnicas antiguas |
| Ciencia y datos | Registro en FarmOS, observación de biodiversidad, fotografía de flora apícola, publicación en ciencia abierta |
| Formación | Apoyo en cursos presenciales, preparación de materiales didácticos, documentación audiovisual |
Las estancias se coordinan directamente con el equipo de El Salto, que orienta a cada voluntario según sus intereses.
Secciones relacionadas¶
- Proyecto matriz: ⛰️ El Salto
- Proyecto: 🌦️ Proyecto Clima
- Rol: Melissa — Colmenas y miel
- Rol: Hefesto — Infraestructura como código
- Rol: Terminus — Resiliencia
- Ficha: farmOS
- Ficha: Ollama + Qdrant
- Ficha: Hermes Agent
- Ficha: n8n
- Ficha: Grafana
- Compromiso: Agricultor y finca
- Compromiso: Conocimiento y ciencia