# Roadmap General - OrbiQuant IA Trading Platform

**Última actualización:** 2025-12-05
**Versión:** 1.0.0
**Estado:** Activo

---

## Resumen Ejecutivo

| Métrica | Valor |
|---------|-------|
| **Total Épicas** | 8 |
| **Total Story Points** | 407 SP |
| **Fase 1 (MVP)** | 287 SP (6 épicas) |
| **Fase 2 (Avanzado)** | 120 SP (2 épicas) |
| **Presupuesto Estimado** | $213,500 MXN |
| **Progreso Actual** | 12% (50 SP completados) |

---

## Fases del Proyecto

### Fase 1: MVP (287 SP)

**Objetivo:** Plataforma funcional con autenticación, educación, trading básico, cuentas de inversión y pagos.

| Épica | Nombre | SP | Dependencias | Estado |
|-------|--------|-----|--------------|--------|
| OQI-001 | Fundamentos y Autenticación | 50 | - | ✅ Completada |
| OQI-002 | Módulo Educativo | 45 | OQI-001 | ⏳ Pendiente |
| OQI-003 | Trading y Charts | 55 | OQI-001 | ⏳ Pendiente |
| OQI-004 | Cuentas de Inversión | 57 | OQI-001, OQI-005, OQI-006 | ⏳ Pendiente |
| OQI-005 | Pagos y Stripe | 40 | OQI-001 | ⏳ Pendiente |
| OQI-006 | Señales ML | 40 | OQI-001, OQI-003 | ⏳ Pendiente |

### Fase 2: Avanzado (120 SP)

**Objetivo:** Funcionalidades premium con LLM Copilot y gestión avanzada de portfolio.

| Épica | Nombre | SP | Dependencias | Estado |
|-------|--------|-----|--------------|--------|
| OQI-007 | LLM Strategy Agent | 55 | OQI-001, OQI-003, OQI-006 | 📋 Planificada |
| OQI-008 | Portfolio Manager | 65 | OQI-001, OQI-003, OQI-004 | 📋 Planificada |

---

## Diagrama de Dependencias

```
                    ┌─────────────┐
                    │   OQI-001   │
                    │ Auth & Base │
                    │   50 SP ✅  │
                    └──────┬──────┘
                           │
         ┌─────────────────┼─────────────────┐
         │                 │                 │
         ▼                 ▼                 ▼
   ┌───────────┐    ┌───────────┐    ┌───────────┐
   │  OQI-002  │    │  OQI-003  │    │  OQI-005  │
   │ Education │    │  Trading  │    │  Payments │
   │   45 SP   │    │   55 SP   │    │   40 SP   │
   └───────────┘    └─────┬─────┘    └─────┬─────┘
                          │                 │
                          ▼                 │
                    ┌───────────┐           │
                    │  OQI-006  │           │
                    │ ML Signals│           │
                    │   40 SP   │           │
                    └─────┬─────┘           │
                          │                 │
         ┌────────────────┴─────────────────┤
         │                                  │
         ▼                                  ▼
   ┌───────────┐                     ┌───────────┐
   │  OQI-007  │                     │  OQI-004  │
   │ LLM Agent │                     │Investment │
   │   55 SP   │                     │   57 SP   │
   └───────────┘                     └─────┬─────┘
                                           │
                                           ▼
                                     ┌───────────┐
                                     │  OQI-008  │
                                     │ Portfolio │
                                     │   65 SP   │
                                     └───────────┘
```

---

## Orden de Implementación Sugerido

### Bloque 1: Fundamentos (Completado)
- [x] **OQI-001** - Autenticación y estructura base

### Bloque 2: Core Features (Paralelo)
Estas épicas pueden desarrollarse en paralelo después de OQI-001:

- [ ] **OQI-002** - Módulo Educativo
- [ ] **OQI-003** - Trading y Charts
- [ ] **OQI-005** - Pagos y Stripe

### Bloque 3: ML Integration
Después de completar OQI-003:

- [ ] **OQI-006** - Señales ML (migrar TradingAgent)

### Bloque 4: Investment
Después de OQI-005 y OQI-006:

- [ ] **OQI-004** - Cuentas de Inversión

### Bloque 5: Advanced Features (Fase 2)
Después de completar la Fase 1:

- [ ] **OQI-007** - LLM Strategy Agent
- [ ] **OQI-008** - Portfolio Manager

---

## Milestones

