michangarrito/orchestration/_archive/tareas/TASK-2026-01-20-001/03-PLAN.md

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