michangarrito/orchestration/_archive/analisis/PLAN-PURGA-DOCUMENTAL-2026-01-20.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

203 lines
5.4 KiB
Markdown

# 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