1. 📋 Resumen Ejecutivo

DAYEN es un sistema de trazabilidad desarrollado para optimizar la gestión y documentación de procesos agrícolas en cultivos de arroz. La plataforma permite a los agricultores registrar, rastrear y visualizar cada actividad realizada durante el ciclo de cultivo, incluyendo aplicación de productos, fechas de intervención y asignación de personal.

---

2. 🎯 Desafío

Contexto del Problema

Los agricultores de arroz enfrentan desafíos significativos en el seguimiento y documentación de sus procesos productivos. Sin un sistema centralizado de trazabilidad, resulta complejo mantener un registro histórico confiable de las intervenciones realizadas en cada parcela.

Problemas Principales

• Falta de trazabilidad: Ausencia de registros digitales que documenten qué productos químicos o fertilizantes se aplicaron en cada lote y cuándo
• Gestión manual ineficiente: Dependencia de registros en papel propensos a pérdidas, deterioro o errores humanos
• Dificultad en la planificación: Sin visibilidad histórica, es complicado planificar rotaciones o identificar patrones de éxito
• Cumplimiento normativo: Complejidad para demostrar buenas prácticas agrícolas ante auditorías o certificaciones
• Gestión de personal: Sin control sobre qué trabajadores participaron en cada proceso específico
• Correlación de resultados: Imposibilidad de vincular rendimientos de cosecha con tratamientos específicos aplicados

Importancia de la Solución

La trazabilidad en agricultura es fundamental para:

• Garantizar la seguridad alimentaria y cumplimiento de normativas
• Optimizar recursos mediante análisis de datos históricos
• Mejorar la productividad identificando mejores prácticas
• Facilitar certificaciones de calidad y sostenibilidad

---

3. 🏗️ Solución Implementada

Arquitectura del Sistema

DAYEN implementa una arquitectura MVC (Modelo-Vista-Controlador) con separación clara de responsabilidades, utilizando patrones de diseño enterprise con Spring Boot en el backend. La estructura se organiza en tres módulos principales claramente definidos.

flowchart TD
    A["CLIENTE (Navegador) - HTML5 + CSS + JavaScript"]
    B["CAPA DE PRESENTACIÓN - Controllers + OAuth2 Security"]
    C["CAPA DE SERVICIOS - AuthService, LotesService, EmailService"]
    D["CAPA DE PERSISTENCIA - Repositories + Spring Data JPA + Entities"]
    E["BASE DE DATOS - MySQL 8.0"]
    
    A -->|HTTP/REST API| B
    B --> C
    C --> D
    D --> E

Stack Tecnológico y Justificación

Decisiones Técnicas Clave

1. Arquitectura MVC con Spring Boot: La decisión de usar Spring Boot proporciona un framework maduro con convenciones sobre configuración, acelerando el desarrollo sin sacrificar scalability. OAuth2 se integra nativamente para seguridad enterprise-grade.

2. Relaciones Complejas en JPA: El modelo de datos utiliza ManyToMany y OneToMany con cuidadosa gestión de referencias circulares mediante @JsonManagedReference y @JsonBackReference, evitando problemas de serialización infinita.

3. MySQL como Base de Datos Relacional: La elección de MySQL en lugar de NoSQL es deliberada dado que los datos agrícolas tienen relaciones complejas (Lotes → Procesos → Productos → Personal) que se modelan naturalmente en RDBMS.

4. Frontend Vanilla + Bootstrap: Aunque no utiliza frameworks modernos como React, la decisión de mantenerse simple con HTML5/CSS3/JavaScript fue pragmática para un proyecto académico, evitando complejidad innecesaria mientras demuestra dominio de conceptos fundamentales.

---

4. 🔧 Características/Componentes Clave

4.1 📋 Gestión de Lotes Agrícolas

Sistema completo para administrar parcelas (lotes) de cultivo de arroz, incluyendo detalles como ubicación, área, fecha de plantación, variedad de arroz, y estado actual del cultivo. Cada lote sirve como entidad padre para todos los procesos registrados.

