# 03-PLAN MAESTRO JERARQUICO - Trading Platform

**Fecha:** 2026-01-27
**Modo:** @ANALYSIS (Plan de ejecucion sin ejecutar)
**Metodologia:** CAPVED por cada tarea/subtarea
**Agentes:** Claude Code (orquestador) + subagentes paralelos

---

## ESTRUCTURA DE FASES

```
FASE 0: Fundamentos (sin dependencias)
  ├── 0.1 Correccion de discrepancias y limpieza
  └── 0.2 Infraestructura y alineacion WSL

FASE 1: Data Layer (base para todo)
  ├── 1.1 DDL fixes y extensiones
  ├── 1.2 Seeds faltantes
  └── 1.3 Recreation de BD en WSL

FASE 2: Backend Core (depende de Fase 1)
  ├── 2.1 Entity/model layer
  ├── 2.2 Auth service completion
  ├── 2.3 Trading service completion
  └── 2.4 Remaining services

FASE 3: Frontend Integration (depende de Fase 2)
  ├── 3.1 Service layers faltantes
  ├── 3.2 Page implementations
  └── 3.3 Real data wiring

FASE 4: ML & Backtesting (paralelo con Fase 2-3)
  ├── 4.1 OOS dinamico (12 meses)
  ├── 4.2 Entrenamiento completo
  └── 4.3 Backtesting validacion

FASE 5: Integration Testing (depende de Fases 2-4)
  ├── 5.1 Backend API tests
  ├── 5.2 Frontend E2E tests
  └── 5.3 ML integration tests

FASE 6: Documentation & Cleanup (paralelo)
  ├── 6.1 Purga documentacion
  ├── 6.2 Actualizacion definiciones
  └── 6.3 Inventarios sync
```

---

## FASE 0: FUNDAMENTOS

### TAREA 0.1: Correccion de Discrepancias
**Prioridad:** P0 | **Paralelizable:** SI | **CAPVED:** Quick

#### 0.1.1 Estandarizar password BD
- **C:** Password inconsistente (2025 vs 2026) en 5+ archivos
- **A:** Afecta .env.example, WORKSPACE-INTEGRATION.yml, docker-compose.yml
- **P:** Cambiar TODO a `trading_dev_2026`
- **E:** Editar archivos
- **V:** grep "trading_dev_20" en todo el workspace
- **D:** Actualizar CREDENTIALS-INVENTORY.yml
- **Archivos:** .env.example, docker-compose.yml, WORKSPACE-INTEGRATION.yml, DATABASE_INVENTORY.yml, CLAUDE.md (proyecto)

#### 0.1.2 Corregir puertos Python services en PROJECT-PROFILE.yml
- **C:** Puertos 8000/8001/8002 en profile vs 3083/3084/3085-3086 reales
- **A:** Solo afecta documentacion/referencia
- **P:** Actualizar PROJECT-PROFILE.yml
- **E:** Editar archivo
- **V:** Comparar con DEVENV-PORTS-INVENTORY.yml
- **D:** N/A
- **Archivos:** PROJECT-PROFILE.yml

#### 0.1.3 Corregir ML frameworks en PROJECT-PROFILE.yml
- **C:** TensorFlow listado pero no se usa; PyTorch y XGBoost faltan
- **P:** Cambiar a PyTorch, XGBoost, scikit-learn, pandas
- **Archivos:** PROJECT-PROFILE.yml

#### 0.1.4 Actualizar schemas en CLAUDE.md proyecto
- **C:** Solo 4 schemas listados (core, trading, ml, portfolio) vs 10 reales
- **P:** Listar los 10 schemas reales
- **Archivos:** CLAUDE.md (proyecto)

#### 0.1.5 Corregir trading-agents port en backend client
- **C:** Backend client apunta a 8004, deberia ser 3086
- **A:** Afecta conexion backend -> trading agents
- **P:** Actualizar configuracion
- **Archivos:** apps/backend/src/shared/clients/trading-agents.client.ts, .env.example

#### 0.1.6 Actualizar progreso OQI modules
- **C:** Porcentajes en CLAUDE.md y PROJECT-PROFILE.yml no reflejan tareas completadas
- **P:** Recalcular basado en estado real post Jan 25-27 tasks
- **Archivos:** CLAUDE.md, PROJECT-PROFILE.yml

---

