trading-platform/orchestration/tareas/2026-01-30/TASK-2026-01-30-ANALISIS-INTEGRACION/EXECUTION-PLAN-HIERARCHICAL.md
Adrian Flores Cortes 3c2d98707c [TASK-2026-01-30-ANALISIS-INTEGRACION] chore: Sprint 3 - Purga y limpieza
- 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>
2026-01-30 15:26:40 -06:00

13 KiB

Plan de Ejecución Jerárquico

Subtarea: 2.2 Fecha: 2026-01-30 Agente: Claude Code (Opus 4.5) Modo: @ANALYSIS → @FULL (para ejecución)


1. ESTRUCTURA JERÁRQUICA COMPLETA

TAREA PRINCIPAL: Integración Trading-Platform + Template-SaaS + Workspace
├── FASE 1: ANÁLISIS (C+A) ████████████████████ 100% COMPLETADA
│   ├── 1.1 Coherencia inventarios ✓
│   ├── 1.2 Integración template-saas ✓
│   ├── 1.3 Gaps documentación ✓
│   └── 1.4 Análisis purga ✓
│
├── FASE 2: PLANEACIÓN (P+V) █████████████░░░░░░░ 67% EN PROGRESO
│   ├── 2.1 Matriz de gaps ✓
│   ├── 2.2 Plan jerárquico (ESTE DOCUMENTO) ← EN PROGRESO
│   └── 2.3 Validación CAPVED (Gate V)
│
├── FASE 3: EJECUCIÓN (E) ░░░░░░░░░░░░░░░░░░░░ 0% PENDIENTE
│   ├── SPRINT 1: Coherencia Base (P0 + P1 parcial)
│   │   ├── 3.1.1 Actualizar BACKEND_INVENTORY.yml (workspace)
│   │   ├── 3.1.2 Actualizar FRONTEND_INVENTORY.yml (workspace)
│   │   ├── 3.1.3 Actualizar DATABASE_INVENTORY.yml (workspace)
│   │   ├── 3.1.4 Crear PROYECTO-TRADING-PLATFORM.md
│   │   └── 3.1.5 Actualizar PROYECTOS-PRIORITARIOS.md
│   │
│   ├── SPRINT 2: Integración Template-SaaS (P1)
│   │   ├── 3.2.1 Integrar SAAS-008 Audit Logs
│   │   ├── 3.2.2 Integrar SAAS-009 Feature Flags
│   │   └── 3.2.3 Evaluar/Integrar MFA (SAAS-001)
│   │
│   ├── SPRINT 3: Purga y Mejoras (P2)
│   │   ├── 3.3.1 Archivar análisis obsoletos
│   │   ├── 3.3.2 Cerrar tareas estancadas
│   │   ├── 3.3.3 Consolidar documentación arquitectura
│   │   └── 3.3.4 Completar movimiento _archive/
│   │
│   └── SPRINT 4: Webhooks y Documentación (P2-P3)
│       ├── 3.4.1 Integrar SAAS-010 Webhooks
│       ├── 3.4.2 Crear DATABASE-SCHEMA.md
│       └── 3.4.3 Crear TESTING-STRATEGY.md
│
└── FASE 4: DOCUMENTACIÓN Y CIERRE (D) ░░░░░░░░░░░░░░░░░░░░ 0% PENDIENTE
    ├── 4.1 Actualizar PROJECT-STATUS.md
    ├── 4.2 Actualizar _INDEX.yml de tareas
    ├── 4.3 Cerrar tarea principal
    └── 4.4 Commit + Push

2. SPRINT 1: COHERENCIA BASE

2.1 Detalle de Tareas

TASK-3.1.1: Actualizar BACKEND_INVENTORY.yml

Campo Valor
ID TASK-3.1.1
Tipo SYNC
Prioridad P0
Dependencias Ninguna
Bloquea TASK-3.1.4
Ubicación workspace-v2/orchestration/inventarios/BACKEND_INVENTORY.yml