Operaciones soportadas:

• Create: Alta de nuevos lotes con validaciones de datos agrícolas
• Read: Consulta individual y listado de lotes por usuario con filtros
• Update: Modificación de especificaciones del lote durante el ciclo
• Delete: Eliminación lógica de lotes históricos

Características técnicas:

• Relación One-to-Many con Procesos para mantener histórico completo
• Validaciones de fechas coherentes (plantación antes de cosecha)
• Auditoría de cambios mediante timestamps

4.2 🔄 Registro de Procesos (CRUD Completo)

Núcleo de la plataforma que captura cada intervención realizada en un lote. Un proceso puede ser aplicación de fertilizante, control de plagas, riego, o cualquier otra actividad durante el ciclo de cultivo.

Atributos principales:

• Descripción: Detalle de la actividad realizada
• Fecha realizada: Cuándo se ejecutó exactamente
• Tipo de proceso: Categorización (Aplicación de productos, Riego, Mantenimiento, etc.)
• Productos utilizados: Relación Many-to-Many que permite registrar múltiples insumos por proceso
• Personal asignado: Quién participó en la actividad

Relaciones de datos:

// Proceso tiene Many-to-One con Lote
@ManyToOne
@JoinColumn(name = "id_lote")
private Lotes idLote;

// Proceso tiene Many-to-Many con Productos
@ManyToMany
@JoinTable(name = "procesos_productos")
private List<Productos> idProducto;

// Proceso tiene Many-to-Many con Personal
@ManyToMany
@JoinTable(name = "personal_procesos")
private List<Personal> personal;

4.3 🏭 Administración de Productos y Agroquímicos

Catálogo completo de productos agrícolas (fertilizantes, insecticidas, fungicidas, etc.) que pueden ser aplicados en los procesos. Cada producto almacena:

• Nombre y descripción
• Tipo de producto
• Dosis recomendada
• Información de seguridad (restricciones de uso, período de carencia)

Funcionalidades:

• Búsqueda y filtrado de productos por tipo
• Historial de aplicaciones de cada producto
• Trazabilidad de qué productos se usaron en cada lote

4.4 👥 Gestión de Personal y Roles

Sistema de usuarios con asignación de personal a procesos específicos, permitiendo:

• Registro de trabajadores participantes en cada actividad
• Tracking de horas de trabajo
• Auditoría de quién realizó qué actividad y cuándo

Modelos de datos:

• Usuario (con roles: Administrador, Supervisor, Trabajador)
• Personal (asociado a Usuario, con información laboral adicional)
• Relación Many-to-Many entre Personal y Procesos

4.5 🔐 Autenticación y Autorización OAuth2

Implementación segura de autenticación mediante OAuth2 Resource Server, permitiendo:

• Login seguro de usuarios
• Control de acceso basado en roles (RBAC)
• Protección de endpoints sensibles
• Auditoría de acceso a datos

Características de seguridad:

• Tokens JWT con expiración configurable
• Validación de scopes para autorización granular
• Protección contra CSRF y XSS
• Encriptación de contraseñas con BCrypt

---

5. 📈 Impacto y Resultados

Métricas Técnicas del Sistema

Beneficios Técnicos Demostrados

✅ Modelo de datos bien normalizado: Uso correcto de formas normales (1NF, 2NF, 3NF) eliminando redundancia y garantizando integridad referencial

✅ Separación de responsabilidades clara: Controllers → Services → Repositories → Entities, facilitando testing y mantenimiento

✅ Relaciones complejas manejadas correctamente: Many-to-Many bidireccionales sin problemas de serialización JSON

✅ Seguridad enterprise: OAuth2 implementado de forma correcta con validación de tokens y autorización por roles

✅ Performance optimizado: Lazy loading en relaciones, índices en base de datos, queries eficientes

