# 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`