Manual de Usuario
EGGlogU 360

Gestión Avícola Inteligente — Guía Completa

v1.0 — 2026

Qué es EGGlogU 360

EGGlogU 360 es una plataforma web completa para la gestión de granjas avícolas de postura. Funciona como una Progressive Web App (PWA), lo que significa que puedes instalarla en tu celular o computador y usarla incluso sin conexión a internet.

Capacidades principales

  • 14 módulos que cubren desde producción diaria hasta IA predictiva
  • 2 modos especiales: Campo (uso rápido en terreno) y Veterinario (vista clínica)
  • 8 idiomas: Español, Inglés, Portugués, Francés, Alemán, Chino, Hindi, Árabe
  • 16 razas comerciales con curvas de producción reales
  • IA integrada: predicción de brotes, pronósticos de producción, detección de anomalías
  • IoT compatible: sensores MQTT en tiempo real
  • 100% offline: todos los datos se guardan en tu dispositivo (localStorage)
🚀

Primeros Pasos

Acceso a la plataforma

Abre index.html en cualquier navegador moderno (Chrome, Firefox, Edge, Safari). No necesitas servidor — funciona directo desde el archivo.

Instalar como app (PWA)

  1. Abre EGGlogU en Chrome o Edge
  2. Haz clic en el icono de instalación en la barra de dirección (o en el menú ⋮ > "Instalar app")
  3. La app aparecerá en tu escritorio o pantalla de inicio
  4. Ahora funciona como una aplicación nativa, incluso sin internet

Navegación general

La interfaz tiene un sidebar izquierdo con todos los módulos. En móvil, el sidebar se oculta y aparece un botón ☰ para abrirlo.

  1. Haz clic en cualquier módulo del sidebar para navegar a él
  2. El módulo activo se resalta con un fondo más claro
  3. En la parte inferior del sidebar encontrarás los botones de Modo Campo y Modo Veterinario

Cambiar idioma

  1. En la parte superior del sidebar verás 8 banderas de idiomas
  2. Haz clic en la bandera del idioma que prefieras
  3. La interfaz se traduce instantáneamente
  4. Tu preferencia se guarda automáticamente para futuras sesiones
Idiomas disponibles: 🇪🇸 Español, 🇺🇸 Inglés, 🇧🇷 Portugués, 🇫🇷 Francés, 🇩🇪 Alemán, 🇨🇳 Chino, 🇮🇳 Hindi, 🇸🇦 Árabe

Configuración inicial recomendada

  1. Ve a Configuración (⚙️) y establece el nombre de tu granja, ubicación y moneda
  2. Si tienes datos climáticos, ingresa tu API Key de OpenWeatherMap
  3. Crea tu primer Lote con la raza, cantidad de aves y fecha de nacimiento
  4. Empieza a registrar Producción diaria — desde aquí los KPIs del Dashboard se activan
📊

Dashboard Panel principal

Vista general

El Dashboard es tu centro de mando. Muestra los indicadores clave (KPIs) de toda la granja en tiempo real.

KPIs mostrados

KPIQué mideCómo se calcula
Producción HoyHuevos recolectados hoySuma de registros de producción del día
Hen-Day %Tasa de postura(Huevos hoy ÷ gallinas activas) × 100
FCRConversión alimenticiakg alimento consumido ÷ kg huevos producidos (30 días)
Mortalidad %Pérdida de aves(Muertes 30d ÷ aves totales) × 100
Costo/HuevoCosto unitarioGastos totales ÷ huevos totales (30 días)
Ingreso NetoGanancia del mesIngresos del mes − gastos del mes
Gallinas ActivasPlantel actualSuma de aves vivas por lote
AlertasSituaciones que requieren atenciónConteo de alertas activas

Panel de alertas

Las alertas se generan automáticamente cuando se detectan situaciones importantes:

  • Urgente Vacunas vencidas sin aplicar
  • Atención Vacunas próximas a vencer
  • Atención Stock de alimento bajo el mínimo configurado
  • Urgente Mortalidad sobre el umbral
  • Urgente Brotes sanitarios activos
  • Atención Períodos de retiro de medicamentos activos
  • Atención Zonas de bioseguridad con desinfección vencida
  • Urgente Avistamientos de plagas sin resolver
  • Urgente Riesgo de contaminación cruzada por visitantes
Los umbrales de alerta se configuran en Configuración → Umbrales de alerta.

Recomendaciones inteligentes

El motor de recomendaciones analiza tus datos y genera sugerencias priorizadas:

  • Alta FCR > 2.4 → revisar dieta y calidad de alimento
  • Alta Pico de mortalidad en 48h → revisar condiciones ambientales
  • Media Lote bajo su curva de raza por >10% → investigar causa
  • Media Stock de alimento para menos de 7 días → programar compra
  • Normal Sin lectura ambiental en 3+ días → registrar temperatura y humedad
  • Media Zonas con desinfección vencida → desinfectar
  • Alta Estrés térmico prolongado (THI > 28 consecutivo) → activar plan de calor