### TAREA 0.2: Infraestructura y Alineacion WSL
**Prioridad:** P0 | **Paralelizable:** SI | **CAPVED:** Quick

#### 0.2.1 Agregar trading-platform a LOCAL-WSL-ENVIRONMENT.yml
- **C:** No esta en seccion bases_de_datos
- **P:** Agregar entrada completa con db_name, user, pass, redis_db, schemas
- **Archivos:** orchestration/inventarios/LOCAL-WSL-ENVIRONMENT.yml

#### 0.2.2 Agregar trading-platform a SHARED-PLATFORM-CONFIG.yml
- **C:** No esta en seccion databases
- **P:** Agregar entrada con credenciales estandarizadas
- **Archivos:** orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml

#### 0.2.3 Crear/verificar .env.ports
- **C:** DEVENV-PORTS-INVENTORY referencia archivo que puede no existir
- **P:** Crear si no existe con puertos oficiales
- **Archivos:** projects/trading-platform/.env.ports

#### 0.2.4 Verificar script unified-recreate-db.sh soporte trading
- **C:** Script puede no tener caso para trading-platform
- **P:** Agregar soporte si no existe
- **Archivos:** scripts/database/unified-recreate-db.sh

---

## FASE 1: DATA LAYER

### TAREA 1.1: DDL Fixes y Extensiones
**Prioridad:** P0 | **Bloquea:** Fase 2 | **CAPVED:** Full

#### 1.1.1 Agregar pgvector extension
- **C:** llm.embeddings usa tipo vector sin extension
- **A:** Requiere PostgreSQL con pgvector instalado en WSL
- **P:** Agregar `CREATE EXTENSION IF NOT EXISTS vector;` a 00-extensions.sql
- **E:** Editar DDL, recrear BD
- **V:** Verificar que tabla embeddings se crea correctamente
- **D:** Actualizar DATABASE_INVENTORY.yml
- **Archivos:** apps/database/ddl/00-extensions.sql, apps/database/ddl/schemas/llm/00-extensions.sql

#### 1.1.2 Fix migration schema prefix
- **C:** 2026-01-27_add_token_rotation.sql sin auth. prefix
- **P:** Agregar `auth.` a referencias de sessions
- **V:** Re-ejecutar migration
- **Archivos:** apps/database/migrations/2026-01-27_add_token_rotation.sql

#### 1.1.3 Crear down migrations
- **C:** No hay rollback capability
- **P:** Crear companion down migration para token_rotation
- **Archivos:** apps/database/migrations/2026-01-27_add_token_rotation_DOWN.sql

#### 1.1.4 Agregar partition maintenance para auth_logs
- **C:** Solo current + next month
- **P:** Crear funcion de maintenance automatica
- **Archivos:** apps/database/ddl/schemas/auth/functions/partition_maintenance.sql

---

### TAREA 1.2: Seeds Faltantes
**Prioridad:** P1 | **Bloquea:** Fase 2 (parcial) | **CAPVED:** Full

#### 1.2.1 Seed: trading.symbols (pares forex/crypto base)
- **C:** No hay seed para symbols. Trading necesita symbols base
- **A:** Frontend necesita symbols para watchlists y charts
- **P:** Crear seed con: XAUUSD, EURUSD, GBPUSD, USDJPY, BTCUSD, AUDUSD + info basica
- **V:** Verificar symbols disponibles en Binance connector
- **Archivos:** apps/database/seeds/prod/trading/01-symbols.sql

#### 1.2.2 Seed: investment.products (Atlas/Orion/Nova)
- **C:** No hay seed para productos de inversion
- **A:** Frontend investment pages necesitan products
- **P:** Crear seed con 3 productos (Atlas conservative, Orion moderate, Nova aggressive)
- **Archivos:** apps/database/seeds/prod/investment/01-products.sql

#### 1.2.3 Seed: market_data.tickers
- **C:** market_data.tickers vacio
- **A:** ML Engine y Data Service necesitan tickers base
- **P:** Crear seed sincronizado con trading.symbols
- **Archivos:** apps/database/seeds/prod/market_data/01-tickers.sql

#### 1.2.4 Seed: financial.subscription_plans (planes VIP)
- **C:** No hay planes definidos en BD
- **A:** Payments module necesita plans (free/basic/pro/premium/enterprise)
- **P:** Crear seed con 5 planes y features
- **Archivos:** apps/database/seeds/prod/financial/01-subscription-plans.sql

