diff --git a/.gemini/antigravity/README.md b/.gemini/antigravity/README.md new file mode 100644 index 0000000..480ecce --- /dev/null +++ b/.gemini/antigravity/README.md @@ -0,0 +1,130 @@ +# Gemini Agent Configuration - Trading Platform + +**Proyecto:** trading-platform +**Tipo:** STANDALONE +**Sistema:** SIMCO v4.0.0 + NEXUS v4.0 + +--- + +## Herencia + +Este proyecto hereda configuraciones de: +- `workspace-v2/.gemini/antigravity/` +- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml` +- `workspace-v2/orchestration/agents/configs/SHARED-PROJECT-REGISTRY.yml` + +--- + +## Identificación del Proyecto + +```yaml +aliases: ["trading-platform", "trading", "oqi"] +root: "projects/trading-platform/" +type: "STANDALONE" +nivel_nexus: "L2" +arquitectura: "hybrid" +``` + +--- + +## Stack Tecnológico + +### TypeScript Stack +| Componente | Tecnología | +|------------|------------| +| Backend | Express.js 5.0.1 | +| Frontend | React 18.2.0 | +| Build | Vite 6.2.0 | + +### Python Stack +| Componente | Tecnología | +|------------|------------| +| ML Engine | FastAPI | +| Data Service | Python 3.11 | +| ML Libraries | TensorFlow, scikit-learn | + +--- + +## Credenciales BD + +```yaml +db_name: trading_platform +db_user: trading_user +db_pass: trading_dev_2026 +db_port: 5432 +schemas: + - core + - trading + - ml + - portfolio +``` + +--- + +## Boot Sequence + +Al trabajar en este proyecto: + +1. Cargar `workspace-v2/CLAUDE.md` +2. Cargar `projects/trading-platform/CLAUDE.md` +3. Cargar `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml` +4. Identificar stack (TypeScript vs Python) +5. Cargar contexto específico según tarea + +--- + +## Servicios y Puertos + +| Servicio | Puerto | Stack | +|----------|--------|-------| +| Backend API | 3080 | TypeScript | +| Frontend | 3000 | TypeScript | +| ML Engine | 3083 | Python | +| Trading Agents | 3086 | Python | +| LLM Agent | 3085 | Python | +| MCP Auth | 3095 | TypeScript | +| MCP Wallet | 3090 | TypeScript | + +--- + +## Epics en Desarrollo (9) + +| ID | Nombre | Progreso | +|----|--------|----------| +| OQI-001 | fundamentos-auth | 70% | +| OQI-002 | educativo | 30% | +| OQI-003 | trading-charts | 40% | +| OQI-004 | cuentas-inversion | 35% | +| OQI-005 | pagos-stripe | 50% | +| OQI-006 | senales-ml | 60% | +| OQI-007 | llm-strategy-agent | 25% | +| OQI-008 | portfolio-manager | 20% | +| OQI-009 | mt4-gateway | 15% | + +--- + +## Paths de Trabajo + +``` +Backend: projects/trading-platform/apps/backend/src/ +Frontend: projects/trading-platform/apps/frontend/src/ +ML Engine: projects/trading-platform/apps/ml-engine/ +Database: projects/trading-platform/apps/database/ +MCPs: projects/trading-platform/mcp-*/ +Docs: projects/trading-platform/docs/ +``` + +--- + +## Propagación + +Como STANDALONE, NO propaga a otros proyectos. +Completamente independiente. + +--- + +## Referencias + +- CLAUDE.md: `projects/trading-platform/CLAUDE.md` +- Directivas: `projects/trading-platform/orchestration/directivas/` +- Inventarios: `projects/trading-platform/orchestration/inventarios/` diff --git a/.trae/AGENT-CAPABILITIES.md b/.trae/AGENT-CAPABILITIES.md new file mode 100644 index 0000000..c3f3a81 --- /dev/null +++ b/.trae/AGENT-CAPABILITIES.md @@ -0,0 +1,75 @@ +# Agent Capabilities - Trae IDE (Trading Platform) + +**Proyecto:** trading-platform +**Versión:** 1.0.0 +**Sistema:** SIMCO v4.0.0 + +--- + +## Herencia + +Este archivo extiende: +- `workspace-v2/.trae/rules.md` +- `workspace-v2/orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml` + +--- + +## Capacidades en este Proyecto + +### Operaciones Permitidas + +| Operación | Status | Notas | +|-----------|--------|-------| +| Crear módulos backend (TS) | ✅ | Express.js en apps/backend/ | +| Crear componentes frontend | ✅ | React en apps/frontend/ | +| Modificar ML engine (Python) | ✅ | FastAPI en apps/ml-engine/ | +| Crear MCPs | ✅ | Servicios MCP en raíz | +| Modificar DDL | ✅ | Con validación de coherencia | +| Escribir tests | ✅ | Jest (TS) + Pytest (Python) | +| Git operations | ✅ | Commit, push, pull | + +### Limitaciones Específicas + +1. **NO ejecutar** trades reales en desarrollo +2. **NO usar** API keys de producción +3. **NO mezclar** código TypeScript y Python en mismo servicio + +--- + +## Validaciones Requeridas + +Antes de marcar tarea como completada: + +```bash +# Backend TypeScript +cd apps/backend +npm run build +npm run lint +npm run test + +# Frontend +cd apps/frontend +npm run build +npm run lint + +# ML Engine (Python) +cd apps/ml-engine +python -m pytest +``` + +--- + +## Contexto del Proyecto + +- **12 apps/módulos** en monorepo +- **9 epics** en desarrollo +- **Arquitectura híbrida** TypeScript + Python +- **Tipo** STANDALONE (independiente) + +--- + +## Quick Reference + +- CLAUDE.md: `projects/trading-platform/CLAUDE.md` +- Rules: `projects/trading-platform/.trae/rules/project_rules.md` +- Docs: `projects/trading-platform/docs/` diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md new file mode 100644 index 0000000..545f6ef --- /dev/null +++ b/.trae/rules/project_rules.md @@ -0,0 +1,102 @@ +# Project Rules - Trading Platform (Trae IDE) + +**Proyecto:** trading-platform +**Tipo:** STANDALONE +**Sistema:** SIMCO v4.0.0 + +--- + +## Reglas Heredadas + +Este proyecto hereda TODAS las reglas de: +- `workspace-v2/CLAUDE.md` +- `workspace-v2/.trae/rules.md` + +Las reglas aquí son EXTENSIONES específicas del proyecto. + +--- + +## Arquitectura Híbrida + +- **TypeScript:** Express.js backend, React frontend, MCPs +- **Python:** FastAPI (ml-engine, data-service) +- **Monorepo:** Múltiples apps en `/apps/` y servicios MCP en raíz + +--- + +## Stack + +- **Backend API:** Express.js 5.0.1 +- **Frontend:** React 18.2.0 + Vite 6.2.0 +- **ML Engine:** FastAPI + Python 3.11 +- **Database:** PostgreSQL 16+ +- **Cache:** Redis 7.x + +--- + +## Credenciales BD + +``` +DB_HOST=localhost +DB_PORT=5432 +DB_NAME=trading_platform +DB_USER=trading_user +DB_PASS=trading_dev_2026 +``` + +--- + +## Reglas Específicas + +### 1. Separación TypeScript/Python + +- NO mezclar código entre stacks +- Comunicación via REST/gRPC únicamente +- Cada servicio tiene su propio package.json o requirements.txt + +### 2. Trading Safety + +- NUNCA ejecutar trades reales sin confirmación explícita +- Usar modo sandbox en desarrollo +- Validar límites de riesgo en código + +### 3. ML Models + +- Modelos en `apps/ml-engine/` +- Backtesting obligatorio antes de deploy +- Documentar métricas de performance + +### 4. Tests + +Cobertura mínima: 60% +- TypeScript: `npm run test` +- Python: `pytest` + +--- + +## Paths de Trabajo + +``` +Backend: projects/trading-platform/apps/backend/src/ +Frontend: projects/trading-platform/apps/frontend/src/ +ML Engine: projects/trading-platform/apps/ml-engine/ +Database: projects/trading-platform/apps/database/ +MCPs: projects/trading-platform/mcp-*/ +``` + +--- + +## Propagación + +Como STANDALONE, trading-platform: +- **NO propaga** a otros proyectos +- **NO recibe** de otros proyectos +- Es completamente independiente + +--- + +## Referencias + +- CLAUDE.md local: `projects/trading-platform/CLAUDE.md` +- Directivas: `projects/trading-platform/orchestration/directivas/` +- Inventarios: `projects/trading-platform/orchestration/inventarios/` diff --git a/.windsurf/AGENT-CAPABILITIES.md b/.windsurf/AGENT-CAPABILITIES.md new file mode 100644 index 0000000..036881f --- /dev/null +++ b/.windsurf/AGENT-CAPABILITIES.md @@ -0,0 +1,75 @@ +# Agent Capabilities - Windsurf IDE (Trading Platform) + +**Proyecto:** trading-platform +**Versión:** 1.0.0 +**Modelo:** Cascade AI (NO-RAZONADOR) + +--- + +## Paradigma NO-RAZONADOR + +Windsurf NO toma decisiones autónomas. +Ejecuta instrucciones LITERALES únicamente. + +--- + +## Capacidades + +| Capacidad | Status | +|-----------|--------| +| Edición de archivos | ✅ | +| Creación de archivos | ✅ | +| Ejecución de comandos | ✅ | +| Git operations | ✅ | +| Decisiones autónomas | ❌ | +| Resolución de ambigüedad | ❌ | + +--- + +## Limitaciones Críticas + +1. **NO puede** interpretar instrucciones vagas +2. **NO puede** elegir entre alternativas +3. **NO puede** modificar plan sin aprobación +4. **Max 50 líneas** por operación +5. **NO puede** ejecutar trades reales +6. **NO puede** mezclar TypeScript/Python + +--- + +## Formato de Tarea Atómica + +```yaml +tarea: + id: "TASK-XXX-T01" + archivo: "path/to/file.ts" + stack: "typescript" # o "python" + operacion: "EDITAR" + lineas_desde: 45 + lineas_hasta: 52 + codigo_actual: | + // código exacto actual + codigo_nuevo: | + // código exacto nuevo + validacion: + - "npm run build" # o "pytest" para Python + - "npm run lint" +``` + +--- + +## Protocolo de Bloqueo + +Si hay ambigüedad: +1. DETENER inmediatamente +2. NO intentar resolver +3. Reportar en BLOCKED-TASKS.yml +4. Esperar resolución de agente superior + +--- + +## Referencias + +- Shared configs: `orchestration/agents/configs/` +- Platform config: `orchestration/agents/configs/SHARED-PLATFORM-CONFIG.yml` +- Project rules: `.windsurf/rules/project_rules.md` diff --git a/.windsurf/rules/project_rules.md b/.windsurf/rules/project_rules.md new file mode 100644 index 0000000..333d617 --- /dev/null +++ b/.windsurf/rules/project_rules.md @@ -0,0 +1,115 @@ +# Project Rules - Trading Platform (Windsurf IDE) + +**Proyecto:** trading-platform +**Tipo:** STANDALONE +**Sistema:** SIMCO v4.0.0 + +--- + +## IMPORTANTE: Windsurf es NO-RAZONADOR + +Windsurf con Cascade NO razona autónomamente. +Sigue instrucciones LITERALMENTE. + +Si hay ambigüedad: +1. DETENER +2. Reportar en orchestration/trazas/BLOCKED-TASKS.yml +3. Esperar resolución + +--- + +## Reglas Heredadas + +Hereda TODAS las reglas de: +- `workspace-v2/CLAUDE.md` +- `workspace-v2/.windsurf/rules.md` + +--- + +## Arquitectura Híbrida + +```yaml +typescript: + backend: Express.js 5.0.1 + frontend: React 18.2.0 + Vite 6.2.0 + mcps: Servicios independientes + +python: + ml_engine: FastAPI + Python 3.11 + data_service: Processing +``` + +--- + +## Credenciales BD + +``` +DB_HOST=localhost +DB_PORT=5432 +DB_NAME=trading_platform +DB_USER=trading_user +DB_PASS=trading_dev_2026 +``` + +--- + +## Paths Absolutos + +``` +Backend: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\backend\src\ +Frontend: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\frontend\src\ +ML Engine: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\ml-engine\ +Database: C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\database\ +``` + +--- + +## Reglas de Edición + +1. **Max 50 líneas** por cambio +2. **NO usar placeholders** (// ... resto del código) +3. **Código LITERAL** siempre +4. **Verificar** archivo existe antes de editar +5. **NO mezclar** TypeScript y Python en mismo archivo + +--- + +## Validaciones Post-Cambio + +```cmd +# Para TypeScript +cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\backend +npm run build +npm run lint + +# Para Frontend +cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\frontend +npm run build +npm run lint + +# Para Python +cd C:\Empresas\ISEM\workspace-v2\projects\trading-platform\apps\ml-engine +python -m pytest +``` + +--- + +## Epics/Módulos (9) + +``` +fundamentos-auth, educativo, trading-charts, +cuentas-inversion, pagos-stripe, senales-ml, +llm-strategy-agent, portfolio-manager, mt4-gateway +``` + +--- + +## Bloqueos + +Si encuentras: +- Ambigüedad en instrucciones → BLOQUEAR +- Archivo no existe → BLOQUEAR +- Mezcla TypeScript/Python → BLOQUEAR +- Trade real en desarrollo → BLOQUEAR + +Reportar en: `orchestration/trazas/BLOCKED-TASKS.yml` diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..4555107 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,203 @@ +# CLAUDE.md - Trading Platform + +**Hereda de:** workspace-v2/CLAUDE.md +**Sistema:** SIMCO v4.0.0 + NEXUS v4.0 +**Proyecto:** trading-platform +**Tipo:** STANDALONE +**Versión:** 1.0.0 +**Actualizado:** 2026-01-24 + +--- + +## EXTENSIONES LOCALES + +Este archivo EXTIENDE (no reemplaza) las reglas del workspace. +Para reglas base, ver: `../../CLAUDE.md` + +--- + +## ARQUITECTURA HIBRIDA + +Este proyecto usa una arquitectura híbrida TypeScript + Python: + +``` +┌─────────────────────────────────────────────────────────┐ +│ TRADING PLATFORM │ +├──────────────────────┬──────────────────────────────────┤ +│ TypeScript Stack │ Python Stack │ +├──────────────────────┼──────────────────────────────────┤ +│ • Express.js Backend │ • FastAPI (ml-engine) │ +│ • React Frontend │ • Data Service │ +│ • MCP Connectors │ • Trading Agents │ +│ • Portfolio Manager │ • Prediction Models │ +└──────────────────────┴──────────────────────────────────┘ +``` + +--- + +## STACK TECNOLOGICO + +| Capa | Tecnología | Versión | +|------|------------|---------| +| Backend API | Express.js | 5.0.1 | +| Frontend | React | 18.2.0 | +| Build Tool | Vite | 6.2.0 | +| ML Engine | FastAPI (Python) | 3.11 | +| Database | PostgreSQL | 16+ | +| Cache | Redis | 7.x | +| Charts | lightweight-charts | 4.1.1 | +| State | Zustand | 4.4.7 | +| Data Fetching | TanStack Query | 5.14.0 | + +--- + +## CREDENCIALES BD + +``` +Database: trading_platform +User: trading_user +Password: trading_dev_2026 +Port: 5432 +Host: localhost +Schemas: core, trading, ml, portfolio +``` + +--- + +## ESTRUCTURA DEL MONOREPO + +``` +trading-platform/ +├── apps/ +│ ├── backend/ → Express.js API +│ ├── frontend/ → React SPA +│ ├── database/ → DDL/Schemas +│ ├── data-service/ → Python data aggregation +│ ├── ml-engine/ → Python ML service +│ ├── mcp-binance-connector/ +│ └── mcp-mt4-connector/ +├── mcp-auth/ → Auth service (port 3095) +├── mcp-wallet/ → Wallet service (port 3090) +├── mcp-products/ → Products service (port 3091) +├── mcp-vip/ → VIP service (port 3092) +├── mcp-investment/ → Investment service (port 3093) +├── mcp-predictions/ → ML signals (port 3094) +├── packages/ → Shared packages +└── docker/ → Docker configs +``` + +--- + +## MODULOS/EPICS (9) + +| ID | Módulo | Progreso | Descripción | +|----|--------|----------|-------------| +| OQI-001 | fundamentos-auth | 70% | Autenticación base | +| OQI-002 | educativo | 30% | Módulo educativo | +| OQI-003 | trading-charts | 40% | Charts de trading | +| OQI-004 | cuentas-inversion | 35% | Cuentas de inversión | +| OQI-005 | pagos-stripe | 50% | Integración Stripe | +| OQI-006 | senales-ml | 60% | Señales ML | +| OQI-007 | llm-strategy-agent | 25% | Agente LLM | +| OQI-008 | portfolio-manager | 20% | Gestión portafolio | +| OQI-009 | mt4-gateway | 15% | Gateway MetaTrader | + +--- + +## PUERTOS DE SERVICIOS + +| Servicio | Puerto | +|----------|--------| +| Backend API | 3080 | +| Frontend | 3000 | +| ML Engine | 3083 | +| Trading Agents | 3086 | +| LLM Agent | 3085 | +| MCP Auth | 3095 | +| MCP Wallet | 3090 | +| MCP Products | 3091 | +| MCP VIP | 3092 | +| MCP Investment | 3093 | +| MCP Predictions | 3094 | + +--- + +## REGLAS ESPECIFICAS + +### 1. Código TypeScript vs Python + +- **TypeScript:** APIs, Frontend, MCPs +- **Python:** ML, Data processing, Trading agents +- NO mezclar: cada servicio es independiente + +### 2. ML Models + +- Los modelos ML están en `apps/ml-engine/` +- Usar TensorFlow para predicciones +- Validar con backtesting antes de deploy + +### 3. Trading Safety + +- NUNCA ejecutar trades reales sin confirmación +- Usar modo sandbox en desarrollo +- Validar límites de riesgo + +### 4. API Keys + +- Binance API: Solo read en desarrollo +- MT4: Cuenta demo únicamente +- Stripe: Test mode + +--- + +## VALIDACIONES ADICIONALES + +Además de las validaciones del workspace: + +1. **TypeScript Backend:** + ```bash + cd apps/backend && npm run build && npm run lint + ``` + +2. **Frontend:** + ```bash + cd apps/frontend && npm run build && npm run lint + ``` + +3. **Python Services:** + ```bash + cd apps/ml-engine && python -m pytest + ``` + +--- + +## ALIASES LOCALES + +- `@BACKEND` → apps/backend/src/ +- `@FRONTEND` → apps/frontend/src/ +- `@ML` → apps/ml-engine/ +- `@DDL` → apps/database/ +- `@DOCS` → docs/ +- `@MCP` → mcp-*/ + +--- + +## ANTES DE IMPLEMENTAR + +1. Identificar si es TypeScript o Python +2. Verificar módulo/epic correspondiente +3. Consultar directivas en `orchestration/directivas/` +4. Verificar impacto en otros servicios + +--- + +## DESPUES DE IMPLEMENTAR + +1. Actualizar inventarios locales +2. Ejecutar tests del servicio afectado +3. Commit y push siguiendo SIMCO-GIT +4. NO hay propagación (STANDALONE) + +--- + +*Trading Platform v1.0.0 - Sistema SIMCO v4.0.0*