diff --git a/docs/99-analisis/PLAN-DESARROLLO-PENDIENTE.md b/docs/99-analisis/PLAN-DESARROLLO-PENDIENTE.md new file mode 100644 index 0000000..05b0cc2 --- /dev/null +++ b/docs/99-analisis/PLAN-DESARROLLO-PENDIENTE.md @@ -0,0 +1,231 @@ +--- +id: "PLAN-DESARROLLO-PENDIENTE" +title: "Plan de Desarrollo Pendiente - Trading Platform" +type: "Plan" +status: "In Progress" +priority: "Alta" +project: "trading-platform" +version: "1.0.0" +created_date: "2026-01-07" +updated_date: "2026-01-07" +author: "Claude-Orquestador" +--- + +# Plan de Desarrollo Pendiente - Trading Platform + +**Última actualización:** 2026-01-07 +**Estado:** En Progreso +**Para:** Agentes futuros que continúen el desarrollo + +--- + +## Resumen del Estado Actual + +### Completado (2026-01-07) + +1. **Base de Datos** + - ✅ 9 schemas creados (auth, education, financial, trading, investment, ml, llm, audit, market_data) + - ✅ 77 tablas, 104 FK + - ✅ market_data con 6 activos (XAUUSD, EURUSD, BTCUSD, GBPUSD, USDJPY, AUDUSD) + - ✅ 4M+ registros 5m, 1.3M+ registros 15m (10 años: 2015-2025) + +2. **ML Engine** + - ✅ 15 endpoints documentados en ET-ML-004-api.md + - ✅ 14 modelos en ML_INVENTORY.yml (ML-005 a ML-018) + - ✅ Backend clients actualizados (ml-engine.client.ts, ml-integration.service.ts) + - ✅ Trazabilidad completa en TRACEABILITY.yml + +3. **Documentación** + - ✅ NEXUS v3.4 frontmatter aplicado + - ✅ _MAP.md actualizado con todos los schemas + - ✅ VALIDACION-ALINEACION-ML-2026-01-07.md (8 fases completadas) + +--- + +## Tareas Pendientes por Módulo + +### 1. Base de Datos (OQI-009) + +| Tarea | Prioridad | Descripción | +|-------|-----------|-------------| +| Instalar pgvector | Alta | Requerido para llm.embeddings | +| Crear indices adicionales | Media | Optimizar queries frecuentes | +| Configurar particionamiento | Media | Para predictions y audit_logs | +| Implementar RLS | Media | Row Level Security | + +**Comando para continuar:** +```bash +cd apps/database +./scripts/drop-and-recreate-database.sh +./scripts/migrate_6_assets.sh +``` + +### 2. Backend (OQI-002) + +| Tarea | Prioridad | Estado | +|-------|-----------|--------| +| Unificar ML clients | Media | Pendiente - Dos clientes incompatibles | +| WebSocket signals | Alta | Implementar canal de signals en tiempo real | +| Auth middleware | Alta | Completar integración con auth schema | +| API tests | Media | Aumentar cobertura | + +**Archivos relevantes:** +- `apps/backend/src/shared/clients/ml-engine.client.ts` +- `apps/backend/src/modules/ml/services/ml-integration.service.ts` + +### 3. ML Engine (OQI-006) + +| Tarea | Prioridad | Estado | +|-------|-----------|--------| +| Entrenar modelos BTCUSD | Completado | Actualizado 2026-01-07 | +| Agregar más activos | Baja | Solo 6 de 17+ disponibles | +| Optimizar backtesting | Media | Mejorar performance | +| Implementar monitoring | Alta | Métricas de producción | + +**Modelos implementados:** +- ML-005: AttentionScoreModel +- ML-006: SymbolTimeframeModel +- ML-007: AssetMetamodel +- ML-008 a ML-018: Modelos extendidos + +### 4. Frontend (OQI-003) + +| Tarea | Prioridad | Descripción | +|-------|-----------|-------------| +| Dashboard ML | Alta | Mostrar signals y predicciones | +| Charts con overlays | Alta | Integrar ML overlays | +| Configuración de alertas | Media | UI para notificaciones | + +### 5. LLM Agent (OQI-007) + +| Tarea | Prioridad | Descripción | +|-------|-----------|-------------| +| Instalar pgvector | Alta | Prerrequisito | +| Configurar embeddings | Alta | RAG implementation | +| Integrar con ML Engine | Media | Tool: get_signal | + +--- + +## Orden de Ejecución Recomendado + +``` +1. [ALTA] Instalar pgvector para LLM + └── sudo apt install postgresql-16-pgvector + +2. [ALTA] Ejecutar recreación limpia de BD + └── ./scripts/drop-and-recreate-database.sh + └── ./scripts/migrate_6_assets.sh + +3. [ALTA] Verificar backend compila y tests pasan + └── cd apps/backend && npm run build && npm test + +4. [ALTA] Verificar ML Engine funciona + └── cd apps/ml-engine && python -m pytest + +5. [MEDIA] Unificar ML clients en backend + └── Merge ml-engine.client.ts y ml-integration.service.ts + +6. [MEDIA] Implementar WebSocket signals + └── apps/backend/src/modules/trading/trading-stream.service.ts +``` + +--- + +## Archivos Clave para Desarrollo + +### Base de Datos +- `apps/database/scripts/create-database.sh` - Script principal +- `apps/database/schemas/_MAP.md` - Índice de schemas +- `apps/database/ddl/schemas/market_data/` - DDL datos de mercado + +### Backend +- `apps/backend/src/shared/clients/ml-engine.client.ts` - Cliente ML +- `apps/backend/src/modules/ml/` - Módulo ML + +### ML Engine +- `apps/ml-engine/src/api/main.py` - FastAPI endpoints +- `apps/ml-engine/config/database.yaml` - Configuración BD + +### Documentación +- `docs/99-analisis/VALIDACION-ALINEACION-ML-2026-01-07.md` - Validación ML +- `docs/02-definicion-modulos/OQI-006-ml-signals/` - Especificaciones ML + +--- + +## Configuración de Ambiente + +### Variables de Entorno Requeridas + +```bash +# PostgreSQL +DB_HOST=localhost +DB_PORT=5432 +DB_NAME=trading_platform +DB_USER=trading_user +DB_PASSWORD=trading_dev_2025 + +# ML Engine +ML_ENGINE_URL=http://localhost:3083 +ML_ENGINE_API_KEY= + +# MySQL (solo lectura - datos históricos) +MYSQL_HOST=72.60.226.4 +MYSQL_USER=root +MYSQL_PASSWORD=AfcItz2391,. +MYSQL_DB=db_trading_meta +``` + +### Puertos + +| Servicio | Puerto | Descripción | +|----------|--------|-------------| +| PostgreSQL | 5432 | Base de datos principal | +| Backend | 3081 | API NestJS | +| ML Engine | 3083 | FastAPI ML | +| Frontend | 3080 | React/Vite | + +--- + +## Commits Recientes Relevantes + +| Subproyecto | Commit | Descripción | +|-------------|--------|-------------| +| database | `35fb51a` | Add market_data schema + 6 assets | +| backend | `14da1f1` | Update ML clients with correct API routes | +| ml-engine | `7d61d54` | Add tests for DirectionalFilters | +| main | `3f64a12` | Update validation report Phase 8 | + +--- + +## Notas para Agente Continuador + +1. **Antes de comenzar**: Verificar estado de BD con: + ```bash + PGPASSWORD=trading_dev_2025 psql -h localhost -U trading_user -d trading_platform \ + -c "SELECT schemaname, COUNT(*) FROM pg_tables WHERE schemaname NOT IN ('pg_catalog', 'information_schema') GROUP BY schemaname;" + ``` + +2. **Si BD está vacía**: Ejecutar recreación completa: + ```bash + cd apps/database + ./scripts/drop-and-recreate-database.sh + ./scripts/migrate_6_assets.sh + ``` + +3. **Si hay errores de locale**: El script tiene fallback automático para WSL2 + +4. **Si pgvector falta**: Solo afecta llm.embeddings, resto funciona + +5. **Documentación**: Siempre actualizar _MAP.md al modificar schemas + +--- + +## Changelog + +| Fecha | Versión | Cambios | +|-------|---------|---------| +| 2026-01-07 | 1.0.0 | Creación inicial con estado actual | + +--- + +*Creado: 2026-01-07 | Agente: Claude-Orquestador* diff --git a/docs/99-analisis/_MAP.md b/docs/99-analisis/_MAP.md index 2bf0083..0a9d0e3 100644 --- a/docs/99-analisis/_MAP.md +++ b/docs/99-analisis/_MAP.md @@ -23,6 +23,7 @@ Esta carpeta contiene documentos de análisis técnico, planes de implementació | Documento | Descripción | Estado | |-----------|-------------|--------| +| [PLAN-DESARROLLO-PENDIENTE.md](./PLAN-DESARROLLO-PENDIENTE.md) | **ACTIVO** - Plan de desarrollo para agentes continuadores | 🔄 En Progreso | | [PLAN-IMPLEMENTACION-FASES.md](./PLAN-IMPLEMENTACION-FASES.md) | Plan completo de implementación ML Integration (Fases 1-11) | ✅ Completo | | [PLAN-IMPLEMENTACION-CORRECCIONES.md](./PLAN-IMPLEMENTACION-CORRECCIONES.md) | Plan de correcciones arquitectónicas | ✅ Completo | | [PLAN-INTEGRACION-COMPLETA.md](./PLAN-INTEGRACION-COMPLETA.md) | Plan de integración completa del sistema | ✅ Completo | @@ -67,7 +68,7 @@ Esta carpeta contiene documentos de análisis técnico, planes de implementació | [REPORTE-EJECUCION-ALINEACION-2026-01-07.md](./REPORTE-EJECUCION-ALINEACION-2026-01-07.md) | **NUEVO** - Reporte ejecucion + validacion BD (73 tablas) | ✅ Completo | | [VALIDACION-PLAN-VS-ANALISIS.md](./VALIDACION-PLAN-VS-ANALISIS.md) | Validación del plan vs análisis | ✅ Completo | | [RESUMEN-CAMBIOS-FASE6.md](./RESUMEN-CAMBIOS-FASE6.md) | Resumen de cambios Fase 6 | ✅ Completo | -| [VALIDACION-ALINEACION-ML-2026-01-07.md](./VALIDACION-ALINEACION-ML-2026-01-07.md) | **NUEVO** - Validación ML Engine vs Documentación (7 fases) | ✅ Completo | +| [VALIDACION-ALINEACION-ML-2026-01-07.md](./VALIDACION-ALINEACION-ML-2026-01-07.md) | Validación ML Engine vs Documentación (8 fases) | ✅ Completo | --- @@ -92,6 +93,8 @@ Esta carpeta contiene documentos de análisis técnico, planes de implementació | Fecha | Cambio | |-------|--------| +| 2026-01-07 | Agregado PLAN-DESARROLLO-PENDIENTE.md - Plan para agentes continuadores | +| 2026-01-07 | Actualizado VALIDACION-ALINEACION-ML: 8 fases, market_data schema, 77 tablas | | 2026-01-07 | Agregado VALIDACION-ALINEACION-ML-2026-01-07.md - Validación ML Engine en 7 fases (91% discrepancias resueltas) | | 2026-01-07 | Agregado REPORTE-EJECUCION-ALINEACION - Reporte con validacion BD (73 tablas, 102 FK) | | 2026-01-07 | Actualizado ANALISIS-ALINEACION: consolidacion de inventarios completada (3 duplicados eliminados) |