# Contexto del Proyecto - OrbiQuant IA

## Identificación

| Campo | Valor |
|-------|-------|
| **Nombre** | OrbiQuant IA - Trading Platform |
| **Código** | trading-platform |
| **Estado** | En Desarrollo (MVP + Fase 2) |
| **Creado** | 2025-12-05 |
| **Fase Actual** | Fase 1 - MVP (expandido) |

---

## Descripción

OrbiQuant IA es una plataforma integral de gestión de inversiones asistida por inteligencia artificial, similar a Trade Republic pero potenciada con IA. Combina:

- **Money Manager con IA**: Agentes automáticos (Atlas, Orion, Nova) con diferentes perfiles de riesgo que operan en nombre del usuario
- **Plataforma Educativa**: Cursos de trading con gamificación
- **TradingView Clone con ML**: Charts profesionales con indicadores predictivos del modelo ML
- **Copiloto de Trading (LLM)**: Agente conversacional que interpreta señales y sugiere estrategias
- **Portfolio Manager**: Gestión de carteras a largo plazo con rebalanceo automático
- **Sistema SaaS**: Suscripciones, pagos con Stripe, wallets internos

---

## Visión

> "Ser la plataforma de trading más accesible e inteligente de Latinoamérica, democratizando el acceso a herramientas de inversión profesional"

## Misión

Empoderar a personas a invertir de manera inteligente, combinando educación de calidad con herramientas de IA de nivel institucional para optimizar sus decisiones de inversión.

---

## Activos Existentes

### TradingAgent (ML Engine)

**Ubicación:** `/home/isem/workspace-old/UbuntuML/TradingAgent`

Sistema de ML ya desarrollado con:
- **Modelos XGBoost/GRU/Transformer** para predicción de precios
- **RangePredictor**: Predicción de rangos (85.9% accuracy)
- **TPSLClassifier**: Clasificación TP/SL (0.94 AUC)
- **AMDDetector**: Detección de fases de mercado (Accumulation/Manipulation/Distribution)
- **SignalGenerator**: Generación de señales en formato JSON
- **10+ años de datos históricos**: XAUUSD, EURUSD, GBPUSD, USDJPY
- **API FastAPI** + Dashboard real-time

---

## Stack Tecnológico

| Capa | Tecnología |
|------|------------|
| **Frontend** | React 18 + TypeScript + Vite + Tailwind CSS |
| **Backend** | Express.js + TypeScript |
| **Database** | PostgreSQL 15+ |
| **Cache** | Redis 7 |
| **ML Engine** | Python 3.11 + FastAPI + XGBoost (TradingAgent) |
| **LLM** | Claude API / OpenAI API |
| **Pagos** | Stripe |
| **Auth** | JWT + Passport + OAuth (Google, Facebook, X, Apple, GitHub) |
| **Exchange** | Binance API (trading automático) |

---

## Estructura del Proyecto (8 Épicas)

### Épicas MVP (Fase 1)

| Código | Nombre | SP | Estado | Descripción |
|--------|--------|-----|--------|-------------|
| OQI-001 | Fundamentos y Auth | 50 | ✅ Completado | OAuth, JWT, 2FA |
| OQI-002 | Módulo Educativo | 45 | Parcial | Cursos, quizzes |
| OQI-003 | Trading y Charts | 55 | Pendiente | TradingView clone |
| OQI-004 | Cuentas de Inversión | 57 | Pendiente | Money Manager |
| OQI-005 | Pagos y Stripe | 40 | Parcial | Suscripciones |
| OQI-006 | Señales ML | 40 | ML Engine listo | Predicciones |

### Épicas Fase 2 (Nuevas)

| Código | Nombre | SP | Estado | Descripción |
|--------|--------|-----|--------|-------------|
| **OQI-007** | **LLM Strategy Agent** | **55** | **Nuevo** | Copiloto de trading IA |
| **OQI-008** | **Portfolio Manager** | **65** | **Nuevo** | Gestión de carteras |

**Total: 407 Story Points**

---

## Productos de Inversión (Agentes IA)

| Agente | Perfil | Target Mensual | Max Drawdown | Mín. Inversión |
|--------|--------|----------------|--------------|----------------|
| **Atlas** | Conservador | 3-5% | 5% | $100 USD |
| **Orion** | Moderado | 5-10% | 10% | $500 USD |
| **Nova** | Agresivo | 10-50% | 20% | $1,000 USD |

