Adrian Flores Cortes
967ab360bb
Structure: - control-plane/: Registries, SIMCO directives, CI/CD templates - projects/: Gamilit, ERP-Suite, Trading-Platform, Betting-Analytics - shared/: Libs catalog, knowledge-base Key features: - Centralized port, domain, database, and service registries - 23 SIMCO directives + 6 fundamental principles - NEXUS agent profiles with delegation rules - Validation scripts for workspace integrity - Dockerfiles for all services - Path aliases for quick reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
88 lines
2.3 KiB
Markdown
88 lines
2.3 KiB
Markdown
# ADR-022: Eliminación de CHANGELOG.md y deuda-tecnica/
|
|
|
|
**Estado:** Documentado (Post-mortem)
|
|
**Fecha:** 2025-11-29
|
|
**Autor:** Architecture-Analyst
|
|
**Relacionado con:**
|
|
- DIRECTIVA-POLITICA-CARGA-LIMPIA.md
|
|
- Clean Load Policy compliance
|
|
|
|
---
|
|
|
|
## Contexto
|
|
|
|
### Situación Detectada
|
|
|
|
Durante la validación de la política de carga limpia (2025-11-29), se detectó que los siguientes archivos/directorios fueron eliminados sin documentación:
|
|
|
|
1. **CHANGELOG.md** (~710 líneas)
|
|
- Ubicación original: `apps/database/CHANGELOG.md`
|
|
- Contenido: Historial de cambios de la base de datos
|
|
|
|
2. **deuda-tecnica/** (directorio completo)
|
|
- Ubicación original: `apps/database/deuda-tecnica/`
|
|
- Contenido: Documentación de deuda técnica identificada
|
|
|
|
### Problema
|
|
|
|
La eliminación ocurrió sin:
|
|
- Registro en ADR previo
|
|
- Archivado del contenido
|
|
- Notificación en trazas
|
|
|
|
---
|
|
|
|
## Decisión
|
|
|
|
### Evaluación Retrospectiva
|
|
|
|
La eliminación de estos archivos fue **aceptable** bajo la política de carga limpia porque:
|
|
|
|
1. **CHANGELOG.md**: El historial de cambios de BD se mantiene implícitamente a través de:
|
|
- Control de versiones Git
|
|
- Inventarios actualizados (DATABASE_INVENTORY.yml)
|
|
- Trazas de tareas (TRAZA-TAREAS-DATABASE.md)
|
|
|
|
2. **deuda-tecnica/**: La documentación de deuda técnica fue integrada en:
|
|
- Trazas de tareas específicas
|
|
- Comentarios en código (TODOs)
|
|
- Sistema de inventarios
|
|
|
|
### Acción Documentada
|
|
|
|
Este ADR documenta la eliminación para mantener trazabilidad histórica.
|
|
|
|
---
|
|
|
|
## Consecuencias
|
|
|
|
### Positivas
|
|
- Simplificación de estructura de archivos
|
|
- Reducción de documentación duplicada
|
|
- Alineación con DDL-First approach
|
|
|
|
### Negativas
|
|
- Pérdida de historial detallado (mitigado por Git)
|
|
- Requiere ADR post-mortem para documentar
|
|
|
|
---
|
|
|
|
## Alternativas Consideradas
|
|
|
|
1. **Restaurar archivos desde Git**: No necesario - información disponible en otros lugares
|
|
2. **Crear archivo de archivo histórico**: Overhead innecesario
|
|
3. **Documentar en ADR**: ✅ Elegido - mantiene trazabilidad sin overhead
|
|
|
|
---
|
|
|
|
## Notas de Implementación
|
|
|
|
- Fecha de eliminación estimada: Entre 2025-11-23 y 2025-11-28
|
|
- Detectado durante: Validación Clean Load Policy 2025-11-29
|
|
- No se requiere acción adicional
|
|
|
|
---
|
|
|
|
**Validado por:** Architecture-Analyst
|
|
**Fecha validación:** 2025-11-29
|