# 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
