rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
618e3220bd
trading-platform/docs/_MAP.md
Adrian Flores Cortes 4ce399adf5 docs: Update _MAP.md after ST3.2 reorganization 
Changes:
- Version: 2.1.0 → 2.2.0
- Date: 2026-01-07 → 2026-01-26
- Metrics: Documentation 98% → 100%, Implementation 25% → 30%
- Structure: Add swagger.yml, ENDPOINT-ROUTING.md references
- Remove: ARCHITECTURE.md (eliminated), planning/ (obsolete)
- Add: ARQUITECTURA-EA-BRIDGE-MT4.md, INT-SERVICES-INTEGRATION.md
- Move: SECURITY.md to 90-transversal/security/
- Update API.md reference (now overview)

Part of ST3.2 Documentation Purge.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 19:06:04 -06:00

332 lines
17 KiB
Markdown
Raw Blame History

---
id: "MAP-docs"
title: "Mapa de docs"
type: "Index"
project: "trading-platform"
updated_date: "2026-01-26"
---
# _MAP: Trading Platform - Trading Platform
**Ultima actualizacion:** 2026-01-26
**Version:** 2.2.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)
│
├── 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
│ ├── ARQUITECTURA-EA-BRIDGE-MT4.md ← MT4 Expert Advisor bridge (ST3.2)
│ ├── 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
│ ├── integraciones/ ← Integraciones externas
│ │ ├── INT-DATA-001-data-service.md
│ │ ├── INT-DATA-002-analisis-impacto.md
│ │ └── INT-SERVICES-INTEGRATION.md ← Integracion MCP/ML/Backend (ST3.2)
│ ├── security/ ← Seguridad y compliance (ST3.2)
│ │ └── SECURITY.md
│ ├── estrategias/ ← Estrategias de prediccion
│ │ └── ESTRATEGIA-PREDICCION-RANGOS.md
│ ├── sprints/ ← Tracking por sprint
│ ├── roadmap/ ← Roadmap del proyecto
│ │ └── PLAN-DESARROLLO-DETALLADO.md
│ ├── metricas/ ← KPIs y metricas
│ └── gaps/ ← Analisis de brechas
│
├── 95-guias-desarrollo/ # Guias tecnicas
│ ├── backend/
│ ├── frontend/
│ ├── database/
│ ├── ml-engine/
│ └── JENKINS-DEPLOY.md
│
├── 97-adr/ # Architecture Decision Records
│
├── 99-analisis/ # Analisis y reportes tecnicos
│ ├── _MAP.md ← Indice de analisis
│ ├── PLAN-*.md ← Planes de implementacion
│ ├── REPORTE-*.md ← Reportes de entrega
│ ├── ANALISIS-*.md ← Analisis tecnicos
│ └── VALIDACION-*.md ← Validaciones
│
└── 98-standards/ # Estandares del proyecto
```
**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)*
Reference in New Issue View Git Blame Copy Permalink