workspace/projects/trading-platform/orchestration/00-guidelines/HERENCIA-SIMCO.md

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

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

# 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