rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
6ed7f9e2ec
erp-transportistas-v2/orchestration/tareas/2026-01-28/TASK-008-validacion-remediacion/PURGE-CANDIDATES.md
Adrian Flores Cortes 6ed7f9e2ec [BACKUP] Pre-restructure workspace backup 2026-01-29 
- Updated docs and inventory files
- Added new architecture docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 17:35:54 -06:00

13 KiB
Raw Blame History

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)

  1. 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)

  1. Crear archivo faltante WHATSAPP-TEMPLATES.yml
    • Si la funcionalidad WhatsApp es relevante, crear el archivo
    • Si no, remover la referencia

5.4 Gobernanza

  1. 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)