# Fase P - Planeacion **Tarea:** TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT **Fecha:** 2026-01-25 **Sistema:** SIMCO v4.0.0 + CAPVED --- ## Estrategia General ### Enfoque de Descomposicion ```yaml estrategia: Divide and Conquer con Paralelizacion Masiva principios: - Un subagente por epic (9 subagentes en paralelo) - Cada subagente ejecuta CAPVED completo en su scope - Agente principal consolida resultados - Modelo haiku para subagentes (costo-efectivo) - Modelo opus para consolidacion (calidad) niveles_de_descomposicion: nivel_1: Por Epic/Modulo (9 divisiones) nivel_2: Por tipo de analisis (componentes, APIs, multimedia) nivel_3: Por archivo/componente individual ``` --- ## FASE 1: Analisis Paralelo por Epic (9 Subagentes) ### Subtarea ST-001: Analisis OQI-001 (fundamentos-auth) ```yaml id: ST-001 epic: OQI-001-fundamentos-auth progreso_actual: 70% agente: general-purpose (haiku) modelo: haiku scope: ruta: apps/frontend/src/modules/auth/ paginas: - Login.tsx - Register.tsx - ForgotPassword.tsx - VerifyEmail.tsx - ResetPassword.tsx - AuthCallback.tsx - SecuritySettings.tsx componentes: - SocialLoginButtons.tsx - PhoneLoginForm.tsx - SessionsList.tsx - DeviceCard.tsx tareas_del_subagente: 1. Analizar_Componentes: - Funcion de cada componente - Props y tipos - Estados locales (useState, useEffect) - Hooks utilizados - Eventos y acciones 2. Analizar_APIs: - Endpoints consumidos - Metodos HTTP - Request schemas - Response schemas esperados - Manejo de errores - Loading states 3. Analizar_Multimedia: - Imagenes usadas (avatars, logos) - Tipo: GET (carga) o POST (upload) 4. Identificar_Gaps: - Funcionalidades documentadas no implementadas - Funcionalidades implementadas no documentadas - Gaps criticos (2FA UI, biometrics) 5. Documentar: - Crear reporte markdown estructurado - Incluir tablas de componentes - Incluir matriz de APIs - Incluir lista de gaps artefactos_output: - OQI-001-ANALISIS-COMPONENTES.md - OQI-001-CONTRATOS-API.md - OQI-001-MULTIMEDIA.md - OQI-001-GAPS.md criterios_aceptacion: - Todos los componentes documentados - Todos los endpoints identificados - Schemas de request/response capturados - Gaps priorizados (P0, P1, P2, P3) ``` ### Subtarea ST-002: Analisis OQI-002 (educativo) ```yaml id: ST-002 epic: OQI-002-education progreso_actual: 30% agente: general-purpose (haiku) modelo: haiku scope: ruta: apps/frontend/src/modules/education/ paginas: - Courses.tsx - CourseDetail.tsx - Lesson.tsx - Quiz.tsx - MyLearning.tsx - Leaderboard.tsx componentes_clave: - VideoProgressPlayer.tsx (CRITICO: multimedia) - CourseCard.tsx - CourseProgressTracker.tsx - LessonNotes.tsx - QuizQuestion.tsx - AchievementBadge.tsx - CertificatePreview.tsx - "... (15+ componentes)" tareas_del_subagente: 1. Analizar_VideoPlayer: - Caracteristicas implementadas (bookmarks, notas, velocidades) - Props del componente - APIs de persistencia (bookmarks, progreso) - Formatos de video soportados - Manejo de errores de carga - Progressive download (si existe) 2. Analizar_Componentes_Educativos: - Funcion de cada componente - Props y tipos - Integracion con gamificacion 3. Analizar_APIs_Educacion: - GET /education/courses - GET /education/lessons/:id - POST /education/lessons/:id/progress - POST /education/lessons/:id/complete - GET /education/quizzes/:id - POST /education/quizzes/:id/submit - GET /education/achievements - GET /education/leaderboard 4. Analizar_Multimedia: - Videos: GET (streaming), POST (upload si existe) - Imagenes: GET (course thumbnails) - Certificados: GET (PDF generation) 5. Identificar_Gaps: - Live streaming (documentado, no implementado) - Creator UI (no existe) - YouTube/Vimeo integration (no existe) artefactos_output: - OQI-002-ANALISIS-COMPONENTES.md - OQI-002-VIDEO-PLAYER-SPEC.md (detallado) - OQI-002-CONTRATOS-API.md - OQI-002-MULTIMEDIA.md - OQI-002-GAPS.md criterios_aceptacion: - VideoProgressPlayer completamente documentado - Todos los endpoints de educacion mapeados - Multimedia (video/imagenes/PDFs) identificado - Gaps criticos listados ``` ### Subtarea ST-003: Analisis OQI-003 (trading-charts) ```yaml id: ST-003 epic: OQI-003-trading-charts progreso_actual: 40% agente: general-purpose (haiku) modelo: haiku scope: ruta: apps/frontend/src/modules/trading/ pagina_principal: Trading.tsx (dashboard complejo) componentes_charts: - CandlestickChart.tsx - CandlestickChartWithML.tsx - TradingChart.tsx - ChartToolbar.tsx - ChartDrawingToolsPanel.tsx - IndicatorConfigPanel.tsx componentes_ml: - MLSignalsPanel.tsx - ICTAnalysisCard.tsx - EnsembleSignalCard.tsx componentes_trading: - OrderForm.tsx - AdvancedOrderEntry.tsx - PositionsList.tsx - PaperTradingPanel.tsx - OrderBookPanel.tsx componentes_monitoreo: - AlertsPanel.tsx - TradeExecutionHistory.tsx - RiskMonitor.tsx - AccountHealthDashboard.tsx componentes_mt4: - MT4ConnectionStatus.tsx - MT4LiveTradesPanel.tsx - MT4PositionsManager.tsx "... (35+ componentes)" tareas_del_subagente: 1. Analizar_Charts: - lightweight-charts integration - Indicadores implementados (SMA, EMA, RSI, MACD, Bollinger) - Overlays ML - Drawing tools (UI vs logica) - Persistencia de dibujos 2. Analizar_Trading_Components: - OrderForm: tipos de ordenes (market/limit/OCO) - Paper trading: engine local vs backend - Posiciones: modificacion SL/TP - Alertas: creacion/edicion/eliminacion 3. Analizar_APIs_Trading: - GET /trading/market/klines/:symbol - GET /trading/market/price/:symbol - GET /trading/market/order-book/:symbol - GET /trading/indicators/* - POST /trading/paper/orders - GET /trading/alerts - POST /trading/alerts 4. Analizar_WebSocket: - Implementacion actual (polling vs WebSocket) - Frecuencia de polling - Endpoints WebSocket (si existen) 5. Analizar_MT4_Integration: - Estado de componentes MT4 - Conexion real vs stubs - MCP MT4 Connector (estado) 6. Identificar_Gaps: - Drawing tools sin persistencia - WebSocket no implementado (usa polling) - MT4 conexion real (solo UI stubs) - Backtesting visual interactivo artefactos_output: - OQI-003-ANALISIS-COMPONENTES.md - OQI-003-CHARTS-SPEC.md (detallado) - OQI-003-CONTRATOS-API.md - OQI-003-WEBSOCKET-ANALYSIS.md - OQI-003-MT4-STATUS.md - OQI-003-GAPS.md criterios_aceptacion: - Todos los 35+ componentes documentados - Chart functionality mapeada - APIs de trading identificadas - WebSocket vs polling clarificado - MT4 integration status documentado ``` ### Subtarea ST-004: Analisis OQI-004 (cuentas-inversion) ```yaml id: ST-004 epic: OQI-004-investment-accounts progreso_actual: 35% agente: general-purpose (haiku) scope: ruta: apps/frontend/src/modules/investment/ paginas: - Investment.tsx - Portfolio.tsx - Products.tsx - ProductDetail.tsx - AccountDetail.tsx - Withdrawals.tsx - Transactions.tsx - Reports.tsx componentes: - DepositForm.tsx - WithdrawForm.tsx tareas_del_subagente: 1. Analizar_Componentes_Inversion 2. Analizar_APIs_Investment 3. Identificar_Gaps (creacion cuentas, optimizacion) artefactos_output: - OQI-004-ANALISIS-COMPONENTES.md - OQI-004-CONTRATOS-API.md - OQI-004-GAPS.md ``` ### Subtarea ST-005: Analisis OQI-005 (pagos-stripe) ```yaml id: ST-005 epic: OQI-005-payments-stripe progreso_actual: 50% agente: general-purpose (haiku) scope: ruta: apps/frontend/src/modules/payments/ paginas: - Pricing.tsx - Billing.tsx - CheckoutSuccess.tsx - CheckoutCancel.tsx componentes: - PricingCard.tsx - SubscriptionCard.tsx - SubscriptionUpgradeFlow.tsx - PaymentMethodForm.tsx - PaymentMethodsList.tsx - WalletCard.tsx - WalletDepositModal.tsx - WalletWithdrawModal.tsx - InvoiceList.tsx - TransactionHistory.tsx - "... (11+ componentes)" tareas_del_subagente: 1. Analizar_Stripe_Integration 2. Analizar_Wallet_Components 3. Analizar_APIs_Payments 4. Identificar_Gaps (refunds UI, historico cambios) artefactos_output: - OQI-005-ANALISIS-COMPONENTES.md - OQI-005-STRIPE-INTEGRATION.md - OQI-005-WALLET-SPEC.md - OQI-005-CONTRATOS-API.md - OQI-005-GAPS.md ``` ### Subtarea ST-006: Analisis OQI-006 (senales-ml) ```yaml id: ST-006 epic: OQI-006-ml-signals progreso_actual: 60% agente: general-purpose (haiku) scope: ruta: apps/frontend/src/modules/ml/ pagina: MLDashboard.tsx componentes_signals: - PredictionCard.tsx - AMDPhaseIndicator.tsx - SignalsTimeline.tsx - AccuracyMetrics.tsx - SignalPerformanceTracker.tsx - ConfidenceMeter.tsx - EnsembleSignalCard.tsx - ICTAnalysisCard.tsx - BacktestResultsVisualization.tsx - "... (11 componentes)" documentacion_existente: - README.md - USAGE_EXAMPLES.md - VALIDATION_CHECKLIST.md tareas_del_subagente: 1. Analizar_ML_Components (11 componentes) 2. Analizar_APIs_ML_Engine 3. Analizar_Documentacion_Existente 4. Identificar_Gaps (WebSocket, exportacion) artefactos_output: - OQI-006-ANALISIS-COMPONENTES.md - OQI-006-CONTRATOS-API.md - OQI-006-DOC-REVIEW.md - OQI-006-GAPS.md ``` ### Subtarea ST-007: Analisis OQI-007 (llm-strategy-agent) ```yaml id: ST-007 epic: OQI-007-llm-agent progreso_actual: 25% agente: general-purpose (haiku) scope: ruta: apps/frontend/src/modules/assistant/ pagina: Assistant.tsx componentes: - ChatHeader.tsx - ChatInput.tsx - ChatMessage.tsx - MessageList.tsx - MessageFeedback.tsx - MessageSearch.tsx - ConversationHistory.tsx - ToolCallCard.tsx - SignalExecutionPanel.tsx - MarkdownRenderer.tsx - "... (10 componentes)" tareas_del_subagente: 1. Analizar_Chat_Components 2. Analizar_LLM_Integration 3. Analizar_Tool_Calls (analyze_symbol, get_portfolio, get_signals) 4. Identificar_Gaps (memory, file uploads, streaming) artefactos_output: - OQI-007-ANALISIS-COMPONENTES.md - OQI-007-LLM-INTEGRATION.md - OQI-007-CONTRATOS-API.md - OQI-007-GAPS.md ``` ### Subtarea ST-008: Analisis OQI-008 (portfolio-manager) ```yaml id: ST-008 epic: OQI-008-portfolio-manager progreso_actual: 20% agente: general-purpose (haiku) scope: ruta: apps/frontend/src/modules/portfolio/ paginas: - PortfolioDashboard.tsx - CreatePortfolio.tsx - CreateGoal.tsx - EditAllocations.tsx componentes: - AllocationChart.tsx (pie/donut) - AllocationTable.tsx - PerformanceChart.tsx (line chart) - GoalCard.tsx - RebalanceCard.tsx tareas_del_subagente: 1. Analizar_Portfolio_Components 2. Analizar_Charts (AllocationChart, PerformanceChart) 3. Analizar_APIs_Portfolio 4. Identificar_Gaps (optimizacion automatica, Markowitz, benchmarks) artefactos_output: - OQI-008-ANALISIS-COMPONENTES.md - OQI-008-CHARTS-SPEC.md - OQI-008-CONTRATOS-API.md - OQI-008-GAPS.md ``` ### Subtarea ST-009: Analisis OQI-009 (mt4-gateway) ```yaml id: ST-009 epic: OQI-009-mt4-gateway progreso_actual: 15% agente: general-purpose (haiku) scope: nota: "No hay modulo especifico, componentes distribuidos en trading/" componentes: - MT4ConnectionStatus.tsx - MT4LiveTradesPanel.tsx - MT4PositionsManager.tsx tareas_del_subagente: 1. Analizar_MT4_Components (solo 3) 2. Analizar_MCP_Connector (estado) 3. Identificar_Gaps (conexion real, sincronizacion) artefactos_output: - OQI-009-ANALISIS-COMPONENTES.md - OQI-009-MCP-STATUS.md - OQI-009-GAPS.md ``` --- ## FASE 2: Consolidacion (Agente Principal) ### Subtarea ST-010: Consolidar Reportes de Componentes ```yaml id: ST-010 agente: claude-opus-4.5 (principal) dependencias: [ST-001, ST-002, ST-003, ST-004, ST-005, ST-006, ST-007, ST-008, ST-009] tareas: 1. Leer_Reportes_Subagentes: - OQI-001-ANALISIS-COMPONENTES.md - OQI-002-ANALISIS-COMPONENTES.md - "... (9 reportes)" 2. Consolidar_en_Matriz: - Tabla maestra de todos los componentes - Columnas: Epic, Componente, Funcion, Props, APIs, Multimedia, Estado - Ordenar por epic 3. Generar_Estadisticas: - Total componentes por epic - Total componentes documentados vs sin docs - Cobertura de documentacion artefactos_output: - COMPONENTS-MASTER-MATRIX.md - COMPONENTS-STATISTICS.md ``` ### Subtarea ST-011: Consolidar Contratos de API ```yaml id: ST-011 agente: claude-opus-4.5 dependencias: [ST-001, ..., ST-009] tareas: 1. Leer_Contratos_Subagentes: - OQI-001-CONTRATOS-API.md - "... (9 documentos)" 2. Consolidar_en_Matriz: - Tabla maestra de endpoints - Columnas: Epic, Endpoint, Metodo, Request Schema, Response Schema, Componente Consumidor - Agrupar por modulo 3. Validar_Coherencia: - Endpoints consumidos existen en backend? - Schemas coinciden con Swagger? - Endpoints duplicados? artefactos_output: - API-CONTRACTS-MASTER-MATRIX.md - API-VALIDATION-REPORT.md ``` ### Subtarea ST-012: Consolidar Multimedia ```yaml id: ST-012 agente: claude-opus-4.5 dependencias: [ST-001, ..., ST-009] tareas: 1. Leer_Multimedia_Subagentes: - OQI-002-MULTIMEDIA.md (videos) - OQI-003-MULTIMEDIA.md (charts) - OQI-005-MULTIMEDIA.md (imagenes) 2. Consolidar_en_Matriz: - Tipo: Video | Imagen | Audio | PDF | Chart - Operacion: GET | POST | DELETE - Componente: Donde se usa - Formato: MP4, JPG, PNG, etc. - API: Endpoint si aplica artefactos_output: - MULTIMEDIA-MASTER-MATRIX.md ``` ### Subtarea ST-013: Consolidar Gaps ```yaml id: ST-013 agente: claude-opus-4.5 dependencias: [ST-001, ..., ST-009] tareas: 1. Leer_Gaps_Subagentes: - OQI-001-GAPS.md - "... (9 documentos)" 2. Categorizar_Gaps: - Por tipo: Documentacion | Implementacion | Integracion - Por prioridad: P0 | P1 | P2 | P3 - Por esfuerzo: S | M | L | XL 3. Generar_Roadmap: - Quick wins (P0 + S) - Features criticas (P0 + M/L) - Nice-to-have (P2/P3) artefactos_output: - GAPS-CONSOLIDATED.md - IMPLEMENTATION-ROADMAP.md ``` --- ## FASE 3: Analisis de Purga ### Subtarea ST-014: Identificar Documentacion Obsoleta ```yaml id: ST-014 agente: general-purpose (haiku) tareas: 1. Listar_Tareas_Completadas: - Buscar en orchestration/tareas/ - Filtrar estado: completada - Identificar fechas antiguas (>30 dias) 2. Verificar_Relevancia: - Tarea replicada en otra documentacion? - Definiciones duplicadas? - User stories ya implementadas? 3. Generar_Plan_Purga: - Lista de archivos a eliminar - Justificacion por archivo - Archivos a conservar (historico) artefactos_output: - PURGE-CANDIDATES.md - PURGE-JUSTIFICATION.md - PURGE-PLAN.md ``` --- ## FASE 4: Analisis de Integracion ### Subtarea ST-015: Identificar Definiciones Faltantes ```yaml id: ST-015 agente: general-purpose (haiku) tareas: 1. Comparar_Implementacion_vs_Docs: - Componentes implementados sin ET specs - Features implementadas sin user stories - APIs sin documentacion Swagger 2. Generar_Lista_Faltantes: - Especificaciones tecnicas a crear - User stories a redactar - Documentacion de API a completar artefactos_output: - MISSING-DEFINITIONS.md - INTEGRATION-PLAN.md ``` --- ## FASE 5: Grafo de Dependencias ### Subtarea ST-016: Analizar Dependencias entre Componentes ```yaml id: ST-016 agente: Plan tareas: 1. Analizar_Imports: - Leer imports de cada archivo - Construir grafo de dependencias - Detectar dependencias circulares 2. Ordenar_Logicamente: - Topological sort - Agrupar por modulo - Identificar componentes raiz vs hoja 3. Generar_Visualizacion: - Mermaid diagram - Niveles de dependencia artefactos_output: - DEPENDENCY-GRAPH.md - DEPENDENCY-ANALYSIS.md - CIRCULAR-DEPENDENCIES.md (si existen) ``` --- ## FASE 6: Documentacion Final ### Subtarea ST-017: Crear Reporte Ejecutivo ```yaml id: ST-017 agente: claude-opus-4.5 tareas: 1. Consolidar_Todos_Entregables 2. Generar_Resumen_Ejecutivo 3. Generar_Recomendaciones artefactos_output: - EXECUTIVE-SUMMARY.md - RECOMMENDATIONS.md ``` ### Subtarea ST-018: Actualizar Inventarios ```yaml id: ST-018 agente: claude-opus-4.5 tareas: - Actualizar FRONTEND_INVENTORY.yml - Actualizar MASTER_INVENTORY.yml - Actualizar _INDEX.yml de tareas artefactos_output: - FRONTEND_INVENTORY.yml (actualizado) - MASTER_INVENTORY.yml (actualizado) - _INDEX.yml (actualizado) ``` --- ## Orden de Ejecucion ``` FASE 1: Analisis Paralelo ┌────────────────────────────────────────┐ │ ST-001 (Auth) │ │ │ ST-002 (Educacion) │ │ │ ST-003 (Trading) │ PARALELO │ │ ST-004 (Inversion) │ (9 agentes) │ │ ST-005 (Pagos) │ │ │ ST-006 (ML Signals) │ │ │ ST-007 (LLM Agent) │ │ │ ST-008 (Portfolio) │ │ │ ST-009 (MT4) │ │ └────────────────────────────────────────┘ ↓ FASE 2: Consolidacion ┌────────────────────────────────────────┐ │ ST-010 (Componentes) │ │ │ ST-011 (APIs) │ SECUENCIAL │ │ ST-012 (Multimedia) │ (Opus) │ │ ST-013 (Gaps) │ │ └────────────────────────────────────────┘ ↓ FASE 3-4: Purga e Integracion ┌────────────────────────────────────────┐ │ ST-014 (Purga) │ PARALELO │ │ ST-015 (Integracion) │ (2 agentes) │ └────────────────────────────────────────┘ ↓ FASE 5: Dependencias ┌────────────────────────────────────────┐ │ ST-016 (Grafo) │ SECUENCIAL │ └────────────────────────────────────────┘ ↓ FASE 6: Documentacion ┌────────────────────────────────────────┐ │ ST-017 (Ejecutivo) │ SECUENCIAL │ │ ST-018 (Inventarios) │ (Opus) │ └────────────────────────────────────────┘ ``` --- ## Criterios de Aceptacion Global ### Funcionales - [x] Los 9 epics analizados completamente - [ ] Matriz maestra de componentes generada - [ ] Matriz maestra de APIs generada - [ ] Matriz maestra de multimedia generada - [ ] Plan de purga creado - [ ] Plan de integracion creado - [ ] Grafo de dependencias generado - [ ] Roadmap de implementacion creado - [ ] Reporte ejecutivo completado ### Tecnicos - [ ] Formato markdown coherente en todos los entregables - [ ] Tablas bien formateadas - [ ] Links internos funcionando - [ ] Ubicacion correcta de archivos ### Documentacion - [ ] Inventarios actualizados - [ ] _INDEX.yml actualizado - [ ] METADATA.yml completado - [ ] Todas las fases CAPVED documentadas --- ## Estimacion de Tiempos ```yaml FASE_1_Analisis_Paralelo: duracion: 2-3 horas nota: "9 agentes en paralelo, carga asincrónica" FASE_2_Consolidacion: duracion: 1 hora nota: "Procesamiento secuencial" FASE_3_4_Purga_Integracion: duracion: 30 min nota: "2 agentes en paralelo" FASE_5_Dependencias: duracion: 30 min FASE_6_Documentacion: duracion: 30 min TOTAL: 4.5-5.5 horas (con paralelizacion) TOTAL_SIN_PARALELIZACION: 15-20 horas AHORRO: ~70% de tiempo ``` --- ## Riesgos y Mitigaciones (Actualizados) ```yaml riesgos_actualizados: - id: R1 descripcion: "Subagentes pueden divergir en formato de reportes" mitigacion: "Proveer template exacto a cada subagente" probabilidad: media impacto: bajo - id: R2 descripcion: "Analisis de 208 archivos puede generar reportes muy largos" mitigacion: "Usar tablas compactas, evitar texto verboso" probabilidad: alta impacto: medio - id: R3 descripcion: "Consolidacion puede tomar mas tiempo que analisis" mitigacion: "Usar scripts automatizados si es necesario" probabilidad: media impacto: medio - id: R4 descripcion: "Purga de docs puede eliminar informacion valiosa" mitigacion: "Revision manual antes de eliminar, backup" probabilidad: baja impacto: alto - id: R5 descripcion: "Grafo de dependencias puede ser muy complejo" mitigacion: "Limitar a 3 niveles de profundidad" probabilidad: media impacto: bajo ``` --- ## Siguientes Pasos 1. **Aprobar Plan**: Validar que la estructura de subtareas es correcta 2. **Fase V**: Ejecutar validacion del plan 3. **Fase E**: Ejecutar subtareas en orden establecido 4. **Fase D**: Documentar resultados y actualizar inventarios --- **FASE P COMPLETADA** **Siguiente Fase:** V - Validacion