# PLAN MAESTRO - Análisis de Integración Trading-Platform **Fecha:** 2026-01-30 **Modo:** @ANALYSIS (C+A+P) **Agente:** Claude Code (Opus 4.5) - Perfil Arquitecto/Orquestador **Estado:** Fase de Planeación --- ## 1. RESUMEN EJECUTIVO ### 1.1 Objetivo de la Tarea Análisis detallado y planeación de la coherencia entre: - Workspace orchestration (`workspace-v2/orchestration/`) - Trading-platform orchestration (`projects/trading-platform/orchestration/`) - Template-saas como base de características (`projects/template-saas/`) - Documentación en `docs/` del workspace vs proyecto ### 1.2 Alcance - Validar sincronización de inventarios - Identificar módulos reutilizables no integrados - Mapear documentación faltante - Crear plan de purga de elementos obsoletos - Generar plan jerárquico de ejecución con dependencias CAPVED --- ## 2. HALLAZGOS DEL ANÁLISIS EXPLORATORIO ### 2.1 Estado Actual de Trading-Platform | Aspecto | Estado | Completitud | Fuente | |---------|--------|-------------|--------| | Tareas Activas | 4 | - | _INDEX.yml | | Tareas Archivadas | 21 | - | _archive/2026-01/ | | Completitud Global | ~60% | - | PROJECT-STATUS.md | | DDL | 95% | 89 tablas, 10 schemas | LOCAL | | Backend | 48% | 113+ endpoints | LOCAL | | Frontend | 65% | 189 componentes | LOCAL | | ML Engine | 75% | 12 modelos | LOCAL | ### 2.2 Discrepancias Identificadas | Fuente | Métrica DDL-Backend | Métrica Backend-Frontend | |--------|---------------------|-------------------------| | Workspace orchestration | 74% | N/A | | Proyecto local | 94% | 90% | | **Discrepancia** | **20%** | **N/A** | **Causa probable:** El workspace usa métricas antiguas o diferentes criterios de medición. ### 2.3 Estado de Template-SaaS | Categoría | Módulos | Estado | Reutilizabilidad para Trading | |-----------|---------|--------|-------------------------------| | Core (SAAS-001 a 005) | Auth, Tenants, Users, Billing, Plans | 100% | ALTA (90%+) | | Platform (SAAS-006 a 014) | AI, Notifications, Audit, Feature Flags, etc. | 100% | ALTA (80%+) | | Extended (SAAS-015 a 022) | OAuth, Analytics, Reports, Sales, Portfolio, etc. | 100% | MEDIA-ALTA (50-80%) | **Template-SaaS tiene 22 módulos completamente implementados con 750 tests unitarios y 47 E2E tests.** ### 2.4 Documentación | Ubicación | Archivos | Cobertura Trading | |-----------|----------|-------------------| | Workspace docs/60-proyectos/ | ~5 archivos | 1 línea | | Trading-platform docs/ | 284 archivos | Completa | **Falta:** Documentación a nivel workspace que integre trading-platform (arquitectura, WebSocket protocol, ML integration). --- ## 3. ESTRUCTURA DE TAREAS CAPVED ### 3.1 Diagrama de Dependencias ``` FASE 1: ANÁLISIS (C+A) - Paralelo ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────┐ │ │ │ 1.1 │ │ 1.2 │ │ 1.3 │ │ 1.4 │ │ │ │ Inventarios │ │ Template-SaaS│ │ Documentación│ │ Purga │ │ │ │ Coherencia │ │ Integración │ │ Gaps │ │ Análisis │ │ │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └────┬─────┘ │ │ │ │ │ │ │ └─────────┼─────────────────┼─────────────────┼───────────────┼───────┘ │ │ │ │ └─────────────────┴────────┬────────┴───────────────┘ │ ▼ FASE 2: PLANEACIÓN (P+V) - Secuencial ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ ┌──────────────────┐ │ │ │ 2.1 │ │ │ │ Matriz de Gaps │ │ │ │ Consolidada │ │ │ └────────┬─────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ 2.2 │ │ │ │ Plan Jerárquico │ │ │ │ con Dependencias │ │ │ └────────┬─────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────┐ │ │ │ 2.3 │ │ │ │ Validación CAPVED│ │ │ │ (Gate V) │ │ │ └────────┬─────────┘ │ │ │ │ └───────────┼──────────────────────────────────────────────────────────┘ │ ▼ [Solo si Gate V pasa] FASE 3: EJECUCIÓN (E) - Por definir ┌─────────────────────────────────────────────────────────────────────┐ │ 3.1 Sincronización de Inventarios (P0) │ │ 3.2 Integración de Módulos Template-SaaS (P1) │ │ 3.3 Creación de Documentación Faltante (P1) │ │ 3.4 Ejecución de Purga (P2) │ └─────────────────────────────────────────────────────────────────────┘ FASE 4: DOCUMENTACIÓN Y CIERRE (D) ┌─────────────────────────────────────────────────────────────────────┐ │ 4.1 Actualizar inventarios │ │ 4.2 Actualizar PROJECT-STATUS.md │ │ 4.3 Cerrar tareas │ │ 4.4 Commit + Push │ └─────────────────────────────────────────────────────────────────────┘ ``` ### 3.2 Lista de Tareas con IDs | ID | Tarea | Tipo | Prioridad | Dependencias | Estado | |----|-------|------|-----------|--------------|--------| | #1 | FASE 1: Análisis Integral | MAIN | P0 | - | EN_PROGRESO | | #2 | 1.1 Auditar coherencia inventarios | SUB | P0 | #1 | PENDIENTE | | #3 | 1.2 Auditar integración template-saas | SUB | P0 | #1 | PENDIENTE | | #4 | 1.3 Auditar documentación | SUB | P0 | #1 | PENDIENTE | | #5 | 1.4 Análisis de purga | SUB | P1 | #1 | PENDIENTE | | #6 | 2.1 Matriz consolidada de gaps | SUB | P0 | #2,#3,#4,#5 | PENDIENTE | | #7 | 2.2 Plan jerárquico con dependencias | SUB | P0 | #6 | PENDIENTE | | #8 | 2.3 Validación CAPVED (Gate V) | SUB | P0 | #7 | PENDIENTE | --- ## 4. DETALLE DE SUBTAREAS FASE 1 ### 4.1 Subtarea 1.1: Coherencia de Inventarios **Archivos a comparar:** | Tipo | Workspace | Proyecto | |------|-----------|----------| | Backend | orchestration/inventarios/BACKEND_INVENTORY.yml (L216-253) | orchestration/inventarios/BACKEND_INVENTORY.yml | | Frontend | orchestration/inventarios/FRONTEND_INVENTORY.yml (L218-252) | orchestration/inventarios/FRONTEND_INVENTORY.yml | | Database | orchestration/inventarios/DATABASE_INVENTORY.yml (L59-76) | orchestration/inventarios/DATABASE_INVENTORY.yml | | Master | - | orchestration/inventarios/MASTER_INVENTORY.yml | **Validaciones:** - [ ] Módulos coinciden - [ ] Métricas coinciden - [ ] Fechas de actualización coherentes ### 4.2 Subtarea 1.2: Integración Template-SaaS **Módulos a evaluar (prioridad por reutilizabilidad):** | Módulo | Template | Trading Equivalente | Acción Sugerida | |--------|----------|---------------------|-----------------| | Auth (SAAS-001) | 100% | OQI-001 (85%) | Evaluar gaps OAuth/MFA | | Notifications (SAAS-007) | 100% | Parcial | Integrar WebSocket gateway | | Audit (SAAS-008) | 100% | Parcial | Adoptar patrón completo | | Feature Flags (SAAS-009) | 100% | No existe | Evaluar adopción | | Analytics (SAAS-016) | 100% | Parcial | Integrar dashboard patterns | | Portfolio (SAAS-019) | 100% | OQI-008 (45%) | Evaluar merge | | Commissions (SAAS-020) | 100% | Trading fees | Adaptar para fees | ### 4.3 Subtarea 1.3: Gaps de Documentación **Documentación faltante a nivel workspace:** | Documento | Ubicación Sugerida | Prioridad | |-----------|-------------------|-----------| | PROYECTO-TRADING-PLATFORM.md | docs/60-proyectos/ | P0 | | WEBSOCKET-PROTOCOL.md | docs/10-arquitectura/ | P1 | | ML-INTEGRATION-GUIDE.md | docs/10-arquitectura/ | P1 | **Documentación faltante a nivel proyecto:** | Documento | Ubicación Sugerida | Prioridad | |-----------|-------------------|-----------| | DATABASE-SCHEMA.md | docs/01-arquitectura/ | P1 | | FRONTEND-ARCHITECTURE.md | docs/01-arquitectura/ | P2 | | DEPLOYMENT.md | docs/95-guias-desarrollo/ | P2 | ### 4.4 Subtarea 1.4: Análisis de Purga **Elementos a revisar:** | Tipo | Cantidad | Ubicación | Acción | |------|----------|-----------|--------| | Tareas archivadas | 21 | _archive/2026-01/ | Revisar duplicados | | Análisis antiguos | 15 | orchestration/analisis/ | Consolidar/Eliminar | | Docs del proyecto | 284 | docs/ | Identificar obsoletos | --- ## 5. CRITERIOS DE ACEPTACIÓN GLOBALES ### 5.1 Para Fase 1 (Análisis) - [ ] Todos los inventarios comparados y discrepancias documentadas - [ ] Matriz de módulos template-saas vs trading-platform completa - [ ] Lista de documentación faltante identificada - [ ] Lista de candidatos a purga generada ### 5.2 Para Fase 2 (Planeación) - [ ] Matriz de gaps con prioridades P0-P3 - [ ] Plan jerárquico con todas las tareas y dependencias - [ ] Validación CAPVED completada y aprobada ### 5.3 Para Fase 3 (Ejecución) - [ ] Inventarios sincronizados - [ ] Módulos integrados según plan - [ ] Documentación creada - [ ] Purga ejecutada ### 5.4 Para Fase 4 (Cierre) - [ ] Build pasa (backend + frontend) - [ ] Lint pasa - [ ] Inventarios actualizados - [ ] PROJECT-STATUS.md actualizado - [ ] Commit + Push completado --- ## 6. PRÓXIMOS PASOS 1. **Desbloquear subtareas de Fase 1** (pueden ejecutarse en paralelo) 2. **Asignar agentes** a cada subtarea 3. **Ejecutar análisis** en paralelo (1.1, 1.2, 1.3, 1.4) 4. **Consolidar resultados** en matriz (2.1) 5. **Crear plan detallado** (2.2) 6. **Validar** (2.3) 7. **Proceder a ejecución** si Gate V aprueba --- ## 7. NOTAS IMPORTANTES ### 7.1 Trading-Platform es STANDALONE - NO hereda de template-saas directamente - Puede COPIAR módulos de template-saas - NO hay propagación hacia otros proyectos ### 7.2 Continúa TASK-2026-01-27-MASTER-ANALYSIS-PLAN - Esta tarea complementa el análisis maestro al 50% - Integrar hallazgos con los existentes ### 7.3 Reglas de Edición - Máximo 50 líneas por cambio - Sin placeholders - Verificar build/lint después de cada cambio --- **Documento generado por:** Claude Code (Opus 4.5) **Fecha:** 2026-01-30 **Versión:** 1.0.0