#### 1.2.5 Seed: auth admin user
- **C:** Solo existe admin en education seed
- **A:** Admin panel necesita usuario admin real
- **P:** Crear seed con admin user (admin@orbiquant.com)
- **Archivos:** apps/database/seeds/prod/auth/01-admin-user.sql

---

### TAREA 1.3: Recreacion de BD en WSL
**Prioridad:** P0 | **Bloquea:** Fase 2 | **CAPVED:** Full
**Depende de:** 1.1, 1.2

#### 1.3.1 Ejecutar script de recreacion
- **C:** BD puede no tener todos los cambios recientes
- **P:** `unified-recreate-db.sh trading-platform --drop`
- **V:** Verificar 89 tablas creadas, seeds ejecutados
- **Archivos:** Script output

#### 1.3.2 Verificar pgvector extension
- **V:** `SELECT * FROM pg_extension WHERE extname = 'vector';`

#### 1.3.3 Verificar seeds ejecutados
- **V:** Contar registros en: trading.symbols, investment.products, market_data.tickers, education.categories

---

## FASE 2: BACKEND CORE

### TAREA 2.1: Entity/Model Layer
**Prioridad:** P1 | **Bloquea:** 2.2-2.4 | **CAPVED:** Full
**Depende de:** Fase 1

#### 2.1.1 Definir patron de entity layer
- **C:** Backend usa raw SQL sin tipo safety
- **A:** 75 entities faltantes formalmente
- **P:** Decidir entre: (a) TypeORM entities, (b) Drizzle ORM, (c) Type-safe query builder, (d) Interfaces TS manuales
- **V:** Evaluar impacto en codigo existente
- **Nota:** Requiere decision arquitectonica del usuario

#### 2.1.2 Crear interfaces TypeScript por schema
- **C:** Representar DDL como interfaces TS
- **P:** 1 archivo de interfaces por schema (10 archivos)
- **Archivos:**
  - src/shared/database/entities/auth.entities.ts
  - src/shared/database/entities/trading.entities.ts
  - src/shared/database/entities/education.entities.ts
  - src/shared/database/entities/financial.entities.ts
  - src/shared/database/entities/investment.entities.ts
  - src/shared/database/entities/portfolio.entities.ts
  - src/shared/database/entities/market-data.entities.ts
  - src/shared/database/entities/ml.entities.ts
  - src/shared/database/entities/llm.entities.ts
  - src/shared/database/entities/audit.entities.ts

#### 2.1.3 Crear repository pattern base
- **P:** BaseRepository<T> con CRUD generico tipado
- **Archivos:** src/shared/database/repositories/base.repository.ts

---

### TAREA 2.2: Auth Services Completion
**Prioridad:** P0 | **CAPVED:** Full
**Depende de:** 2.1

#### 2.2.1 Completar token service (ya avanzado por BLOCKER-001)
- **C:** Token rotation implementado
- **V:** Verificar que rate limiting, rotation y proactive refresh funcionan E2E

#### 2.2.2 Integrar auth con entity layer
- **P:** Actualizar queries a usar entities tipadas

#### 2.2.3 Completar OAuth providers
- **C:** Google, Facebook, Apple, GitHub, Microsoft, Twitter definidos
- **V:** Verificar cada provider funciona con credenciales reales

---

### TAREA 2.3: Trading Services Completion
**Prioridad:** P0 | **CAPVED:** Full
**Depende de:** 2.1, 1.2.1 (symbols seed)

#### 2.3.1 Completar market.service.ts
- **C:** Klines, tickers, orderbook - parcialmente implementados
- **P:** Conectar a BD y/o Binance API
- **Archivos:** src/modules/trading/services/market.service.ts

#### 2.3.2 Completar order.service.ts
- **C:** Order execution logic incompleto
- **P:** Implementar create/cancel/fill para paper trading
- **Archivos:** src/modules/trading/services/order.service.ts

#### 2.3.3 Completar paper-trading.service.ts
- **C:** Paper trading simulation no conectada a BD
- **P:** Implementar con BD transactions
- **Archivos:** src/modules/trading/services/paper-trading.service.ts

#### 2.3.4 Integrar WebSocket en trading
- **C:** WS server existe, trading no lo usa
- **P:** Emitir price updates, order fills, position changes via WS
- **Archivos:** src/modules/trading/trading.websocket.ts