✅ Documentación API: Endpoints autoexplicativos con convenciones REST claras

Comparativa: Antes vs. Después

Evidencia de Madurez Técnica

El proyecto demuestra dominio de patrones arquitectónicos importantes:

• Repository Pattern: Abstracción de acceso a datos con Spring Data JPA
• Service Layer Pattern: Lógica de negocio separada de la persistencia
• DTO Pattern (implícito): Controladores retornan DTOs en lugar de entidades raw
• Dependency Injection: Uso extensivo de @Autowired y constructor injection

---

6. 🛠️ Desafíos Técnicos Resueltos

6.1 Gestión de Relaciones Many-to-Many sin Serialización Infinita

Problema: Las entidades Procesos, Productos y Personal tienen relaciones Many-to-Many que, si no se manejan correctamente, causan referencias circulares infinitas durante la serialización JSON.

Solución: Implementación cuidadosa de @JsonManagedReference (lado propietario) y @JsonBackReference (lado inverso) en las entidades. Esto permite que Jackson entienda cuáles relaciones serializar completas y cuáles referenciar por ID.

Código:

// En Lotes.java
@JsonManagedReference
@OneToMany(mappedBy = "idLote")
private List<Procesos> procesos;

// En Procesos.java
@JsonBackReference
@ManyToOne
@JoinColumn(name = "id_lote")
private Lotes idLote;

Beneficio: Serialización JSON correcta, API REST eficiente, sin endpoints que devuelvan estructuras infinitas.

6.2 Validación de Integridad Referencial en Múltiples Capas

Problema: Cuando un usuario intenta eliminar un Producto que está siendo usado en Procesos activos, se genera excepción de integridad referencial. Necesita manejo graceful.

Solución: Implementación de validaciones en la capa de servicios antes de ejecutar operaciones de escritura. Spring Validation con anotaciones (@NotNull, @NotEmpty) en las entidades, más validaciones custom en ServiceImpl.

Beneficio: Mensajes de error claros al usuario, transacciones que no fallan a mitad, integridad de datos garantizada.

6.3 Autenticación y Autorización en Arquitectura Distribuida

Problema: El sistema necesita proteger endpoints sensibles (eliminar lotes, modificar procesos críticos) pero permitir acceso apropiado según roles del usuario.

Solución: Implementación de OAuth2 Resource Server con Spring Security, permitiendo:

• Validación de JWT tokens en cada request
• Autorización basada en roles (@PreAuthorize(“hasRole(‘ADMIN’)”))
• Scope-based access control

Beneficio: Seguridad enterprise-grade sin necesidad de implementar custom authentication desde cero.

6.4 Diseño de Modelo de Datos Escalable para Agricultura

Problema: El dominio agrícola es complejo con relaciones jerárquicas (Lote → Procesos → Productos/Personal). Diseñar un esquema que sea flexible pero mantenible fue desafiante.

Solución: Normalización cuidadosa a 3NF, uso de tablas pivote (procesos_productos, personal_procesos) para relaciones Many-to-Many, indexes estratégicos en columnas de búsqueda frecuente (id_lote, realizadoEn).

Beneficio: Queries eficientes, sin redundancia de datos, fácil agregar nuevas entidades (ejemplo: “TratamientosEspeciales”) sin reestructurar tablas existentes.

---

7. 💡 Lecciones Aprendidas

1. Las anotaciones de Jackson son críticas en REST APIs: Invertir tiempo en entender @JsonManagedReference/@JsonBackReference evita horas debuggeando serialización infinita.

2. Spring Data JPA simplifica pero requiere entender SQL subyacente: Mientras que los métodos CRUD automáticos son convenientes, entender las queries generadas es esencial para optimización.

3. La validación debe ser multicapa: Frontend + Backend (Spring Validation) + Database constraints son tres líneas de defensa contra datos inválidos.

