trading-platform/docs/_MAP.md
Adrian Flores Cortes 8f0235c096 [TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION] docs: Complete 6-phase documentation analysis
- FASE-0: Diagnostic audit of 500+ files, 33 findings cataloged (7P0/8P1/12P2/6P3)
- FASE-1: Resolved 7 P0 critical conflicts (ports, paths, dedup OQI-010/ADR-002, orphan schemas)
- FASE-2: Resolved 8 P1 issues (traces, README/CLAUDE.md, DEPENDENCY-GRAPH v2.0, DDL drift, stack versions, DoR/DoD)
- FASE-3: Resolved 12 P2 issues (archived tasks indexed, RNFs created, OQI-010 US/RF/ET, AGENTS v2.0)
- FASE-4: Purged 3 obsolete docs to _archive/, fixed MODELO-NEGOCIO.md broken ref
- FASE-5: Cross-layer validation (DDL→OQI 66%, OQI→BE 72%, BE→FE 78%, Inventories 95%)
- FASE-6: INFORME-FINAL, SA-INDEX (18 subagents), METADATA COMPLETED

27/33 findings resolved (82%), 6 P3 deferred to backlog.
18 new files created, 40+ modified, 4 archived.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 10:57:03 -06:00

338 lines
17 KiB
Markdown

---
id: "MAP-docs"
title: "Mapa de docs"
type: "Index"
project: "trading-platform"
updated_date: "2026-02-06"
---
# _MAP: Trading Platform - Trading Platform
**Ultima actualizacion:** 2026-02-04
**Version:** 2.3.0
**Estado:** En Desarrollo
**Codigo Proyecto:** trading-platform
---
## Proposito
Este documento es el **indice maestro** de toda la documentacion del proyecto Trading Platform. 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** | 100% | Completa con OpenAPI, coherencia tipo fixeada |
| **Implementacion** | 30% | OQI-001, OQI-006, OQI-007 componentes |
---
## Estructura de Documentacion
```
docs/
├── _MAP.md ← ESTE ARCHIVO (indice maestro)
├── README.md ← Vision general del proyecto
├── API.md ← API Overview (referencia a swagger.yml)
├── DOCUMENTATION-STATUS.md ← Estado de la documentacion (2026-02-04)
├── _archive/ # Documentos archivados/obsoletos
│ ├── 00-notas/ ← Notas resueltas
│ └── 04-fase-backlog/ ← Backlog deprecado
├── 00-vision-general/ # Vision, arquitectura base
│ ├── 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/ # 11 Epicas del proyecto
│ ├── _MAP.md ← Indice de epicas
│ ├── OQI-001-fundamentos-auth/ ← Fase 1 MVP (COMPLETO)
│ ├── 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/
│ ├── OQI-009-marketplace/ ← Fase 3 Expansion
│ ├── OQI-010-mt4-gateway/ ← NO FUNCIONAL (15%)
│ └── OQI-010-llm-trading-integration/
├── 04-fase-backlog/ # Definiciones de calidad
│ ├── DEFINITION-OF-READY.md
│ └── DEFINITION-OF-DONE.md
├── 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
│ ├── integraciones/ ← Integraciones externas
│ │ ├── INT-DATA-001-data-service.md
│ │ ├── INT-DATA-002-analisis-impacto.md
│ │ └── INT-SERVICES-INTEGRATION.md
│ ├── security/ ← Seguridad y compliance
│ │ └── SECURITY.md
│ ├── estrategias/ ← Estrategias de prediccion
│ │ └── ESTRATEGIA-PREDICCION-RANGOS.md
│ ├── roadmap/ ← Roadmap del proyecto
│ │ └── PLAN-DESARROLLO-DETALLADO.md
│ └── setup/ ← Guias de configuracion
│ └── SETUP-MT4-TRADING.md
├── 95-guias-desarrollo/ # Guias tecnicas
│ ├── ml-engine/ ← Setup Python ML
│ ├── JENKINS-DEPLOY.md
│ ├── PUERTOS-SERVICIOS.md
│ └── TESTING-STRATEGY.md
├── 97-adr/ # Architecture Decision Records
└── 99-analisis/ # Analisis y reportes tecnicos (historico)
├── _MAP.md ← Indice de analisis
├── PLAN-*.md ← Planes de implementacion
├── REPORTE-*.md ← Reportes de entrega
├── ANALISIS-*.md ← Analisis tecnicos
└── VALIDACION-*.md ← Validaciones
```
**Tambien ver:**
- [swagger.yml](../apps/backend/swagger.yml) - Especificacion OpenAPI 3.0.3 completa (ST2.3)
- [ENDPOINT-ROUTING.md](../apps/backend/ENDPOINT-ROUTING.md) - Documentacion de routing (ST1.7)
---
## 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-DATA-003-batch-actualizacion-activos.md](./90-transversal/integraciones/INT-DATA-003-batch-actualizacion-activos.md)** | **Batch de Actualizacion de Activos con Priorizacion (XAU, EURUSD, BTC)** | **📋 Planificado** |
| **[INT-MT4-001-gateway-service.md](./90-transversal/integraciones/INT-MT4-001-gateway-service.md)** | **MT4 Gateway - Multi-agente trading** | **🔄 En Desarrollo** |
| [INT-SERVICES-INTEGRATION.md](./90-transversal/integraciones/INT-SERVICES-INTEGRATION.md) | Integracion MCP/ML/Backend services | ✅ Documentado |
## 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 |
| **[RF-DATA-001](./90-transversal/requerimientos/RF-DATA-001-sincronizacion-batch-activos.md)** | **Sincronizacion Batch de Activos (XAU, EURUSD, BTC)** | **Transversal** | **📋 Planificado** |
**Total: 51 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 |
| **[ET-DATA-001](./90-transversal/especificaciones/ET-DATA-001-arquitectura-batch-priorizacion.md)** | **Arquitectura Batch Priorizacion** | **Transversal** | **Data Service (Python)** |
**Total: 51 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)** |
| **Arquitectura EA Bridge MT4** | **MT4 Expert Advisor bridge** | **[Ver](./01-arquitectura/ARQUITECTURA-EA-BRIDGE-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) |
| **API Documentation** | **API overview + Swagger** | **[Ver](./API.md) + [swagger.yml](../apps/backend/swagger.yml)** |
| **Endpoint Routing** | **Route structure** | **[Ver](../apps/backend/ENDPOINT-ROUTING.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)** |
| **Security Guide** | **Security y compliance** | **[Ver](./90-transversal/security/SECURITY.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: 2026-01-26 (ST3.2 - Documentation Purge)*