- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
8.7 KiB
8.7 KiB
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