#### 2.3.5 Completar watchlist.service.ts
- **P:** CRUD completo con BD
- **Archivos:** src/modules/trading/services/watchlist.service.ts

#### 2.3.6 Completar alerts.service.ts
- **P:** Price alerts con persistence y trigger mechanism
- **Archivos:** src/modules/trading/services/alerts.service.ts

---

### TAREA 2.4: Remaining Backend Services
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** 2.1

#### 2.4.1 Education services (5 services)
- **C:** 60+ endpoints definidos, services parciales
- **P:** Completar course, enrollment, quiz, gamification, video services
- **Paralelizable:** SI (5 subagentes)

#### 2.4.2 Investment services
- **C:** 15 endpoints, implementacion minima
- **P:** Products, accounts, transactions, distributions, withdrawals

#### 2.4.3 Payments services (Stripe)
- **C:** 16 endpoints, Stripe integration started
- **P:** Completar Stripe webhook processing, subscription lifecycle

#### 2.4.4 Portfolio services
- **C:** 13 endpoints, parcial
- **P:** Portfolio CRUD, allocations, rebalancing, goals, snapshots

#### 2.4.5 Notifications services
- **C:** 8 endpoints, parcial
- **P:** Push notifications, preferences, mark read

#### 2.4.6 Admin services (conectar a BD real)
- **C:** Todo retorna MOCK data
- **P:** Conectar dashboard, users, audit a queries reales

#### 2.4.7 LLM services
- **C:** 5 endpoints, parcial
- **P:** Session persistence, chat history, quick analysis

---

## FASE 3: FRONTEND INTEGRATION

### TAREA 3.1: Service Layers Faltantes
**Prioridad:** P0 | **CAPVED:** Full
**Depende de:** Fase 2

#### 3.1.1 Crear auth.service.ts
- **C:** CRITICO - no existe
- **P:** Login, register, OAuth, token refresh, 2FA, sessions
- **V:** Login/register flow funcional
- **Archivos:** src/services/auth.service.ts

#### 3.1.2 Crear trading.service.ts
- **C:** CRITICO - no existe, pagina /trading crashea
- **P:** Klines, tickers, orderbook, orders, positions, paper trading
- **V:** Chart renderiza con datos reales
- **Archivos:** src/services/trading.service.ts

#### 3.1.3 Crear portfolio.service.ts
- **P:** CRUD portfolios, allocations, goals, performance
- **Archivos:** src/services/portfolio.service.ts

#### 3.1.4 Completar investment.service.ts
- **C:** Solo AccountDetail implementado
- **P:** Products, accounts, transactions, distributions, withdrawals
- **Archivos:** src/services/investment.service.ts

#### 3.1.5 Crear notifications.service.ts
- **P:** List, mark read, preferences, push token
- **Archivos:** src/services/notifications.service.ts

#### 3.1.6 Crear settings.service.ts
- **P:** User preferences, profile update, notification settings
- **Archivos:** src/services/settings.service.ts

---

### TAREA 3.2: Page Implementations
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** 3.1

#### 3.2.1 Portfolio pages (4 pages)
- PortfolioDashboard.tsx, CreatePortfolio.tsx, CreateGoal.tsx, EditAllocations.tsx
- **Depende de:** 3.1.3

#### 3.2.2 Investment pages (7 pages)
- Investment.tsx, Portfolio.tsx, Products.tsx, AccountDetail.tsx (existe), Withdrawals.tsx, Transactions.tsx, Reports.tsx
- **Depende de:** 3.1.4

#### 3.2.3 Settings pages
- Profile, Security, Notifications, Trading preferences
- **Depende de:** 3.1.6

#### 3.2.4 Dashboard page (real data)
- Conectar a backend APIs: portfolio summary, recent trades, ML signals
- **Depende de:** 3.1.1-3.1.5

#### 3.2.5 Notifications page
- NotificationCenter.tsx con list, mark read, filters
- **Depende de:** 3.1.5

#### 3.2.6 Assistant page (wrapper)
- AssistantPage.tsx wrapping chat components
- **Depende de:** Backend LLM service

---

### TAREA 3.3: Real Data Wiring
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** 3.1, 3.2

#### 3.3.1 Reemplazar mock data en Dashboard
#### 3.3.2 Reemplazar mock data en Trading stats/orderbook/alerts
#### 3.3.3 Conectar WebSocket para real-time prices
#### 3.3.4 Agregar Error Boundary global en App.tsx
#### 3.3.5 Crear .env.local con URLs de servicios