Widget climático y gráfico de tendencia

Si tienes configurada una API Key de OpenWeatherMap, el Dashboard muestra:

  • Clima actual: temperatura, humedad, viento, sensación térmica, índice THI
  • Pronóstico 3 días

Además, un gráfico de línea muestra la tendencia de producción de los últimos 30 días.

Snapshots de KPIs

El sistema guarda una "foto" de tus KPIs cada día. Puedes ver el historial en la tabla de snapshots al final del Dashboard. Estos datos alimentan el módulo de Análisis → Evolución de KPIs.

🥚

Producción Registro diario de huevos

Para qué sirve

Aquí registras la recolección diaria de huevos por lote. Es el módulo más importante — alimenta el Dashboard, Análisis, Finanzas, Trazabilidad y la IA Predictiva.

Registrar producción

  1. Haz clic en "+ Nuevo Registro"
  2. Selecciona la fecha (por defecto hoy)
  3. Selecciona el lote del que vienes a registrar
  4. Ingresa la cantidad de huevos recolectados
  5. Ingresa la cantidad de huevos rotos (si aplica)
  6. Distribuye por tamaño: S, M, L, XL, Jumbo
  7. Selecciona el tipo de huevo: Convencional, Free-range, Orgánico, Pastura, Decorativo
  8. Selecciona el canal de venta: Mayorista, Supermercado, Restaurante, Directo, Exportación, Pasteurizado
  9. Opcional: color de cáscara, puntaje de yema (1-10), muertes del día, causa de muerte, notas
  10. Haz clic en "Guardar"
FechaDía de recolección
LoteParvada origen
HuevosTotal recolectados
RotosHuevos dañados
S / M / L / XL / JumboDistribución por tamaño
TipoConvencional, orgánico, etc.
CanalCanal de comercialización
Calidad yemaPuntaje 1-10
MuertesBajas del día
Registra muertes aquí — el sistema descuenta automáticamente las aves del lote para mantener actualizado el conteo de gallinas activas.

Filtrar y consultar registros

Usa la barra de filtros en la parte superior para:

  • Filtrar por lote: ver solo la producción de un lote específico
  • Filtrar por rango de fechas: fecha inicio y fecha fin

La tabla muestra todos los registros con sus detalles. Cada fila tiene botones para editar o eliminar.

🐔

Lotes Gestión de parvadas

Para qué sirve

Un lote (o parvada) es un grupo de aves que ingresaron juntas a la granja. Todo en EGGlogU se organiza por lote: producción, sanidad, alimentación, trazabilidad, etc.

Crear un nuevo lote

  1. Haz clic en "+ Nuevo Lote"
  2. Ingresa un nombre identificador (ej: "Lote A-2026", "Galpón 3")
  3. Selecciona la raza del menú desplegable (16 razas comerciales disponibles)
  4. Ingresa la cantidad inicial de aves
  5. Selecciona la fecha de nacimiento — esto es crucial para las curvas de producción y el calendario de vacunas
  6. Selecciona el tipo de alojamiento: Piso, Jaula, o Free-range
  7. La curva objetivo y el color de huevo se llenan automáticamente según la raza
  8. Opcional: estado (activo/inactivo), costo de adquisición, notas
  9. Haz clic en "Guardar"

Razas disponibles

RazaTipoHuevos/AñoColor HuevoPeso HuevoFCR
ISA BrownIndustrial320Marrón63g2.1
Hy-Line W-36Industrial330Blanco62g1.9
Hy-Line BrownIndustrial325Marrón64g2.0
Lohmann BrownIndustrial315Marrón64g2.1
Lohmann LSLIndustrial330Blanco63g1.9
Bovans BrownIndustrial310Marrón63g2.1
Bovans WhiteIndustrial325Blanco62g1.9
Dekalb WhiteIndustrial320Blanco61g2.0
Novogen BrownIndustrial310Marrón63g2.1
Novogen WhiteIndustrial320Blanco62g2.0
AraucanaHeritage250Azul/Verde55g2.5
MaransHeritage200Chocolate65g2.6
SussexDoble propósito260Crema60g2.4
Plymouth RockDoble propósito250Marrón60g2.4
LeghornIndustrial300Blanco61g2.0
GenéricaGeneral280Marrón60g2.2

Hoja de ruta del ciclo de vida

Cada lote muestra una barra visual con las 8 etapas del ciclo de vida:

