inmobiliaria-analytics/docs/04-fase-backlog/DEFINITION-OF-DONE.md

id	title	type	version	status	created_date	updated_date
DOD-IA	Definition of Done - Inmobiliaria Analytics	Process Document	1.0.0	Active	2026-01-04	2026-01-04

Definition of Done (DoD)

Inmobiliaria Analytics

---

Proposito

Define los criterios que debe cumplir un item (User Story, Task, Bug) para ser considerado "terminado" y listo para produccion.

---

Checklist General

Un item esta Done cuando cumple TODOS los siguientes criterios:

Codigo

• Codigo implementado

  • Funcionalidad completa segun especificacion
  • Sin codigo comentado o debug
  • Sin console.log innecesarios

• Code review aprobado

  • Al menos 1 revisor aprobo
  • Comentarios de review atendidos
  • Sin conflictos de merge

• Sin warnings de linter

  • ESLint pasa sin errores
  • Prettier aplicado
  • TypeScript sin errores de tipo

• Commits limpios

  • Mensajes descriptivos
  • Formato convencional (feat/fix/docs...)
  • Sin commits de WIP

Testing

• Tests unitarios

  • Coverage minimo 80% del codigo nuevo
  • Todos los tests pasan
  • Casos edge cubiertos

• Tests de integracion

  • Endpoints probados
  • Flujos criticos cubiertos

• Tests E2E (si aplica)

  • Flujos de usuario probados
  • Sin regresiones

• Probado en ambiente de desarrollo

  • Funciona en ambiente local
  • Validado con datos de prueba

Documentacion

• API documentada (si aplica)

  • Swagger/OpenAPI actualizado
  • Ejemplos de request/response
  • Codigos de error documentados

• YAML front-matter actualizado

  • status: "Done"
  • completed_date: "YYYY-MM-DD"

• Notas de implementacion

  • Decisiones tecnicas documentadas
  • Cambios de diseno registrados

• _MAP.md actualizado (si aplica)

  • Nuevos archivos agregados
  • Estados actualizados

Deploy

• Build exitoso

  • npm run build sin errores
  • Sin warnings criticos

• Deploy a staging (si aplica)

  • Despliegue automatico funciona
  • Configuracion correcta

• Smoke tests pasados

  • Funcionalidad basica verificada
  • Sin errores 500

---

Checklist por Tipo

User Story

Codigo:
- [ ] Implementacion completa de todos los criterios de aceptacion
- [ ] Code review aprobado
- [ ] Sin deuda tecnica nueva (o documentada)

Testing:
- [ ] Tests unitarios (>80% coverage nuevo codigo)
- [ ] Tests de integracion para endpoints
- [ ] Casos de error manejados

Documentacion:
- [ ] API documentada en Swagger
- [ ] US marcada como "Done" con fecha
- [ ] Notas de implementacion agregadas

Validacion:
- [ ] Demo al PO (si requerido)
- [ ] Todos los CA verificados

Task

- [ ] Tarea completada segun descripcion
- [ ] Sin efectos secundarios no documentados
- [ ] Tests relevantes actualizados
- [ ] TASK marcada como "Done"
- [ ] Horas reales registradas

Bug

- [ ] Bug corregido y verificado
- [ ] No reproduce con pasos originales
- [ ] Test de regresion agregado
- [ ] Sin efectos secundarios
- [ ] Root cause documentado
- [ ] BUG marcado como "Done"

---

Proceso de Validacion

1. Desarrollador completa implementacion
2. Desarrollador verifica checklist DoD
3. Crea Pull Request
4. Revisor valida codigo y tests
5. Si cumple DoD:
   a. Merge a branch principal
   b. Actualizar status a "Done"
   c. Mover en Board.md a "Hecho"
6. Si NO cumple:
   a. Comentarios en PR
   b. Desarrollador corrige
   c. Volver a paso 3

---

Excepciones

Se permiten excepciones documentadas para:

1. Hotfixes P0: Pueden diferir tests a siguiente Sprint
2. Prototipos/POC: Menor coverage requerido
3. Refactors masivos: Review por Tech Lead

En estos casos:

• Documentar excepcion en el item
• Crear TASK de seguimiento para completar
• Registrar en deuda tecnica

---

Metricas

Metrica	Objetivo
Items que cumplen DoD	100%
Coverage promedio	>80%
PRs rechazados por DoD	<5%
Bugs post-deploy	<2 por sprint

---

Niveles de Done

Done-Done (Desarrollo)

• Codigo completo y revisado
• Tests pasando
• Documentacion actualizada

Done-Done-Done (Staging)

• Desplegado en staging
• Smoke tests pasados
• QA validado

Done-Done-Done-Done (Produccion)

• Desplegado en produccion
• Monitoreado por 24h
• Sin incidentes

---

Referencias

• DEFINITION-OF-READY.md
• Board.md
• config.yml

---

Documento: Definition of Done Version: 1.0.0 Estado: Active Ultima actualizacion: 2026-01-04