workspace/projects/trading-platform/docs/_MAP.md

_MAP: OrbiQuant IA - Trading Platform

Ultima actualizacion: 2025-12-12 Version: 2.1.0 Estado: En Desarrollo Codigo Proyecto: trading-platform

---

Proposito

Este documento es el indice maestro de toda la documentacion del proyecto OrbiQuant IA. Proporciona navegacion rapida a cualquier seccion y mantiene la trazabilidad entre documentos.

---

Metricas del Proyecto

Metrica	Valor	Estado
Total Epicas	9	Fase 1: 6, Fase 2: 3
Story Points	452 SP	95 completados (21%)
Servicios Python	4	ML, Data, MT4 GW, LLM
Documentacion	98%	Estructura completa
Implementacion	25%	OQI-001, OQI-006 (70%), OQI-009 (30%)

---

Estructura de Documentacion

docs/
├── _MAP.md                          ← ESTE ARCHIVO (indice maestro)
├── README.md                        ← Vision general del proyecto
│
├── 00-vision-general/               # Vision, arquitectura base
│   ├── _MAP.md
│   ├── VISION-PRODUCTO.md
│   ├── ARQUITECTURA-GENERAL.md
│   └── STACK-TECNOLOGICO.md
│
├── 01-arquitectura/                 # Documentos de arquitectura
│   ├── ARQUITECTURA-UNIFICADA.md    ← Sistema completo
│   ├── ARQUITECTURA-MULTI-AGENTE-MT4.md ← Multi-agent MT4 system
│   ├── INTEGRACION-TRADINGAGENT.md  ← ML Engine existente
│   └── DIAGRAMA-INTEGRACIONES.md    ← Flujos y protocolos
│
├── 02-definicion-modulos/           # 8 Epicas del proyecto
│   ├── _MAP.md                      ← Indice de epicas
│   ├── OQI-001-fundamentos-auth/    ← Fase 1 MVP
│   ├── OQI-002-education/
│   ├── OQI-003-trading-charts/
│   ├── OQI-004-investment-accounts/
│   ├── OQI-005-payments-stripe/
│   ├── OQI-006-ml-signals/
│   ├── OQI-007-llm-agent/           ← Fase 2 Avanzado
│   └── OQI-008-portfolio-manager/
│
├── 90-transversal/                  # Documentacion transversal
│   ├── inventarios/                 ← INVENTARIOS CONSOLIDADOS
│   │   ├── DATABASE_INVENTORY.yml
│   │   ├── BACKEND_INVENTORY.yml
│   │   ├── FRONTEND_INVENTORY.yml
│   │   ├── ML_INVENTORY.yml
│   │   ├── STRATEGIES_INVENTORY.yml
│   │   └── MATRIZ-DEPENDENCIAS.yml  ← NUEVO: Mapa de dependencias
│   ├── integraciones/               ← Integraciones externas
│   │   ├── INT-DATA-001-data-service.md
│   │   └── INT-DATA-002-analisis-impacto.md
│   ├── estrategias/                 ← Estrategias de prediccion
│   │   └── ESTRATEGIA-PREDICCION-RANGOS.md
│   ├── sprints/                     ← Tracking por sprint
│   ├── roadmap/                     ← Roadmap del proyecto
│   │   └── PLAN-DESARROLLO-DETALLADO.md ← NUEVO: Plan de 16 sprints
│   ├── metricas/                    ← KPIs y metricas
│   └── gaps/                        ← Analisis de brechas
│
├── 95-guias-desarrollo/             # Guias tecnicas
│   ├── backend/
│   ├── frontend/
│   ├── database/
│   ├── ml-engine/
│   └── JENKINS-DEPLOY.md            ← NUEVO: CI/CD Pipelines
│
├── 97-adr/                          # Architecture Decision Records
│
└── 98-standards/                    # Estandares del proyecto

---

Navegacion por Fase

Fase 1 - MVP (287 SP)

