Producción — Modelo de módulos (referencia de producto)

Fuente: análisis de la "sábana" de Excel (hoja semanal por piscina) + validación del socio Winston Antonio Loaiza Jimenez (informe del 16-jun-2026). Esta es la fuente de verdad de los módulos de negocio; cada uno se documenta a detalle en su propio [modulo]-flow.md al implementarse.

Eje del modelo

La entidad central es el ciclo de producción de una piscina (siembra → engorde → cosecha), NO la hoja semanal. Cada dato se registra una vez en el momento en que ocurre; el reporte semanal (la sábana) se genera, no se llena. Prioridad del socio: trazabilidad absoluta de cada piscina desde su origen (historial robusto).

Módulos definitivos y orden de construcción

1. piscinas (+ sectores)

• Sector (catálogo por organización), código (T2, L20, PR1, PC T1), hectáreas, tipo (engorde | precriadero).
• Tope de libras/hectárea por piscina (capacidad de carga única por piscina; el sistema debe respetarlo/avisar en la planificación de biomasa).
• Equipos: alimentadores, hidrófonos (Shrimp Talk), aireadores eléctricos/mecánicos, HP. Soportar dos modalidades: equipos fijos por piscina o móviles (se trasladan entre piscinas según necesidad de oxígeno/biomasa). No hay regla única.

2. ciclos (siembra, llenado, transferencias)

• Siembra: fecha, cantidad de larvas, peso inicial, origen (precriadero PC o laboratorio directo), laboratorio, nauplio/raza, código genético. Derivados: densidad/ha, días de engorde, días vacío.
• Llenado de piscina: registrar el llenado correlacionado con los equipos de bombeo y acondicionamiento usados (tiempos + variación de equipos).
• Transferencias desde precriadero: flexibilidad total — parciales y completas. La piscina de origen puede quedar como "madre" o liberarse por completo para recibir un nuevo lote de postlarvas.

3. muestreos (biometría)

• Fecha, peso promedio (g), poblaciones (animales/m², "lo da el campo"), % sobrevivencia estimado (% Tec). Derivados: incremento, crecimiento/día, biomasa, lb/ha.
• Frecuencia: NO solo semanal. Muestreo de entre semana obligatorio (corrige alimentación/variables en tiempo real). Poblaciones: evaluación obligatoria cada aguaje (ventana de mayor actividad biológica).

4. alimentación

• Diaria (día a día), obligatoria. Registrar marca del balanceado + tipo de pellet, que progresa en el ciclo: 0.6 → 0.8 → 1.2 → 2 → 2.2.
• Derivados: semana, acumulado, kg/ha/día, FCR.
• Tabla de alimentación teórica referencial: la plataforma la provee y corre en paralelo con los datos reales de campo → análisis de desviación (Referencial vs Real), base para estimar supervivencia.

5. parámetros de agua 🆕

• Captura obligatoria de físico-químicos que NO van en la sábana tradicional: oxígeno disuelto, temperatura, salinidad (por piscina, en campo).

6. eventos / eventualidades 🆕

• Registro de mortalidades y cualquier contratiempo productivo bajo la nomenclatura "Eventos/Eventualidades", reflejado de inmediato para acceso de gerencia.

7. raleos y cosechas

• Raleo (pesca parcial): fecha, libras, peso promedio.
• Cosecha final: fecha exacta, libras totales, peso promedio, % sobrevivencia final (contraste estricto vs animales sembrados). Cierra el ciclo → la piscina queda "vacía".
• Sin destino de venta (confidencial; pertenece a Planta de Procesamiento/Exportaciones).

8. reporte semanal (la sábana digital)

• No se llena: SE GENERA. Misma estructura que el Excel (por sector, fila por piscina), siempre al día y exportable. Incluye el análisis de desviación (referencial vs real).

A futuro (post-consolidación)

• Tratamientos + costos: tratamientos sanitarios/bacterianos con costo individual por producto → costo de tratamiento por kg de biomasa producido. El socio pide consolidar primero la base estructural antes de habilitar este módulo financiero.

Acceso por cliente y permisos

• Módulos de campo (piscinas, ciclos, muestreos, alimentación, parámetros de agua, eventos, raleos/cosechas) → clients ["web","mobile"]; el reporte → principalmente web.
• Cada módulo agrega su entrada al catálogo RBAC (modulo:ver/crear/editar/eliminar/exportar).
• App móvil offline: registro local en campo sin señal + sincronización automática masiva al recuperar conectividad.