Adrian Flores Cortes c9ad315a07 [TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS] docs: Update CLAUDE.md to reflect MCP migration to apps/

- All 8 MCP submodules now under apps/ (canonical structure)
- Removed exception note (migration successful)
- Added branch note: MCPs use master, main apps use main

Part of: TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS Sprint 4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 10:43:34 -06:00

6.9 KiB

Raw Blame History

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: 2.0.0 Actualizado: 2026-02-06

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 (11): auth, trading, education, financial, investment, ml, llm, audit, portfolio, market_data, feature_flags
Tables: 101 DDL | Enums: 50 | Functions: 36 | Triggers: 46

Metricas de Coherencia (SSOT: orchestration/inventarios/)

Capa	Metrica	Valor
Database	Schemas	11
Database	Tablas DDL	101
Backend	Modulos	18
Backend	Type Interfaces	85/101 (84%)
Backend	Services	76/101 (75%)
Backend	Controllers	62/101 (61%)
Frontend	Modulos	14
Frontend	Componentes	225 (185 funcionales)
Frontend	Paginas	58

ESTRUCTURA DEL MONOREPO

trading-platform/
├── apps/                        ← Todos los componentes (submodulos)
│   ├── backend/                 → Express.js API (main)
│   ├── frontend/                → React SPA (main)
│   ├── database/                → DDL/Schemas (main)
│   ├── data-service/            → Python data aggregation (main)
│   ├── ml-engine/               → Python ML service (main)
│   ├── mcp-auth/                → Auth service, port 3095 (master)
│   ├── mcp-binance-connector/   → Binance connector (master)
│   ├── mcp-investment/          → Investment service, port 3093 (master)
│   ├── mcp-mt4-connector/       → MT4 connector (master)
│   ├── mcp-predictions/         → ML signals, port 3094 (master)
│   ├── mcp-products/            → Products service, port 3091 (master)
│   ├── mcp-vip/                 → VIP service, port 3092 (master)
│   └── mcp-wallet/              → Wallet service, port 3090 (master)
├── packages/                    → Shared packages
├── docker/                      → Docker configs
├── orchestration/               → Gobernanza SIMCO
└── docs/                        → Documentacion

NOTA: Los 8 MCP submodulos usan branch master (no main). Los 5 apps principales usan branch main. Migracion de branch pendiente cuando se actualicen los repos remotos.

MODULOS/EPICS (9)

ID	Módulo	Progreso	Descripción
OQI-001	fundamentos-auth	85%	Autenticacion base (token rotation, 2FA, OAuth)
OQI-002	educativo	55%	Modulo educativo (courses, quizzes, gamification, video)
OQI-003	trading-charts	60%	Charts de trading (panels, indicators, screener)
OQI-004	cuentas-inversion	55%	Cuentas de inversion (detail, wizard, risk analysis)
OQI-005	pagos-stripe	65%	Integracion Stripe (elements, refunds, invoices)
OQI-006	senales-ml	75%	Senales ML (models, signals, ensemble, ICT)
OQI-007	llm-strategy-agent	45%	Agente LLM (panels, prompts, connection, tokens)
OQI-008	portfolio-manager	45%	Gestion portafolio (dashboard, allocations, goals)
OQI-009	mt4-gateway	15%	Gateway MetaTrader (NO FUNCIONAL)

PUERTOS DE SERVICIOS

Servicio	Puerto
Backend API	3081
Frontend	3080
Backend WebSocket	3082
ML Engine	3083
Data Service	3084
LLM Agent	3085
Trading Agents	3086
MCP Wallet	3090
MCP Products	3091
MCP VIP	3092
MCP Investment	3093
MCP Predictions	3094
MCP Auth	3095

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 PyTorch + XGBoost para predicciones (NO TensorFlow)
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:

TypeScript Backend:

cd apps/backend && npm run build && npm run lint

Frontend:

cd apps/frontend && npm run build && npm run lint

Python Services:
```
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

Identificar si es TypeScript o Python
Verificar módulo/epic correspondiente
Consultar directivas en orchestration/directivas/
Verificar impacto en otros servicios

DESPUES DE IMPLEMENTAR

Actualizar inventarios locales
Ejecutar tests del servicio afectado
Commit y push siguiendo SIMCO-GIT
NO hay propagación (STANDALONE)

Trading Platform v1.0.0 - Sistema SIMCO v4.0.0

6.9 KiB Raw Blame History