# _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](./02-definicion-modulos/OQI-001-fundamentos-auth/) | Fundamentos y Auth | 50 | ✅ Completado | [RF](./02-definicion-modulos/OQI-001-fundamentos-auth/requerimientos/) / [ET](./02-definicion-modulos/OQI-001-fundamentos-auth/especificaciones/) / [US](./02-definicion-modulos/OQI-001-fundamentos-auth/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-001-fundamentos-auth/implementacion/TRACEABILITY.yml) |
| [OQI-002](./02-definicion-modulos/OQI-002-education/) | Modulo Educativo | 45 | Pendiente | [RF](./02-definicion-modulos/OQI-002-education/requerimientos/) / [ET](./02-definicion-modulos/OQI-002-education/especificaciones/) / [US](./02-definicion-modulos/OQI-002-education/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-002-education/implementacion/TRACEABILITY.yml) |
| [OQI-003](./02-definicion-modulos/OQI-003-trading-charts/) | Trading y Charts | 55 | Pendiente | [RF](./02-definicion-modulos/OQI-003-trading-charts/requerimientos/) / [ET](./02-definicion-modulos/OQI-003-trading-charts/especificaciones/) / [US](./02-definicion-modulos/OQI-003-trading-charts/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-003-trading-charts/implementacion/TRACEABILITY.yml) |
| [OQI-004](./02-definicion-modulos/OQI-004-investment-accounts/) | Cuentas de Inversion | 57 | Pendiente | [RF](./02-definicion-modulos/OQI-004-investment-accounts/requerimientos/) / [ET](./02-definicion-modulos/OQI-004-investment-accounts/especificaciones/) / [US](./02-definicion-modulos/OQI-004-investment-accounts/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-004-investment-accounts/implementacion/TRACEABILITY.yml) |
| [OQI-005](./02-definicion-modulos/OQI-005-payments-stripe/) | Pagos y Stripe | 40 | Pendiente | [RF](./02-definicion-modulos/OQI-005-payments-stripe/requerimientos/) / [ET](./02-definicion-modulos/OQI-005-payments-stripe/especificaciones/) / [US](./02-definicion-modulos/OQI-005-payments-stripe/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-005-payments-stripe/implementacion/TRACEABILITY.yml) |
| [OQI-006](./02-definicion-modulos/OQI-006-ml-signals/) | Senales ML | 40 | Pendiente | [RF](./02-definicion-modulos/OQI-006-ml-signals/requerimientos/) / [ET](./02-definicion-modulos/OQI-006-ml-signals/especificaciones/) / [US](./02-definicion-modulos/OQI-006-ml-signals/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-006-ml-signals/implementacion/TRACEABILITY.yml) |

### Fase 2 - Avanzado (165 SP)

| Codigo | Epica | SP | Estado | Documentos |
|--------|-------|-----|--------|------------|
| [OQI-007](./02-definicion-modulos/OQI-007-llm-agent/) | LLM Strategy Agent | 55 | Planificado | [RF](./02-definicion-modulos/OQI-007-llm-agent/requerimientos/) / [ET](./02-definicion-modulos/OQI-007-llm-agent/especificaciones/) / [US](./02-definicion-modulos/OQI-007-llm-agent/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-007-llm-agent/implementacion/TRACEABILITY.yml) |
| [OQI-008](./02-definicion-modulos/OQI-008-portfolio-manager/) | Portfolio Manager | 65 | Planificado | [RF](./02-definicion-modulos/OQI-008-portfolio-manager/requerimientos/) / [ET](./02-definicion-modulos/OQI-008-portfolio-manager/especificaciones/) / [US](./02-definicion-modulos/OQI-008-portfolio-manager/historias-usuario/) / [TRACE](./02-definicion-modulos/OQI-008-portfolio-manager/implementacion/TRACEABILITY.yml) |
| **OQI-009** | **Trading Execution (MT4 Gateway)** | **45** | **En Desarrollo** | [ARCH](./01-arquitectura/ARQUITECTURA-MULTI-AGENTE-MT4.md) / [INT](./90-transversal/integraciones/INT-MT4-001-gateway-service.md) / [INV](./90-transversal/inventarios/MT4_GATEWAY_INVENTORY.yml) |

---

## Inventarios Consolidados

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

---

