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

10 KiB

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

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

# 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

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

Ver directiva completa: @PROPAGACION

Propagar Mejoras desde Este Proyecto

./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

10 KiB Raw Permalink Blame History