Acciones:

  1. Leer líneas 216-253
  2. Agregar módulos faltantes: users, education, notifications, payments, admin, llm, agents, portfolio, shared
  3. Incluir métricas: total_controllers: 25, total_services: 38, total_endpoints: 79
  4. Actualizar fecha: 2026-01-30

Criterios de Aceptación:

  • 13 módulos listados (no 4)
  • Métricas de controllers/services incluidas
  • Fecha actualizada

TASK-3.1.2: Actualizar FRONTEND_INVENTORY.yml

Campo Valor
ID TASK-3.1.2
Tipo SYNC
Prioridad P1
Dependencias Ninguna (paralelo con 3.1.1)
Bloquea Ninguna
Ubicación workspace-v2/orchestration/inventarios/FRONTEND_INVENTORY.yml

Acciones:

  1. Leer líneas 218-252
  2. Actualizar progress: "30%" → "38%"
  3. Agregar métricas: total_componentes: 146, total_stores: 9, total_services: 16
  4. Actualizar fecha

Criterios de Aceptación:

  • Progress actualizado a 38%
  • Métricas de componentes incluidas

TASK-3.1.3: Actualizar DATABASE_INVENTORY.yml

Campo Valor
ID TASK-3.1.3
Tipo SYNC
Prioridad P1
Dependencias Ninguna (paralelo)
Bloquea Ninguna
Ubicación workspace-v2/orchestration/inventarios/DATABASE_INVENTORY.yml

Acciones:

  1. Leer líneas 59-76
  2. Agregar schemas faltantes: portfolio, market_data, notifications (si aplican)
  3. Agregar total_tablas: 78
  4. Actualizar fecha

Criterios de Aceptación:

  • 11 schemas listados
  • Total tablas incluido

TASK-3.1.4: Crear PROYECTO-TRADING-PLATFORM.md

Campo Valor
ID TASK-3.1.4
Tipo CREATE
Prioridad P0
Dependencias 3.1.1 (para métricas correctas)
Bloquea 3.1.5
Ubicación workspace-v2/docs/60-proyectos/PROYECTO-TRADING-PLATFORM.md

Contenido mínimo:

# Trading Platform

## Descripción
Plataforma integral de trading con Money Manager IA, educación,
charts TradingView-style, y cuentas de inversión PAMM.

## Stack Tecnológico
| Capa | Tecnología |
|------|------------|
| Backend | Express.js 5.0.1 |
| Frontend | React 18.2.0 + Vite |
| ML Engine | FastAPI + PyTorch |
| Database | PostgreSQL 16+ |

## Módulos (9 OQIs)
[Tabla con 9 OQIs y progreso]

## Servicios y Puertos
[Tabla con 11 servicios]

## Credenciales
- DB: trading_platform / trading_user / trading_dev_2026

## Referencias
- Documentación: /projects/trading-platform/docs/
- Inventarios: /projects/trading-platform/orchestration/inventarios/

Criterios de Aceptación:

  • Archivo existe
  • >100 líneas
  • Incluye stack, módulos, puertos, credenciales

TASK-3.1.5: Actualizar PROYECTOS-PRIORITARIOS.md

Campo Valor
ID TASK-3.1.5
Tipo UPDATE
Prioridad P1
Dependencias 3.1.4
Bloquea Ninguna
Ubicación workspace-v2/docs/60-proyectos/PROYECTOS-PRIORITARIOS.md

Acciones:

  1. Agregar sección para trading-platform
  2. Clasificar como P2 o P3 según criterio actual

3. SPRINT 2: INTEGRACIÓN TEMPLATE-SAAS

3.1 Detalle de Tareas

TASK-3.2.1: Integrar SAAS-008 Audit Logs

Campo Valor
ID TASK-3.2.1
Tipo FEATURE
Prioridad P1
Dependencias Sprint 1 completado
Bloquea Ninguna