EtapaSemanasDescripción
Cría0-4Pollitas recién nacidas, control de temperatura
Recría5-8Crecimiento, primeras vacunas
Desarrollo9-15Preparación para postura
Pre-postura16-17Estimulación lumínica, cambio de alimento
Inicio postura18-22Primeros huevos, producción creciente
Pico23-35Máxima producción (90-95% Hen-Day)
Persistencia36-65Producción gradualmente descendente
Fin ciclo66+Producción mínima, evaluar descarte/muda
La etapa se calcula automáticamente a partir de la fecha de nacimiento del lote.

Detalle de lote

Haz clic en un lote para ver su tarjeta de detalle, que incluye:

  • Score de salud: puntuación compuesta (0-100) basada en mortalidad, brotes, vacunas y FCR
  • Timeline de vacunas: calendario de vacunación específico para ese lote
  • Información de producción: resumen de huevos y rendimiento
💉

Sanidad Vacunas, medicamentos, brotes y estrés

Vista general

El módulo de Sanidad tiene 4 pestañas: Vacunas, Medicamentos, Brotes y Eventos de Estrés.

Vacunas

El sistema genera automáticamente un calendario de 9 vacunas para cada lote basado en su fecha de nacimiento:

VacunaDíaEnfermedad que previene
MarekDía 1Enfermedad de Marek
Newcastle + BIDía 7Newcastle + Bronquitis Infecciosa
GumboroDía 14Enfermedad de Gumboro (IBD)
Newcastle RefuerzoDía 21Refuerzo Newcastle
Gumboro RefuerzoDía 28Refuerzo Gumboro
Viruela AviarDía 42Viruela aviar
Newcastle + BI 2do RefuerzoDía 63Segundo refuerzo Newcastle + BI
CorizaDía 77Coriza infecciosa
Newcastle + BI 3er RefuerzoDía 112Refuerzo pre-postura

Cómo aplicar una vacuna

  1. Ve a Sanidad → Vacunas
  2. Verás la tabla con todas las vacunas pendientes de todos los lotes
  3. Las vacunas vencidas aparecen resaltadas en rojo
  4. Haz clic en "Aplicar" junto a la vacuna
  5. El estado cambia a Aplicada
Las vacunas vencidas generan alertas en el Dashboard. Es importante mantener el calendario al día.

Medicamentos

Registra tratamientos médicos con control de período de retiro.

  1. Haz clic en "+ Nuevo Medicamento"
  2. Selecciona fecha y lote
  3. Ingresa el nombre del medicamento
  4. Ingresa dosis y vía de administración (oral, inyectable, agua, etc.)
  5. Ingresa los días de tratamiento
  6. Ingresa los días de retiro — el sistema calcula automáticamente la fecha en que termina el período de retiro
  7. Guardar
Mientras un lote está en período de retiro, aparece un badge visible y una alerta en el Dashboard. Los huevos de ese lote NO deben comercializarse hasta que termine el retiro.

Brotes

Registra eventos de enfermedad para llevar seguimiento hasta su resolución.

FechaInicio del brote
LoteParvada afectada
EnfermedadNombre o sospecha
SíntomasDescripción clínica
TratamientoAcciones tomadas
EstadoActivo / Controlado / Resuelto
Los brotes activos generan alertas, incrementan el riesgo de brote de la IA Predictiva, y se muestran en el Modo Veterinario.

Eventos de Estrés

Registra eventos que pueden afectar la producción. El sistema mide automáticamente el impacto en producción comparando los 3 días antes vs. 3 días después del evento.

FechaCuándo ocurrió
TipoCalor, enfermedad, cambio de alimento, corte de luz, depredador, otro
Severidad1-5 (de leve a severo)
LoteParvada afectada
DescripciónDetalle del evento
Cuando el índice THI (Temperatura-Humedad) supera 28, el sistema genera automáticamente un evento de estrés por calor.
🌾

Alimento Compras y consumo de alimento

KPIs de alimento

En la parte superior del módulo verás:

  • Stock actual (kg): compras totales − consumo total
  • Total compras: inversión acumulada en alimento
  • Total consumo (kg): alimento usado
  • FCR 30 días: conversión alimenticia del último mes

Registrar compra de alimento

  1. Ve a la pestaña "Compras"
  2. Haz clic en "+ Nueva Compra"
  3. Ingresa: fecha, tipo de alimento, cantidad (kg), costo total y proveedor
  4. El sistema calcula automáticamente el $/kg
  5. Guardar

Registrar consumo de alimento

  1. Ve a la pestaña "Consumo"
  2. Haz clic en "+ Nuevo Consumo"
  3. Ingresa: fecha, lote, cantidad (kg) y tipo de alimento
  4. Guardar
