rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
trading-platform/orchestration/00-guidelines/HERENCIA-SIMCO.md
Adrian Flores Cortes 8f0235c096 [TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION] docs: Complete 6-phase documentation analysis 
- FASE-0: Diagnostic audit of 500+ files, 33 findings cataloged (7P0/8P1/12P2/6P3)
- FASE-1: Resolved 7 P0 critical conflicts (ports, paths, dedup OQI-010/ADR-002, orphan schemas)
- FASE-2: Resolved 8 P1 issues (traces, README/CLAUDE.md, DEPENDENCY-GRAPH v2.0, DDL drift, stack versions, DoR/DoD)
- FASE-3: Resolved 12 P2 issues (archived tasks indexed, RNFs created, OQI-010 US/RF/ET, AGENTS v2.0)
- FASE-4: Purged 3 obsolete docs to _archive/, fixed MODELO-NEGOCIO.md broken ref
- FASE-5: Cross-layer validation (DDL→OQI 66%, OQI→BE 72%, BE→FE 78%, Inventories 95%)
- FASE-6: INFORME-FINAL, SA-INDEX (18 subagents), METADATA COMPLETED

27/33 findings resolved (82%), 6 P3 deferred to backlog.
18 new files created, 40+ modified, 4 archived.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 10:57:03 -06:00

360 lines
10 KiB
Markdown
Raw Permalink Blame History

# Herencia SIMCO - Trading Platform (Trading Platform)
**Sistema:** SIMCO v4.0.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
**Fecha:** 2026-02-06
---
## Configuración del Proyecto
| Propiedad | Valor |
|-----------|-------|
| **Proyecto** | Trading Platform - Trading Platform |
| **Nivel** | STANDALONE |
| **Padre** | core/orchestration |
| **SIMCO Version** | 4.0.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 |
---
## Directivas de Documentación (SIMCO v3.7)
Ubicación: `workspace/orchestration/directivas/simco/`
**Directivas de estandarización de documentación:**
| Alias | Directiva | Propósito | Aplica |
|-------|-----------|-----------|--------|
| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura base de documentación | **SÍ** |
| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de nomenclatura | **SÍ** |
| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna de documentos | **SÍ** |
| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Estándares de inventarios YAML | **SÍ** |
| `@TESTING` | `SIMCO-TESTING.md` | Cobertura y estándares de testing | **SÍ** |
| `@MIGRACIONES` | `SIMCO-MIGRACIONES-BD.md` | Migraciones y DDL | **SÍ** |
| `@INTEGRACIONES` | `SIMCO-INTEGRACIONES-EXTERNAS.md` | Documentación de integraciones | **SÍ** |
### Checklists Asociados
| Alias | Checklist | Items |
|-------|-----------|-------|
| `@CHK_DOCUMENTACION` | `CHECKLIST-DOCUMENTACION-PROYECTO.md` | 44 |
| `@CHK_INVENTARIOS` | `CHECKLIST-INVENTARIOS.md` | 63 |
| `@CHK_NOMENCLATURA` | `CHECKLIST-NOMENCLATURA.md` | 40 |
### Templates Disponibles
| Alias | Template | Uso |
|-------|----------|-----|
| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML |
| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones |
| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos |
---
## Directivas de Mantenimiento de Documentación (SIMCO v3.8)
Ubicación: `workspace/orchestration/directivas/simco/`
**Directivas de mantenimiento, purga y sincronización:**
| Alias | Directiva | Propósito | Aplica |
|-------|-----------|-----------|--------|
| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo de mantenimiento, purga y deprecación | **SÍ** |
| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD ↔ Código ↔ Docs | **SÍ** |
### Checklists de Mantenimiento
| Alias | Checklist | Items |
|-------|-----------|-------|
| `@CHK_MANTENIMIENTO` | `CHECKLIST-MANTENIMIENTO-DOCS.md` | 80 |
| `@CHK_SYNC_BD` | `CHECKLIST-SINCRONIZACION-BD.md` | 70 |
### Templates y Perfiles
| Alias | Archivo | Uso |
|-------|---------|-----|
| `@TPL_DEPRECACION` | `TEMPLATE-DEPRECACION.md` | Marcar documentos como deprecados |
| `@PERFIL_DOC_MAINT` | `PERFIL-DOCUMENTATION-MAINTAINER.md` | Perfil especializado en mantenimiento |
### Cuándo Usar
| Evento | Acción |
|--------|--------|
| Tarea completada (código) | `@MANTENIMIENTO_DOCS` nivel básico |
| Cambio en DDL | `@SYNC_BD` + `@CHK_SYNC_BD` |
| Fin de sprint/fase | `@CHK_MANTENIMIENTO` completo |
| Deprecar documentos | `@TPL_DEPRECACION` |
**CRÍTICO para Trading:** Los datos financieros requieren sincronización estricta. Usar `@SYNC_BD` + `@CHK_SYNC_BD` en cada cambio de schema.
---
## Variables de Contexto CCA
```yaml
PROJECT_NAME: "trading-platform"
PROJECT_LEVEL: "STANDALONE"
PROJECT_ROOT: "C:/Empresas/ISEM/workspace-v2/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: "pg Pool (raw SQL, NO ORM)"
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 |
---
## 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
```bash
./devtools/scripts/propagation/propagate-module-update.sh <modulo> <version> trading-platform
```
---
**Sistema:** SIMCO v4.0.0 + CAPVED + CCA Protocol
**Nivel:** STANDALONE
**Última actualización:** 2026-02-06
Reference in New Issue View Git Blame Copy Permalink