---
id: "DOD-IA"
title: "Definition of Done - Inmobiliaria Analytics"
type: "Process Document"
version: "1.0.0"
status: "Active"
created_date: "2026-01-04"
updated_date: "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

```markdown
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

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

### Bug

```markdown
- [ ] 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](./DEFINITION-OF-READY.md)
- [Board.md](../planning/Board.md)
- [config.yml](../planning/config.yml)

---

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