Registra el consumo diariamente para obtener un FCR preciso. El FCR es el indicador más importante de eficiencia alimenticia.
👥

Clientes Gestión de compradores

Para qué sirve

Gestiona tu cartera de clientes y sus precios personalizados por tamaño de huevo. Los clientes se vinculan con Finanzas (ingresos, cuentas por cobrar) y Trazabilidad (despachos).

Crear un cliente

  1. Haz clic en "+ Nuevo Cliente"
  2. Ingresa: nombre, teléfono, email, ruta, dirección
  3. Define los precios por tamaño para este cliente: S, M, L, XL, Jumbo
  4. Opcional: notas
  5. Guardar
Los precios por tamaño permiten que al registrar un ingreso vinculado a este cliente, el precio se sugiera automáticamente según el tamaño del huevo.
💰

Finanzas Ingresos, gastos y cuentas por cobrar

Vista general

El módulo de Finanzas tiene 4 pestañas: Ingresos, Gastos, Cuentas por Cobrar y Resumen.

Ingresos

  1. Haz clic en "+ Nuevo Ingreso"
  2. Selecciona la fecha
  3. Selecciona el tipo: Huevos, Aves, Guano (gallinaza), Otro
  4. Ingresa cantidad y precio unitario — el total se calcula automáticamente
  5. Opcional: selecciona el cliente vinculado
  6. Guardar

Gastos

  1. Haz clic en "+ Nuevo Gasto"
  2. Selecciona la fecha
  3. Selecciona la categoría: Alimento, Vacunas, Transporte, Mano de obra, Infraestructura, Otro
  4. Ingresa descripción y monto
  5. Guardar

Cuentas por Cobrar

Lleva control de ventas a crédito.

  1. Haz clic en "+ Nueva Cuenta"
  2. Ingresa: fecha, cliente, descripción, monto, fecha de vencimiento
  3. Cuando el cliente pague, haz clic en "Marcar como pagada"

Resumen financiero

La pestaña Resumen muestra:

  • KPIs del mes: ingresos, gastos, ingreso neto
  • Desglose mensual: tabla mes a mes con ingresos, gastos y neto
  • Gastos por categoría: cuánto se gasta en cada rubro
  • Análisis de punto de equilibrio: cuántos huevos necesitas vender para cubrir costos
  • Costo por huevo: costo real de producir cada huevo
  • Exportar CSV: botón para descargar todos los datos financieros
Revisa el resumen financiero mensualmente para detectar tendencias de costos y ajustar precios.
📈

Análisis Comparaciones, estacionalidad y rentabilidad

Vista general

El módulo de Análisis tiene 5 pestañas que procesan todos tus datos para generar inteligencia accionable.

Comparación de Lotes

Tabla que compara todos los lotes activos lado a lado:

  • Cantidad de aves, gallinas actuales
  • Hen-Day % (tasa de postura)
  • FCR (conversión alimenticia)
  • Mortalidad %
  • Score de salud

Los lotes se ordenan por Hen-Day %. Se identifica el mejor y el peor lote.

Estacionalidad

Gráfico de barras y tabla mostrando la producción promedio de huevos por mes. Permite identificar los meses de mayor y menor producción, útil para planificar ventas y abastecimiento.

Rentabilidad

Tres análisis de rentabilidad:

  • Por lote: huevos, ingresos, gastos, neto y costo/huevo por cada lote
  • Por tipo de huevo: rentabilidad de convencional vs. orgánico vs. free-range, etc.
  • Por canal de venta: rentabilidad por mayorista, supermercado, directo, etc.

Evolución de KPIs

Gráfico de líneas multi-eje con los últimos 30 snapshots diarios, mostrando:

  • Hen-Day % (eje izquierdo)
  • FCR (eje derecho)
  • Mortalidad % (eje derecho)

Debajo, tabla histórica con todos los KPIs: gallinas activas, Hen-Day, FCR, mortalidad, costo/huevo, ingreso neto.

Predicciones (ML)

Ver sección completa en IA Predictiva.

📋

Operaciones Checklist, bitácora y personal

Checklist diario

Lista de tareas que se deben completar cada día en la granja.

  1. Al abrir la pestaña "Checklist", verás las tareas predefinidas del día
  2. Marca cada tarea como completada haciendo clic en el checkbox
  3. Haz clic en "+ Agregar tarea" para añadir tareas personalizadas
  4. Un indicador muestra el % de completitud del día
  5. Puedes ver el historial de los últimos 7 días
Configura las tareas predeterminadas del checklist en Configuración → Checklist por defecto.

Bitácora

Registro libre de notas y observaciones diarias.

  1. Ve a la pestaña "Bitácora"
  2. Haz clic en "+ Nueva Entrada"
  3. Selecciona la fecha y categoría: General, Salud, Producción, Mantenimiento, Observación
  4. Escribe tu nota
  5. Guardar

