1cdae920fc
- Update CLAUDE.md with project-level instructions - Update docker-compose.yml with correct service ports - Update PROJECT-PROFILE.yml with current module status - Update PROJECT-STATUS.md with Phase 2/4 progress - Update PROXIMA-ACCION.md with current priorities - Purge stale sprint reports from _archive - Add TASK-2026-01-27-MASTER-ANALYSIS-PLAN documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
694 lines
24 KiB
Markdown
694 lines
24 KiB
Markdown
# 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) |
|