rckrdmrd
f570727617
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
227 lines
4.5 KiB
Markdown
227 lines
4.5 KiB
Markdown
---
|
|
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
|