Codigo	Epica	SP	Estado	Documentos
OQI-001	Fundamentos y Auth	50	✅ Completado	RF / ET / US / TRACE
OQI-002	Modulo Educativo	45	Pendiente	RF / ET / US / TRACE
OQI-003	Trading y Charts	55	Pendiente	RF / ET / US / TRACE
OQI-004	Cuentas de Inversion	57	Pendiente	RF / ET / US / TRACE
OQI-005	Pagos y Stripe	40	Pendiente	RF / ET / US / TRACE
OQI-006	Senales ML	40	Pendiente	RF / ET / US / TRACE

Fase 2 - Avanzado (165 SP)

Codigo	Epica	SP	Estado	Documentos
OQI-007	LLM Strategy Agent	55	Planificado	RF / ET / US / TRACE
OQI-008	Portfolio Manager	65	Planificado	RF / ET / US / TRACE
OQI-009	Trading Execution (MT4 Gateway)	45	En Desarrollo	ARCH / INT / INV

---

Inventarios Consolidados

Inventario	Ubicacion	Contenido
DATABASE_INVENTORY.yml	Base de Datos	Schemas, tablas, funciones, triggers
BACKEND_INVENTORY.yml	Backend	Modulos, servicios, controllers, endpoints
FRONTEND_INVENTORY.yml	Frontend	Features, paginas, componentes, hooks
ML_INVENTORY.yml	ML Engine	Modelos, features, pipelines
STRATEGIES_INVENTORY.yml	Trading	Estrategias AMD, SMC, patrones
MT4_GATEWAY_INVENTORY.yml	MT4 Gateway	Agentes, endpoints, configuracion
MATRIZ-DEPENDENCIAS-TRADING.yml	Integraciones	Dependencias del sistema de trading

---

Integraciones Externas

Documento	Descripcion	Estado
INT-DATA-001-data-service.md	Data Service - Polygon API, MT4, spreads	✅ Implementado
INT-DATA-002-analisis-impacto.md	Analisis de impacto del Data Service	✅ Validado
INT-MT4-001-gateway-service.md	MT4 Gateway - Multi-agente trading	🔄 En Desarrollo

Setup y Configuracion

Documento	Descripcion	Estado
SETUP-MT4-TRADING.md	Guia de configuracion MT4 + Polygon	✅ Completo

---

Estrategias de Trading

Documento	Descripcion	Estado
ESTRATEGIA-PREDICCION-RANGOS.md	Estrategia de prediccion de max/min con R:R 2:1/3:1	✅ Documentado

---

Documentacion por Tipo

Requerimientos Funcionales (RF)

ID	Nombre	Epica	Estado
RF-AUTH-001	OAuth Multi-proveedor	OQI-001	✅
RF-AUTH-002	Autenticacion Email	OQI-001	✅
RF-AUTH-003	2FA TOTP	OQI-001	✅
RF-AUTH-004	Gestion de Sesiones	OQI-001	✅
RF-AUTH-005	RBAC	OQI-001	✅
RF-EDU-001 a 006	Modulo Educativo	OQI-002	Pendiente
RF-TRD-001 a 008	Trading y Charts	OQI-003	Pendiente
RF-INV-001 a 006	Cuentas Inversion	OQI-004	Pendiente
RF-PAY-001 a 006	Pagos Stripe	OQI-005	Pendiente
RF-ML-001 a 005	Senales ML	OQI-006	Pendiente
RF-LLM-001 a 006	LLM Agent	OQI-007	Planificado
RF-PFM-001 a 007	Portfolio Manager	OQI-008	Planificado

Total: 50 Requerimientos Funcionales

Especificaciones Tecnicas (ET)

