# Herencia SIMCO - OrbiQuant IA (Trading Platform)

**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Fecha:** 2025-12-08

---

## Configuración del Proyecto

| Propiedad | Valor |
|-----------|-------|
| **Proyecto** | OrbiQuant IA - Trading Platform |
| **Nivel** | STANDALONE |
| **Padre** | core/orchestration |
| **SIMCO Version** | 2.2.0 |
| **CAPVED** | Habilitado |
| **CCA Protocol** | Habilitado |
| **Estado** | En Desarrollo (MVP + Fase 2) |

## Jerarquía de Herencia

```
Nivel 0: core/orchestration/                    ← FUENTE PRINCIPAL (76 docs)
    │
    └── STANDALONE: trading-platform/orchestration/ ← ESTE PROYECTO
```

---

## Directivas Heredadas de CORE (OBLIGATORIAS)

### 1. Ciclo de Vida - USAR SIEMPRE

| Alias | Archivo | Propósito |
|-------|---------|-----------|
| `@TAREA` | `directivas/simco/SIMCO-TAREA.md` | Punto de entrada para toda HU |
| `@CAPVED` | `directivas/principios/PRINCIPIO-CAPVED.md` | Ciclo de 6 fases |
| `@INICIALIZACION` | `directivas/simco/SIMCO-INICIALIZACION.md` | Bootstrap de agentes |

### 2. Operaciones Universales

| Alias | Propósito |
|-------|-----------|
| `@CREAR` | Crear archivos nuevos |
| `@MODIFICAR` | Modificar existentes |
| `@VALIDAR` | Validar código |
| `@DOCUMENTAR` | Documentar trabajo |
| `@BUSCAR` | Buscar información |
| `@DELEGAR` | Delegar a subagentes |

### 3. Catálogo de Funcionalidades

| Alias | Propósito |
|-------|-----------|
| `@CATALOG` | Funcionalidades reutilizables |
| `@CATALOG_INDEX` | Índice |
| `@REUTILIZAR` | Antes de implementar |
| `@CONTRIBUIR` | Después de crear |

**Funcionalidades del catálogo usadas:**

| Funcionalidad | Uso |
|---------------|-----|
| `auth` | JWT + OAuth |
| `payments` | Stripe integration |
| `websocket` | Real-time trading data |
| `notifications` | Alertas de trading |
| `rate-limiting` | API protection |

### 4. Principios Fundamentales

| Alias | Resumen |
|-------|---------|
| `@CAPVED` | Toda tarea pasa por 6 fases |
| `@DOC_PRIMERO` | Consultar docs/ antes de implementar |
| `@ANTI_DUP` | Verificar que no existe |
| `@VALIDACION` | Build y lint DEBEN pasar |
| `@TOKENS` | Desglosar tareas grandes |

---

## Directivas por Dominio Técnico

| Alias | Aplica | Notas |
|-------|--------|-------|
| `@OP_DDL` | **SÍ** | Schemas de trading |
| `@OP_BACKEND` | **SÍ** | Express.js APIs |
| `@OP_FRONTEND` | **SÍ** | React + TradingView |
| `@OP_MOBILE` | **SÍ** | App móvil |
| `@OP_ML` | **SÍ** | ML Engine (TradingAgent) |

---

## Patrones Heredados (OBLIGATORIOS)

| Patrón | Uso en Trading Platform |
|--------|------------------------|
| `MAPEO-TIPOS-DDL-TYPESCRIPT.md` | DB ↔ Entities |
| `PATRON-VALIDACION.md` | DTOs de órdenes, señales |
| `PATRON-EXCEPTION-HANDLING.md` | Errores de trading |
| `PATRON-TESTING.md` | Tests de estrategias |
| `PATRON-LOGGING.md` | Audit trail obligatorio |
| `PATRON-CONFIGURACION.md` | API keys, env vars |
| `PATRON-SEGURIDAD.md` | **CRÍTICO** - Datos financieros |
| `PATRON-PERFORMANCE.md` | **CRÍTICO** - Latencia mínima |
| `PATRON-TRANSACCIONES.md` | **CRÍTICO** - Atomicidad |
| `ANTIPATRONES.md` | Evitar siempre |
| `NOMENCLATURA-UNIFICADA.md` | Consistencia |

---

## Variables de Contexto CCA