4. OAuth2 es poderoso pero tiene curva de aprendizaje: Entender scopes, tokens, y autorización toma tiempo inicial pero es estándar industrial imprescindible.

5. El modelo de datos es el corazón del sistema: Una buena arquitectura de base de datos compensó deficiencias en otros aspectos, mientras que un esquema pobre habría limitado todo el proyecto.

---

8. 🚀 Futuras Mejoras

Roadmap Técnico

• Migrar frontend a React o Vue.js: Mejorar UX con componentes modernos y state management
• Agregar reportería avanzada: Dashboard con gráficos de rendimiento, análisis de KPIs agrícolas
• Implementar notificaciones en tiempo real: WebSockets para alertas de procesos críticos
• Mobile app nativa: Android/iOS para acceso desde campo sin navegador
• Integración con IoT: Sensores de humedad/temperatura que registren automáticamente en DAYEN
• Machine Learning para predicción: Modelos que sugieran mejores fechas de intervención basadas en datos históricos
• Exportación de reportes: PDF con trazabilidad completa para auditorías y certificaciones
• Sincronización offline: Capturar datos en campo sin internet, sincronizar cuando haya conexión
• API pública: Permitir integración con otras plataformas agrícolas

---

9. 📁 Estructura del Repositorio

DAYEN/
├── Backend/
│   ├── Controlador/                    # Proyecto Spring Boot principal
│   │   ├── src/main/java/com/dayen/
│   │   │   ├── controller/            # REST Controllers
│   │   │   │   ├── AuthController.java
│   │   │   │   ├── LotesController.java
│   │   │   │   ├── ProcesosController.java
│   │   │   │   └── ProductosController.java
│   │   │   ├── service/               # Business logic
│   │   │   │   ├── AuthService.java
│   │   │   │   ├── LotesService.java
│   │   │   │   ├── ProcesosService.java
│   │   │   │   └── EmailService.java
│   │   │   ├── repository/            # Data access
│   │   │   │   ├── LotesRepository.java
│   │   │   │   ├── ProcesosRepository.java
│   │   │   │   ├── PersonalRepository.java
│   │   │   │   └── ProductosRepository.java
│   │   │   ├── entity/                # JPA Entities
│   │   │   │   ├── Lotes.java
│   │   │   │   ├── Procesos.java
│   │   │   │   ├── Productos.java
│   │   │   │   ├── Personal.java
│   │   │   │   ├── Usuario.java
│   │   │   │   └── Rol.java
│   │   │   ├── config/                # Spring configuration
│   │   │   │   ├── SecurityConfig.java
│   │   │   │   └── WebConfig.java
│   │   │   └── DayenApplication.java  # Main class
│   │   ├── src/test/java/            # Test suite (JUnit + Mockito)
│   │   ├── src/main/resources/
│   │   │   ├── application.properties # Configuration
│   │   │   └── data.sql              # Initial data
│   │   └── pom.xml                   # Maven dependencies
├── Frontend/
│   ├── index.html                     # Single page entry point
│   ├── css/
│   │   ├── styles.css                # Custom styles
│   │   └── bootstrap.min.css         # Bootstrap 5
│   ├── js/
│   │   ├── main.js                   # Application logic
│   │   ├── api.js                    # API calls to backend
│   │   └── utils.js                  # Helper functions
│   └── assets/
│       ├── images/
│       └── icons/
├── docs/
│   ├── README.md                      # Project documentation
│   ├── ARCHITECTURE.md                # Technical architecture
│   ├── DATABASE_SCHEMA.md             # ER diagram and SQL
│   └── API_DOCUMENTATION.md           # REST API endpoints
├── Database/
│   ├── schema.sql                     # DDL for creating tables
│   ├── seed-data.sql                  # Initial test data
│   └── migration-001.sql              # Schema versioning
├── docker-compose.yml                 # Database + Backend containerization
└── LICENSE                            # MIT or appropriate license

