rckrdmrd/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
db4bf55c31
workspace/projects/trading-platform/docs/_MAP.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

288 lines
14 KiB
Markdown
Raw Blame History

# _MAP: OrbiQuant IA - Trading Platform
**Ultima actualizacion:** 2025-12-05
**Version:** 2.0.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** | 8 | Fase 1: 6, Fase 2: 2 |
| **Story Points** | 407 SP | 50 completados (12%) |
| **Presupuesto** | $213,500 MXN | $25,000 ejecutados |
| **Documentacion** | 95% | Estructura completa |
| **Implementacion** | 12% | OQI-001 completada |
---
## 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
│ ├── INTEGRACION-TRADINGAGENT.md ← ML Engine existente
│ └── DIAGRAMA-INTEGRACIONES.md ← NUEVO: 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 (120 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) |
---
## 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 |
| **[MATRIZ-DEPENDENCIAS.yml](./90-transversal/inventarios/MATRIZ-DEPENDENCIAS.yml)** | **Integraciones** | **Dependencias completas del sistema** |
---
## 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 |
---
## 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) |
| **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 | [Ver](./97-adr/ADR-001-seleccion-orm.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](file:///home/isem/workspace-old/UbuntuML/TradingAgent/) - ML Engine existente
- [Gamilit (Referencia)](file:///home/isem/workspace/projects/gamilit/docs/) - Estructura de referencia
- [Contexto del Proyecto](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)
---
*Indice maestro - Sistema NEXUS*
*Ultima actualizacion: 2025-12-05*
Reference in New Issue View Git Blame Copy Permalink