---

## FASE 4: ML & BACKTESTING (PARALELO con Fases 2-3)

### TAREA 4.1: Parametrizar OOS Dinamico
**Prioridad:** P0 | **CAPVED:** Full

#### 4.1.1 Modificar validation_oos.yaml para OOS dinamico
- **C:** Hardcoded 2025 como OOS period
- **P:** Parametrizar: OOS = max_date_in_db - 12 meses
- **Archivos:** config/validation_oos.yaml

#### 4.1.2 Actualizar TemporalDataSplitter
- **C:** Split dates hardcoded
- **P:** Calcular dinamicamente basado en datos disponibles
- **Archivos:** src/training/data_splitter.py

#### 4.1.3 Verificar datos en BD
- **V:** Contar registros por simbolo y rango de fechas
- **V:** Confirmar que existen datos 2023-2025 (minimo)

---

### TAREA 4.2: Entrenamiento Completo
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** 4.1, 1.3

#### 4.2.1 Entrenar Level 0 (Attention) para todos los symbols
- **Symbols:** XAUUSD, EURUSD, BTCUSD, GBPUSD, USDJPY, AUDUSD
- **Timeframes:** 5m, 15m
- **Output:** 12 modelos attention
- **V:** Attention score distribution reasonable

#### 4.2.2 Entrenar Level 1 (Base Models) para todos los symbols
- **Modelos:** RangePredictorV2, AMDDetectorML, MovementMagnitude
- **V:** R2 >= 0.4 para range, dir_accuracy >= 85%

#### 4.2.3 Entrenar Level 2 (Metamodels)
- **XGBoost:** Para EURUSD, BTCUSD, GBPUSD, USDJPY, AUDUSD
- **Neural Gating:** Para XAUUSD
- **V:** Improvement over single-timeframe models

#### 4.2.4 Guardar modelos y metadata
- **V:** Archivos .joblib/.pth guardados con metadata de entrenamiento

---

### TAREA 4.3: Backtesting y Validacion
**Prioridad:** P0 | **CAPVED:** Full
**Depende de:** 4.2

#### 4.3.1 Ejecutar OOS backtest (12 meses excluidos)
- **P:** Para cada symbol, ejecutar backtest en periodo OOS
- **Config:** Initial capital 10K, risk 2%, multiple R:R configs
- **V:** Resultados vs targets:
  - Win Rate >= 75% (target 80%)
  - Profit Factor >= 2.0 (target 4.0)
  - Sharpe Ratio >= 1.5 (target 2.5)
  - Max Drawdown <= 15%

#### 4.3.2 Walk-Forward Validation
- **P:** 5-fold walk-forward para cada symbol/model
- **V:** Consistencia entre folds (std < 10% del mean)

#### 4.3.3 Comparar estrategias
- **P:** R:R 2:1, R:R 3:1, R:R 1:2@80WR, Range Adaptive
- **V:** Identificar mejor estrategia por symbol

#### 4.3.4 Generar reporte de resultados
- **D:** Reporte con metricas por symbol, modelo, estrategia
- **Archivos:** reports/backtesting/OOS-REPORT-{date}.md

#### 4.3.5 Validar integracion ML Engine -> Backend
- **V:** POST /predict retorna signal correcta
- **V:** POST /hierarchical-predict retorna L0->L1->L2

#### 4.3.6 Validar integracion Backend -> Frontend
- **V:** ML Dashboard muestra signals reales
- **V:** Backtesting Dashboard ejecuta backtest real

---

## FASE 5: INTEGRATION TESTING

### TAREA 5.1: Backend API Tests
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** Fase 2

#### 5.1.1 Auth module tests (login, register, OAuth, 2FA)
#### 5.1.2 Trading module tests (orders, positions, paper trading)
#### 5.1.3 Education module tests (courses, enrollment, quizzes)
#### 5.1.4 Payments module tests (Stripe webhook, subscriptions)
#### 5.1.5 ML integration tests (signals, predictions)
#### 5.1.6 WebSocket tests (connection, subscription, broadcast)

---

### TAREA 5.2: Frontend E2E Tests
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** Fase 3