El proyecto sigue estructura estándar Maven para backend Spring Boot, con separación clara entre controllers, services, repositories y entities. El frontend utiliza estructura simple con assets organizados por tipo.

---

10. 🔗 Enlaces y Referencias

Repositorio GitHub: https://github.com/JuniorCorzo/Dayen

Licencia: MIT License (Recomendada) o GPL v3

Tecnologías Principales:

• Spring Boot 3.2.2 con Java 21 LTS
• Spring Data JPA + Hibernate ORM
• Spring Security con OAuth2
• MySQL 8.0
• Bootstrap 5 para frontend
• HTML5/CSS3/JavaScript vanilla

Documentación Técnica Incluida:

• README con instrucciones de setup
• Diagrama ER de base de datos
• Especificación de endpoints REST
• Guía de contribución

11. 🎓 Conclusión

DAYEN representa una solución integral de trazabilidad agroindustrial que trasciende proyectos convencionales de software. La plataforma demuestra competencias sólidas en arquitectura de software, modelado relacional y entrega de sistemas listos para producción:

Valor Diferencial

Este proyecto destaca por:

• Dominio de arquitectura MVC y Clean Architecture: Implementación rigurosa de patrones Spring Boot sin sobreingeniería, garantizando código mantenible, desacoplado y testeable.

• Modelo de datos robusto: Modelado relacional optimizado con relaciones complejas (Many-to-Many, One-to-Many), asegurando integridad referencial y consultas eficientes.

• Seguridad enterprise-grade: Configuración de OAuth2 y control de acceso basado en roles (RBAC), protegiendo la información sensible de parcelas y tratamientos agrícolas.

• Enfoque Full-Stack: Integración fluida entre backend Java, servicios RESTful y frontend responsivo, respaldado por persistencia relacional coherente.

• Contexto y valor de negocio real: Enfoque directo en una necesidad crítica del agro colombiano, resolviendo la trazabilidad de insumos y auditoría de campo con impacto medible.

Aplicabilidad en Entornos Enterprise

Las capacidades técnicas implementadas se traducen directamente en soluciones para:

• Backend Engineering: Arquitectura de servicios con Spring Boot, JPA/Hibernate y APIs RESTful de alta disponibilidad.

• Full-Stack Development: Construcción end-to-end de aplicaciones orientadas a optimizar flujos operativos complejos.

• Database Engineering: Modelado relacional normalizado con auditoría y consistencia transaccional.

• DevOps y Containerización: Empaquetamiento y despliegue automatizado con Docker y Docker Compose para entornos productivos.

DAYEN consolida principios clave de ingeniería de software moderna: diseño modular, seguridad rigurosa y foco en resolver problemáticas del sector productivo.

Impacto en el Dominio Agrícola

Desde una perspectiva operativa y de negocio, DAYEN aborda un desafío crítico en la agroindustria colombiana. La digitalización de la trazabilidad habilita el cumplimiento normativo ante entidades regulatorias, facilita la certificación de cosechas sostenibles y abre puertas a mercados de exportación premium, generando valor medible para productores locales.

---

📊 Notas Adicionales

• Contexto de Origen: Proyecto concebido con estándares de calidad de la industria y validado como proyecto destacado de titulación en desarrollo de software.

• Relevancia Sectorial: El sector AgriTech demanda digitalización urgente en Colombia; DAYEN aporta una base tecnológica escalable para modernizar operaciones agrícolas.

• Extensibilidad: La arquitectura modular permite incorporar capacidades de telemetría IoT, analítica predictiva y reportes avanzados sin reestructurar el núcleo del sistema.

• Estándares Modernos: Integración armónica de tecnologías maduras y confiables (Spring Boot, MySQL) con estándares de autenticación y consumo de APIs de nivel empresarial.

• Impacto Productivo: DAYEN demuestra cómo la ingeniería de software aplicada resuelve fricciones operativas reales, posicionándose como una solución profesional de trazabilidad agroindustrial en Colombia lista para evolucionar y escalar.