rckrdmrd
97f407c661
- Prefijo v2: MCH - TRACEABILITY-MASTER.yml creado - Listo para integracion como submodulo Workspace: v2.0.0 | SIMCO: v4.0.0
320 lines
9.9 KiB
Markdown
320 lines
9.9 KiB
Markdown
# 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:
|
|
- [x] 1.1 Explorar estructura completa del proyecto
|
|
- [x] 1.2 Identificar todos los archivos de documentacion
|
|
- [x] 1.3 Leer archivos principales de referencia
|
|
- [x] 1.4 Crear matriz de documentos vs proposito
|
|
- [x] 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/)
|
|
- [x] Analizar VISION-PROYECTO.md
|
|
- [x] Analizar REQUERIMIENTOS-FUNCIONALES.md
|
|
- [x] Analizar ARQUITECTURA-TECNICA.md - **CONFLICTO: 8 vs 9 schemas**
|
|
- [x] Validar coherencia entre los tres documentos
|
|
|
|
#### 2.2 Epicas (docs/01-epicas/)
|
|
- [x] Revisar MCH-001 a MCH-028
|
|
- [x] Validar estados (Completado vs Pendiente)
|
|
- [x] Verificar coherencia con desarrollo real
|
|
- [x] Identificar epicas con informacion duplicada o contradictoria - **25% discrepancias**
|
|
|
|
#### 2.3 Especificaciones (docs/02-especificaciones/)
|
|
- [x] Validar existencia de archivos listados en _MAP.md - **5 NO EXISTEN**
|
|
- [x] Analizar contenido de archivos existentes - **5 NO LISTADOS**
|
|
- [x] Identificar especificaciones faltantes - **CALCULADORA-CAMBIO.md**
|
|
- [x] Verificar alineacion con epicas
|
|
|
|
#### 2.4 Transversal (docs/90-transversal/)
|
|
- [x] Analizar duplicados de arquitectura - **41% duplicado**
|
|
- [x] Validar GUIA-DESPLIEGUE.md
|
|
- [x] Identificar contenido que deberia estar en otra ubicacion
|
|
|
|
#### 2.5 Orchestration
|
|
- [x] Analizar CONTEXT-MAP.yml vs realidad - **IDs desplazados MCH-012+**
|
|
- [x] Validar PLAN-IMPLEMENTACION.md
|
|
- [x] Revisar PROJECT-STATUS.md
|
|
- [x] Consolidar archivos de analisis historicos - **5 obsoletos, 6 vigentes**
|
|
|
|
#### 2.6 Inventarios
|
|
- [x] Validar MASTER_INVENTORY.yml
|
|
- [x] Comparar inventarios vs codigo real
|
|
- [x] 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
|