rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
4c00d2656c
trading-platform/docs/90-transversal/roadmap/PLAN-DESARROLLO-DETALLADO.md
rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment 
ML Engine Updates:
- Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records
- Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence)
- Backtest results: +176.71R profit with aggressive_filter strategy

Documentation Consolidation:
- Created docs/99-analisis/_MAP.md index with 13 new analysis documents
- Consolidated inventories: removed duplicates from orchestration/inventarios/
- Updated ML_INVENTORY.yml with BTCUSD metrics and training results
- Added execution reports: FASE11-BTCUSD, correction issues, alignment validation

Architecture & Integration:
- Updated all module documentation with NEXUS v3.4 frontmatter
- Fixed _MAP.md indexes across all folders
- Updated orchestration plans and traces

Files: 229 changed, 5064 insertions(+), 1872 deletions(-)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:31:29 -06:00

615 lines
17 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: "PLAN-DESARROLLO-DETALLADO"
title: "Plan de Desarrollo Detallado - Trading Platform"
type: "Documentation"
project: "trading-platform"
version: "1.0.0"
updated_date: "2026-01-04"
---
# Plan de Desarrollo Detallado - Trading Platform
**Version:** 1.1.0
**Fecha:** 2025-12-06
**Autor:** Agente de Documentacion y Planificacion
**Estado:** En Progreso - Sprint 2-3
---
## 1. Resumen Ejecutivo
Este documento define el plan de desarrollo completo para Trading Platform, detallando:
- **16 sprints** organizados en **5 fases**
- **407 Story Points** distribuidos estrategicamente
- **Dependencias criticas** entre componentes
- **Orden de implementacion** optimizado
- **Criterios de aceptacion** por fase
**Objetivo:** Lanzar una plataforma de trading completa con IA, gestion de portafolios y educacion en 8 meses.
---
## 2. Vision de Fases
```
FASE 1: FUNDAMENTOS (MVP) ████████████░░░░ Sprints 1-6 (12 semanas)
├─ OQI-001: Auth y Usuarios ✅ Completado
├─ Database DDL (8 schemas) ✅ Completado (67 tablas, 95% alineado)
├─ OQI-002: Educacion Basica 🔵 Sprint 2-3 (en progreso)
├─ OQI-005: Pagos y Stripe 🔵 Sprint 3-4 (en progreso)
└─ OQI-003: Trading Charts 🔵 Sprint 4-6
FASE 2: TRADING CORE ████████░░░░░░░░ Sprints 7-10 (8 semanas)
├─ OQI-004: Cuentas Inversion 🔴 Sprint 7-8
├─ OQI-006: ML Signals 🔴 Sprint 8-10
└─ Data Service Integration 🔴 Sprint 9-10
FASE 3: IA AVANZADA ████████░░░░░░░░ Sprints 11-13 (6 semanas)
├─ OQI-007: LLM Agent 🔴 Sprint 11-12
├─ Trading Agents (Atlas/Orion) 🔴 Sprint 12-13
└─ Fine-tuning Pipeline 🔴 Sprint 13
FASE 4: PORTFOLIO PRO ████████░░░░░░░░ Sprints 14-15 (4 semanas)
├─ OQI-008: Portfolio Manager 🔴 Sprint 14-15
├─ Rebalanceo Automatico 🔴 Sprint 15
└─ Proyecciones Monte Carlo 🔴 Sprint 15
FASE 5: PRODUCCION ████████░░░░░░░░ Sprint 16 (2 semanas)
├─ Testing E2E Completo 🔴 Sprint 16
├─ Security Audit 🔴 Sprint 16
├─ Performance Optimization 🔴 Sprint 16
└─ Launch 🔴 Sprint 16
Leyenda: ✅ Completado | 🔵 En Progreso | 🔴 Pendiente
```
---
## 3. Roadmap Detallado por Sprint
### FASE 1: FUNDAMENTOS (MVP)
#### Sprint 1: Auth Completo (2 semanas) ✅ COMPLETADO
**Objetivo:** Sistema de autenticacion multi-metodo funcional
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-001 | RF-AUTH-001 a 005 | US-AUTH-001 a 012 | 50 | ✅ Completado |
**Entregables:**
- ✅ OAuth multi-proveedor (Google, Facebook, Apple, GitHub)
- ✅ Autenticacion email/password con bcrypt
- ✅ 2FA TOTP con QR codes
- ✅ Gestion de sesiones con JWT + refresh tokens
- ✅ RBAC (Role-Based Access Control)
- ✅ Middleware de autenticacion
- ✅ Rate limiting por IP/usuario
**Dependencias:** Ninguna (sprint fundacional)
**Criterios de Aceptacion:**
- [x] Usuario puede registrarse con email
- [x] Usuario puede login con Google/Facebook
- [x] 2FA funciona con Google Authenticator
- [x] Tokens JWT expiran y se renuevan correctamente
- [x] Rate limiting bloquea abuso
---
#### Sprint 2-3: Educacion + Pagos (4 semanas)
**Objetivo:** Modulo educativo con monetizacion
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-002 | RF-EDU-001 a 006 | US-EDU-001 a 015 | 45 | 🔵 En Progreso |
| OQI-005 | RF-PAY-001 a 006 | US-PAY-001 a 012 | 40 | 🔵 En Progreso |
**Sprint 2: Educacion (2 semanas)**
Entregables:
- [ ] CRUD de cursos y lecciones
- [ ] Sistema de modulos/secciones
- [ ] Reproductor de video (YouTube embed)
- [ ] Quizzes con tipos de pregunta variados
- [ ] Tracking de progreso por leccion
- [ ] Sistema de gamificacion (badges, puntos)
**Sprint 3: Pagos (2 semanas)**
Entregables:
- [ ] Integracion Stripe Checkout
- [ ] 4 planes de suscripcion (Free, Basic, Pro, Premium)
- [ ] Wallet interno con balance
- [ ] Webhook de Stripe para renovaciones
- [ ] Sistema de referidos con promo codes
- [ ] Panel de facturacion
**Dependencias:**
- OQI-001 (auth) debe estar completo
- Stripe API key configurada
**Criterios de Aceptacion:**
- [ ] Usuario Free puede ver cursos demo
- [ ] Usuario Pro accede a todos los cursos
- [ ] Pago con Stripe funciona end-to-end
- [ ] Webhook procesa renovacion automatica
- [ ] Wallet muestra transacciones correctas
---
#### Sprint 4-6: Trading Charts (6 semanas)
**Objetivo:** Plataforma de trading con paper trading
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-003 | RF-TRD-001 a 008 | US-TRD-001 a 018 | 55 | 🔴 Pendiente |
**Sprint 4: Charts Base (2 semanas)**
Entregables:
- [ ] Integracion Lightweight Charts (TradingView)
- [ ] Datos OHLCV desde PostgreSQL
- [ ] Timeframes: 5m, 15m, 1h, 4h, 1d
- [ ] Watchlists personalizadas
- [ ] Ticker con precio real-time (WebSocket)
**Sprint 5: Indicadores (2 semanas)**
Entregables:
- [ ] SMA, EMA overlay
- [ ] RSI, MACD, Stochastic indicators
- [ ] Volumen en barras
- [ ] Panel de configuracion de indicadores
**Sprint 6: Paper Trading (2 semanas)**
Entregables:
- [ ] Cuenta de paper trading con $10,000 virtual
- [ ] Ordenes: Market, Limit, Stop
- [ ] Panel de posiciones abiertas/cerradas
- [ ] Calculo de PnL en tiempo real
- [ ] Historial de trades
**Dependencias:**
- OQI-001 (auth para usuarios)
- market_data.ohlcv_5m poblado
- Redis para WebSocket pub/sub
**Criterios de Aceptacion:**
- [ ] Chart renderiza 1 millon de velas sin lag
- [ ] WebSocket actualiza precio cada 1s
- [ ] Paper trading ejecuta orden en <500ms
- [ ] PnL calcula correctamente con fees
- [ ] Watchlist persiste entre sesiones
---
### FASE 2: TRADING CORE
#### Sprint 7-8: Cuentas de Inversion (4 semanas)
**Objetivo:** Money Manager con agentes de trading
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-004 | RF-INV-001 a 006 | US-INV-001 a 014 | 57 | 🔴 Pendiente |
**Sprint 7: Productos y KYC (2 semanas)**
Entregables:
- [ ] 3 productos: Atlas (conservador), Orion (moderado), Nova (agresivo)
- [ ] Flujo de KYC con subida de documentos
- [ ] Risk profile questionnaire
- [ ] Dashboard de productos disponibles
- [ ] Calculo de proyecciones basicas
**Sprint 8: Cuentas y Operaciones (2 semanas)**
Entregables:
- [ ] Apertura de cuenta de inversion
- [ ] Depositos con wallet interno
- [ ] Retiros con aprobacion manual
- [ ] Performance tracking diario
- [ ] Distribucion mensual de utilidades
**Dependencias:**
- OQI-005 (wallet para depositos)
- OQI-001 (KYC storage en DB)
- trading.bots (asignacion de agentes)
**Criterios de Aceptacion:**
- [ ] Usuario pasa KYC en <24h (manual review)
- [ ] Deposito de wallet a cuenta funciona
- [ ] Performance snapshot se genera diario
- [ ] Distribucion calcula comisiones correctas
- [ ] Usuario puede cerrar cuenta con retiro
---
#### Sprint 8-10: ML Signals (6 semanas)
**Objetivo:** Integracion completa del ML Engine
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-006 | RF-ML-001 a 005 | US-ML-001 a 010 | 40 | 🔴 Pendiente |
**Sprint 8: Migracion TradingAgent (2 semanas)**
Entregables:
- [ ] Copiar modelos entrenados a apps/ml-engine/models/
- [ ] Migrar codigo Python de TradingAgent
- [ ] Crear Dockerfile para ML Engine
- [ ] FastAPI con endpoints /predictions, /signals
- [ ] Tests de validacion de modelos
**Sprint 9: Integracion Backend (2 semanas)**
Entregables:
- [ ] MLClientService en Express backend
- [ ] Endpoints proxy: GET /api/ml/signals/:symbol
- [ ] WebSocket para senales real-time
- [ ] Cache de predicciones en Redis (TTL 5min)
- [ ] Rate limiting por plan de usuario
**Sprint 10: Frontend Charts + ML (2 semanas)**
Entregables:
- [ ] Overlay de predicciones en charts
- [ ] Indicador AMD phase en panel
- [ ] Panel de senales con filtros
- [ ] Notificaciones push de senales
- [ ] Historial de accuracy de modelos
**Dependencias:**
- Data Service (INT-DATA-001) para datos OHLCV
- Redis para cache y pub/sub
- PostgreSQL schema ml_predictions
**Criterios de Aceptacion:**
- [ ] Prediccion de rango toma <2s
- [ ] Overlay muestra predicted_high/low en chart
- [ ] Senal se genera con prob_tp_first > 0.60
- [ ] WebSocket envia senal a usuarios suscritos
- [ ] Cache evita llamadas duplicadas a ML
---
### FASE 3: IA AVANZADA
#### Sprint 11-12: LLM Strategy Agent (4 semanas)
**Objetivo:** Copiloto de trading con IA conversacional
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-007 | RF-LLM-001 a 006 | US-LLM-001 a 010 | 55 | 🔴 Pendiente |
**Sprint 11: Chat Interface (2 semanas)**
Entregables:
- [ ] UI de chat con historial
- [ ] Backend LLM service con Claude 3.5 Sonnet
- [ ] Sistema de conversaciones (CRUD)
- [ ] Context builder con RAG (Pinecone)
- [ ] Streaming de respuestas
**Sprint 12: Tools Integration (2 semanas)**
Entregables:
- [ ] Tool: get_ml_signal(symbol, horizon)
- [ ] Tool: analyze_chart(symbol, timeframe)
- [ ] Tool: execute_paper_trade(symbol, side, amount)
- [ ] Tool: get_portfolio_status()
- [ ] Tool: search_education_content(query)
- [ ] Fine-tuning dataset preparation
**Dependencias:**
- OQI-006 (ML Engine para tools)
- OQI-003 (Paper trading para ejecucion)
- OQI-002 (Educacion para search)
- Claude API key / OpenAI API key
**Criterios de Aceptacion:**
- [ ] LLM responde pregunta en <5s
- [ ] Tool get_ml_signal retorna prediccion valida
- [ ] Chat mantiene contexto de ultimos 10 mensajes
- [ ] Usuario puede ejecutar trade via chat
- [ ] RAG retrieval es relevante (>0.7 similarity)
---
#### Sprint 12-13: Trading Agents (4 semanas)
**Objetivo:** Agentes automaticos Atlas, Orion, Nova
**Sprint 12: Agent Core (2 semanas)**
Entregables:
- [ ] TradingAgentEngine (base class)
- [ ] Atlas Agent (conservative strategy)
- [ ] Orion Agent (moderate strategy)
- [ ] Risk manager por agente
- [ ] Signal router (ML -> Agent)
**Sprint 13: Execution Layer (2 semanas)**
Entregables:
- [ ] Order executor con MT4 integration
- [ ] Position tracker en DB
- [ ] PnL calculator real-time
- [ ] Performance logger
- [ ] Dashboard de agentes
**Dependencias:**
- OQI-006 (senales ML)
- OQI-004 (cuentas de inversion)
- broker_integration schema
- MetaAPI account configurada
**Criterios de Aceptacion:**
- [ ] Atlas genera max 3 trades/dia
- [ ] Orion respeta max drawdown 10%
- [ ] Nova ajusta size segun volatilidad
- [ ] Stop loss ejecuta en <1s
- [ ] Performance log en audit schema
---
### FASE 4: PORTFOLIO PRO
#### Sprint 14-15: Portfolio Manager (4 semanas)
**Objetivo:** Gestion avanzada de portafolios
| Epica | RF | US | SP | Estado |
|-------|----|----|-----|--------|
| OQI-008 | RF-PFM-001 a 007 | US-PFM-001 a 012 | 65 | 🔴 Pendiente |
**Sprint 14: Dashboard y Metricas (2 semanas)**
Entregables:
- [ ] Dashboard con allocation chart
- [ ] Metricas: Sharpe, Sortino, Max DD
- [ ] Stress testing (escenarios predefinidos)
- [ ] Comparacion con benchmark (S&P500)
- [ ] Reportes PDF exportables
**Sprint 15: Rebalanceo y Metas (2 semanas)**
Entregables:
- [ ] Motor de rebalanceo automatico
- [ ] Drift detection (threshold 5%)
- [ ] Calendario de rebalanceo
- [ ] Investment goals tracker
- [ ] Proyecciones Monte Carlo
**Dependencias:**
- OQI-004 (cuentas de inversion)
- investment.portfolio_allocations schema
- Python scipy para Monte Carlo
**Criterios de Aceptacion:**
- [ ] Dashboard carga en <3s
- [ ] Stress test ejecuta 1000 scenarios
- [ ] Rebalanceo sugiere trades optimos
- [ ] Monte Carlo simula 10k paths
- [ ] PDF incluye todos los graficos
---
### FASE 5: PRODUCCION
#### Sprint 16: Launch (2 semanas)
**Objetivo:** Preparacion para produccion
**Entregables:**
- [ ] Tests E2E con Playwright (100 scenarios)
- [ ] Security audit (OWASP Top 10)
- [ ] Performance optimization (Lighthouse >90)
- [ ] Load testing (1000 concurrent users)
- [ ] Monitoring con Prometheus + Grafana
- [ ] CI/CD pipeline en Jenkins
- [ ] Backup automatico de DB
- [ ] Disaster recovery plan
- [ ] Documentacion de API (OpenAPI)
- [ ] Marketing landing page
**Criterios de Aceptacion:**
- [ ] 0 vulnerabilidades criticas
- [ ] API responde en <200ms (p95)
- [ ] Frontend carga en <2s (p90)
- [ ] 99.9% uptime en staging
- [ ] Backup restaura en <1h
---
## 4. Matriz de Dependencias
### 4.1 Dependencias por Epica
```yaml
OQI-001: # Fundamentos Auth
depende_de: []
bloquea: [OQI-002, OQI-003, OQI-004, OQI-005]
criticidad: ALTA
OQI-002: # Educacion
depende_de: [OQI-001]
bloquea: [OQI-007]
criticidad: MEDIA
OQI-003: # Trading Charts
depende_de: [OQI-001]
bloquea: [OQI-006, OQI-007]
criticidad: ALTA
OQI-004: # Cuentas Inversion
depende_de: [OQI-001, OQI-005]
bloquea: [OQI-006, OQI-008]
criticidad: ALTA
OQI-005: # Pagos Stripe
depende_de: [OQI-001]
bloquea: [OQI-004]
criticidad: ALTA
OQI-006: # ML Signals
depende_de: [OQI-003, OQI-004]
bloquea: [OQI-007, OQI-008]
criticidad: CRITICA
OQI-007: # LLM Agent
depende_de: [OQI-002, OQI-003, OQI-006]
bloquea: []
criticidad: MEDIA
OQI-008: # Portfolio Manager
depende_de: [OQI-004, OQI-006]
bloquea: []
criticidad: MEDIA
```
### 4.2 Dependencias de Infraestructura
```yaml
base_de_datos:
- PostgreSQL 15+
- Redis 7+
- Schema migracion completa
servicios_externos:
- Stripe API (pagos)
- Claude API / OpenAI (LLM)
- Polygon.io API (datos mercado)
- MetaAPI (broker MT4)
- Twilio (SMS/WhatsApp)
devops:
- Docker + Docker Compose
- Jenkins CI/CD
- Prometheus + Grafana
- Cloudflare CDN
```
---
## 5. Recursos por Sprint
### 5.1 Team Composition
| Rol | Cantidad | Sprints Asignados |
|-----|----------|-------------------|
| Full Stack Developer | 2 | 1-16 |
| Backend Developer | 1 | 7-13 |
| ML Engineer | 1 | 8-13 |
| DevOps Engineer | 1 | 14-16 |
| QA Engineer | 1 | 14-16 |
| UI/UX Designer | 1 | 1-6 |
### 5.2 Velocity Esperada
- **Sprint 1-6:** 25 SP/sprint (equipo completo)
- **Sprint 7-13:** 30 SP/sprint (ML Engineer agregado)
- **Sprint 14-16:** 35 SP/sprint (DevOps + QA agregados)
**Total Capacity:** 16 sprints × 28 SP promedio = **448 SP** (buffer de 41 SP)
---
## 6. Riesgos y Mitigaciones
| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Retraso en OQI-006 (ML) | Alta | Critico | Empezar migracion en Sprint 6, buffer de 2 semanas |
| API de Claude/OpenAI cambia | Media | Alto | Abstraer LLM provider, tener fallback a modelos locales |
| Problemas con MT4 integration | Alta | Medio | Implementar modo "investor only" como fallback |
| Fallo en security audit | Baja | Critico | Code reviews continuos, OWASP checks desde Sprint 1 |
| Overload en BD con ML queries | Media | Alto | Indices optimizados, cache agresivo, read replicas |
---
## 7. Hitos (Milestones)
| Hito | Sprint | Fecha Estimada | Descripcion |
|------|--------|----------------|-------------|
| **MVP Launch** | 6 | Semana 12 | Auth + Educacion + Charts funcionando |
| **Money Manager Live** | 10 | Semana 20 | Usuarios pueden invertir con agentes |
| **LLM Agent Beta** | 13 | Semana 26 | Chat funcional con tools |
| **Portfolio Pro** | 15 | Semana 30 | Rebalanceo y proyecciones |
| **Production Ready** | 16 | Semana 32 | Launch publico |
---
## 8. Criterios de Aceptacion por Fase
### FASE 1: FUNDAMENTOS (MVP)
- [x] Usuario puede registrarse y hacer login
- [ ] Usuario puede comprar curso y verlo completo
- [ ] Usuario puede suscribirse a plan Pro con Stripe
- [ ] Usuario puede ver charts con indicadores
- [ ] Usuario puede hacer paper trading
### FASE 2: TRADING CORE
- [ ] Usuario puede abrir cuenta de inversion (KYC)
- [ ] Usuario puede depositar desde wallet
- [ ] ML Engine predice rangos con >65% accuracy
- [ ] Senales ML aparecen en tiempo real en frontend
- [ ] Agentes ejecutan trades en paper trading
### FASE 3: IA AVANZADA
- [ ] Usuario puede chatear con LLM sobre mercado
- [ ] LLM puede ejecutar paper trades via chat
- [ ] Atlas Agent genera trades con max DD <5%
- [ ] Orion Agent tiene Sharpe >1.5
- [ ] Nova Agent ajusta posiciones por volatilidad
### FASE 4: PORTFOLIO PRO
- [ ] Usuario ve allocation chart en dashboard
- [ ] Stress test muestra peor escenario
- [ ] Rebalanceo sugiere trades cuando drift >5%
- [ ] Monte Carlo proyecta rango de retornos
- [ ] Reporte PDF incluye todos los graficos
### FASE 5: PRODUCCION
- [ ] 0 vulnerabilidades criticas en audit
- [ ] API p95 <200ms bajo load de 1000 usuarios
- [ ] Frontend Lighthouse score >90
- [ ] Backup/restore funciona en <1h
- [ ] Monitoring dashboard operativo
---
## 9. Documentacion Asociada
| Documento | Proposito |
|-----------|-----------|
| [DIAGRAMA-INTEGRACIONES.md](../../01-arquitectura/DIAGRAMA-INTEGRACIONES.md) | Flujos de datos entre componentes |
| [MATRIZ-DEPENDENCIAS.yml](../inventarios/MATRIZ-DEPENDENCIAS.yml) | Mapa completo de dependencias |
| [JENKINS-DEPLOY.md](../../95-guias-desarrollo/JENKINS-DEPLOY.md) | CI/CD pipelines |
| [ARQUITECTURA-UNIFICADA.md](../../01-arquitectura/ARQUITECTURA-UNIFICADA.md) | Vision general del sistema |
---
## 10. Aprobaciones
| Rol | Nombre | Firma | Fecha |
|-----|--------|-------|-------|
| Product Owner | TBD | - | - |
| Tech Lead | TBD | - | - |
| Stakeholder | TBD | - | - |
---
**Proxima Revision:** Semana 4 (fin de Sprint 2)
**Versionamiento:** Actualizar al final de cada fase
Reference in New Issue View Git Blame Copy Permalink