```yaml
PROJECT_NAME: "trading-platform"
PROJECT_LEVEL: "STANDALONE"
PROJECT_ROOT: "/home/isem/workspace/projects/trading-platform"

# Rutas principales
DB_DDL_PATH: "database/ddl"
BACKEND_ROOT: "backend/src"
FRONTEND_ROOT: "frontend/src"
ML_ROOT: "ml-engine"

# Stack
BACKEND_FRAMEWORK: "Express.js"
ORM: "TypeORM/Prisma"
FRONTEND_FRAMEWORK: "React"
ML_FRAMEWORK: "FastAPI + XGBoost/PyTorch"

# ML Engine Legacy
ML_ENGINE_PATH: "[LEGACY: apps/ml-engine - migrado desde TradingAgent]"

# Inventarios
MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"
DATABASE_INVENTORY: "orchestration/inventarios/DATABASE_INVENTORY.yml"
BACKEND_INVENTORY: "orchestration/inventarios/BACKEND_INVENTORY.yml"
FRONTEND_INVENTORY: "orchestration/inventarios/FRONTEND_INVENTORY.yml"
ML_INVENTORY: "docs/90-transversal/inventarios/ML_INVENTORY.yml"
STRATEGIES_INVENTORY: "docs/90-transversal/inventarios/STRATEGIES_INVENTORY.yml"

# Security
FINANCIAL_DATA: true
AUDIT_REQUIRED: true
```

---

## Módulos del Sistema

| Módulo | Descripción | Estado |
|--------|-------------|--------|
| **Money Manager** | Agentes IA (Atlas, Orion, Nova) | En desarrollo |
| **TradingView Clone** | Charts + indicadores ML | En desarrollo |
| **Copiloto LLM** | Agente conversacional | Por iniciar |
| **Portfolio Manager** | Gestión de carteras | Por iniciar |
| **Sistema Educativo** | Cursos gamificados | Por iniciar |
| **SaaS/Billing** | Suscripciones, Stripe | Por iniciar |

---

## ML Engine (TradingAgent)

| Componente | Función | Métricas |
|------------|---------|----------|
| RangePredictor | Predicción de rangos | 85.9% accuracy |
| TPSLClassifier | Clasificación TP/SL | 0.94 AUC |
| AMDDetector | Fases de mercado | - |
| SignalGenerator | Señales JSON | - |

**Activos:** XAUUSD, EURUSD, GBPUSD, USDJPY (10+ años)

---

## Consideraciones Especiales

### Seguridad (CRÍTICA)
- Datos financieros sensibles
- Cumplimiento regulatorio
- Encriptación de datos en reposo y tránsito
- Audit trail completo

### Performance (CRÍTICA)
- Latencia mínima para trading
- WebSocket real-time
- Caching agresivo
- Optimización de queries

### Transacciones (CRÍTICA)
- Atomicidad en órdenes
- Manejo de rollbacks
- Consistencia de saldos
- Bloqueos optimistas

---

## Flujo de Trabajo

```yaml
# PASO 1: Cargar contexto (CCA)
CARGAR:
  - @TAREA
  - @CAPVED
  - @INICIALIZACION
  - ./CONTEXTO-PROYECTO.md

# PASO 2: Verificar catálogo
VERIFICAR:
  - @CATALOG_INDEX
  - @REUTILIZAR

# PASO 3: Seleccionar operación
OPERACION:
  - @OP_DDL         # Schemas trading
  - @OP_BACKEND     # Express APIs
  - @OP_FRONTEND    # React/Charts
  - @OP_ML          # ML Engine

# PASO 4: Patrones CRÍTICOS
PATRONES:
  - @PATRON-SEGURIDAD     # Datos financieros
  - @PATRON-PERFORMANCE   # Latencia
  - @PATRON-TRANSACCIONES # Atomicidad

# PASO 5: Validar
VALIDAR:
  - npm run build
  - npm run lint
  - npm run test

# PASO 6: Documentar
CIERRE:
  - @DOCUMENTAR
  - Actualizar inventarios
```

---

## Mapeo: Directivas Antiguas → SIMCO

| Directiva Antigua | Reemplazada Por | Alias |
|-------------------|-----------------|-------|
| `DIRECTIVA-FLUJO-5-FASES.md` | `SIMCO-TAREA.md` + `PRINCIPIO-CAPVED.md` | @TAREA, @CAPVED |
| `DIRECTIVA-VALIDACION-SUBAGENTES.md` | `SIMCO-VALIDAR.md` | @VALIDAR |
| `POLITICAS-USO-AGENTES.md` | `SIMCO-DELEGACION.md` | @DELEGAR |

---

**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Nivel:** STANDALONE
**Última actualización:** 2025-12-08
