# 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:**

```yaml
# ANTES
Frontend React: 100% | 14 paginas

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

**Seccion a agregar:**

```markdown
### 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:**

```yaml
# 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:**
```bash
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

```sql
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/

```bash
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/

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

---

## 4. ORDEN DE EJECUCION

### Paso 1: Verificar conteos reales
```bash
# 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
```bash
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