trading-platform/orchestration/tareas/2026-01-30/TASK-2026-01-30-ANALISIS-INTEGRACION/PLAN-MAESTRO.md

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