6ed7f9e2ec
- Updated docs and inventory files - Added new architecture docs Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
289 lines
13 KiB
Markdown
289 lines
13 KiB
Markdown
# PURGE-CANDIDATES.md - ERP Transportistas
|
|
## TASK-008.5.1: Identificacion de Documentacion Obsoleta
|
|
|
|
**Generado:** 2026-01-28
|
|
**Agente:** Claude Code (opus-4.5)
|
|
**Proyecto:** erp-transportistas
|
|
**Sistema:** SIMCO v4.0.0
|
|
|
|
---
|
|
|
|
## RESUMEN EJECUTIVO
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| **Total archivos .md analizados (orchestration/tareas/)** | 20 |
|
|
| **Total archivos .md analizados (docs/)** | 142 |
|
|
| **Archivos referenciados en INDEX/METADATA** | 35 |
|
|
| **Referencias rotas identificadas** | 4 |
|
|
| **Candidatos a consolidacion (RESUMEN-EPICA.md)** | 15 |
|
|
| **Archivos completamente obsoletos** | 0 |
|
|
| **Archivos safe to delete** | 0 (todos requieren consolidacion previa) |
|
|
|
|
---
|
|
|
|
## 1. INVENTARIO DE ARCHIVOS
|
|
|
|
### 1.1 Archivos en orchestration/tareas/
|
|
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `TASK-2026-01-25-001-CREAR-PROYECTO/METADATA.yml` | SI (_INDEX.yml) | KEEP |
|
|
| `TASK-2026-01-25-DOCUMENTACION-MODULOS/METADATA.yml` | SI (_INDEX.yml) | KEEP |
|
|
| `2026-01-27/TASK-006-validacion-documental/METADATA.yml` | SI (_INDEX.yml) | KEEP |
|
|
| `2026-01-27/TASK-006-validacion-documental/README.md` | NO | KEEP (doc tarea) |
|
|
| `2026-01-27/TASK-006-validacion-documental/TASK-006-SUMMARY.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-006-validacion-documental/PURGE-EXECUTION-REPORT.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-006-validacion-documental/PURGE-ANALYSIS.yml` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-006-validacion-documental/AUDITORIA-SERVICIOS.yml` | NO | KEEP (referencia util) |
|
|
| `2026-01-27/TASK-007-.../METADATA.yml` | SI (_INDEX.yml) | KEEP |
|
|
| `2026-01-27/TASK-007-.../ANALISIS-GAPS.md` | SI (PROXIMA-ACCION) | KEEP |
|
|
| `2026-01-27/TASK-007-.../PLAN-EJECUCION.md` | NO | KEEP (doc tarea) |
|
|
| `2026-01-27/TASK-007-.../PLAN-COPIA-GPS.md` | SI (PROXIMA-ACCION) | KEEP |
|
|
| `2026-01-27/TASK-007-.../PLAN-COPIA-DISPATCH.md` | SI (PROXIMA-ACCION) | KEEP |
|
|
| `2026-01-27/TASK-007-.../ROADMAP-IMPLEMENTACION.md` | SI (PROXIMA-ACCION) | KEEP |
|
|
| `2026-01-27/TASK-007-.../FASE-0-COMPLETADA.md` | NO | KEEP (historico) |
|
|
| `2026-01-27/TASK-007-.../FASE-1-2-COMPLETADAS.md` | NO | KEEP (historico) |
|
|
| `2026-01-27/TASK-007-.../FASE-3-COMPLETADA.md` | NO | KEEP (historico) |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S1-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S2-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S3-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S4-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S5-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S6-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S7-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../SPRINT-S8-COMPLETADO.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-27/TASK-007-.../TASK-007-COMPLETADA.md` | SI (METADATA) | KEEP |
|
|
| `2026-01-28/TASK-008-.../METADATA.yml` | SI (_INDEX.yml) | KEEP |
|
|
| `_INDEX.yml` | ROOT | KEEP |
|
|
|
|
### 1.2 Archivos en docs/ (categorias principales)
|
|
|
|
#### docs/_definitions/ (5 archivos)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `_INDEX.yml` | ROOT | KEEP |
|
|
| `MODULES-CATALOG.md` | SI (_INDEX) | KEEP |
|
|
| `ENTITIES-CATALOG.md` | SI (_INDEX) | KEEP |
|
|
| `SERVICES-CATALOG.md` | SI (_INDEX) | KEEP |
|
|
| `DATABASE-SCHEMA.md` | SI (_INDEX) | KEEP |
|
|
|
|
#### docs/_quick/ (4 archivos)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `QUICK-INDEX.yml` | SI (MAPA) | KEEP |
|
|
| `QUICK-MODULES.yml` | SI (MAPA) | KEEP |
|
|
| `QUICK-DATABASE.yml` | SI (MAPA) | KEEP |
|
|
| `QUICK-API.yml` | SI (MAPA) | KEEP |
|
|
|
|
#### docs/00-vision-general/ (1 archivo)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `VISION-ERP-TRANSPORTISTAS.md` | SI (MAPA) | KEEP |
|
|
|
|
#### docs/02-definicion-modulos/ (~110 archivos)
|
|
Ver seccion 3.1 para candidatos a consolidacion.
|
|
|
|
#### docs/03-requerimientos/ (1 archivo)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `REQ-GIRO-TRANSPORTISTA.md` | SI (PROXIMA-ACCION) | KEEP |
|
|
|
|
#### docs/10-arquitectura/ (3 archivos)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `ARQUITECTURA-OFFLINE.md` | SI (MAPA) | KEEP |
|
|
| `FLUJO-PRINCIPAL-TRANSPORTE.md` | SI (MAPA) | KEEP |
|
|
| `SINCRONIZACION-OFFLINE.md` | SI (MAPA) | KEEP |
|
|
|
|
#### docs/30-integraciones/ (3 archivos)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `INTEGRACIONES-EXTERNAS.md` | SI (MAPA) | KEEP |
|
|
| `INTEGRACION-GEOFENCING.md` | SI (MAPA) | KEEP |
|
|
| `INTEGRACION-GPS-PROVIDERS.md` | SI (MAPA) | KEEP |
|
|
|
|
#### docs/40-estandares/ (2 archivos)
|
|
| Archivo | Referenciado | Estado |
|
|
|---------|--------------|--------|
|
|
| `ESPECIFICACION-KPIS.yml` | SI (PROXIMA-ACCION) | KEEP |
|
|
| `MATRIZ-RBAC-TRANSPORTISTAS.yml` | SI (PROXIMA-ACCION) | KEEP |
|
|
|
|
---
|
|
|
|
## 2. REFERENCIAS ROTAS IDENTIFICADAS
|
|
|
|
### 2.1 Referencias en PROXIMA-ACCION.md que NO existen
|
|
|
|
| Referencia en archivo | Ruta especificada | Estado |
|
|
|-----------------------|-------------------|--------|
|
|
| PROXIMA-ACCION.md linea 256 | `docs/30-integraciones/GPS-MULTI-PROVIDER-SPEC.md` | **NO EXISTE** |
|
|
| PROXIMA-ACCION.md linea 257 | `docs/02-definicion-modulos/MAI-005-DESPACHO/DISPATCH-CENTER-SPEC.md` | **NO EXISTE** (nota: carpeta es `MAI-005-despacho` minusculas) |
|
|
| PROXIMA-ACCION.md linea 258 | `docs/10-arquitectura/OFFLINE-SYNC-SPEC.md` | **NO EXISTE** |
|
|
| PROXIMA-ACCION.md linea 259 | `docs/30-integraciones/WHATSAPP-TEMPLATES.yml` | **NO EXISTE** |
|
|
|
|
### 2.2 Analisis de las referencias rotas
|
|
|
|
**Causa probable:** PROXIMA-ACCION.md fue actualizado con referencias a archivos planificados en TASK-007 que nunca fueron creados, o fueron creados con nombres diferentes.
|
|
|
|
**Archivos existentes similares:**
|
|
- `docs/30-integraciones/INTEGRACION-GPS-PROVIDERS.md` (podria ser el GPS-MULTI-PROVIDER-SPEC.md)
|
|
- `docs/02-definicion-modulos/MAI-005-despacho/API-ASIGNACION.md` (podria ser el DISPATCH-CENTER-SPEC.md)
|
|
- `docs/10-arquitectura/SINCRONIZACION-OFFLINE.md` (podria ser el OFFLINE-SYNC-SPEC.md)
|
|
- No hay archivo similar a WHATSAPP-TEMPLATES.yml
|
|
|
|
### 2.3 Accion Recomendada
|
|
|
|
**Categoria: FIX**
|
|
|
|
Actualizar PROXIMA-ACCION.md para corregir las referencias:
|
|
1. Cambiar `GPS-MULTI-PROVIDER-SPEC.md` por `INTEGRACION-GPS-PROVIDERS.md`
|
|
2. Cambiar `MAI-005-DESPACHO/DISPATCH-CENTER-SPEC.md` por `MAI-005-despacho/API-ASIGNACION.md` o `MAI-005-despacho/README.md`
|
|
3. Cambiar `OFFLINE-SYNC-SPEC.md` por `SINCRONIZACION-OFFLINE.md`
|
|
4. Eliminar referencia a `WHATSAPP-TEMPLATES.yml` o crear el archivo
|
|
|
|
---
|
|
|
|
## 3. CANDIDATOS A CONSOLIDACION
|
|
|
|
### 3.1 Archivos RESUMEN-EPICA.md (15 archivos)
|
|
|
|
Segun PURGE-ANALYSIS.yml de TASK-006, los archivos RESUMEN-EPICA.md tienen ~50% overlap con README.md y deben consolidarse. Ya se purgo MAI-003 y MAE-016, quedan 15:
|
|
|
|
| Archivo | Directorio | Estado | Accion |
|
|
|---------|------------|--------|--------|
|
|
| `RESUMEN-EPICA.md` | MAI-002-tarifas-sla | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-004-planeacion | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-005-despacho | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-006-tracking | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-007-pod-cierre | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-008-incidencias | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-009-facturacion-transporte | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-010-liquidaciones | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-011-gestion-flota | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-012-combustible-gastos | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-013-mantenimiento-flota | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-014-carriers | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAI-015-portal-cliente | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAE-017-hos-bitacora | CONSOLIDATE | Mergear en README.md |
|
|
| `RESUMEN-EPICA.md` | MAE-018-reportes-kpis | CONSOLIDATE | Mergear en README.md |
|
|
|
|
**Total archivos a consolidar:** 15
|
|
**Proceso:** Copiar contenido unico a README.md, luego eliminar RESUMEN-EPICA.md
|
|
**Riesgo:** BAJO (mismo proceso exitoso aplicado a MAI-003 y MAE-016)
|
|
|
|
---
|
|
|
|
## 4. CATEGORIZACION FINAL
|
|
|
|
### 4.1 KEEP (Mantener sin cambios)
|
|
|
|
| Categoria | Cantidad | Descripcion |
|
|
|-----------|----------|-------------|
|
|
| Tareas completadas (orchestration/tareas/) | 28 archivos | Historico valido y reciente |
|
|
| Definiciones canonicas (docs/_definitions/) | 5 archivos | SSOT del proyecto |
|
|
| Quick references (docs/_quick/) | 4 archivos | Referencias rapidas utiles |
|
|
| Arquitectura (docs/10-arquitectura/) | 3 archivos | Documentacion activa |
|
|
| Integraciones (docs/30-integraciones/) | 3 archivos | Documentacion activa |
|
|
| Estandares (docs/40-estandares/) | 2 archivos | Matrices activas |
|
|
| Requerimientos (docs/03-requerimientos/) | 1 archivo | REQ-GIRO principal |
|
|
| Vision (docs/00-vision-general/) | 1 archivo | Vision del proyecto |
|
|
| README.md de modulos | 17 archivos | Documentacion principal |
|
|
| REQUERIMIENTOS.md de modulos | 17 archivos | Especificaciones |
|
|
| Historias de usuario | ~69 archivos | User stories activas |
|
|
|
|
### 4.2 CONSOLIDATE (Consolidar antes de eliminar)
|
|
|
|
| Archivo | Cantidad | Accion |
|
|
|---------|----------|--------|
|
|
| RESUMEN-EPICA.md | 15 archivos | Mergear contenido en README.md, luego eliminar |
|
|
|
|
### 4.3 PURGE (Eliminar directamente)
|
|
|
|
| Archivo | Cantidad | Notas |
|
|
|---------|----------|-------|
|
|
| N/A | 0 | No hay archivos completamente obsoletos |
|
|
|
|
### 4.4 FIX (Corregir referencias)
|
|
|
|
| Archivo | Problema | Accion |
|
|
|---------|----------|--------|
|
|
| orchestration/PROXIMA-ACCION.md | 4 referencias rotas | Actualizar rutas a archivos existentes |
|
|
|
|
---
|
|
|
|
## 5. RECOMENDACIONES
|
|
|
|
### 5.1 Inmediato (Fase 1 - Esta sesion)
|
|
|
|
1. **Corregir referencias rotas en PROXIMA-ACCION.md**
|
|
- Actualizar 4 rutas incorrectas
|
|
- Verificar con grep que no hay otras referencias a esos nombres
|
|
|
|
### 5.2 Corto Plazo (Fase 2 - Proxima sesion)
|
|
|
|
2. **Consolidar RESUMEN-EPICA.md en README.md**
|
|
- Aplicar el mismo proceso exitoso de TASK-006 a los 15 archivos restantes
|
|
- Verificar referencias antes de eliminar
|
|
- Validar build tras cada batch
|
|
|
|
### 5.3 Mediano Plazo (Fase 3)
|
|
|
|
3. **Crear archivo faltante WHATSAPP-TEMPLATES.yml**
|
|
- Si la funcionalidad WhatsApp es relevante, crear el archivo
|
|
- Si no, remover la referencia
|
|
|
|
### 5.4 Gobernanza
|
|
|
|
4. **Establecer politica de nomenclatura consistente**
|
|
- Estandarizar mayusculas/minusculas en nombres de carpetas
|
|
- Documentar patron README.md vs RESUMEN-EPICA.md
|
|
|
|
---
|
|
|
|
## 6. ARCHIVOS SAFE TO DELETE
|
|
|
|
**NINGUNO** - Todos los archivos identificados para eliminacion requieren consolidacion previa.
|
|
|
|
Tras completar la consolidacion de RESUMEN-EPICA.md en README.md (seccion 3.1), los siguientes 15 archivos seran safe to delete:
|
|
|
|
```
|
|
docs/02-definicion-modulos/MAI-002-tarifas-sla/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-004-planeacion/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-005-despacho/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-006-tracking/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-007-pod-cierre/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-008-incidencias/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-009-facturacion-transporte/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-010-liquidaciones/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-011-gestion-flota/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-012-combustible-gastos/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-013-mantenimiento-flota/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-014-carriers/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAI-015-portal-cliente/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAE-017-hos-bitacora/RESUMEN-EPICA.md
|
|
docs/02-definicion-modulos/MAE-018-reportes-kpis/RESUMEN-EPICA.md
|
|
```
|
|
|
|
**Condicion:** Solo eliminar DESPUES de verificar que el contenido unico fue consolidado en README.md.
|
|
|
|
---
|
|
|
|
## 7. CONCLUSION
|
|
|
|
El proyecto erp-transportistas tiene una documentacion bien estructurada con minima obsolescencia. Los principales hallazgos son:
|
|
|
|
1. **4 referencias rotas** en PROXIMA-ACCION.md que requieren correccion
|
|
2. **15 archivos RESUMEN-EPICA.md** candidatos a consolidacion (patron ya aplicado exitosamente en TASK-006)
|
|
3. **0 archivos completamente obsoletos** para eliminacion directa
|
|
4. **100% de archivos de tareas** correctamente referenciados en _INDEX.yml
|
|
|
|
**Estado general:** SALUDABLE - El proyecto mantiene buena gobernanza documental.
|
|
|
|
---
|
|
|
|
**Generado por:** Claude Code (opus-4.5)
|
|
**Fecha:** 2026-01-28
|
|
**Sistema:** SIMCO v4.0.0
|
|
**Tarea:** TASK-008.5.1 (subtarea de TASK-008-validacion-remediacion)
|