workspace/projects/trading-platform/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration
- 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>
2025-12-08 10:44:23 -06:00

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