# 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)