Definition of Done (DoD) ‐ Open Code - OpenCodeISPC/Sistema-de-Gestion-de-Mesas GitHub Wiki

Objetivo: Asegurar que cada tarea esté completamente terminada y cumpla con los estándares mínimos de calidad acordados por el equipo.

Alcance

Este DoD aplica a:

  • Tareas técnicas (TK)

  • Historias de Usuario (US)

  • Documentacion del PROYECTO (DOC)

  • Maquetado estático y responsive

  • Correcciones o mejoras

  • Documentación asociada a entregas

Para considerar un tarea finalizada, deberá cumplir los siguientes criterios en:

Tareas Técnicas / Desarrollo

  1. Código implementado y funcionando
  2. Revisión de código realizada
  3. Pruebas unitarias aprobadas
  4. Integración correcta en la rama principal sin conflictos y sigue la estructura de carpetas definida.
  5. Validación funcional por QA o usuario responsable
  6. Documentación técnica actualizada
  7. El código está correctamente versionado en Git y tiene mensajes de commit claros, atómicos y con prefijos.
  8. Se ejecutó Lighthouse y no se obtuvieron valores críticos (<60%) sin justificar.
  9. La vista o componente es responsive y funciona correctamente en distintos tamaños de pantalla.
  10. Sin efectos críticos abiertos
  11. El código está documentado internamente cuando es necesario:
  • Nombres claros, comentarios útiles.
  • Angular: Se usan comentarios JS Doc o similares para documentar componentes, servicios y métodos clave.
  • Django: Los modelos y vistas críticos tienen docstrings claros explicando su propósito y lógica.
  1. El código es limpio, legible y sigue las convenciones acordadas:
  • HTML semántico, buenas prácticas en CSS.
  • Angular: Se respeta la guía de estilo de Angular (estructura por módulos o feature). Los componentes son modulares y siguen el principio de responsabilidad única(SRP).
  • Django: Se siguen las convenciones de Django(estructura de apps, modelos, vistas, templates). Se utiliza el patrón MVT (Model-View-Template).

Tareas de Documentación (Wiki, DoD, ceremonias, manuales, readme)

  • El contenido está completo, claro y redactado correctamente.
  • Se usó vocabulario técnico apropiado y sin errores gramaticales ni ortográficos.
  • Está alojado en la ubicación correspondiente (Wiki, README).
  • Refleja el estado actual del proyecto a la fecha de entrega.
  • Fue revisado por otro miembro del equipo.