🫶🏻 Unir colonias

🎯 Propósito

Fusiona dos colonias en una colmena más fuerte manteniendo registros digitales completos. Es útil para reforzar colonias débiles antes del invierno, gestionar genética de reinas o consolidar el apiario.

🎭 Historia de usuario

Como apicultor que gestiona varias colonias,
quiero unir dos colmenas con control completo sobre la gestión de reinas,
para reforzar colonias débiles, preparar el invierno o gestionar genética conservando todos los datos históricos.

🚀 Beneficios clave

Comparación visual: ve ambas colmenas lado a lado con recuentos de abejas y detalles de reina antes de unirlas.
Control de reina: elige qué reina sobrevive - ambas reinas, reina objetivo o reina origen.
Automatización inteligente: el sistema gestiona automáticamente el movimiento de cajas y elementos estructurales.
Historial completo: registra todas las fusiones con fechas, tipos y enlaces clicables entre colmenas.
Navegación sencilla: las colmenas fusionadas siguen visibles con indicadores de estado claros.
Conservación de datos: se mantienen todos los datos de cajas, cuadros e inspecciones.

💡 Escenarios comunes

Reforzar antes del invierno

Tienes una colonia débil que no sobrevivirá sola al invierno. Únela con una colmena más fuerte para aumentar población y reservas de alimento, dando a la colonia resultante una mejor probabilidad de supervivencia.

Gestionar pérdida de reina

Una colonia perdió su reina y no puede criar una nueva. Únela con una colonia con reina para salvar las abejas y sus recursos en lugar de dejar que se debilite.

Consolidar el apiario

Reduce el número de colmenas antes de moverlas a otro lugar o al disminuir la operación. Combina colonias estratégicamente y conserva todos los datos históricos para consulta futura.

🎓 Cómo usarlo

1. Abrir el diálogo de unión

Navega a la colmena que quieres unir, la colmena origen.
Haz clic en el botón "Unir colonia".
Se abre un modal que muestra tu colmena actual a la izquierda.

2. Seleccionar la colmena objetivo

Ve la lista de colmenas disponibles en tu apiario.
Consulta recuentos de abejas y detalles de reina de cada opción.
Haz clic en la colmena objetivo deseada.
Compara ambas colmenas lado a lado.

3. Elegir estrategia de gestión de reina

Haz clic en el botón conmutador entre los paneles de colmena para seleccionar:

🎲 Ambas reinas (+) - deja que compitan naturalmente y sobreviva la más fuerte.

Mejor cuando no tienes claro qué reina es superior.
La selección natural determina el resultado.

➡️ Reina objetivo - conserva la reina objetivo y retira la reina origen antes de unir.

Mejor cuando la colmena objetivo tiene una reina más joven o mejor genética.
Resultado predecible y genética controlada.

⬅️ Reina origen - conserva la reina origen y retira la reina objetivo antes de unir.

Mejor cuando la colmena origen tiene una reina más joven o mejor genética.
Resultado predecible y genética controlada.

4. Completar la unión

Revisa los detalles de ambas colmenas una última vez.
Haz clic en el botón "Unir colonias".
El sistema mueve automáticamente las cajas y actualiza los registros.
Se te redirige a la colmena objetivo fusionada.

5. Ver resultados

Colmena origen: marcada como "fusionada", aparece atenuada en la lista del apiario y muestra enlace a la colmena objetivo.
Colmena objetivo: activa, con todas las cajas combinadas y un historial de unión con fechas.
Todos los datos de inspecciones y cuadros se conservan en ambas colmenas.

⚙️ Qué ocurre internamente

El sistema gestiona la unión de forma inteligente:

Movimiento de cajas: cámaras de cría y alzas se mueven a la colmena objetivo y se colocan encima.
Elementos estructurales: fondos y piqueras permanecen con la colmena origen.
Conservación de datos: se mantienen todos los cuadros, fotos e historial de inspecciones.
Actualización de estado: la colmena origen queda marcada como "fusionada" y la objetivo permanece activa.
Seguimiento histórico: línea temporal completa con fechas y decisiones sobre reinas.

Última actualización: 5 de diciembre de 2025

⚠️ Consideraciones importantes

Operación irreversible:

⚠️ La unión no se puede deshacer.
Las cajas se mueven permanentemente.
La colmena origen queda marcada como fusionada.
Planifica cuidadosamente antes de confirmar.

Reglas de validación:

Ambas colmenas deben existir y pertenecer al mismo usuario.
Ambas colmenas deben estar en el mismo apiario.
La colmena origen no puede estar ya fusionada ni colapsada.
La colmena objetivo debe tener espacio, es decir posiciones disponibles para cajas.
El tipo de unión debe ser válido, una de las tres opciones.

Pasos físicos de unión:

La unión digital en la aplicación representa la logística. La unión física de colonias requiere:

Elegir el método de unión, por ejemplo con periódico o directo.
Retirar o enjaular la reina según el tipo de unión elegido.
Combinar físicamente las cajas como indica la aplicación.
Vigilar la aceptación de la colonia durante 3 a 7 días.
Revisar señales de lucha o rechazo.
Confirmar que queda una sola reina después de la unión.

🎯 Casos de uso

1. Reforzar colonia débil

Origen: colonia débil, 1000 abejas.
Objetivo: colonia fuerte, 5000 abejas.
Tipo de unión: reina objetivo (→).
Resultado: colonia de 6000 abejas con reina fuerte.

2. Combinar antes del invierno

Origen: pequeño núcleo tardío.
Objetivo: colonia establecida.
Tipo de unión: ambas reinas (+).
Resultado: colonia fuerte para invernar.

3. Sustituir reina vieja

Origen: colonia con reina nueva, 2024.
Objetivo: colonia con reina vieja, 2021.
Tipo de unión: reina origen (←).
Resultado: colonia con genética de reina joven.

4. Consolidar apiarios

Varias colonias débiles en el apiario.
Fusiona varias en menos colonias fuertes.
Conserva las mejores reinas mediante uniones dirigidas.
Resultado: menos colonias, pero más fuertes.

🔗 Funciones relacionadas

Dividir colonia: operación opuesta para crear una nueva colmena desde una existente.
Colapsar colmena: marcar una colonia inactiva o muerta, distinto de fusionar.
Eliminar colmena: eliminar permanentemente el registro de colmena.
Inspecciones: seguir la colonia antes y después de la unión.

📝 Buenas prácticas

Antes de unir:

✅ Revisa ambas reinas si quieres conservar una concreta.
✅ Evalúa fuerza de colonia y población de abejas.
✅ Considera la época del año, idealmente final de verano u otoño.
✅ Planifica el método físico de unión.
✅ Ten listo el material, como periódico o pulverizador.

Durante la unión:

✅ Completa primero la unión digital en la aplicación.
✅ Sigue el procedimiento físico de unión.
✅ Usa el método del periódico para una aceptación gradual.
✅ Minimiza la perturbación de las abejas.
✅ Cierra la colmena rápidamente después de combinar.

Después de unir:

✅ Vigila durante 3 a 7 días para confirmar aceptación.
✅ Comprueba que queda una sola reina.
✅ Observa señales de pelea o rechazo.
✅ Evalúa reservas de alimento, porque la colonia combinada necesita más.
✅ Crea una inspección para documentar el resultado.
✅ Elimina la colmena origen fusionada después de confirmar el éxito, si lo deseas.

🐛 Solución de problemas

"No hay otras colmenas disponibles"

Necesitas al menos 2 colmenas en el mismo apiario.
Crea otra colmena o mueve una colmena a un apiario con otras.

"Tipo de unión no válido"

Asegúrate de seleccionar una de las tres opciones.
Recarga la página e inténtalo de nuevo.

"Colmena origen no encontrada"

La colmena puede haber sido eliminada.
Comprueba la propiedad de la colmena.

Las cajas no se mueven como esperabas:

Las cajas BOTTOM y GATE permanecen siempre en la colmena origen.
Este comportamiento es intencional.
Las demás cajas deberían moverse a la colmena objetivo.

No encuentro la colmena fusionada:

Las colmenas fusionadas aparecen atenuadas en la lista del apiario.
Usa búsqueda o filtro por estado.
Revisa la sección "Fusionada desde" de la colmena objetivo para ver el enlace.

📚 Recursos técnicos

Archivos de implementación:

Backend: swarm-api/graph/schema.resolvers.go (mutación JoinHives)
Backend: swarm-api/graph/model/hive.go (MarkAsMerged, GetMergedFromHives)
Backend: swarm-api/graph/model/box.go (MoveBoxesToHive, GetBoxesByTypeForHive)
Frontend: web-app/src/page/hiveEdit/JoinColonyModal.tsx
Frontend: web-app/src/page/hiveEdit/JoinColonyModal.module.less
Migración: swarm-api/migrations/20251205130000_add_hive_merge_tracking.sql