Puedes filtrar las entradas por categoría usando el selector superior.

Personal

Gestiona a los trabajadores de la granja.

NombreNombre del trabajador
RolCargo o función
SalarioSueldo mensual
Fecha inicioDesde cuándo trabaja
EstadoActivo / Inactivo

El KPI superior muestra la suma total de salarios activos, útil para el análisis de costos.

🛡️

Bioseguridad Visitantes, zonas, plagas y protocolos

KPIs de bioseguridad

  • Pest Score (/100): puntuación compuesta de riesgo de plagas — mientras más alto, más riesgo
  • Plagas sin resolver: avistamientos activos
  • Total visitantes: conteo de visitas registradas
  • Total zonas: zonas de bioseguridad configuradas

Visitantes

Registra cada persona que ingresa a la granja.

  1. Haz clic en "+ Nuevo Visitante"
  2. Ingresa: fecha, nombre, empresa, motivo de visita, zona visitada
  3. Ingresa la patente del vehículo (si aplica)
  4. Marca si fue desinfectado (Sí/No)
  5. Si viene de otra granja: ingresa el ID de granja de origen y su estado sanitario (Sana / En brote / Desconocido)
  6. Guardar
Si un visitante viene de una granja "En brote", el sistema genera una alerta de contaminación cruzada que aparece en el Dashboard y en el Modo Veterinario.

Zonas

Define las zonas de bioseguridad de tu granja con nivel de riesgo y frecuencia de desinfección.

  1. Haz clic en "+ Nueva Zona"
  2. Ingresa: nombre (ej: "Galpón 1", "Bodega alimento", "Ingreso")
  3. Selecciona el nivel de riesgo: Verde Amarillo Rojo
  4. Ingresa la fecha de última desinfección y la frecuencia (cada cuántos días)
  5. Guardar

Las zonas con desinfección vencida aparecen con un indicador Vencida y generan alertas.

Plagas

Registra avistamientos de plagas con timeline visual.

FechaCuándo se detectó
TipoRoedor, mosca, ave silvestre, otro
UbicaciónDónde se detectó
Severidad1-5 estrellas
Acción tomadaQué se hizo al respecto
EstadoActivo / Resuelto

Haz clic en "Marcar como resuelto" cuando el problema esté controlado.

Cómo se calcula el Pest Score

El puntaje (0-100) se compone de:

  • Avistamientos sin resolver: hasta 40 puntos
  • Severidad promedio: hasta 20 puntos
  • Zonas en rojo: 15 puntos c/u; zonas en amarillo: 5 puntos c/u
  • Desinfecciones vencidas: 10 puntos c/u

Protocolos

Define protocolos recurrentes de bioseguridad.

  1. Haz clic en "+ Nuevo Protocolo"
  2. Ingresa: nombre (ej: "Desratización", "Fumigación galpones")
  3. Selecciona la frecuencia: Diaria, Semanal, Mensual
  4. Agrega los ítems del checklist del protocolo
  5. Guardar

Cada protocolo muestra su fecha de última ejecución y un indicador si está vencido. Haz clic en "Completar protocolo" para registrar su ejecución.

📦

Trazabilidad Lotes de despacho con QR

Para qué sirve

Registra cada despacho de huevos desde la granja hasta el cliente, con código QR que permite rastrear el origen completo de cada caja.

Crear un lote de despacho

  1. Haz clic en "+ Nuevo Lote"
  2. Ingresa la fecha de preparación
  3. Selecciona el lote de aves de origen
  4. Ingresa: galpón, número de rack
  5. Ingresa: cantidad de cajas y huevos por caja (default: 30)
  6. Selecciona el tipo de huevo
  7. Selecciona el cliente destino
  8. Ingresa la fecha de entrega
  9. Opcional: notas
  10. Guardar

Código QR

Cada lote genera automáticamente un código QR con el siguiente formato:

EGGLOGU|BATCH:{id}|FLOCK:{flockId}|DATE:{fecha}|HOUSE:{galpón}|TYPE:{tipo}

Al hacer clic en un lote, se abre la vista de trazabilidad completa que muestra:

  • ID del lote de despacho
  • Galpón de origen
  • Lote de aves + raza
  • Fecha de producción
  • Score de salud del lote de origen
  • Tipo de huevo
  • Cliente destino
  • Código QR escaneable
Puedes buscar lotes de despacho por ID usando la barra de búsqueda. También puedes exportar todos los lotes a CSV con el botón de descarga.
🗓️

Planificación Planes de producción

Para qué sirve

Crea planes de producción para cumplir compromisos con clientes. El sistema estima automáticamente la producción esperada de cada lote usando las curvas de raza y calcula si alcanzarás la meta.