#### 5.2.1 Auth flow E2E (login -> dashboard)
#### 5.2.2 Trading flow E2E (chart -> order -> position)
#### 5.2.3 Education flow E2E (browse -> enroll -> lesson -> quiz)
#### 5.2.4 Payment flow E2E (pricing -> checkout -> subscription)
#### 5.2.5 ML Dashboard E2E (signals -> backtest)

---

### TAREA 5.3: ML Integration Tests
**Prioridad:** P1 | **CAPVED:** Full
**Depende de:** Fase 4

#### 5.3.1 Data pipeline test (DB -> features -> prediction)
#### 5.3.2 Backtesting reproducibility test
#### 5.3.3 Model serving latency test (<500ms per prediction)

---

## FASE 6: DOCUMENTACION & CLEANUP (PARALELO)

### TAREA 6.1: Purga de Documentacion
**Prioridad:** P1 | **Paralelizable:** SI | **CAPVED:** Quick

#### 6.1.1 Eliminar reportes obsoletos
```
ELIMINAR:
- orchestration/_archive/reportes/REPORTE-SESION-2025-12-07.md
- orchestration/_archive/reportes/REPORTE-EJECUCION-SPRINT{1,2,3}.md
- orchestration/_archive/reportes/VALIDACION-PLAN-VS-ANALISIS-2026-01-07.md
- docs/00-vision-general/NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md
```

#### 6.1.2 Consolidar analisis obsoletos
```
MOVER a _archive/consolidated/:
- orchestration/_archive/analisis/ANALISIS-GAPS-ML-FIRST-2026-01.md
- orchestration/_archive/analisis/ANALISIS-DEPENDENCIAS-2026-01-07.md
- orchestration/_archive/analisis/ANALISIS-CONSOLIDADO-FASE1-2026-01-07.md
```

#### 6.1.3 Archivar planes superseded
```
MOVER a _archive/2026-01-planes/:
- orchestration/_archive/planes/ (todo el directorio)
```

---

### TAREA 6.2: Actualizacion de Definiciones
**Prioridad:** P1 | **CAPVED:** Full

#### 6.2.1 Actualizar PROJECT-STATUS.md
- Reflejar estado post Jan 25-27: 19 tareas completadas
- Actualizar metricas de completitud por modulo

#### 6.2.2 Actualizar PROXIMA-ACCION.md
- Apuntar a este plan maestro como referencia
- Definir siguiente tarea a ejecutar

#### 6.2.3 Actualizar PROJECT-PROFILE.yml
- Puertos corregidos (3083/3084/3085-3086)
- Frameworks corregidos (PyTorch/XGBoost)
- Schemas (10)
- Progreso OQI actualizado

#### 6.2.4 Crear user stories faltantes OQI-006 (ML)
- Actualmente 0 user stories
- Crear 8-10 US basadas en funcionalidad ML actual

#### 6.2.5 Crear user stories faltantes OQI-007 (LLM)
- Actualmente 0 user stories
- Crear 6-8 US basadas en funcionalidad LLM actual

#### 6.2.6 Actualizar API contracts document
- Documentar todos los 113+ endpoints con request/response schemas
- Sincronizar con Swagger

---

### TAREA 6.3: Inventarios Sync
**Prioridad:** P1 | **CAPVED:** Quick

#### 6.3.1 Sync MASTER_INVENTORY.yml con estado real
#### 6.3.2 Sync DATABASE_INVENTORY.yml (89 tablas)
#### 6.3.3 Sync BACKEND_INVENTORY.yml (113+ endpoints)
#### 6.3.4 Sync FRONTEND_INVENTORY.yml (189 components)
#### 6.3.5 Actualizar _INDEX.yml de tareas con esta nueva tarea

---

## ORDEN DE EJECUCION Y DEPENDENCIAS

```
PARALELO GRUPO A (sin dependencias):
  ├── 0.1 Correccion discrepancias          ← Puede empezar YA
  ├── 0.2 Infraestructura WSL               ← Puede empezar YA
  ├── 6.1 Purga documentacion               ← Puede empezar YA
  └── 4.1 Parametrizar OOS dinamico         ← Puede empezar YA

SECUENCIAL GRUPO B (depende de 0.x):
  1.1 DDL fixes → 1.2 Seeds → 1.3 Recrear BD

PARALELO GRUPO C (depende de 1.3):
  ├── 2.1 Entity layer → 2.2 Auth → 2.3 Trading → 2.4 Rest
  └── 4.2 Entrenamiento ML (depende tambien de 4.1)

PARALELO GRUPO D (depende de 2.x):
  ├── 3.1 Frontend services → 3.2 Pages → 3.3 Wiring
  └── 4.3 Backtesting (depende tambien de 4.2)

SECUENCIAL GRUPO E (depende de 2.x + 3.x + 4.x):
  5.1 Backend tests → 5.2 Frontend E2E → 5.3 ML integration

PARALELO CONTINUO:
  6.2 Actualizar definiciones (durante toda ejecucion)
  6.3 Sync inventarios (al final de cada fase)
```

