[MCH] docs: Add missing CAPVED phase files for TASK-2026-01-20-001

- Add 02-ANALISIS.md with code analysis and dependencies - Add 03-PLAN.md with master plan and subagent assignments - Add 04-VALIDACION.md with pre-execution validation gate Completes SIMCO governance for Sprint 8 task documentation. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 03:33:42 -06:00 · 2026-01-20 03:33:42 -06:00 · a79e7e55d8
commit a79e7e55d8
parent c5c2f3d942
3 changed files with 440 additions and 0 deletions
--- a/orchestration/tareas/TASK-2026-01-20-001/02-ANALISIS.md
+++ b/orchestration/tareas/TASK-2026-01-20-001/02-ANALISIS.md
@ -0,0 +1,124 @@
+# FASE A - ANALISIS
+# TASK-2026-01-20-001: Sprint 8 - Frontend Integration Complete
+
+**Fecha:** 2026-01-20
+**Sistema:** SIMCO v4.0.0 + CAPVED
+**Agente:** Orquestador
+
+---
+
+## 1. ARCHIVOS CONSULTADOS
+
+### 1.1 Archivos de Definicion
+
+| Archivo | Ubicacion | Proposito |
+|---------|-----------|-----------|
+| CLAUDE.md | `/home/isem/workspace-v2/CLAUDE.md` | Directivas SIMCO, reglas de gobernanza |
+| FRONTEND_INVENTORY.yml | `orchestration/inventarios/FRONTEND_INVENTORY.yml` | Estado de paginas frontend |
+| BACKEND_INVENTORY.yml | `orchestration/inventarios/BACKEND_INVENTORY.yml` | Modulos y endpoints backend |
+| PROXIMA-ACCION.md | `orchestration/PROXIMA-ACCION.md` | Estado del proyecto y proximos pasos |
+| ESTADO-REAL-EPICAS.md | `docs/_definitions/ESTADO-REAL-EPICAS.md` | Estado de epicas MCH-001 a MCH-035 |
+
+### 1.2 Archivos de Codigo Analizados
+
+| Archivo | Ubicacion | Lineas | Estado Inicial |
+|---------|-----------|--------|----------------|
+| Dashboard.tsx | `frontend/src/pages/Dashboard.tsx` | 269 | Mock data |
+| Products.tsx | `frontend/src/pages/Products.tsx` | ~400 | Mock data |
+| Orders.tsx | `frontend/src/pages/Orders.tsx` | ~350 | Mock data |
+| Customers.tsx | `frontend/src/pages/Customers.tsx` | ~300 | Mock data |
+| Fiado.tsx | `frontend/src/pages/Fiado.tsx` | ~250 | Mock data |
+| Inventory.tsx | `frontend/src/pages/Inventory.tsx` | ~280 | Mock data |
+| Settings.tsx | `frontend/src/pages/Settings.tsx` | ~200 | Mock data |
+| api.ts | `frontend/src/lib/api.ts` | 132 | APIs parciales |
+
+---
+
+## 2. ANALISIS DE ESTADO ACTUAL
+
+### 2.1 Frontend Web
+
+| Pagina | Estado | API Conectada | Observacion |
+|--------|--------|---------------|-------------|
+| Dashboard | Mock | No | Usa datos estaticos |
+| Products | Mock | No | CRUD con mock data |
+| Orders | Mock | No | Estados hardcoded |
+| Customers | Mock | No | Lista estatica |
+| Fiado | Mock | No | Sin API |
+| Inventory | Mock | No | Movimientos mock |
+| Settings | N/A | No | Sin endpoints backend |
+
+### 2.2 Funcionalidades Faltantes
+
+| Feature | Estado | Dependencia |
+|---------|--------|-------------|
+| Dark Mode | No existe | ThemeContext |
+| PWA | No configurado | Vite plugin |
+| Export PDF | No implementado | Backend module |
+| Export Excel | No implementado | Backend module |
+
+---
+
+## 3. HALLAZGOS CRITICOS
+
+| # | Hallazgo | Impacto | Severidad |
+|---|----------|---------|-----------|
+| 1 | 8 paginas con mock data | No reflejan datos reales | ALTA |
+| 2 | ESTADO-REAL-EPICAS desactualizado | Documentacion incorrecta | ALTA |
+| 3 | Settings sin endpoints backend | Frontend no puede guardar | ALTA |
+| 4 | Sin exportacion PDF/Excel | Feature requerida faltante | MEDIA |
+| 5 | Sin Dark Mode | Feature UI esperada | MEDIA |
+| 6 | Sin PWA | No instalable en moviles | MEDIA |
+
+---
+
+## 4. ANALISIS DE DEPENDENCIAS
+
+### 4.1 Dependencias de Frontend
+
+```
+Dashboard.tsx ────► dashboardApi, ordersApi, inventoryApi
+Products.tsx ─────► productsApi
+Orders.tsx ───────► ordersApi
+Customers.tsx ────► customersApi
+Fiado.tsx ────────► fiadosApi, customersApi
+Inventory.tsx ────► inventoryApi, productsApi
+Settings.tsx ─────► settingsApi (NO EXISTE)
+```
+
+### 4.2 Modulos Backend Requeridos
+
+| Modulo | Estado | Accion |
+|--------|--------|--------|
+| settings | NO EXISTE | Crear |
+| exports | NO EXISTE | Crear |
+
+---
+
+## 5. DIRECTIVAS SIMCO APLICABLES
+
+| Directiva | Aplicacion |
+|-----------|------------|
+| Regla 1: Metodologia CAPVED | Ciclo completo |
+| Regla 2: Anti-Duplicacion | Verificar catalogo |
+| Regla 7: Gobernanza | Crear carpeta de tarea |
+| Regla 8: Coherencia Capas | Backend-Frontend sincronizado |
+| Regla 9: Cierre Obligatorio | Checklist post-tarea |
+
+---
+
+## 6. CONCLUSION DEL ANALISIS
+
+El frontend tiene 8 paginas principales que actualmente usan datos mock.
+Se requiere:
+1. Conectar todas las paginas a APIs reales
+2. Crear modulos backend faltantes (settings, exports)
+3. Implementar features: Dark Mode, PWA, Export PDF/Excel
+4. Actualizar documentacion y inventarios
+
+**Estado del analisis:** COMPLETADO
+**Fase siguiente:** PLAN (03-PLAN.md)
+
+---
+
+*Analisis generado segun metodologia CAPVED - SIMCO v4.0.0*
--- a/orchestration/tareas/TASK-2026-01-20-001/03-PLAN.md
+++ b/orchestration/tareas/TASK-2026-01-20-001/03-PLAN.md
@ -0,0 +1,154 @@
+# FASE P - PLAN
+# TASK-2026-01-20-001: Sprint 8 - Frontend Integration Complete
+
+**Fecha:** 2026-01-20
+**Sistema:** SIMCO v4.0.0 + CAPVED
+**Agente:** Orquestador
+
+---
+
+## 1. PLAN MAESTRO
+
+### 1.1 Estructura de Tareas
+
+```
+MCH-FRONTEND-DOC-2026
+├── T1: Purga y Limpieza Documental
+├── T2: Sincronizacion Documentacion-Codigo
+├── T3: Integracion Frontend Web con APIs
+│   ├── T3.1: Dashboard.tsx
+│   ├── T3.2: Products.tsx
+│   ├── T3.3: Orders.tsx
+│   ├── T3.4: Customers.tsx
+│   ├── T3.5: Fiado.tsx
+│   ├── T3.6: Inventory.tsx
+│   └── T3.7: Settings.tsx (requiere backend)
+├── T4: Documentacion de Componentes
+├── T5: Funcionalidades Faltantes
+│   ├── T5.1: Exportacion PDF/Excel
+│   ├── T5.2: Dark Mode
+│   └── T5.3: PWA
+└── T6: Validacion Final y Cierre
+```
+
+---
+
+## 2. ANALISIS DE DEPENDENCIAS
+
+### 2.1 Grafo de Dependencias
+
+```
+T1 (Purga) ────► T2 (Sync) ────► T3 (APIs)
+                                    │
+                    ┌───────────────┼───────────────┐
+                    ▼               ▼               ▼
+                T4 (Docs)      T5 (Features)    T3.7 (Settings)
+                    │               │               │
+                    └───────────────┴───────────────┘
+                                    │
+                                    ▼
+                              T6 (Validacion)
+```
+
+### 2.2 Tareas Paralelizables
+
+| Oleada | Tareas | Dependencia |
+|--------|--------|-------------|
+| 1 | T3.1, T3.2, T3.3, T3.4, T3.5, T3.6 | Ninguna (independientes) |
+| 2 | T3.7-BE, T4, T5.1-BE, T5.2, T5.3 | T3.1-T3.6 completadas |
+| 3 | T3.7-FE, T5.1-FE | Backend de oleada 2 |
+| 4 | T6 | Todas completadas |
+
+---
+
+## 3. PLAN DE SUBAGENTES
+
+### 3.1 Asignacion de Subagentes
+
+| SA-ID | Tarea | Perfil | Contexto Requerido |
+|-------|-------|--------|-------------------|
+| SA-001 | Dashboard.tsx | Frontend | dashboardApi, ordersApi, inventoryApi |
+| SA-002 | Products.tsx | Frontend | productsApi |
+| SA-003 | Orders.tsx | Frontend | ordersApi |
+| SA-004 | Customers.tsx | Frontend | customersApi |
+| SA-005 | Fiado.tsx | Frontend | fiadosApi |
+| SA-006 | Inventory.tsx | Frontend | inventoryApi |
+| SA-007 | Settings Backend | Backend | settingsApi (crear) |
+| SA-008 | Exports Backend | Backend | exportsApi (crear) |
+| SA-009 | Dark Mode | Frontend | ThemeContext |
+| SA-010 | PWA | Frontend | Vite config |
+| SA-011 | Component Docs | Docs | Todos los componentes |
+| SA-012 | Settings Frontend | Frontend | settingsApi (consumir) |
+| SA-013 | Exports Frontend | Frontend | exportsApi (consumir) |
+| SA-014 | Gobernanza | Docs | Tarea completa |
+| SA-015 | Backend Inventory | Docs | Modulos backend |
+
+### 3.2 Contexto por Subagente
+
+Cada subagente recibira:
+1. Path absoluto a archivos objetivo
+2. APIs/endpoints disponibles
+3. Patron de codigo esperado
+4. Formato de commit
+
+---
+
+## 4. CRITERIOS DE EXITO
+
+### 4.1 Por Pagina
+
+- [ ] Usa useQuery/useMutation de React Query
+- [ ] Conecta a API real (no mock)
+- [ ] Tiene loading y error states
+- [ ] Build pasa sin errores
+
+### 4.2 Por Feature
+
+| Feature | Criterio |
+|---------|----------|
+| Dark Mode | Toggle funcional, persiste en localStorage |
+| PWA | Instalable, manifest correcto |
+| Export PDF | Descarga archivo PDF |
+| Export Excel | Descarga archivo XLSX |
+
+### 4.3 Gobernanza
+
+- [ ] Carpeta de tarea creada
+- [ ] METADATA.yml completo
+- [ ] Inventarios actualizados
+- [ ] Commits atomicos
+
+---
+
+## 5. RIESGOS IDENTIFICADOS
+
+| Riesgo | Mitigacion |
+|--------|------------|
+| Settings backend no existe | Crear antes de frontend |
+| Dependencias circulares | Oleadas secuenciales |
+| Conflictos de merge | Archivos separados por subagente |
+
+---
+
+## 6. CRONOGRAMA
+
+| Oleada | Duracion Estimada | Subagentes |
+|--------|-------------------|------------|
+| Oleada 1 | 2h | 6 |
+| Oleada 2 | 2h | 5 |
+| Oleada 3 | 1h | 2 |
+| Oleada 4 | 1h | 2 |
+| **Total** | **6h** | **15** |
+
+---
+
+## 7. SIGUIENTE PASO
+
+Ejecutar FASE V (Validacion del plan) antes de proceder con la ejecucion.
+
+**Estado del plan:** COMPLETADO
+**Fase siguiente:** VALIDACION (04-VALIDACION.md)
+
+---
+
+*Plan generado segun metodologia CAPVED - SIMCO v4.0.0*
--- a/orchestration/tareas/TASK-2026-01-20-001/04-VALIDACION.md
+++ b/orchestration/tareas/TASK-2026-01-20-001/04-VALIDACION.md
@ -0,0 +1,162 @@
+# FASE V - VALIDACION
+# TASK-2026-01-20-001: Sprint 8 - Frontend Integration Complete
+
+**Fecha:** 2026-01-20
+**Sistema:** SIMCO v4.0.0 + CAPVED
+**Agente:** Orquestador
+
+---
+
+## 1. VALIDACION DEL PLAN
+
+### 1.1 Checklist Pre-Ejecucion
+
+| Item | Estado | Observacion |
+|------|--------|-------------|
+| Objetivos claros definidos | PASA | 7 objetivos identificados |
+| Tareas desglosadas | PASA | 6 tareas principales, 15 subtareas |
+| Dependencias mapeadas | PASA | Grafo de dependencias documentado |
+| Subagentes asignados | PASA | 15 subagentes con perfiles |
+| Contexto por subagente | PASA | APIs y paths definidos |
+| Criterios de exito | PASA | Por pagina, feature y gobernanza |
+| Riesgos identificados | PASA | 3 riesgos con mitigacion |
+
+### 1.2 Validacion de Recursos
+
+| Recurso | Disponible | Observacion |
+|---------|------------|-------------|
+| APIs backend | SI | Excepto settings y exports |
+| Documentacion | SI | Inventarios actualizados |
+| Templates | SI | Carpeta de tarea disponible |
+| Directivas SIMCO | SI | CLAUDE.md accesible |
+
+---
+
+## 2. VALIDACION DE DEPENDENCIAS
+
+### 2.1 Dependencias Resueltas
+
+| Dependencia | Estado | Resolucion |
+|-------------|--------|------------|
+| dashboardApi | DISPONIBLE | Ya existe |
+| ordersApi | DISPONIBLE | Ya existe |
+| productsApi | DISPONIBLE | Ya existe |
+| customersApi | DISPONIBLE | Ya existe |
+| inventoryApi | DISPONIBLE | Ya existe |
+| fiadosApi | DISPONIBLE | Ya existe |
+
+### 2.2 Dependencias Pendientes
+
+| Dependencia | Estado | Accion |
+|-------------|--------|--------|
+| settingsApi | NO EXISTE | Crear en Oleada 2 |
+| exportsApi | NO EXISTE | Crear en Oleada 2 |
+
+---
+
+## 3. VALIDACION DE OLEADAS
+
+### 3.1 Oleada 1 - Paginas Independientes
+
+| Tarea | Dependencias | Estado |
+|-------|--------------|--------|
+| T3.1 Dashboard | dashboardApi, ordersApi | LISTO |
+| T3.2 Products | productsApi | LISTO |
+| T3.3 Orders | ordersApi | LISTO |
+| T3.4 Customers | customersApi | LISTO |
+| T3.5 Fiado | fiadosApi | LISTO |
+| T3.6 Inventory | inventoryApi | LISTO |
+
+**Veredicto Oleada 1:** APROBADA para ejecucion paralela
+
+### 3.2 Oleada 2 - Backend + Features
+
+| Tarea | Dependencias | Estado |
+|-------|--------------|--------|
+| T3.7-BE Settings | Ninguna | LISTO |
+| T5.1-BE Exports | Ninguna | LISTO |
+| T5.2 Dark Mode | Ninguna | LISTO |
+| T5.3 PWA | Ninguna | LISTO |
+| T4 Docs | Oleada 1 | ESPERAR |
+
+**Veredicto Oleada 2:** APROBADA (ejecutar despues de Oleada 1)
+
+### 3.3 Oleada 3 - Frontend Dependiente
+
+| Tarea | Dependencias | Estado |
+|-------|--------------|--------|
+| T3.7-FE Settings | T3.7-BE | ESPERAR |
+| T5.1-FE Exports | T5.1-BE | ESPERAR |
+
+**Veredicto Oleada 3:** APROBADA (ejecutar despues de Oleada 2)
+
+### 3.4 Oleada 4 - Validacion Final
+
+| Tarea | Dependencias | Estado |
+|-------|--------------|--------|
+| T6 Gobernanza | Todas | ESPERAR |
+
+**Veredicto Oleada 4:** APROBADA (ejecutar al final)
+
+---
+
+## 4. GATE DE VALIDACION
+
+### 4.1 Criterios de Gate
+
+| Criterio | Estado |
+|----------|--------|
+| Plan completo | PASA |
+| Dependencias resueltas o planificadas | PASA |
+| Subagentes con contexto suficiente | PASA |
+| Riesgos mitigados | PASA |
+| Recursos disponibles | PASA |
+
+### 4.2 Decision
+
+```
+╔════════════════════════════════════════╗
+║                                        ║
+║   GATE DE VALIDACION: APROBADO        ║
+║                                        ║
+║   Proceder con FASE E (Ejecucion)     ║
+║                                        ║
+╚════════════════════════════════════════╝
+```
+
+---
+
+## 5. INSTRUCCIONES PARA EJECUCION
+
+### 5.1 Secuencia de Ejecucion
+
+1. **Oleada 1:** Lanzar 6 subagentes en paralelo (SA-001 a SA-006)
+2. **Verificar:** Build frontend exitoso
+3. **Oleada 2:** Lanzar 5 subagentes (SA-007, SA-008, SA-009, SA-010, SA-011)
+4. **Verificar:** Build backend y frontend exitosos
+5. **Oleada 3:** Lanzar 2 subagentes (SA-012, SA-013)
+6. **Verificar:** Build frontend exitoso
+7. **Oleada 4:** Lanzar 2 subagentes (SA-014, SA-015)
+8. **Final:** Ejecutar T6 - Validacion y cierre
+
+### 5.2 Checkpoints
+
+| Checkpoint | Validacion |
+|------------|------------|
+| Post-Oleada 1 | npm run build (frontend) |
+| Post-Oleada 2 | npm run build (backend + frontend) |
+| Post-Oleada 3 | npm run build (frontend) |
+| Post-Oleada 4 | Checklist gobernanza |
+
+---
+
+## 6. CONCLUSION
+
+El plan ha sido validado y cumple todos los criterios para proceder.
+
+**Estado de validacion:** COMPLETADO
+**Fase siguiente:** EJECUCION (05-EJECUCION.md)
+
+---
+
+*Validacion generada segun metodologia CAPVED - SIMCO v4.0.0*