Gestión del Proyecto y Tareas
Plataforma Oficial: Monday.com
Metodología: Kanban de Ingeniería
Este documento establece las reglas para la creación, asignación y seguimiento de tareas técnicas. El objetivo es asegurar que ninguna línea de código se escriba sin una definición previa en esta documentación.
1. Relación entre Gestión y Documentación
Para mantener una Documentación Viva, existe una dependencia obligatoria entre nuestras herramientas:
| Fase | Actividad en Monday | Requisito en Docusaurus |
|---|---|---|
| Definición | Crear Ticket en columna "Definición" | Redactar Reglas de Negocio y flujo lógico. |
| Diseño | Adjuntar link de Figma al ticket | Vincular Embed de Miro en la página de producto. |
| Desarrollo | Mover ticket a "Ready for Dev" | El ticket debe tener el link a su especificación en Docusaurus. |
| Cierre | Mover a "Done" | Actualizar el documento técnico con cambios finales de implementación. |
2. Estándar de creación de Tickets (Plantilla)
Cada tarea creada en la plataforma de gestión debe seguir este formato para evitar ambigüedades:
Título: [ID-Técnico] Nombre de la funcionalidad
1. Definición (User Story):
Como [rol], quiero [acción] para [beneficio].
2. Enlaces de Verdad Única (Obligatorio):
- 📖 Documentación:
[Link a la página exacta en Docusaurus] - 🎨 Diseño:
[Link a Figma/Miro]
3. Criterios de Aceptación:
- El sistema debe validar X...
- Se debe mostrar error Y...
3. Definición de Listo (DoR) y Hecho (DoD)
Definition of Ready (DoR) - "Para empezar a programar"
Una tarea entra a LISTO PARA DESARROLLO solo si:
- El flujo lógico en Miro está aprobado.
- Los campos de base de datos están definidos en el Modelo de Dominio.
- El contrato de API (endpoints sugeridos) está escrito en Docusaurus.
Definition of Done (DoD) - "Para dar por terminada"
Una tarea está TERMINADA solo si:
- El código pasa las pruebas de QA.
- Se ha actualizado la documentación si hubo cambios en la lógica durante el desarrollo.
- El Swagger (OpenAPI) refleja los nuevos endpoints y está actualizado.
4. Roles en la Gestión
- Tech Lead: Supervisa que los tickets cumplan con el DoR.
- Desarrollador: Responsable de actualizar el estado en Monday y reportar discrepancias con la documentación.
- QA: Valida el ticket contra los criterios de aceptación escritos en Docusaurus.