workspace-v1/projects/trading-platform/orchestration/00-guidelines/HERENCIA-SIMCO.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

7.5 KiB

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 Schemas de trading
@OP_BACKEND Express.js APIs
@OP_FRONTEND React + TradingView
@OP_MOBILE App móvil
@OP_ML 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-v1/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

Propagacion de Mejoras

Este proyecto participa en el sistema de propagacion de mejoras de NEXUS.

Modulos Base Usados

Modulo Version Estado
auth-jwt-nestjs 2.1.0 Al dia
payments-stripe-checkout 3.0.0 Al dia
payments-stripe-subscriptions 2.5.0 Al dia
notifications-in-app-websocket 2.0.0 Al dia
users-profiles 1.5.0 Al dia
users-preferences 1.0.0 Al dia
api-rate-limiting 1.0.0 Al dia

Ver estado completo: shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml

Recibir Propagaciones

  1. Se crea una tarea de propagacion
  2. Evaluar si la mejora aplica a este proyecto
  3. Implementar cambios siguiendo guia de migracion
  4. Actualizar esta tabla con nueva version
  5. Notificar completitud

Ver directiva completa: @PROPAGACION

Propagar Mejoras desde Este Proyecto

./devtools/scripts/propagation/propagate-module-update.sh <modulo> <version> trading-platform

Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol Nivel: STANDALONE Última actualización: 2026-01-04