rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
6b2baf8b0f
michangarrito/backups/orchestration-backup-2026-01-10/orchestration/analisis/PLAN-MAESTRO-PURGA-DOCUMENTAL-2026-01-10.md
rckrdmrd 97f407c661 [MIGRATION-V2] feat: Migrar michangarrito a estructura v2 
- Prefijo v2: MCH
- TRACEABILITY-MASTER.yml creado
- Listo para integracion como submodulo

Workspace: v2.0.0 | SIMCO: v4.0.0
2026-01-10 11:28:54 -06:00

9.9 KiB
Raw Blame History

PLAN MAESTRO DE PURGA Y REESTRUCTURACION DOCUMENTAL

Proyecto: MiChangarrito Fecha: 2026-01-10 Estado: ANALISIS COMPLETADO - PLAN VALIDADO - PENDIENTE EJECUCION Responsable: Arquitecto de Documentacion Version: 2.0.0

DOCUMENTOS RELACIONADOS

Documento Proposito
ANALISIS-CONSOLIDADO-PURGA-DOCUMENTAL-2026-01-10.md Hallazgos detallados
PLAN-EJECUCION-PURGA-DOCUMENTAL-2026-01-10.md Plan de tareas para ejecutar
VALIDACION-PLAN-PURGA-2026-01-10.md Verificacion de cobertura

1. OBJETIVO

Realizar un analisis exhaustivo de toda la documentacion del proyecto MiChangarrito para:

  • Identificar y eliminar documentacion obsoleta
  • Detectar y resolver duplicaciones
  • Consolidar definiciones en una sola fuente de verdad
  • Homologar planeacion con el desarrollo actual
  • Crear un historico resumido de progresion
  • Validar trazabilidad de funcionalidades y dependencias

2. ALCANCE

2.1 Archivos a Analizar

Categoria Cantidad Ubicacion
Documentacion Principal (docs/) 45+ /projects/michangarrito/docs/
Orchestration 33+ /projects/michangarrito/orchestration/
Inventarios YAML 6 /projects/michangarrito/orchestration/inventarios/
Analisis historicos 15 /projects/michangarrito/orchestration/analisis/
Trazas 7 /projects/michangarrito/orchestration/trazas/
Epicas 28 /projects/michangarrito/docs/01-epicas/

2.2 Discrepancias Detectadas Preliminarmente

