michangarrito/orchestration/analisis/PLAN-PURGA-DOCUMENTAL-2026-01-20.md

PLAN DE PURGA DOCUMENTAL

MiChangarrito - 2026-01-20

Objetivo: Limpiar, actualizar y sincronizar la documentacion del proyecto Prioridad: P0 - Prerequisito para todas las demas tareas Estado: LISTO PARA EJECUTAR

---

1. DOCUMENTOS A ACTUALIZAR (CRITICOS)

1.1 ESTADO-REAL-EPICAS.md

Ruta: docs/_definitions/ESTADO-REAL-EPICAS.md Problema: Estados incorrectos vs codigo real Cambios requeridos:

Epica	Estado Actual	Estado Real	Accion
MCH-006	PENDIENTE	COMPLETADO	Cambiar a COMPLETADO
MCH-007	PENDIENTE	COMPLETADO	Cambiar a COMPLETADO
MCH-022	PENDIENTE	COMPLETADO	Cambiar a COMPLETADO
MCH-026	PENDIENTE	COMPLETADO	Cambiar a COMPLETADO
Progreso	60%	100%	Actualizar a 100%

1.2 PROXIMA-ACCION.md

Ruta: orchestration/PROXIMA-ACCION.md Problema: Reporta Frontend 100% pero 8 paginas usan mock data Cambios requeridos:

# ANTES
Frontend React: 100% | 14 paginas

# DESPUES
Frontend React: 57% funcional | 6 paginas conectadas, 8 con mock data

Seccion a agregar:

### Paginas Pendientes de Integracion

| Pagina | Estado Actual | Accion Requerida |
|--------|---------------|------------------|
| Dashboard | Mock Data | Conectar a dashboardApi |
| Products | Mock Data | Conectar a productsApi |
| Orders | Mock Data | Conectar a ordersApi |
| Customers | Mock Data | Conectar a customersApi |
| Fiado | Mock Data | Conectar a fiadosApi |
| Inventory | Mock Data | Conectar a inventoryApi |
| Settings | Mock Data | Crear endpoints + conectar |

1.3 FRONTEND_INVENTORY.yml

Ruta: orchestration/inventarios/FRONTEND_INVENTORY.yml Cambios requeridos:

# Actualizar seccion notas:
notas:
  - "8 de 14 paginas usan datos mock - requieren integracion"
  - "Paginas funcionales: Login, Register, Invoices, Marketplace, Tokens, CodiSpei, Referrals"
  - "Paginas con mock: Dashboard, Products, Orders, Customers, Fiado, Inventory, Settings"
  - "Dark mode pendiente"
  - "PWA pendiente"
  - "Hooks personalizados pendientes (src/hooks/)"

# Actualizar status por pagina en la seccion pages

1.4 MASTER_INVENTORY.yml

Ruta: orchestration/inventarios/MASTER_INVENTORY.yml Cambios requeridos:

• Verificar y unificar conteo de tablas (38 vs 49 vs 51)
• Agregar nota sobre estado real del frontend

---

2. DOCUMENTOS A ARCHIVAR

2.1 Backups Obsoletos

Directorio	Contenido	Accion
backups/docs-backup-2026-01-10/	Backup de docs	MOVER a .archive/
backups/orchestration-backup-2026-01-10/	Backup orchestration	MOVER a .archive/

Comando:

mkdir -p /home/isem/workspace-v2/projects/michangarrito/.archive/2026-01-10
mv /home/isem/workspace-v2/projects/michangarrito/backups/* /home/isem/workspace-v2/projects/michangarrito/.archive/2026-01-10/

2.2 Analisis Antiguos

Los siguientes archivos pueden archivarse si ya no son relevantes:

Archivo	Fecha	Accion
orchestration/analisis/*-2026-01-06.md	2026-01-06	REVISAR
orchestration/analisis/*-2026-01-10.md	2026-01-10	REVISAR

---

3. DISCREPANCIAS DE CONTEO

3.1 Tablas de Base de Datos

Fuente	Valor	Verificar
MASTER_INVENTORY.yml	38
DATABASE_INVENTORY.yml	49
PROXIMA-ACCION.md	51

Accion: Ejecutar query en BD para contar tablas reales

SELECT count(*) FROM information_schema.tables
WHERE table_schema NOT IN ('pg_catalog', 'information_schema');

3.2 Modulos Backend

Fuente	Valor	Verificar
BACKEND_INVENTORY.yml	19
PROJECT-STATUS.md	12
PROXIMA-ACCION.md	21

Accion: Contar carpetas en backend/src/modules/

ls -d /home/isem/workspace-v2/projects/michangarrito/backend/src/modules/*/ | wc -l

3.3 Paginas Frontend

Fuente	Valor	Verificar
MASTER_INVENTORY.yml	12
FRONTEND_INVENTORY.yml	14
PROXIMA-ACCION.md	14

Accion: Contar archivos en frontend/src/pages/

ls /home/isem/workspace-v2/projects/michangarrito/frontend/src/pages/*.tsx | wc -l

---

4. ORDEN DE EJECUCION

Paso 1: Verificar conteos reales

# Ejecutar comandos de verificacion

Paso 2: Actualizar ESTADO-REAL-EPICAS.md

• Cambiar estados de MCH-006, MCH-007, MCH-022, MCH-026
• Actualizar progreso a 100%

Paso 3: Actualizar PROXIMA-ACCION.md

• Corregir porcentaje de frontend
• Agregar seccion de paginas pendientes

Paso 4: Actualizar FRONTEND_INVENTORY.yml

• Actualizar notas
• Marcar estado real de cada pagina

Paso 5: Unificar MASTER_INVENTORY.yml

• Usar conteos verificados

Paso 6: Archivar backups

• Mover a .archive/

Paso 7: Commit cambios

git add .
git commit -m "[MCH] fix: Sincronizar documentacion con estado real del codigo"
git push origin main

---

5. VALIDACION

Checklist Post-Purga

• ESTADO-REAL-EPICAS.md refleja codigo real
• PROXIMA-ACCION.md tiene metricas correctas
• FRONTEND_INVENTORY.yml tiene estado real por pagina
• MASTER_INVENTORY.yml tiene conteos unificados
• No hay contradicciones entre documentos
• Backups archivados en .archive/
• Commit realizado y pusheado

---

Documento generado: 2026-01-20 Estado: Pendiente de ejecucion