📋 Planilla Diaria del Productor
La planilla diaria es donde se registra la producción de huevos, alimento y bajas de cada granja, día a día dentro de la semana. Las semanas se muestran en orden cronológico, igual que en los reportes Excel.
Clave de edición 🔒
Los datos están protegidos por defecto. Para modificarlos:
- El botón 🔒 Bloqueado (rojo) está visible en la barra de tabs del productor.
- Hacé clic en él — o directamente en cualquier campo — para que aparezca el modal de contraseña.
- Ingresá la contraseña de administrador y presioná Confirmar.
- El botón cambia a 🔓 Edición activa (verde) y todos los campos quedan habilitados para esa sesión.
- Para volver a bloquear, clic en el botón verde. Al cerrar sesión el bloqueo se restablece automáticamente.
Columnas de la planilla
| Campo | Qué se ingresa | Calculado automático |
|---|
| Huevos | Cantidad de huevos recolectados ese día | — |
| Bolsas | Bolsas de alimento consumidas (1 bolsa = 25 kg) | KG = bolsas × 25 |
| Bajas | Aves muertas ese día | — |
| Aves | — | Aves iniciales − bajas acumuladas |
| % Post. | — | (huevos/día ÷ aves) × 100 |
| Grs/Ave | — | (kg × 1000) ÷ aves |
| Observaciones | Texto libre por semana (no por día) | — |
¿Por qué a veces veo dos números en Kg o Grs/Ave? 🔢
En el Excel de referencia, las columnas "KG" y "GRS/AVE" de la planilla diaria no son el consumo de ese día puntual: son un acumulado que se reinicia cada semana (día 1 = consumo de ese día, día 2 = día 1 + día 2, ..., día 7 = total de la semana). Para que la app muestre exactamente lo mismo que el cliente ya conoce del Excel, esa celda aparece igual acá — grande, tal cual el Excel — con el consumo real de ese día puntual (el que usa la app para todos los cálculos internos, gráficos y alertas) chico entre paréntesis, solo cuando son distintos.
Ejemplo: si un día muestra 4.350 kg (750), el 4.350 es el acumulado de la semana hasta ese día tal como lo muestra el Excel, y el 750 entre paréntesis es lo que realmente se consumió ese día puntual.
Fila de TOTALES y FCR semanal
Al final de cada bloque semanal aparece una fila ↳ TOTALES (fondo coloreado) que muestra:
- Total huevos de la semana, bolsas, kg, bajas.
- % Postura promedio semanal.
- Grs/Ave — consumo diario promedio por ave en la semana.
- FCR — conversión alimenticia de la semana (kg alimento ÷ cajones producidos). Verde si < 1.8, rojo si > 2.5.
El bar Total del lote debajo de la tabla muestra el acumulado histórico de huevos y kg de alimento desde crianza hasta hoy.
Primera semana de postura
Si el sistema detecta que es la primera semana con huevos y el % de postura es menor al 5%, muestra un aviso amarillo:
🐣 Primera semana de postura — puede incluir huevos acumulados de crianza.
Esto ocurre porque los lotes que vienen de crianza pueden llegar con varios días de huevos acumulados, generando un pico inicial que no es representativo de la producción regular.
📦 Stock e Inventario de Huevo
El tab de inventario registra semanalmente los huevos entregados al camión y el stock real en la granja. Se actualiza una vez por semana, al cierre (generalmente jueves o viernes según el productor).
Columnas del inventario
| Columna | Qué significa | Origen |
|---|
| Producidos | Huevos producidos en la semana | Calculado de la planilla diaria |
| Entregados | Huevos que salieron al camión | Ingreso manual |
| Stock Teórico | Stock anterior + producidos − entregados | Calculado automático |
| Stock Real | Conteo físico real en la granja | Ingreso manual |
| Merma | Diferencia entre stock real y teórico (puede ser negativa por rotura, consumo interno, etc.) | Stock Real − Stock Teórico |
Cómo registrar el inventario semanal
- Desbloqueá la edición con la clave (botón 🔒 en la barra de tabs).
- Buscá la semana correspondiente en la tabla de inventario.
- Ingresá los Entregados (huevos que salieron al camión esa semana).
- Ingresá el Stock Real (conteo físico de la granja al cierre de la semana).
- Al salir del campo, el sistema guarda automáticamente y recalcula Stock Teórico y Merma.
🐣 Crianza / Recría
El módulo de Crianza sigue a las pollitas desde que nacen hasta que están listas para pasar a producción de huevo: seguimiento de peso vs. estándar, alimento y bajas, semana a semana. Cada lote de crianza tiene su propia fecha de nacimiento, de la que sale tanto el día de cierre semanal (mismo criterio que producción) como la edad que se muestra en cada registro.
Cómo pasa un lote de crianza a producción 🐔
- A partir de las 18 semanas de vida (edad de transición estándar para Hy-Line Brown) aparece un aviso amarillo arriba del panel del productor: "¡Lote listo para pasar a producción!". Es solo un recordatorio — no bloquea nada, el traslado se hace cuando el productor decida.
- El traslado se registra con el formulario "Traslado de Aves", indicando fecha y cantidad. Hay tres destinos posibles:
- Producción propia (el más común): cierra el lote de crianza y abre uno de producción para el mismo productor, heredando la fecha de nacimiento — así la edad y el día de cierre siguen siendo continuos entre las dos etapas, sin saltos.
- Producción de otro productor: las aves pasan directamente a postura, pero en otra granja.
- Crianza de otro productor: las aves siguen creciendo, todavía no pasan a postura — solo cambian de ubicación. Es lo que pasó, por ejemplo, cuando un lote de Vero se repartió y una parte terminó criándose en lo de Ramón.
- El traslado puede ser parcial: si se trasladan menos aves de las que hay disponibles, el lote de origen sigue activo con el resto — no hace falta vaciarlo entero de una sola vez.
Cómo se gestionan las altas y bajas de lotes
⚠️ Ojo con el nombre: "bajas" en la planilla diaria de crianza es la mortalidad del día (columna Bajas). "Dar de baja un lote" es otra cosa: cerrarlo porque ya no tiene más aves o porque se reemplazó. Son dos usos distintos de la misma palabra.
Alta de un lote de crianza pasa de dos formas:
- Automática: la primera vez que un productor carga un registro diario de crianza sin tener ya un lote activo, el sistema crea uno con fecha de nacimiento = la de ese primer registro.
- Manual: el administrador puede crear un lote de crianza para cualquier productor desde "Iniciar nueva crianza" en el panel de Crianza, indicando fecha de nacimiento y cantidad inicial de aves.
Baja (cierre) de un lote de crianza: se cierra automáticamente solo cuando se traslada la totalidad de las aves — si el traslado fue parcial, el lote sigue activo con la población que quedó. No se puede abrir un segundo lote de crianza activo para el mismo productor mientras el actual siga abierto (el sistema lo rechaza para evitar tener dos lotes activos al mismo tiempo, sin saber cuál es el vigente).
Baja (archivado) de un lote de producción: cuando un productor recibe un lote nuevo — desde su propia crianza o la de otro productor — el lote de producción activo anterior se archiva automáticamente, dejando registrada su población final antes de cerrarse.
Todo alta, traslado y cierre queda anotado en la trazabilidad del productor. El administrador puede ver el historial completo de todos los productores, sin entrar a cada login por separado, en Crianza → "Historial de Traspasos y Movimientos".
🗓 Seguimiento Semanal Multi-Granja
El tab "Seguimiento" en el panel de administrador ofrece una vista rápida de todas las granjas en la semana actual: producción, postura, FCR y estado general de cada productor de un vistazo.
Es útil para la revisión semanal operativa: ver de un vistazo qué granjas están bien, cuáles tienen desvíos y priorizar dónde actuar.
📊 Cuadro Consolidado Mensual
El cuadro consolidado es la vista principal del sistema. Muestra, semana a semana, todos los indicadores productivos de cada granja en paralelo. Hay 5 bloques semanales por mes. Cada columna es un productor; cada fila es un indicador.
¿Por qué a veces una celda muestra dos números? 🔢
Para que el cuadro refleje exactamente lo que el cliente ya conoce del Excel, varias filas (Bajas, % Bajas, Aves, Hue/Día, % Postura, Grs/Ave, Kg/Sem, FCR, FCR +/- y Calific.) muestran primero el valor tal cual aparece en el Excel de referencia de esa semana/productor — aunque a veces ese valor del Excel venga de una hoja auxiliar frágil (con celdas tipeadas a mano o fórmulas sin vincular) y no coincida exactamente con la cuenta que hace la app desde los registros diarios reales.
- Si ambos números coinciden, se ve uno solo.
- Si difieren, se ve el del Excel grande y el que calculó la app chico entre paréntesis, con un ícono de ayuda para el detalle.
- Al hacer clic en la celda (o en el número chico) se abre un panel que aclara explícitamente cuál es cuál y por qué pueden diferir.
Para todo lo demás (gráficos, alertas estadísticas, panel de análisis) la app siempre usa su propio cálculo — el número grande es solo para que esta vista puntual coincida visualmente con el Excel que el cliente ya conoce.
Cómo leer las filas
| Fila | Qué mide | Fórmula | Normal |
|---|
| EDAD | Semana de vida del lote | Calculada desde fecha de nacimiento del lote | Depende del lote |
| BAJAS | Aves muertas en la semana | Suma diaria de muertes | < 0.3% del lote / semana |
| % BAJAS | Tasa de mortalidad | (bajas ÷ aves al inicio) × 100 | ≤ 0.3% |
| AVES | Aves vivas al cierre | Aves previas − bajas semana | Decrecimiento lento |
| HUE/DÍA | Huevos/día promedio | Huevos semana ÷ días | Depende del tamaño del lote |
| % POSTURA ✔/⊛ | % de aves que ponen por día | (huevos ÷ aves) × 100 | Curva Hy-Line Brown — ver glosario |
| GRS/AVE | Alimento/ave/día | (kg × 1000) ÷ (aves × días) | 100–115 g/ave/día |
| KG/SEM | Total alimento consumido | Bolsas × 25 kg | Depende del tamaño del lote |
| FCR | Conversión alimenticia | kg ÷ (huevos ÷ 360) | 1.5–2.5 kg/caja (menor = mejor) |
| FCR +/- | Cambio vs semana anterior | +1 mejoró / −1 empeoró | Positivo = bueno |
| TRAZ/BIO | Eventos de control | Registros del módulo trazabilidad | Cuanto más, mejor |
| CALIFIC. ⭐ | Estrellitas por mortalidad | Escala 0–20 basada en % bajas | 20 = excelente |
| OBS | Observaciones del admin | Texto libre editable | – |
Íconos ✔ y ⊛ en % Postura
La curva genética Hy-Line Brown define el porcentaje de postura esperado para cada semana de vida del lote. El sistema compara automáticamente:
- ✔ (verde): La postura superó o igualó el estándar genético para esa edad. El lote está rindiendo bien.
- ⊛ (naranja): La postura está por debajo del estándar. El lote no está rindiendo lo esperado para su edad.
Esta comparación es más exigente que el badge σ, porque compara contra un estándar externo (Hy-Line), no contra el historial propio del productor.
Cómo usar el Cuadro Consolidado paso a paso
- Seleccioná el mes en el selector "Mes de Análisis" arriba a la derecha.
- El cuadro muestra 5 bloques semanales. Cada bloque tiene todos los indicadores para esa semana.
- La columna Total / Promedio (azul) muestra el agregado de todas las granjas.
- Hacé clic en el ícono ⓘ de cualquier fila para ver la explicación de ese indicador.
- Hacé clic en un badge ▲/▼σ (si aparece) para ver el análisis estadístico de esa celda.
- Completá las observaciones semanales y presioná "Guardar" al final de esa fila.
📈 Panel de Análisis Dinámico
El panel de Análisis permite explorar tendencias, comparar productores y descubrir correlaciones entre variables en cualquier período.
Cómo usar los filtros
- Período (desde / hasta): Seleccioná el rango de meses a analizar. Podés elegir un solo mes o varios meses consecutivos para ver tendencias largas.
- Métrica: La variable que querés visualizar en el gráfico. Incluye todas las métricas del sistema más las Variables Dinámicas numéricas que hayas creado.
- Productores: Marcá los que querés comparar. Podés seleccionar varios a la vez.
- Clic en "Analizar" para generar todos los gráficos y tablas.
Cómo leer el Gráfico de Tendencias
- Eje X: Tiempo (cada punto es una semana del período seleccionado, ej: "OCTUBRE 2024 S1").
- Eje Y: El valor de la métrica elegida.
- Línea sólida: Valores reales registrados semana a semana.
- Línea discontinua (mismo color): Tendencia calculada por regresión lineal. Muestra hacia dónde se dirige la métrica filtrando el ruido semanal. Si sube, la métrica mejora/empeora en general, aunque haya semanas irregulares.
Cómo leer la Tabla Resumen
| Columna | Qué significa |
|---|
| Promedio | Media del período. Cuánto promedió el productor en la métrica elegida. |
| Mín. / Máx. | El peor y el mejor valor semanal del período. |
| Tendencia ↑↓→ | Dirección de la regresión lineal. El número es el cambio promedio por semana (ej: +0.05 = sube 0.05 unidades por semana). |
| R² | Qué tan regular es la tendencia. 100% = sube/baja perfectamente constante. 20% = hay mucho ruido y la tendencia no es confiable. Por encima de 50% ya es significativa. |
| Total huevos / bajas | Acumulado real del período seleccionado para el productor. |
Cómo leer la Matriz de Correlación (Pearson r)
La matriz muestra si dos métricas tienden a moverse juntas durante el período analizado. El coeficiente r va de −1 a +1:
- Verde intenso (r cerca de +1.0): Correlación positiva fuerte — cuando una sube, la otra también sube.
- Rojo intenso (r cerca de −1.0): Correlación negativa fuerte — cuando una sube, la otra baja.
- Gris (r cerca de 0): Sin relación detectable.
- Negrita: Correlación fuerte (|r| ≥ 0.7). Merece atención.
Ejemplos de correlaciones típicas que podés encontrar:
- % Postura ↔ FCR: correlación negativa fuerte (cuando produce más, convierte mejor).
- % Bajas ↔ % Postura: correlación negativa (más mortalidad = menos producción).
- Temperatura (variable dinámica) ↔ % Bajas: si hay correlación positiva, el calor afecta la salud del lote.
🔔 Alertas Estadísticas (z-score σ)
El sistema calcula automáticamente el historial de cada productor en cada métrica y detecta semanas inusualmente buenas o malas comparado con su propia media histórica.
¿Qué es un z-score?
El z-score mide cuántas desviaciones estándar (σ) se aleja un valor de su promedio histórico.
- z = 0: El valor está exactamente en el promedio del productor.
- z = +2σ: El valor está 2 desviaciones por encima — mejor de lo habitual.
- z = −2σ: El valor está 2 desviaciones por debajo — peor de lo habitual.
- |z| ≥ 2: Ocurre en menos del 5% de las semanas normales. Estadísticamente significativo.
- |z| ≥ 3: Ocurre en menos del 0.3% de las semanas. Evento muy excepcional.
Cómo leer los badges ▲/▼σ en el cuadro
- ▲1.9σ verde (% Postura): La postura esta semana fue 1.9σ mejor que la media histórica del productor. Semana excepcionalmente buena.
- ▼2.3σ rojo (% Bajas): La mortalidad fue 2.3σ peor que su media. Mortalidad anormalmente alta — investigar.
- ▲2.1σ rojo (FCR): El FCR subió 2.1σ — conversión inusualmente mala. Las aves consumieron mucho más para la misma producción.
- Sin badge: El valor está dentro del rango normal del productor (desvío < 1.8σ).
Hacé clic en cualquier badge para ver el panel de detalle con: valor actual, promedio histórico, desviación estándar, rango normal y una interpretación en texto.
Alertas automáticas en el Panel de Análisis
Al ejecutar un análisis, el sistema lista automáticamente todas las semanas del período donde algún productor tuvo un desvío ≥ 2σ. Las alertas aparecen ordenadas por magnitud (las más extremas primero) con chips de color verde/rojo.
¿Por qué comparar con el historial propio y no con un estándar genérico? Cada productor tiene condiciones únicas (instalaciones, clima, agua). Un valor que es normal para una granja puede ser anormal para otra. El z-score captura esto automáticamente.
🚚 Módulo del Camión
El módulo Camión registra la cantidad de cajones de huevos que el camión de retiro recibe en cada visita. Al cruzar estos datos con la producción declarada por el productor, el sistema detecta automáticamente diferencias.
Cómo registrar una entrega
- Ir al tab "Camión" en el panel del administrador.
- Seleccionar el productor que hizo la entrega.
- Ingresar la fecha del retiro.
- Ingresar la cantidad de cajones recibidos por el camión.
- Opcionalmente agregar una observación (ej: "llegaron 3 cajones rotos").
- Clic en "+ Guardar".
Cómo leer los Indicadores de Auditoría
El sistema compara automáticamente los cajones declarados por el productor (calculados de: huevos_semana ÷ 360) contra los cajones recibidos registrados por el camión.
| Indicador | Desvío | Qué significa |
|---|
| ✓ Normal | < 3% | Diferencia dentro del margen de error esperado. Todo en orden. |
| ⚠ Revisar | 3–8% | Diferencia notable. Puede deberse a errores de registro, cajones incompletos, o merma en tránsito. Amerita verificación. |
| ⚑ Alerta de trazabilidad | > 8% | Diferencia importante. El productor declaró significativamente más cajones de los que el camión recibió. Requiere investigación. |
Los indicadores de auditoría también aparecen en el gráfico de trazabilidad dentro del Panel de Análisis cuando hay datos registrados.
📐 Variables Dinámicas
Las variables dinámicas permiten registrar cualquier dato adicional que no está en el sistema por defecto: temperatura del galpón, calidad del agua, resultados de vacunaciones, visitas veterinarias, etc.
Cómo crear una variable nueva
- Ir a Admin → tab "Productores y Usuarios".
- Bajar hasta la sección "Variables Dinámicas".
- Completar: Nombre (ej: Temperatura del galpón), Unidad (ej: °C), Tipo (Numérico para números, Texto para notas libres) y Descripción opcional.
- Clic en "+ Crear Variable".
Cómo cargar valores
- En la misma sección, seleccionar la variable en "Cargar Valor".
- Elegir el productor y la fecha de medición.
- Ingresar el valor correspondiente.
- Clic en "Guardar Valor".
Si cargás un valor para la misma variable + productor + fecha que ya existe, lo sobreescribe automáticamente.
Integración con el Panel de Análisis
Las variables numéricas aparecen automáticamente como opciones en el selector de métricas del tab "Análisis". Esto permite:
- Graficar la variable en el tiempo para cada productor.
- Ver su línea de tendencia (regresión lineal).
- Detectar si correlaciona con % Postura, % Bajas, FCR u otras variables en la Matriz de Correlación.
Ejemplo práctico: Si creás la variable "Temperatura máxima del galpón" y la cargás semana a semana, el sistema puede detectar automáticamente si hay correlación entre el calor y la caída de producción en cada granja específica.
📚 Glosario de Términos
| Lote | Grupo de aves de la misma edad y genética en una granja. Cada lote tiene su propio historial de producción. |
| Bolsa | Unidad de alimento balanceado. 1 bolsa = 25 kg. |
| Caja / Cajón | Unidad de venta de huevos. 1 cajón = 360 huevos = 30 docenas. |
| FCR | Feed Conversion Ratio — Índice de Conversión Alimenticia. Kg de alimento necesarios para producir 1 caja de 360 huevos. Menor = más eficiente. Se muestra en el card de estadísticas junto a los Grs/Ave/Día para interpretación rápida. |
| Grs/Ave/Día | Consumo diario promedio de alimento por ave (gramos). Fórmula: (kg alimento semanal × 1000) ÷ 7 ÷ nº aves. Aparece como subtítulo del FCR en las estadísticas y en cada fila de TOTALES semanal. |
| Merma | Diferencia entre el stock teórico (calculado) y el stock real (conteo físico) de huevos. Puede ser negativa por rotura, consumo interno o errores de conteo. Se registra en el módulo de inventario semanal. |
| Postura | Porcentaje de aves que ponen huevo en un día/semana determinado. |
| Curva Hy-Line Brown | Estándar genético de producción esperada semana por semana para esta raza de ponedoras. El sistema lo usa para calcular si el ✔ o el ⊛ aparece en % Postura. |
| Crianza | Etapa de cría de las pollitas (0–18 semanas) antes de entrar en producción. Tiene su propio módulo con seguimiento de peso, alimento y bajas. |
| σ (sigma) | Desviación estándar. Medida de cuánto varían los datos respecto a su promedio. A mayor σ, más dispersos son los datos. |
| z-score | Número de desviaciones estándar que un valor se aleja de la media histórica. z = (valor − media) ÷ desv.estándar. |
| Pearson r | Coeficiente de correlación lineal entre dos variables. Va de −1 (perfectamente opuestas) a +1 (perfectamente alineadas). |
| R² | Coeficiente de determinación. Indica qué porcentaje de la variación de una métrica se explica por la tendencia lineal. 100% = tendencia perfectamente lineal. |
| Regresión lineal | Técnica estadística que ajusta una línea recta a una serie de datos. Se usa para mostrar la tendencia general filtrando el ruido semana a semana. |