Poultry Track
Sistema de Gestión Integral Avícola con Arquitectura Modular DDD
ERP vertical para la agroindustria avícola que automatiza el seguimiento de lotes de cría, curvas de mortalidad, consumo de alimento, inventario de medicamentos, almacenes y ventas. Construido para resolver un problema operativo real del sector productivo.
Tecnologías y Patrones
- Laravel
- React
- TypeScript
- PostgreSQL
- DDD
- Modular Architecture
- Docker
Ingeniería & Límites de Dominio
Arquitectura del Sistema
Monolito modular modelado según Domain-Driven Design (DDD). Cada bounded context (Cría, Almacén, Inventario, Comercial) cuenta con entidades y agregados independientes sobre PostgreSQL.
Puntos Clave de la Arquitectura
- Modelado de dominio biológico: cálculo preciso de índices de conversión alimenticia y tasas de supervivencia.
- Separación en módulos desacoplados (Cría, Almacenes, Inventario, Ventas) para evitar dependencias cruzadas.
- Manejo de transacciones ACID estrictas para despachos de inventario y liquidación de lotes.
- Contenedorización integral con Docker para despliegue reproducible en servidores locales o cloud.
Ecosistema
Stack Tecnológico Detallado
Laravel + PHP 8.2
Arquitectura modular DDD con comandos, eventos de dominio y casos de uso.
React + TypeScript + Vite
Vistas operativas rápidas para captura de datos en campo y dashboards analíticos.
PostgreSQL
Motor relacional para manejo de transacciones concurrentes e histórico de lotes.
Docker + Docker Compose
Empaquetado y ejecución homogénea en desarrollo y producción.
Capacidades Operativas
Características Principales
Monitoreo diario de lotes de aves: mortalidad, consumo de alimento balanceado y peso estimado.
Control de inventario multialmacén: alimentos, vacunas y suministros con puntos de reorden.
Módulo de comercialización y ventas con cálculo de margen operativo por lote finalizado.
Dashboard analítico con gráficos de rendimiento y proyecciones de cosecha avícola.
Diseño modular que permite incorporar nuevas etapas de producción sin tocar módulos existentes.
Ingeniería Real & Aprendizaje
Retos Técnicos & Lecciones Aprendidas
Decisiones de arquitectura tomadas bajo presión operativa y el criterio destilado en producción.
Complejidad Operativa
Gestionar reglas de negocio agroindustriales altamente variables (curvas de mortalidad biológica, conversiones de alimento balanceado, mermas de almacén) propensas a romper cálculos contables.
Arquitectura & Diseño
Desacoplé la lógica biológica y de inventario en Bounded Contexts independientes con Domain-Driven Design, separando las fórmulas matemáticas del ORM y la persistencia en PostgreSQL.
Criterio en Producción
El acoplamiento temprano al framework es el principal generador de deuda técnica en Laravel. Mantener las reglas biológicas en código puro PHP permitió modificarlas sin tocar la base de datos.
Decisiones de Diseño
Resolución & Enfoque Técnico
Nació para resolver los desajustes de costos e inventario en granjas de familiares y amigos del sector avícola.
Aplica el enfoque de Clean Architecture para permitir que las reglas de negocio biológicas y contables permanezcan aisladas del framework.
¿Deseas examinar el repositorio?
El repositorio público contiene el historial de commits, pruebas y estructura modular.