rckrdmrd
1fdac787fd
- Agregar seccion Directivas de Documentacion (v3.7) - Agregar seccion Directivas de Mantenimiento (v3.8) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
196 lines
5.8 KiB
Markdown
196 lines
5.8 KiB
Markdown
# 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` | **SÍ** | Schemas de apuestas |
|
|
| `@OP_BACKEND` | **SÍ** | APIs de análisis |
|
|
| `@OP_FRONTEND` | **SÍ** | Dashboard de estadísticas |
|
|
| `@OP_MOBILE` | Por definir | - |
|
|
| `@OP_ML` | **SÍ** | 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 | **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` |
|
|
|
|
---
|
|
|
|
## Variables de Contexto CCA
|
|
|
|
```yaml
|
|
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
|