Acciones:

  1. Revisar template-saas/backend/src/modules/audit/
  2. Crear trading-platform/apps/backend/src/modules/audit/
  3. Adaptar: audit.module.ts, audit.service.ts, audit.controller.ts
  4. Adaptar entities para Express (no NestJS)
  5. Agregar rutas en audit.routes.ts
  6. Actualizar inventarios

Criterios de Aceptación:

  • audit.service.ts existe y compila
  • Endpoint GET /api/v1/audit/logs funciona
  • Inventario actualizado

TASK-3.2.2: Integrar SAAS-009 Feature Flags

Campo Valor
ID TASK-3.2.2
Tipo FEATURE
Prioridad P1
Dependencias Sprint 1 completado
Bloquea 3.4.1 (parcialmente)

Acciones:

  1. Revisar template-saas/backend/src/modules/feature-flags/
  2. Crear módulo equivalente en trading-platform
  3. Adaptar para Express
  4. Crear tabla en DDL (feature_flags, user_flags)
  5. Actualizar inventarios

Criterios de Aceptación:

  • feature-flags.service.ts existe
  • DDL con tablas creada
  • Endpoint de evaluación funciona

TASK-3.2.3: Evaluar/Integrar MFA

Campo Valor
ID TASK-3.2.3
Tipo EVALUATE + FEATURE
Prioridad P1
Dependencias Sprint 1 completado
Bloquea Ninguna

Fase 1 - Evaluación:

  1. Revisar estado actual de OQI-001 (twofa.service.ts existe?)
  2. Comparar con template-saas MFA
  3. Documentar gaps
  4. Decidir: implementar completo vs mejorar existente

Fase 2 - Implementación (si se decide):

  1. Copiar/adaptar MFA de template-saas
  2. Integrar con auth existente
  3. Actualizar DDL si necesario
  4. Actualizar frontend

Criterios de Aceptación:

  • Evaluación documentada
  • Decisión tomada (implementar/no implementar)
  • Si implementar: MFA funcional

4. SPRINT 3: PURGA Y MEJORAS

4.1 Detalle de Tareas

TASK-3.3.1: Archivar análisis obsoletos

Campo Valor
ID TASK-3.3.1
Tipo CLEANUP
Prioridad P2
Dependencias Ninguna

Archivos a mover a orchestration/analisis/_archive/:

  • OQI-001-ANALISIS-COMPONENTES.md
  • OQI-001-CONTRATOS-API.md
  • OQI-001-MULTIMEDIA.md
  • OQI-001-GAPS.md
  • OQI-001-INDEX.md

TASK-3.3.2: Cerrar tareas estancadas

Campo Valor
ID TASK-3.3.2
Tipo CLEANUP
Prioridad P2
Dependencias Ninguna

Tareas a evaluar:

Tarea Acción Propuesta
BLOCKER-001-TOKEN-REFRESH Evaluar → Cancelar si no hay progreso
MASTER-ANALYSIS-PLAN Integrar hallazgos → Cerrar
FRONTEND-COMPREHENSIVE-AUDIT Evaluar → Cerrar/Continuar
FRONTEND-MODULE-DOCS Evaluar → Cerrar/Continuar

TASK-3.3.3: Consolidar documentación arquitectura

Campo Valor
ID TASK-3.3.3
Tipo REFACTOR
Prioridad P2
Dependencias Ninguna

Acciones:

  1. Comparar ARQUITECTURA-GENERAL.md y ARQUITECTURA-UNIFICADA.md
  2. Merge contenido en ARQUITECTURA-GENERAL.md
  3. Archivar ARQUITECTURA-UNIFICADA.md

TASK-3.3.4: Completar movimiento _archive/

Campo Valor
ID TASK-3.3.4
Tipo CLEANUP
Prioridad P2
Dependencias Ninguna

Acciones:

  1. Verificar que 20 tareas archivadas están físicamente en _archive/2026-01/
  2. Si no, mover archivos
  3. Actualizar ARCHIVE-METADATA.yml: status: COMPLETED