ID	Nombre	Epica	Componente
ET-AUTH-001 a 005	Autenticacion	OQI-001	Backend/Frontend
ET-EDU-001 a 006	Educacion	OQI-002	Full Stack
ET-TRD-001 a 008	Trading	OQI-003	Full Stack + ML
ET-INV-001 a 007	Inversion	OQI-004	Full Stack
ET-PAY-001 a 006	Pagos	OQI-005	Backend + Stripe
ET-ML-001 a 005	ML Signals	OQI-006	ML Engine
ET-LLM-001 a 006	LLM Agent	OQI-007	Backend + LLM
ET-PFM-001 a 007	Portfolio	OQI-008	Full Stack

Total: 50 Especificaciones Tecnicas

Historias de Usuario (US)

Epica	Cantidad	Estado
OQI-001	12 US	✅ Completadas
OQI-002	15 US	Pendientes
OQI-003	18 US	Pendientes
OQI-004	14 US	Pendientes
OQI-005	12 US	Pendientes
OQI-006	10 US	Pendientes
OQI-007	10 US	Planificadas
OQI-008	12 US	Planificadas

Total: 103 Historias de Usuario

---

Arquitectura y Referencias

Documento	Proposito	Link
Arquitectura Unificada	Diagrama completo del sistema	Ver
Arquitectura Multi-Agente MT4	Sistema de trading multi-agente	Ver
Diagrama de Integraciones	Flujos de datos y protocolos	Ver
Integracion TradingAgent	Migracion del ML Engine existente	Ver
Vision del Producto	Alcance y objetivos	Ver
Stack Tecnologico	Tecnologias utilizadas	Ver
ADR-001	Decision de arquitectura ORM	Ver
ADR-002	MVP Operativo Trading	Ver

---

Guias de Desarrollo

Guia	Estado	Link
Backend (Express.js)	En Desarrollo	Ver
Frontend (React)	En Desarrollo	Ver
Database (PostgreSQL)	En Desarrollo	Ver
ML Engine (Python)	En Desarrollo	Ver
Jenkins CI/CD	Completo	Ver

---

Roadmap y Sprints

Recurso	Descripcion	Link
Plan de Desarrollo Detallado	16 sprints en 5 fases	Ver
Roadmap General	Fases y milestones	Ver
Sprint Actual	Tracking de tareas	Ver
Metricas	KPIs del proyecto	Ver
Gaps	Brechas identificadas	Ver

---

Convencion de Nombres

Documentos

Tipo	Patron	Ejemplo
Requerimiento Funcional	RF-{AREA}-{NUM}	RF-AUTH-001
Especificacion Tecnica	ET-{AREA}-{NUM}	ET-AUTH-001
Historia de Usuario	US-{EPIC}-{NUM}	US-AUTH-001
ADR	ADR-{NUM}	ADR-001

Epicas

Fase	Patron	Rango
MVP	OQI-00X	001-006
Avanzado	OQI-00X	007-008
Backlog	OQI-0XX	009+

---

Como Usar Esta Documentacion

Para Nuevos Desarrolladores

1. Leer README.md (5 min)
2. Leer Vision del Producto (10 min)
3. Revisar Arquitectura Unificada (15 min)
4. Ir a la epica asignada y leer su _MAP.md

Para Buscar Objetos Existentes

1. Consultar el inventario correspondiente:
   • Tablas → DATABASE_INVENTORY.yml
   • Endpoints → BACKEND_INVENTORY.yml
   • Componentes → FRONTEND_INVENTORY.yml

Para Analisis de Impacto

1. Ir al TRACEABILITY.yml de la epica
2. Buscar el RF/ET/US afectado
3. Ver la seccion implementation para archivos relacionados
4. Consultar dependencies para epicas bloqueadas/bloqueantes

---

Referencias Externas

• TradingAgent Original - ML Engine migrado a apps/ml-engine/ (origen histórico: workspace-old/UbuntuML/TradingAgent)
• Gamilit (Referencia) - Ver documentación en proyecto hermano projects/gamilit/docs/
• Contexto del Proyecto

---

Indice maestro - Sistema NEXUS Ultima actualizacion: 2025-12-12