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/[usuario]/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 un proyecto académico ambicioso que trasciende la complejidad típica de trabajos de titulación. La plataforma demuestra mis competencias en:

Valor Diferencial para Portfolio

Este proyecto destaca por:

• Dominio de arquitectura MVC: Implementé correctamente los patrones de Spring Boot sin over-engineering, manteniendo el código limpio y mantenible.

• Modelo de datos sofisticado: Diseñé relaciones complejas (Many-to-Many, One-to-Many) y las resolví elegantemente, demostrando profundidad en modelado de datos.

• Seguridad enterprise-grade: Implementé OAuth2 correctamente, no solo un login básico, asegurando que la plataforma proteja datos sensibles de manera profesional.

• Full-stack competency: Trabajé desde el frontend (HTML/CSS/JS) hasta el backend (Java), pasando por el diseño de una base de datos relacional coherente.

• Contexto real: El caso de uso agrícola es concreto y tangible, no un CRUD genérico de tutorial. Resolví un problema específico del sector agrícola colombiano.

Aplicabilidad Profesional

Las habilidades que demostré son directamente transferibles a roles como:

• Backend Developer: Dominio de Spring Boot, JPA y diseño de APIs REST robustas.

• Full-Stack Developer: Capacidad de implementar tanto frontend como backend en una sola plataforma coherente.

• Database Architect: Modelado de datos relacional con normalización correcta, asegurando integridad y eficiencia.

• DevOps Engineer: Containerización con Docker y deployment de aplicaciones Java en producción.

Este proyecto evidencia que no solo aprendí frameworks, sino que entendí conceptos fundamentales de arquitectura de software, seguridad y modelado de datos. DAYEN es exactamente el tipo de proyecto que reclutadores técnicos valoran: contextualizado en un problema real, bien ejecutado y con profundidad técnica demostrable.

Impacto en el Dominio Agrícola

Desde una perspectiva de negocio, DAYEN aborda un problema genuino en el sector agrícola colombiano donde la adopción tecnológica es baja. Un sistema de trazabilidad es más que un proyecto académico: es una herramienta que podría certificar cultivos sostenibles o asegurar trazabilidad para mercados premium, generando valor real para productores locales.

---

📊 Notas Adicionales

• Contexto SENA: Este proyecto de titulación demuestra el cumplimiento de estándares educativos en tecnología establecidos por la institución.

• Relevancia sectorial: AgriTech es un sector de alto crecimiento con adopción acelerada en Colombia, posicionando mis habilidades en un área de demanda creciente.

• Extensibilidad: La arquitectura que diseñé permite agregar módulos adicionales (predicción, IoT, analytics) sin reestructuración del sistema base.

• Aprendizaje continuo: Combiné tecnologías establecidas (Spring Boot, MySQL) con conceptos modernos (OAuth2, REST APIs), demostrando capacidad de adaptación.

• Responsabilidad social: DAYEN es una herramienta que puede impactar positivamente a pequeños y medianos agricultores, demostrando que desarrollo técnico puede ser aliado del desarrollo social.

Este proyecto demuestra que fui más allá de cumplir requisitos académicos: construí una solución técnica profesional aplicada a un problema real del sector productivo colombiano, listo para escalar y crecer.