Proyecto académico de Administración de Sistemas para coordinar turnos y operaciones logísticas de la zafra azucarera. El objetivo es convertir el prototipo visual en una aplicación funcional con una API .NET, un frontend web y una integración controlada con WhatsApp mediante n8n.
AgroFlow/
|- openspec/ Especificaciones normativas y cambios propuestos
|- docs/ Producto, arquitectura, contratos y guías
|- backend/ API y persistencia
`- frontend/ Aplicación web
OpenSpec no reemplaza las carpetas de código. backend/ y frontend/ permanecen separados para que cada equipo trabaje con claridad, mientras openspec/specs/ define el comportamiento común que ambos deben respetar.
El código y los issues viven en este repositorio. Los tableros AgroFlow — Backend y AgroFlow — Frontend separan la planificación por área; no son repositorios distintos. El backlog del backend desglosa tareas de base compartida, endpoints del MVP y la integración n8n. Antes de implementar rutas propuestas en esos issues, hay que cerrar el contrato inicial y las decisiones pendientes en OpenSpec y OpenAPI.
La jerarquía documental del proyecto es:
openspec/specs/para comportamiento y criterios verificables.docs/contracts/para contratos técnicos compartidos.docs/architecture/decisions/para decisiones y sus motivos.docs/para contexto, diseño, planificación y guías.- Los README de cada componente para instalación y operación local.
Los documentos académicos originales son fuentes históricas. Una vez incorporado un requisito a OpenSpec, la especificación versionada es la referencia vigente.
- Leer la guía de incorporación.
- Consultar la visión y alcance del MVP.
- Usar la guía de aceptación del MVP para saber qué resultado es suficiente y qué evidencia conservar.
- Revisar el catálogo de casos de uso.
- Consultar la matriz de 61 reglas de negocio.
- Leer las políticas operativas del MVP y distinguirlas de los detalles todavía abiertos.
- Resolver las decisiones abiertas antes de implementar los puntos bloqueados.
- Leer el flujo de trabajo del equipo.
- Antes de cambiar comportamiento, crear un cambio en
openspec/changes/.
- El backend parte de una copia independiente de ICS2026-backend, commit
dc40f7cfa515a1425f8709c73ae917e9c004266a. - El frontend se integrará desde AgroFlow-Dashboard una vez estabilizado el contrato inicial.
- El backend heredado todavía conserva nombres y módulos del e-commerce original; no representa aún el dominio objetivo de AgroFlow.
No se deben versionar claves, credenciales ni datos personales. La clave JWT debe configurarse mediante variables de entorno o secretos de usuario de .NET.