---

## DIAGRAMA DE DEPENDENCIAS

```
0.1 ──┐
0.2 ──┼──→ 1.1 ──→ 1.2 ──→ 1.3 ──┬──→ 2.1 ──→ 2.2 ──┬──→ 3.1 ──→ 3.2 ──→ 3.3
6.1 ──┘                           │           2.3 ──┤          3.2.1-6
                                  │           2.4 ──┘
4.1 ──────────────────────────────┼──→ 4.2 ──→ 4.3 ──┐
                                  │                   │
                                  └───────────────────┼──→ 5.1 ──→ 5.2 ──→ 5.3
                                                      │
6.2 ──────────────────────────────────────────────────┘
6.3 ──────────────────────────────────────────────────── (continuo)
```

---

## RESUMEN CUANTITATIVO

| Fase | Tareas | Subtareas | SubSubtareas | Prioridad |
|------|--------|-----------|--------------|-----------|
| 0 | 2 | 10 | 0 | P0 |
| 1 | 3 | 12 | 0 | P0 |
| 2 | 4 | 17 | 7+ | P0-P1 |
| 3 | 3 | 17 | 5+ | P0-P1 |
| 4 | 3 | 12 | 6 | P0-P1 |
| 5 | 3 | 14 | 0 | P1 |
| 6 | 3 | 11 | 0 | P1 |
| **TOTAL** | **21** | **93** | **18+** | |

**Total items de trabajo:** 132+ (21 tareas + 93 subtareas + 18+ sub-subtareas)
**Cada item cumple CAPVED** (Contexto, Analisis, Planeacion, Validacion, Ejecucion, Documentacion)

---

## CRITERIOS DE ACEPTACION GLOBALES

1. **DDL:** 89 tablas creadas, pgvector funcional, seeds ejecutados, 0 errors en recreacion
2. **Backend:** Todos los 113+ endpoints retornan datos reales (no mock), entity types match DDL
3. **Frontend:** Todas las rutas renderizan sin crash, services conectan a backend real
4. **ML:** Backtesting OOS ejecutado para 6 symbols, metricas documentadas, WR >= 75%
5. **Infra:** trading-platform en LOCAL-WSL-ENVIRONMENT, BD recreable, Docker compose up funcional
6. **Docs:** 0 archivos obsoletos, inventarios 100% sync, progreso OQI actualizado
7. **Coherencia:** DDL->Backend->Frontend pipeline verificado para los 10 schemas

---

## NOTAS DE EJECUCION

### Subagentes Recomendados por Fase
- **Fase 0:** 2 agentes Quick (discrepancias + infra)
- **Fase 1:** 1 agente DDL + 1 agente Seeds (paralelo)
- **Fase 2:** 4 agentes (entity layer + auth + trading + rest) semi-paralelo
- **Fase 3:** 3 agentes (services + pages + wiring) secuencial
- **Fase 4:** 2 agentes (training + backtesting) secuencial
- **Fase 5:** 3 agentes testing (paralelo por capa)
- **Fase 6:** 2 agentes docs (paralelo)

### Perfiles de Agentes
| Agente | Perfil | Tareas |
|--------|--------|--------|
| Claude Code | Tech-Leader/Architect | Orquestacion, decisiones arquitectonicas |
| Subagente 1 | Backend-Developer | Fase 2 (entities, services) |
| Subagente 2 | Frontend-Developer | Fase 3 (services, pages, wiring) |
| Subagente 3 | ML-Specialist | Fase 4 (training, backtesting) |
| Subagente 4 | QA-Engineer | Fase 5 (tests) |
| Subagente 5 | DevOps/Infra | Fase 0.2, 1.3 (WSL, BD recreation) |
| Subagente 6 | Documentation | Fase 6 (purga, updates) |
