trading-platform/docs/90-transversal/roadmap/PLAN-DESARROLLO-DETALLADO.md

id	title	type	project	version	updated_date
PLAN-DESARROLLO-DETALLADO	Plan de Desarrollo Detallado - Trading Platform	Documentation	trading-platform	1.0.0	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:

• Usuario puede registrarse con email
• Usuario puede login con Google/Facebook
• 2FA funciona con Google Authenticator
• Tokens JWT expiran y se renuevan correctamente
• 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

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

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)

• 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	Flujos de datos entre componentes
MATRIZ-DEPENDENCIAS.yml	Mapa completo de dependencias
JENKINS-DEPLOY.md	CI/CD pipelines
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