### Milestone 1: MVP Básico
**Épicas:** OQI-001, OQI-002, OQI-003
**Story Points:** 150 SP
**Entregables:**
- Autenticación completa (OAuth, email, 2FA)
- Catálogo de cursos funcional
- Charts de trading con indicadores
- Paper trading básico

### Milestone 2: Monetización
**Épicas:** OQI-005
**Story Points:** 40 SP
**Entregables:**
- Suscripciones con Stripe
- Checkout de cursos
- Facturación automática

### Milestone 3: ML Integration
**Épicas:** OQI-006
**Story Points:** 40 SP
**Entregables:**
- Predicciones de precio
- Señales de trading
- ML overlays en charts

### Milestone 4: Investment Platform
**Épicas:** OQI-004
**Story Points:** 57 SP
**Entregables:**
- Productos de inversión (Atlas, Orion, Nova)
- Depósitos y retiros
- Agentes de trading automatizado

### Milestone 5: Premium Features
**Épicas:** OQI-007, OQI-008
**Story Points:** 120 SP
**Entregables:**
- Copilot AI para trading
- Portfolio manager avanzado
- Análisis de riesgo

---

## Métricas por Épica

| Épica | RF | ET | US | Archivos Est. | Tests |
|-------|-----|-----|-----|--------------|-------|
| OQI-001 | 5 | 5 | 12 | 25 | TBD |
| OQI-002 | 6 | 6 | 8 | 35 | TBD |
| OQI-003 | 8 | 8 | 18 | 50 | TBD |
| OQI-004 | 6 | 7 | 14 | 45 | TBD |
| OQI-005 | 6 | 6 | 10 | 35 | TBD |
| OQI-006 | 5 | 5 | 7 | 40 | TBD |
| OQI-007 | 6 | 6 | 10 | 45 | TBD |
| OQI-008 | 7 | 7 | 12 | 50 | TBD |
| **Total** | **49** | **50** | **91** | **325** | - |

---

## Riesgos y Mitigaciones

### Riesgo 1: Integración de TradingAgent
**Descripción:** Migrar el ML Engine existente puede ser complejo
**Impacto:** Alto
**Mitigación:**
- Documentar arquitectura actual
- Crear adaptadores de API
- Migrar componentes gradualmente

### Riesgo 2: Compliance Financiero
**Descripción:** Cuentas de inversión requieren regulaciones
**Impacto:** Alto
**Mitigación:**
- Consultar con abogados financieros
- Implementar KYC
- Términos y condiciones claros

### Riesgo 3: Costos de API
**Descripción:** OpenAI, Stripe, market data tienen costos
**Impacto:** Medio
**Mitigación:**
- Implementar rate limiting
- Caching agresivo
- Tiers de suscripción

### Riesgo 4: Rendimiento de Charts
**Descripción:** Charts en tiempo real son intensivos
**Impacto:** Medio
**Mitigación:**
- Lightweight Charts (optimizado)
- WebSocket con throttling
- Lazy loading

---

## Stack Tecnológico

### Frontend
- React 18 + TypeScript
- Vite
- TailwindCSS + shadcn/ui
- Zustand (state management)
- TanStack Query
- Lightweight Charts

### Backend
- Node.js + Express.js
- TypeScript
- PostgreSQL
- Redis (cache)
- JWT + Sessions

### ML Engine
- Python 3.11+
- PyTorch / TensorFlow
- FastAPI
- Pandas / NumPy

### Infraestructura
- Docker
- GitHub Actions (CI/CD)
- Cloudflare (CDN)
- AWS/Vercel (hosting)

---

## Referencias

- [Arquitectura Unificada](../../01-arquitectura/ARQUITECTURA-UNIFICADA.md)
- [Integración TradingAgent](../../01-arquitectura/INTEGRACION-TRADINGAGENT.md)
- [DATABASE_INVENTORY](../inventarios/DATABASE_INVENTORY.yml)
- [BACKEND_INVENTORY](../inventarios/BACKEND_INVENTORY.yml)
- [FRONTEND_INVENTORY](../inventarios/FRONTEND_INVENTORY.yml)

---

## Historial de Cambios

| Fecha | Versión | Cambios |
|-------|---------|---------|
| 2025-12-05 | 1.0.0 | Creación inicial del roadmap |

---

*Documento de roadmap - Sistema NEXUS*
*OrbiQuant IA Trading Platform*