ID Tipo Descripcion Archivos Afectados
D-001 CRITICA _MAP.md lista archivos que NO EXISTEN en 02-especificaciones/ docs/_MAP.md, docs/02-especificaciones/
D-002 DUPLICADO Arquitectura de BD aparece en 3 ubicaciones 90-transversal/ARQUITECTURA-DATABASE.md, 02-especificaciones/ARQUITECTURA-DATABASE.md, 90-transversal/arquitectura/
D-003 INCONSISTENCIA Numeracion de epicas difiere entre CONTEXT-MAP.yml y _MAP.md Epicas MCH-012 a MCH-028
D-004 OBSOLETO Multiples archivos de analisis historicos sin consolidar orchestration/analisis/*.md
D-005 INCONSISTENCIA Estructura de fases difiere entre documentos PLAN-IMPLEMENTACION.md vs CONTEXT-MAP.yml

3. FASES DEL ANALISIS

FASE 1: MAPEO Y ESTRUCTURA - COMPLETADA

Objetivo: Crear inventario completo de documentacion existente Estado: COMPLETADO

Tareas:

  • 1.1 Explorar estructura completa del proyecto
  • 1.2 Identificar todos los archivos de documentacion
  • 1.3 Leer archivos principales de referencia
  • 1.4 Crear matriz de documentos vs proposito
  • 1.5 Identificar dependencias entre documentos

Resultado: 78 archivos MD, 6 YAML, 18 SQL identificados

FASE 2: ANALISIS DETALLADO POR CATEGORIA - COMPLETADA

Objetivo: Analizar cada categoria de documentacion en profundidad Estado: COMPLETADO (via 4 subagentes especializados)

2.1 Vision General (docs/00-vision-general/)

  • Analizar VISION-PROYECTO.md
  • Analizar REQUERIMIENTOS-FUNCIONALES.md
  • Analizar ARQUITECTURA-TECNICA.md - CONFLICTO: 8 vs 9 schemas
  • Validar coherencia entre los tres documentos

2.2 Epicas (docs/01-epicas/)

  • Revisar MCH-001 a MCH-028
  • Validar estados (Completado vs Pendiente)
  • Verificar coherencia con desarrollo real
  • Identificar epicas con informacion duplicada o contradictoria - 25% discrepancias

2.3 Especificaciones (docs/02-especificaciones/)

  • Validar existencia de archivos listados en _MAP.md - 5 NO EXISTEN
  • Analizar contenido de archivos existentes - 5 NO LISTADOS
  • Identificar especificaciones faltantes - CALCULADORA-CAMBIO.md
  • Verificar alineacion con epicas

2.4 Transversal (docs/90-transversal/)

  • Analizar duplicados de arquitectura - 41% duplicado
  • Validar GUIA-DESPLIEGUE.md
  • Identificar contenido que deberia estar en otra ubicacion

2.5 Orchestration

  • Analizar CONTEXT-MAP.yml vs realidad - IDs desplazados MCH-012+
  • Validar PLAN-IMPLEMENTACION.md
  • Revisar PROJECT-STATUS.md
  • Consolidar archivos de analisis historicos - 5 obsoletos, 6 vigentes

2.6 Inventarios

  • Validar MASTER_INVENTORY.yml
  • Comparar inventarios vs codigo real
  • Identificar entradas obsoletas o faltantes

Resultado: Ver ANALISIS-CONSOLIDADO-PURGA-DOCUMENTAL-2026-01-10.md

FASE 3: IDENTIFICACION DE DUPLICADOS

Objetivo: Detectar contenido duplicado o redundante

Criterios de Duplicacion:

  1. Definicion identica: Mismo concepto definido en multiples archivos
  2. Definicion conflictiva: Mismo concepto con definiciones diferentes
  3. Funcionalidad solapada: Epicas o especificaciones que cubren lo mismo
  4. Archivos redundantes: Documentos que no aportan valor unico

FASE 4: ANALISIS DE DEPENDENCIAS

Objetivo: Mapear relaciones entre documentos y funcionalidades

Matriz de Dependencias:

  • Epicas -> Especificaciones
  • Especificaciones -> Inventarios
  • Inventarios -> Codigo real
  • Trazas -> Epicas completadas

FASE 5: PLANEACION DE PURGA

Objetivo: Definir acciones especificas para cada documento

Categorias de Accion:

Codigo Accion Descripcion
ELIMINAR Borrar archivo Documento obsoleto sin valor
CONSOLIDAR Fusionar contenido Contenido duplicado a unificar
ACTUALIZAR Modificar contenido Informacion desactualizada
REESTRUCTURAR Mover/reorganizar Ubicacion incorrecta
MANTENER Sin cambios Documento correcto y actualizado

FASE 6: VALIDACION DEL PLAN

Objetivo: Verificar que el plan cubre todos los requisitos

Checklist de Validacion:

  • Todas las discrepancias tienen accion asignada
  • No se eliminara informacion critica
  • El plan mantiene trazabilidad
  • Las dependencias estan consideradas

FASE 7: EJECUCION DEL PLAN

Objetivo: Implementar las acciones planificadas

Orden de Ejecucion:

  1. Crear respaldo de documentacion actual
  2. Ejecutar ELIMINARs
  3. Ejecutar CONSOLIDARs
  4. Ejecutar ACTUALIZARs
  5. Ejecutar REESTRUCTURARs
  6. Validar integridad final

FASE 8: VALIDACION FINAL

Objetivo: Verificar que la documentacion reestructurada es correcta

Criterios de Exito:

  • Sin duplicados
  • Sin referencias rotas
  • Coherencia entre documentos
  • Trazabilidad completa
  • Historico resumido creado

4. ESTRUCTURA DE TAREAS DETALLADAS

Tarea T-001: Validar Especificaciones vs _MAP.md

Fase: 2.3 Prioridad: CRITICA Dependencias: Ninguna

Descripcion: El archivo docs/_MAP.md lista los siguientes archivos en 02-especificaciones/:

  • CATALOGO-PRODUCTOS.md
  • TEMPLATE-PRODUCTOS.md
  • POS-BASICO.md
  • VENTAS-DIARIAS.md
  • CALCULADORA-CAMBIO.md
  • INTEGRACIONES-PAGOS.md

Sin embargo, los archivos reales encontrados son:

  • _MAP.md
  • ARQUITECTURA-DATABASE.md
  • ESPECIFICACION-COMPONENTES.md
  • INTEGRACIONES-EXTERNAS.md
  • INVESTIGACION-REFERENCIAS.md
  • PLAN-DESARROLLO.md

Acciones:

  1. Determinar si los archivos listados existieron y fueron eliminados
  2. Determinar si el contenido esta en otro lugar
  3. Actualizar _MAP.md para reflejar realidad

Tarea T-002: Resolver Duplicados de Arquitectura BD

Fase: 2.4 Prioridad: ALTA Dependencias: T-001

Descripcion: Se detectaron 2+ archivos relacionados con arquitectura de base de datos:

  • docs/90-transversal/ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md
  • docs/02-especificaciones/ARQUITECTURA-DATABASE.md
  • docs/90-transversal/arquitectura/ARQUITECTURA-DATABASE.md

Acciones:

  1. Comparar contenido de ambos archivos
  2. Identificar cual es la version canonica
  3. Consolidar si es necesario
  4. Actualizar referencias

Tarea T-003: Homologar Epicas con CONTEXT-MAP

Fase: 2.2 Prioridad: ALTA Dependencias: Ninguna

Descripcion: Las epicas en CONTEXT-MAP.yml tienen nomenclatura diferente a _MAP.md:

  • CONTEXT-MAP: MCH-012-chat-llm (sin especificar dueno/cliente)
  • _MAP: MCH-012-chat-llm-dueno, MCH-013-chat-llm-cliente

Acciones:

  1. Revisar todas las discrepancias de nomenclatura
  2. Definir nomenclatura canonica
  3. Actualizar documentos afectados

Tarea T-004: Consolidar Analisis Historicos

Fase: 2.5 Prioridad: MEDIA Dependencias: Ninguna

Descripcion: Existen 15 archivos de analisis en orchestration/analisis/ con fechas entre 2026-01-06 y 2026-01-10.

Acciones:

  1. Revisar contenido de cada archivo
  2. Crear resumen consolidado de hallazgos importantes
  3. Archivar o eliminar analisis obsoletos
  4. Mantener solo documentos de valor actual

Tarea T-005: Validar Estados de Epicas

Fase: 2.2 Prioridad: ALTA Dependencias: T-003

Descripcion: Validar que el estado de cada epica (Completado/Pendiente) corresponde con el desarrollo real.

Acciones:

  1. Revisar cada epica marcada como completada
  2. Verificar existencia de codigo correspondiente
  3. Identificar discrepancias
  4. Actualizar estados

5. PROGRESO Y SEGUIMIENTO

Estado Actual

Fase Estado Progreso
FASE 1 EN CURSO 60%
FASE 2 PENDIENTE 0%
FASE 3 PENDIENTE 0%
FASE 4 PENDIENTE 0%
FASE 5 PENDIENTE 0%
FASE 6 PENDIENTE 0%
FASE 7 PENDIENTE 0%
FASE 8 PENDIENTE 0%

Hallazgos Clave

  • 5 discrepancias criticas detectadas en analisis preliminar
  • Documentacion de especificaciones severamente desactualizada
  • Potencial duplicacion en documentacion de arquitectura
  • Nomenclatura de epicas inconsistente entre documentos

6. SIGUIENTE ACCION

Accion Inmediata: Lanzar subagentes especializados para analisis paralelo de:

  1. Validacion de especificaciones (T-001)
  2. Analisis de duplicados de arquitectura (T-002)
  3. Revision de epicas completas (T-003, T-005)
  4. Consolidacion de analisis historicos (T-004)

Ultima actualizacion: 2026-01-10 Version: 1.0.0