3c2d98707c
- Archivados 5 análisis obsoletos a _archive/2026-01-25/ - MASTER-ANALYSIS-PLAN marcada SUPERSEDIDA - FRONTEND-COMPREHENSIVE-AUDIT marcada COMPLETADA (7+ entregables) - FRONTEND-MODULE-DOCS marcada CANCELADA (P3, sin progreso) - BLOCKER-001-TOKEN-REFRESH marcada POSTERGADA - Actualizado PROJECT-STATUS.md y _INDEX.yml Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
274 lines
13 KiB
Markdown
274 lines
13 KiB
Markdown
# 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
|