# Plan de Desarrollo Detallado - OrbiQuant IA 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 OrbiQuant IA 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
