betting-analytics/orchestration/00-guidelines/HERENCIA-SIMCO.md
rckrdmrd 1fdac787fd [SIMCO-V38] docs: Actualizar HERENCIA-SIMCO.md a v3.8.0
- Agregar seccion Directivas de Documentacion (v3.7)
- Agregar seccion Directivas de Mantenimiento (v3.8)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:32 -06:00

5.8 KiB

Herencia SIMCO - Betting Analytics

Sistema: SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs Fecha: 2026-01-10


Configuración del Proyecto

Propiedad Valor
Proyecto Betting Analytics
Nivel STANDALONE
Padre core/orchestration
SIMCO Version 3.8.0
CAPVED Habilitado
CCA Protocol Habilitado

Jerarquía de Herencia

Nivel 0: core/orchestration/                    ← FUENTE PRINCIPAL
    │
    └── STANDALONE: betting-analytics/orchestration/ ← ESTE PROYECTO

Directivas Heredadas de CORE (OBLIGATORIAS)

Ciclo de Vida

Alias Propósito
@TAREA Punto de entrada para toda HU
@CAPVED Ciclo de 6 fases
@INICIALIZACION Bootstrap de agentes

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

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 apuestas
@OP_BACKEND APIs de análisis
@OP_FRONTEND Dashboard de estadísticas
@OP_MOBILE Por definir -
@OP_ML Predicción de resultados

Patrones Heredados (OBLIGATORIOS)

Todos los patrones de core/orchestration/patrones/ aplican.


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
@NOMENCLATURA SIMCO-NOMENCLATURA.md Convenciones de nomenclatura
@ESTRUCTURA_DOCS SIMCO-ESTRUCTURA-DOCS.md Estructura interna de documentos
@INVENTARIOS SIMCO-INVENTARIOS.md Estándares de inventarios YAML
@TESTING SIMCO-TESTING.md Cobertura y estándares de testing
@MIGRACIONES SIMCO-MIGRACIONES-BD.md Migraciones y DDL
@INTEGRACIONES SIMCO-INTEGRACIONES-EXTERNAS.md Documentación de integraciones

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
@SYNC_BD SIMCO-SINCRONIZACION-BD.md Sincronización BD ↔ Código ↔ Docs

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

Variables de Contexto CCA

PROJECT_NAME: "betting-analytics"
PROJECT_LEVEL: "STANDALONE"
PROJECT_ROOT: "/home/isem/workspace-v1/projects/betting-analytics"

DB_DDL_PATH: "database/ddl"
BACKEND_ROOT: "backend/src"
FRONTEND_ROOT: "frontend/src"

MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"

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
api-rest-crud 2.0.0 Al dia
api-pagination 1.5.0 Al dia

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

Recibir Propagaciones

Ver directiva completa: @PROPAGACION


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