Crear un plan de producción

  1. Haz clic en "+ Nuevo Plan"
  2. Ingresa el nombre del plan (ej: "Pedido Supermercado Marzo")
  3. Selecciona la fecha objetivo
  4. Ingresa la cantidad de huevos necesarios
  5. Opcional: selecciona el cliente vinculado
  6. Selecciona los lotes asignados al plan — para cada lote verás la producción estimada calculada automáticamente
  7. Guardar

Seguimiento de planes

Cada plan se muestra como una tarjeta con:

  • Nombre y fecha objetivo
  • Huevos necesarios vs. producción esperada
  • Brecha (gap): diferencia entre lo necesario y lo estimado
  • % en camino: porcentaje de cumplimiento estimado
La estimación de producción se calcula día a día usando la curva Hen-Day % de la raza de cada lote asignado, multiplicada por el número actual de gallinas.
🌡️

Ambiente Registro manual, IoT e historial

Rangos óptimos de referencia

ParámetroRango ÓptimoUnidad
Temperatura18 – 24°C
Humedad40 – 70%
Horas de luz14 – 16horas
Amoníaco< 25ppm

Registro Manual

  1. Ve a la pestaña "Manual"
  2. Haz clic en "+ Nueva Lectura"
  3. Ingresa: fecha, temperatura (°C), humedad (%), horas de luz
  4. Opcional: amoníaco (ppm), ventilación, notas
  5. Guardar

La última lectura se muestra con indicadores de color: OK si está en rango, Fuera de rango si no.

El sistema calcula el THI (Índice Temperatura-Humedad) automáticamente:

THI = (1.8×T + 32) − (0.55 − 0.0055×H) × (1.8×T − 26)

Cuando el THI supera 28, se genera automáticamente un evento de estrés por calor en Sanidad.

IoT (Sensores en tiempo real)