5. SPRINT 4: WEBHOOKS Y DOCUMENTACIÓN

5.1 Detalle de Tareas (Backlog - P2/P3)

TASK-3.4.1: Integrar SAAS-010 Webhooks

Campo Valor
ID TASK-3.4.1
Tipo FEATURE
Prioridad P2
Dependencias 3.2.2 (Feature Flags)

TASK-3.4.2: Crear DATABASE-SCHEMA.md

Campo Valor
ID TASK-3.4.2
Tipo DOCUMENTATION
Prioridad P3
Dependencias Ninguna

TASK-3.4.3: Crear TESTING-STRATEGY.md

Campo Valor
ID TASK-3.4.3
Tipo DOCUMENTATION
Prioridad P3
Dependencias Ninguna

6. DIAGRAMA DE DEPENDENCIAS

SPRINT 1 (Paralelo)
┌─────────┐ ┌─────────┐ ┌─────────┐
│ 3.1.1   │ │ 3.1.2   │ │ 3.1.3   │
│ Backend │ │ Frontend│ │ Database│
│ Inv.    │ │ Inv.    │ │ Inv.    │
└────┬────┘ └─────────┘ └─────────┘
     │
     ▼
┌─────────┐
│ 3.1.4   │
│ PROYECTO│
│ DOC     │
└────┬────┘
     │
     ▼
┌─────────┐
│ 3.1.5   │
│ PRIORIT.│
└─────────┘

SPRINT 2 (Secuencial tras Sprint 1)
┌─────────┐ ┌─────────┐ ┌─────────┐
│ 3.2.1   │ │ 3.2.2   │ │ 3.2.3   │
│ Audit   │ │ Feature │ │ MFA     │
│ Logs    │ │ Flags   │ │ Eval    │
└─────────┘ └────┬────┘ └─────────┘
                 │
                 ▼
SPRINT 3 (Paralelo, puede empezar durante Sprint 2)
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ 3.3.1   │ │ 3.3.2   │ │ 3.3.3   │ │ 3.3.4   │
│ Archive │ │ Close   │ │ Consol. │ │ Move    │
│ Analysis│ │ Tasks   │ │ Docs    │ │ Archive │
└─────────┘ └─────────┘ └─────────┘ └─────────┘

SPRINT 4 (Depende de Sprint 2 para Webhooks)
┌─────────┐ ┌─────────┐ ┌─────────┐
│ 3.4.1   │ │ 3.4.2   │ │ 3.4.3   │
│ Webhooks│ │ DB Doc  │ │ Test Doc│
└─────────┘ └─────────┘ └─────────┘

7. ASIGNACIÓN DE AGENTES

Sprint Tareas Agente Sugerido Modo
1 3.1.1 - 3.1.5 Claude Code @QUICK
2 3.2.1 - 3.2.3 Claude Code + Windsurf @FULL
3 3.3.1 - 3.3.4 Claude Code @QUICK
4 3.4.1 - 3.4.3 Claude Code + Windsurf @FULL

8. RESUMEN

Fase Tareas Estado Bloqueadores
FASE 1 4/4 COMPLETADA -
FASE 2 2/3 🔄 EN PROGRESO Ninguno
FASE 3 Sprint 1 0/5 PENDIENTE Gate V
FASE 3 Sprint 2 0/3 PENDIENTE Sprint 1
FASE 3 Sprint 3 0/4 PENDIENTE Ninguno
FASE 3 Sprint 4 0/3 PENDIENTE Sprint 2
FASE 4 0/4 PENDIENTE Sprint 3

Total tareas de ejecución: 15 Tareas P0: 2 (3.1.1, 3.1.4) Tareas P1: 7 Tareas P2-P3: 6


Subtarea completada: 2.2 Definir plan de ejecución jerárquico con dependencias Estado: COMPLETADA Siguiente: 2.3 Validar plan (Gate V de CAPVED)