## Integraciones Externas

| Documento | Descripcion | Estado |
|-----------|-------------|--------|
| [INT-DATA-001-data-service.md](./90-transversal/integraciones/INT-DATA-001-data-service.md) | Data Service - Polygon API, MT4, spreads | ✅ Implementado |
| [INT-DATA-002-analisis-impacto.md](./90-transversal/integraciones/INT-DATA-002-analisis-impacto.md) | Analisis de impacto del Data Service | ✅ Validado |
| **[INT-MT4-001-gateway-service.md](./90-transversal/integraciones/INT-MT4-001-gateway-service.md)** | **MT4 Gateway - Multi-agente trading** | **🔄 En Desarrollo** |

## Setup y Configuracion

| Documento | Descripcion | Estado |
|-----------|-------------|--------|
| [SETUP-MT4-TRADING.md](./90-transversal/setup/SETUP-MT4-TRADING.md) | Guia de configuracion MT4 + Polygon | ✅ Completo |

---

## Estrategias de Trading

| Documento | Descripcion | Estado |
|-----------|-------------|--------|
| [ESTRATEGIA-PREDICCION-RANGOS.md](./90-transversal/estrategias/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](./01-arquitectura/ARQUITECTURA-UNIFICADA.md) |
| **Arquitectura Multi-Agente MT4** | **Sistema de trading multi-agente** | **[Ver](./01-arquitectura/ARQUITECTURA-MULTI-AGENTE-MT4.md)** |
| **Diagrama de Integraciones** | **Flujos de datos y protocolos** | **[Ver](./01-arquitectura/DIAGRAMA-INTEGRACIONES.md)** |
| Integracion TradingAgent | Migracion del ML Engine existente | [Ver](./01-arquitectura/INTEGRACION-TRADINGAGENT.md) |
| Vision del Producto | Alcance y objetivos | [Ver](./00-vision-general/VISION-PRODUCTO.md) |
| Stack Tecnologico | Tecnologias utilizadas | [Ver](./00-vision-general/STACK-TECNOLOGICO.md) |
| ADR-001 | Decision de arquitectura ORM | [Ver](./97-adr/ADR-001-seleccion-orm.md) |
| **ADR-002** | **MVP Operativo Trading** | **[Ver](./97-adr/ADR-002-MVP-OPERATIVO-TRADING.md)** |

---

## Guias de Desarrollo

| Guia | Estado | Link |
|------|--------|------|
| Backend (Express.js) | En Desarrollo | [Ver](./95-guias-desarrollo/backend/) |
| Frontend (React) | En Desarrollo | [Ver](./95-guias-desarrollo/frontend/) |
| Database (PostgreSQL) | En Desarrollo | [Ver](./95-guias-desarrollo/database/) |
| ML Engine (Python) | En Desarrollo | [Ver](./95-guias-desarrollo/ml-engine/) |
| **Jenkins CI/CD** | **Completo** | **[Ver](./95-guias-desarrollo/JENKINS-DEPLOY.md)** |

---

## Roadmap y Sprints

| Recurso | Descripcion | Link |
|---------|-------------|------|
| **Plan de Desarrollo Detallado** | **16 sprints en 5 fases** | **[Ver](./90-transversal/roadmap/PLAN-DESARROLLO-DETALLADO.md)** |
| Roadmap General | Fases y milestones | [Ver](./90-transversal/roadmap/ROADMAP-GENERAL.md) |
| Sprint Actual | Tracking de tareas | [Ver](./90-transversal/sprints/) |
| Metricas | KPIs del proyecto | [Ver](./90-transversal/metricas/) |
| Gaps | Brechas identificadas | [Ver](./90-transversal/gaps/) |

---

## 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](./README.md) (5 min)
2. Leer [Vision del Producto](./00-vision-general/VISION-PRODUCTO.md) (10 min)
3. Revisar [Arquitectura Unificada](./01-arquitectura/ARQUITECTURA-UNIFICADA.md) (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](./90-transversal/inventarios/DATABASE_INVENTORY.yml)
   - Endpoints → [BACKEND_INVENTORY.yml](./90-transversal/inventarios/BACKEND_INVENTORY.yml)
   - Componentes → [FRONTEND_INVENTORY.yml](./90-transversal/inventarios/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](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)

---

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