### Estrategias por Agente

- **Atlas**: Mean reversion + Grid trading (solo BTC/ETH)
- **Orion**: Trend following + Breakouts (Top 10 cryptos)
- **Nova**: Momentum + Altcoin rotation (Top 50 + nuevos listings)

---

## Planes de Suscripción

| Plan | Precio | Features Clave |
|------|--------|----------------|
| **Free** | $0/mes | Paper trading, cursos básicos, 3 señales/día |
| **Basic** | $19/mes | Trading real, 10 señales/día, 1 agente (Atlas) |
| **Pro** | $49/mes | Señales ilimitadas, 3 agentes, LLM copiloto |
| **Premium** | $99/mes | API access, Portfolio Manager, soporte dedicado |

---

## Funcionalidades Clave

### 1. TradingView Clone con ML
- Charts profesionales (Lightweight Charts)
- Indicadores técnicos tradicionales
- **Indicadores predictivos ML** superpuestos
- Señales de entrada/salida visualizadas
- Alertas personalizables

### 2. Money Manager (Agentes)
- Fondear cuenta de inversión
- Seleccionar agente por perfil de riesgo
- Trading automático 24/7
- Dashboard de rendimiento
- Solicitar retiros
- Distribución de ganancias (80% reinversión / 20% usuario)

### 3. LLM Copiloto de Trading
- Chat conversacional
- Interpretación de señales ML en lenguaje natural
- Sugerencias de estrategias personalizadas
- Explicación de decisiones de trading
- Modo proactivo (alertas)

### 4. Portfolio Manager
- Cuestionario de perfil de riesgo
- Asignación automática entre agentes
- Rebalanceo automático
- Proyecciones Monte Carlo
- Metas de inversión
- Reportes fiscales

---

## Arquitectura de Alto Nivel

```
┌─────────────────────────────────────────────────────────────┐
│                    FRONTEND (React)                          │
│  Auth │ Education │ Trading │ Investment │ LLM Chat         │
└─────────────────────────────┬───────────────────────────────┘
                              │
┌─────────────────────────────▼───────────────────────────────┐
│                    BACKEND (Express.js)                      │
│  API Gateway │ WebSocket │ ML Integration │ Payments        │
└─────────────────────────────┬───────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
┌───────▼───────┐    ┌────────▼────────┐    ┌──────▼──────┐
│   ML ENGINE   │    │   LLM AGENT     │    │  TRADING    │
│  (TradingAgent)│    │ (Claude/GPT)    │    │   AGENTS    │
│  - XGBoost    │    │ - Interpreter   │    │ - Atlas     │
│  - Signals    │    │ - Strategies    │    │ - Orion     │
│  - AMD        │    │ - Tools         │    │ - Nova      │
└───────────────┘    └─────────────────┘    └─────────────┘
        │                     │                     │
┌───────▼─────────────────────▼─────────────────────▼─────────┐
│                      DATA LAYER                              │
│  PostgreSQL │ Redis │ Binance API │ Stripe │ S3             │
└─────────────────────────────────────────────────────────────┘
```

---

## Documentación Clave

| Documento | Ubicación |
|-----------|-----------|
| Arquitectura Unificada | `docs/01-arquitectura/ARQUITECTURA-UNIFICADA.md` |
| Integración TradingAgent | `docs/01-arquitectura/INTEGRACION-TRADINGAGENT.md` |
| Épicas MVP | `docs/02-definicion-modulos/OQI-001 a OQI-008` |
| TradingAgent Original | `/home/isem/workspace-old/UbuntuML/TradingAgent/` |

---

## Métricas del Proyecto

| Métrica | Target | Actual |
|---------|--------|--------|
| Story Points | 407 | 50 (12%) |
| Épicas documentadas | 8 | 8 (100%) |
| Épicas completadas | 8 | 1 (12.5%) |
| Documentos técnicos | 200+ | 170+ |
| Cobertura tests | 80% | TBD |

---

## Roadmap

### Q1 2026
- Fase 1 completa (OQI-001 a OQI-006)
- MVP funcional

### Q2 2026
- Fase 2 (OQI-007 y OQI-008)
- LLM Agent + Portfolio Manager

### Q3 2026
- Beta pública
- Onboarding de usuarios

### Q4 2026
- Producción completa
- Expansión de features

---

*Contexto del proyecto - Sistema NEXUS*
*Última actualización: 2025-12-05*