Si tienes sensores conectados por MQTT:

  1. Configura el broker MQTT en Configuración (URL wss://, usuario, password, prefijo de topic)
  2. Ve a la pestaña "IoT"
  3. Haz clic en "Conectar"
  4. Los gauges en tiempo real mostrarán: Temperatura, Humedad, Amoníaco, Luz
  5. Cada gauge tiene colores indicando si el valor está en rango óptimo
  6. Haz clic en "Guardar lectura" para almacenar la lectura actual como registro ambiental
El sistema se suscribe al topic {prefijo}sensors/# y espera mensajes JSON con formato {"value": 23.5, "unit": "°C"}.

Historial

La pestaña "Historial" muestra:

  • Gráfico dual: línea de temperatura (eje izq.) y humedad (eje der.) de las últimas 30 lecturas
  • Tabla completa: todas las lecturas con sus valores y THI calculado
🤖

IA Predictiva Pronósticos y análisis avanzado

Vista general

EGGlogU incluye modelos de Machine Learning que corren 100% en tu navegador — tus datos nunca salen de tu dispositivo. Los resultados se encuentran en Análisis → Predicciones.

Clasificador de Riesgo de Brote

Modelo de clasificación que evalúa la probabilidad de un brote sanitario usando una función sigmoide con 7 factores ponderados:

FactorPesoQué mide
Pico de mortalidad25%Aumento anormal de muertes recientes
Caída de producción20%Tendencia descendente (regresión lineal)
Deterioro de FCR15%Empeoramiento de conversión alimenticia
Estrés térmico (THI)15%Índice calor-humedad elevado
Brotes activos10%Presencia de brotes sin resolver
Vacunas pendientes10%Calendario de vacunación atrasado
Eventos de estrés5%Eventos de estrés recientes

El resultado se muestra como semáforo:

  • Rojo (≥50%) Alto riesgo — acción inmediata requerida
  • Amarillo (>40%) Riesgo moderado — monitorear de cerca
  • Verde (≤40%) Riesgo bajo — operación normal

Además de la probabilidad, el sistema genera recomendaciones específicas según los factores que más contribuyen al riesgo.

Pronóstico de Producción (Ensemble)

Proyección de producción a 7 o 14 días usando un modelo ensemble que combina:

  • Media Móvil Ponderada (WMA): da más peso a los datos recientes
  • Regresión Lineal: captura la tendencia general

El resultado se promedia y se muestra en un gráfico con:

  • Línea azul: datos reales
  • Línea naranja: pronóstico
  • Banda gris: intervalo de confianza (±1 desviación estándar)
Necesitas al menos 14 días de datos de producción para que el pronóstico se active.

Detección de Anomalías

El sistema calcula el Z-score de cada día de producción de los últimos 30 días. Los días con |Z| > 2 se marcan como anomalías — producción inusualmente alta o baja.

Las anomalías pueden indicar problemas de salud, cambios de alimento, errores de registro, o factores externos como cortes de luz o visitas de depredadores.

Benchmark por Raza

Compara la producción real de cada lote contra su curva teórica de raza. Muestra la diferencia porcentual — si un lote produce significativamente menos que su potencial genético, hay un factor que investigar.

Score de Riesgo de Caída

Puntaje compuesto (0-100) que predice la probabilidad de una caída de producción. Considera 4 factores:

  • Pico de mortalidad: hasta 30 puntos
  • Empeoramiento de FCR: hasta 25 puntos
  • THI elevado: hasta 20 puntos
  • Tendencia de producción: hasta 25 puntos
🌿

Modo Campo Uso rápido en terreno

Para qué sirve

El Modo Campo es una vista simplificada diseñada para usar en el gallinero o en terreno, donde necesitas registrar datos rápido, con mínimas distracciones.

Cómo activarlo

  1. En el sidebar, haz clic en el botón "Modo Campo" (icono de hoja 🌿)
  2. La interfaz cambia: se ocultan todos los módulos excepto Dashboard y Producción
  3. El Dashboard muestra solo 4 KPIs grandes: Producción Hoy, Hen-Day%, Mortalidad%, Alertas
  4. Aparece un botón grande de registro rápido
El Modo Campo y el Modo Veterinario son mutuamente excluyentes — activar uno desactiva el otro.

Registro rápido de producción

  1. Haz clic en el botón grande "+" de registro rápido
  2. Se abre un modal simplificado con solo 3 campos:
    Lote (selector)
    Huevos recolectados (campo grande, fácil de tocar en móvil)
    Muertes (si hubo bajas)
  3. Haz clic en "Guardar"
  4. El registro se crea con la fecha de hoy y valores predeterminados para los demás campos
Ideal para: caminar entre galpones con el celular, registrar la recolección de cada lote en segundos, y luego completar los detalles (tamaño, tipo) al volver a la oficina editando el registro en el módulo de Producción.

Desactivar Modo Campo

Haz clic nuevamente en el botón "Modo Campo" en el sidebar para volver a la vista completa con los 14 módulos.

🩺

Modo Veterinario Vista clínica

Para qué sirve

El Modo Veterinario reemplaza el Dashboard con una vista clínica orientada a la salud de los lotes. Diseñado para que el veterinario pueda evaluar rápidamente el estado sanitario de la granja.

Cómo activarlo

  1. En el sidebar, haz clic en el botón "Modo Veterinario" (icono de estetoscopio 🩺)
  2. El Dashboard se reemplaza por la vista veterinaria
  3. Selecciona un lote específico o "Todos" en el selector

Información mostrada

Para cada lote (o todos), el modo veterinario muestra:

  • Score de salud: puntuación compuesta del lote (0-100)
  • Brotes activos: cantidad y detalle de brotes sin resolver
  • Vacunas pendientes: vacunas próximas o vencidas
  • Última lectura ambiental: temperatura, humedad, THI
  • Timeline de vacunas: calendario completo con estado
  • Verificación de contaminación cruzada: visitantes de los últimos 7 días que provienen de granjas con brotes activos

Acciones veterinarias

El modo incluye 3 botones de acción rápida:

  • "Visita" — Registra la visita del veterinario. Crea una entrada en la bitácora y un registro de visitante en bioseguridad
  • "Vacunas" — Navega directo al módulo de vacunas
  • "Pendientes" — Muestra un resumen de todo lo que requiere atención inmediata
El botón "Visita" genera automáticamente un registro de bioseguridad para el veterinario, cumpliendo el protocolo de control de visitantes.
⚙️

Configuración Personalización y datos

Tema visual

Elige entre 5 temas de color haciendo clic en los botones de color:

  • Azul — tema por defecto (profesional)
  • Verde — tema natural
  • Púrpura — tema elegante
  • Negro — tema corporativo
  • Oscuro — tema oscuro completo

Accesibilidad

  • Tamaño de fuente: Pequeño, Normal, Grande, Extra Grande
  • Modo oscuro: toggle on/off — reduce la fatiga visual en ambientes con poca luz

Información de la granja

NombreNombre de tu granja
UbicaciónCiudad o dirección
CapacidadAves máximas
MonedaSímbolo monetario (ej: $, €, CLP)

Geolocalización

Define la ubicación de tu granja para que funcione el widget climático:

  1. Haz clic en "Usar GPS" para capturar tu ubicación actual
  2. O haz clic en el mapa para seleccionar la ubicación manualmente
  3. Las coordenadas se usan para obtener datos climáticos de OpenWeatherMap

API del clima (OpenWeatherMap)

  1. Obtén una API Key gratuita en openweathermap.org
  2. Ingresa la key en el campo "API Key"
  3. Haz clic en "Probar" para verificar que funcione
  4. El Dashboard mostrará clima actual y pronóstico de 3 días

IoT / MQTT

Configura la conexión a sensores IoT:

Broker URLDirección wss:// del broker MQTT
UsuarioCredencial MQTT
PasswordCredencial MQTT
Prefijo topicej: granja/ (se suscribe a granja/sensors/#)

Umbrales de alerta

Stock mínimo alimentoEn kg — genera alerta si baja de este valor
Mortalidad máximaEn % — genera alerta si supera este valor
Días anticipación vacunasCuántos días antes alertar por vacuna próxima

Checklist por defecto

Define las tareas que aparecen cada día en el módulo de Operaciones → Checklist.

  1. Escribe el nombre de una tarea
  2. Haz clic en "Agregar"
  3. Repite para cada tarea diaria
  4. Elimina tareas con el botón ✕

Gestión de datos

Exportar datos

Haz clic en "Exportar JSON" para descargar un archivo con TODOS los datos de tu granja. Esto incluye lotes, producción, sanidad, finanzas, bioseguridad — absolutamente todo.

Importar datos

Haz clic en "Importar JSON" y selecciona un archivo de respaldo. Los datos se cargan y reemplazan los actuales.

Restablecer datos

Haz clic en "Restablecer" para borrar TODOS los datos y volver al estado inicial. Requiere doble confirmación.

Antes de restablecer, SIEMPRE exporta un respaldo. Los datos eliminados no se pueden recuperar.

Estadísticas

Al final de la sección de configuración verás el conteo de registros por categoría (lotes, registros de producción, vacunas, etc.).

Tips y Mejores Prácticas

Registro diario

  • Registra la producción todos los días, idealmente a la misma hora. La consistencia mejora la precisión de las predicciones
  • Usa el Modo Campo en el gallinero para registrar rápido, y completa los detalles después en la oficina
  • Registra el consumo de alimento diariamente para obtener un FCR preciso
  • No olvides registrar las muertes — son cruciales para el cálculo de mortalidad y alertas

Salud y prevención

  • Mantén el calendario de vacunas al día — las vacunas vencidas no solo generan alertas, también incrementan el riesgo calculado por la IA
  • Registra los eventos de estrés cuando ocurran — ayuda a correlacionar caídas de producción
  • Revisa el Modo Veterinario antes de cada visita del vet para preparar la información
  • Siempre registra el período de retiro de medicamentos para evitar vender huevos contaminados

Bioseguridad

  • Registra TODOS los visitantes — especialmente si vienen de otras granjas
  • Mantén las zonas de desinfección actualizadas
  • Resuelve los avistamientos de plagas lo antes posible — el Pest Score es un buen indicador de acción
  • Completa los protocolos en su frecuencia — el sistema te avisa cuando están vencidos

Finanzas y planificación

  • Vincula los ingresos con clientes para poder analizar la rentabilidad por cliente
  • Revisa el resumen financiero mensualmente — el punto de equilibrio te dice cuánto necesitas producir para no perder dinero
  • Usa la planificación para compromisos grandes — la estimación automática por curva de raza es bastante precisa
  • Registra las cuentas por cobrar para no perder de vista las deudas de clientes

Datos y respaldo

  • Exporta tus datos regularmente (al menos una vez por semana). Los datos están en localStorage del navegador — si borras datos del navegador, pierdes todo
  • Guarda los archivos JSON de respaldo en un lugar seguro (USB, nube, otro dispositivo)
  • Si usas la plataforma en varios dispositivos, puedes exportar de uno e importar en otro para sincronizar
EGGlogU guarda todo en localStorage del navegador. Si limpias los datos del navegador o cambias de equipo, necesitarás importar un respaldo. Haz respaldos frecuentes.

IA y pronósticos

  • Los modelos predictivos necesitan mínimo 14 días de datos para funcionar
  • Mientras más datos acumules, más precisos serán los pronósticos
  • El semáforo de riesgo de brote considera 7 factores — si está en rojo, revisa las recomendaciones específicas que genera
  • Las anomalías detectadas no siempre son problemas — pueden ser días festivos, errores de registro, o eventos puntuales. Pero siempre vale la pena verificar

Ambiente e IoT

  • Si no tienes sensores IoT, registra las condiciones ambientales manualmente al menos cada 2-3 días
  • Configura el API del clima — la información de THI es clave para anticipar estrés por calor
  • Si tienes sensores MQTT, el módulo IoT puede recoger datos en tiempo real y guardarlos con un clic

EGGlogU 360 — Gestión Avícola Inteligente

Manual de Usuario v1.0 — 2026