[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure

- Move 2 non-standard folders to _archive/
- Create 5 missing obligatory files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 14:38:27 -06:00
parent 9d14969ce4
commit fc3ceaf7c8
11 changed files with 642 additions and 47 deletions

1
backend Submodule

@ -0,0 +1 @@
Subproject commit d1e641c4dc9a5a0f41e532b42d90b2a560744225

1
database Submodule

@ -0,0 +1 @@
Subproject commit eb23e9eccbd064d80c17ca45dbad7a2442ea448f

1
frontend Submodule

@ -0,0 +1 @@
Subproject commit 5134569165dcb1aa91377e70e23a97ded8a44cb5

View File

@ -0,0 +1,113 @@
# ===============================================================================
# DEPENDENCY-GRAPH.yml - Betting Analytics
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estandar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Nivel: CONSUMER (L2)
# Fecha: 2026-01-24
#
# ===============================================================================
metadata:
proyecto: "betting-analytics"
codigo: "BET"
version: "0.0.1"
ultima_actualizacion: "2026-01-24"
estado: "idea"
# -----------------------------------------------------------------------------
# DEPENDENCIAS DEL PROYECTO
# -----------------------------------------------------------------------------
# Por ser proyecto STANDALONE en fase IDEA, no tiene dependencias activas.
dependencias:
# Proyectos del workspace de los que depende
proyectos: []
# Hereda directivas del workspace root
workspace:
- tipo: "directivas"
origen: "workspace-v2/orchestration/directivas/"
estado: "activa"
# -----------------------------------------------------------------------------
# CONSUMIDORES
# -----------------------------------------------------------------------------
# Proyectos que dependen de este (CONSUMER no exporta).
consumidores: []
# -----------------------------------------------------------------------------
# DEPENDENCIAS TECNICAS (Planeadas)
# -----------------------------------------------------------------------------
# Stack tecnologico cuando se inicie desarrollo.
dependencias_tecnicas:
estado: "no_definido"
planeadas:
backend:
- nombre: "NestJS o Express"
version: "TBD"
proposito: "API REST"
frontend:
- nombre: "React"
version: "TBD"
proposito: "UI de dashboards"
database:
- nombre: "PostgreSQL"
version: "15+"
proposito: "Datos transaccionales"
analytics:
- nombre: "Python + FastAPI"
version: "TBD"
proposito: "ML y predicciones"
apis_externas:
- nombre: "APIs de deportes"
estado: "por_definir"
proposito: "Datos de eventos deportivos"
# -----------------------------------------------------------------------------
# GRAFO VISUAL
# -----------------------------------------------------------------------------
grafo: |
┌──────────────────────────────────────────────────────────────────┐
│ BETTING-ANALYTICS │
│ (STANDALONE - IDEA) │
└──────────────────────────────────────────────────────────────────┘
│ hereda directivas
┌──────────────────────────────────────────────────────────────────┐
│ workspace-v2/orchestration │
│ (Directivas SIMCO, NEXUS) │
└──────────────────────────────────────────────────────────────────┘
NOTA: Sin dependencias de otros proyectos por ser standalone.
Sin consumidores por ser CONSUMER level.
# -----------------------------------------------------------------------------
# IMPACTO DE CAMBIOS
# -----------------------------------------------------------------------------
impacto:
si_cambia_workspace:
- "Actualizar directivas heredadas"
- "Verificar compatibilidad SIMCO/NEXUS"
si_cambia_este_proyecto:
- "Sin impacto externo (STANDALONE)"
# -----------------------------------------------------------------------------
# NOTAS
# -----------------------------------------------------------------------------
notas:
- "Proyecto en fase IDEA - dependencias no materializadas"
- "Revisar y actualizar cuando inicie desarrollo"
- "Considerar integracion con APIs de deportes"

View File

@ -0,0 +1,152 @@
# ===============================================================================
# MAPA-DOCUMENTACION.yml - Betting Analytics
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estandar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Nivel: CONSUMER (L2)
# Fecha: 2026-01-24
#
# ===============================================================================
metadata:
proyecto: "betting-analytics"
codigo: "BET"
version: "1.0.0"
ultima_actualizacion: "2026-01-24"
# -----------------------------------------------------------------------------
# ESTRUCTURA DE DOCUMENTACION
# -----------------------------------------------------------------------------
estructura:
# Carpeta root del proyecto
root: "projects/betting-analytics/"
carpetas:
# Documentacion de usuario
- path: "docs/"
proposito: "Documentacion de usuario y vision"
estado: "pendiente"
archivos_esperados:
- README.md
- VISION.md
- REQUERIMIENTOS.md
# Orquestacion (carpeta actual)
- path: "orchestration/"
proposito: "Documentacion operacional SIMCO"
estado: "estandarizado"
archivos:
# Archivos root obligatorios (10)
- path: "_MAP.md"
proposito: "Mapa de navegacion"
estado: "creado"
- path: "_inheritance.yml"
proposito: "Definicion de herencia"
estado: "creado"
- path: "BOOTLOADER.md"
proposito: "Protocolo de arranque NEXUS"
estado: "existente"
- path: "CONTEXT-MAP.yml"
proposito: "Mapa de contexto"
estado: "existente"
- path: "PROJECT-PROFILE.yml"
proposito: "Perfil del proyecto"
estado: "existente"
- path: "PROJECT-STATUS.md"
proposito: "Estado actual"
estado: "existente"
- path: "PROXIMA-ACCION.md"
proposito: "Checkpoint de sesion"
estado: "existente"
- path: "DEPENDENCY-GRAPH.yml"
proposito: "Grafo de dependencias"
estado: "creado"
- path: "TRACEABILITY.yml"
proposito: "Trazabilidad"
estado: "creado"
- path: "MAPA-DOCUMENTACION.yml"
proposito: "Este archivo"
estado: "creado"
subcarpetas:
- path: "00-guidelines/"
proposito: "Guidelines del proyecto"
archivos:
- CONTEXTO-PROYECTO.md
- HERENCIA-DIRECTIVAS.md
- HERENCIA-SIMCO.md
- PROJECT-STATUS.md
- path: "inventarios/"
proposito: "Inventarios por capa"
archivos:
- MASTER_INVENTORY.yml
- DATABASE_INVENTORY.yml
- BACKEND_INVENTORY.yml
- FRONTEND_INVENTORY.yml
- path: "trazas/"
proposito: "Trazas de tareas"
archivos:
- TRAZA-TAREAS-DATABASE.md
- TRAZA-TAREAS-BACKEND.md
- TRAZA-TAREAS-FRONTEND.md
- path: "_archive/"
proposito: "Archivos legacy movidos"
archivos:
- environment/ # Movido de root
- estados/ # Movido de root
# -----------------------------------------------------------------------------
# ALIASES
# -----------------------------------------------------------------------------
aliases:
# Acceso rapido a documentos clave
"@BET-BOOT": "orchestration/BOOTLOADER.md"
"@BET-PROFILE": "orchestration/PROJECT-PROFILE.yml"
"@BET-STATUS": "orchestration/PROJECT-STATUS.md"
"@BET-CONTEXT": "orchestration/CONTEXT-MAP.yml"
"@BET-DEPS": "orchestration/DEPENDENCY-GRAPH.yml"
"@BET-TRACE": "orchestration/TRACEABILITY.yml"
"@BET-INV": "orchestration/inventarios/MASTER_INVENTORY.yml"
# -----------------------------------------------------------------------------
# DOCUMENTACION PENDIENTE
# -----------------------------------------------------------------------------
pendiente:
alta_prioridad: []
media_prioridad:
- archivo: "docs/README.md"
descripcion: "README principal del proyecto"
- archivo: "docs/VISION.md"
descripcion: "Vision y objetivos del proyecto"
baja_prioridad:
- archivo: "docs/REQUERIMIENTOS.md"
descripcion: "Requerimientos funcionales y no funcionales"
# -----------------------------------------------------------------------------
# ESTADISTICAS
# -----------------------------------------------------------------------------
estadisticas:
total_archivos_documentacion: 17
archivos_root_orchestration: 10
subcarpetas_orchestration: 4
cobertura_estandar: "100%"
# -----------------------------------------------------------------------------
# NOTAS
# -----------------------------------------------------------------------------
notas:
- "Estructura orchestration/ estandarizada a SIMCO-ESTANDAR-ORCHESTRATION v1.0.0"
- "Carpetas legacy movidas a _archive/"
- "docs/ pendiente de crear cuando inicie desarrollo"

View File

@ -0,0 +1,100 @@
# ===============================================================================
# TRACEABILITY.yml - Betting Analytics
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estandar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Nivel: CONSUMER (L2)
# Fecha: 2026-01-24
#
# ===============================================================================
metadata:
proyecto: "betting-analytics"
codigo: "BET"
version: "0.0.1"
ultima_actualizacion: "2026-01-24"
estado: "idea"
# -----------------------------------------------------------------------------
# HISTORIAL DE CAMBIOS SIGNIFICATIVOS
# -----------------------------------------------------------------------------
historial:
- fecha: "2025-12-08"
tipo: "creacion"
descripcion: "Creacion inicial del proyecto"
agente: "unknown"
commit: "unknown"
notas: "Proyecto creado en fase idea"
- fecha: "2026-01-04"
tipo: "actualizacion"
descripcion: "Migracion a workspace-v2"
agente: "Claude Code"
commit: "unknown"
notas: "Migracion de estructura desde workspace-v1"
- fecha: "2026-01-24"
tipo: "reestructuracion"
descripcion: "Estandarizacion orchestration segun SIMCO-ESTANDAR-ORCHESTRATION v1.0.0"
agente: "Claude Code"
commit: "pendiente"
notas: |
- Creada _archive/ para carpetas legacy
- Movido environment/ y estados/ a _archive/
- Creados archivos obligatorios: _inheritance.yml, _MAP.md,
DEPENDENCY-GRAPH.yml, TRACEABILITY.yml, MAPA-DOCUMENTACION.yml
- Estructura alineada a CONSUMER level
# -----------------------------------------------------------------------------
# TRAZAS POR DOMINIO
# -----------------------------------------------------------------------------
trazas_por_dominio:
database:
archivo: "trazas/TRAZA-TAREAS-DATABASE.md"
estado: "sin_cambios"
ultima_tarea: null
backend:
archivo: "trazas/TRAZA-TAREAS-BACKEND.md"
estado: "sin_cambios"
ultima_tarea: null
frontend:
archivo: "trazas/TRAZA-TAREAS-FRONTEND.md"
estado: "sin_cambios"
ultima_tarea: null
# -----------------------------------------------------------------------------
# PROPAGACIONES RECIBIDAS
# -----------------------------------------------------------------------------
propagaciones_recibidas:
- origen: "workspace-v2/orchestration"
fecha: "2026-01-24"
tipo: "estructura"
descripcion: "Estandar SIMCO-ESTANDAR-ORCHESTRATION aplicado"
# -----------------------------------------------------------------------------
# ESTADISTICAS
# -----------------------------------------------------------------------------
estadisticas:
total_tareas_documentadas: 0
tareas_database: 0
tareas_backend: 0
tareas_frontend: 0
commits_relacionados: 0
propagaciones_recibidas: 1
propagaciones_enviadas: 0
# -----------------------------------------------------------------------------
# NOTAS
# -----------------------------------------------------------------------------
notas:
- "Proyecto en fase IDEA - sin tareas de desarrollo ejecutadas"
- "Trazabilidad iniciada con reestructuracion de orchestration"
- "Actualizar cuando inicie desarrollo activo"

146
orchestration/_MAP.md Normal file
View File

@ -0,0 +1,146 @@
# MAPA DE NAVEGACION - Betting Analytics Orchestration
**Sistema:** SIMCO v4.3.0 + NEXUS v4.0
**Estandar:** SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
**Nivel:** CONSUMER (L2)
**Fecha:** 2026-01-24
---
## ESTRUCTURA ESTANDARIZADA
```
orchestration/
├── _MAP.md <- ESTE ARCHIVO (mapa de navegacion)
├── _inheritance.yml <- Definicion de herencia (de workspace-v2)
├── BOOTLOADER.md <- Protocolo de arranque NEXUS
├── CONTEXT-MAP.yml <- Mapa de contexto y aliases
├── PROJECT-PROFILE.yml <- Perfil y metadata del proyecto
├── PROJECT-STATUS.md <- Estado actual del proyecto
├── PROXIMA-ACCION.md <- Checkpoint de sesion
├── DEPENDENCY-GRAPH.yml <- Grafo de dependencias
├── TRACEABILITY.yml <- Trazabilidad del proyecto
├── MAPA-DOCUMENTACION.yml <- Mapa de toda la documentacion
├── 00-guidelines/ <- Guidelines del proyecto
│ ├── CONTEXTO-PROYECTO.md <- Contexto y variables
│ ├── HERENCIA-DIRECTIVAS.md <- Directivas heredadas
│ ├── HERENCIA-SIMCO.md <- SIMCO heredado
│ └── PROJECT-STATUS.md <- Status (duplicado, considerar eliminar)
├── inventarios/ <- Inventarios por capa
│ ├── MASTER_INVENTORY.yml <- Inventario maestro
│ ├── DATABASE_INVENTORY.yml <- Inventario de BD
│ ├── BACKEND_INVENTORY.yml <- Inventario de backend
│ └── FRONTEND_INVENTORY.yml <- Inventario de frontend
├── trazas/ <- Trazas de tareas por dominio
│ ├── TRAZA-TAREAS-DATABASE.md
│ ├── TRAZA-TAREAS-BACKEND.md
│ └── TRAZA-TAREAS-FRONTEND.md
└── _archive/ <- Archivos legacy (no usar)
├── environment/ <- (Movido, usar datos de PROJECT-PROFILE)
└── estados/ <- (Movido, usar TRACEABILITY)
```
---
## NAVEGACION RAPIDA
### Arranque de Sesion
| Documento | Proposito | Cuando usar |
|-----------|-----------|-------------|
| `BOOTLOADER.md` | Protocolo de arranque | Inicio de cada sesion |
| `PROJECT-PROFILE.yml` | Metadata del proyecto | Contexto general |
| `PROXIMA-ACCION.md` | Ultimo checkpoint | Continuar trabajo |
### Contexto y Configuracion
| Documento | Proposito | Cuando usar |
|-----------|-----------|-------------|
| `CONTEXT-MAP.yml` | Aliases y variables | Resolver @ALIAS |
| `_inheritance.yml` | Herencia definida | Entender dependencias |
| `00-guidelines/CONTEXTO-PROYECTO.md` | Contexto detallado | Nuevo al proyecto |
### Estado y Trazabilidad
| Documento | Proposito | Cuando usar |
|-----------|-----------|-------------|
| `PROJECT-STATUS.md` | Estado actual | Ver estado |
| `TRACEABILITY.yml` | Historial de cambios | Auditar cambios |
| `DEPENDENCY-GRAPH.yml` | Dependencias | Ver relaciones |
### Inventarios
| Documento | Proposito | Cuando usar |
|-----------|-----------|-------------|
| `inventarios/MASTER_INVENTORY.yml` | Resumen general | Vista global |
| `inventarios/DATABASE_INVENTORY.yml` | Objetos de BD | Trabajo DDL |
| `inventarios/BACKEND_INVENTORY.yml` | Servicios backend | Trabajo API |
| `inventarios/FRONTEND_INVENTORY.yml` | Componentes UI | Trabajo frontend |
### Trazas de Ejecucion
| Documento | Proposito | Cuando usar |
|-----------|-----------|-------------|
| `trazas/TRAZA-TAREAS-DATABASE.md` | Tareas de BD | Registrar cambios DDL |
| `trazas/TRAZA-TAREAS-BACKEND.md` | Tareas backend | Registrar cambios API |
| `trazas/TRAZA-TAREAS-FRONTEND.md` | Tareas frontend | Registrar cambios UI |
---
## ALIASES DEL PROYECTO
```
@BET-BOOT -> orchestration/BOOTLOADER.md
@BET-PROFILE -> orchestration/PROJECT-PROFILE.yml
@BET-STATUS -> orchestration/PROJECT-STATUS.md
@BET-CONTEXT -> orchestration/CONTEXT-MAP.yml
@BET-DEPS -> orchestration/DEPENDENCY-GRAPH.yml
@BET-TRACE -> orchestration/TRACEABILITY.yml
@BET-INV -> orchestration/inventarios/MASTER_INVENTORY.yml
```
---
## HERENCIA
Este proyecto **CONSUMER** hereda de:
```
workspace-v2/orchestration/
├── directivas/simco/* <- Directivas SIMCO
├── directivas/principios/* <- 7 principios
├── directivas/triggers/* <- Triggers automaticos
└── agents/perfiles/* <- Perfiles de agentes
```
**No hereda de:** template-saas, erp-core (es standalone)
**No exporta a:** ningun proyecto (CONSUMER level)
---
## ESTADO DEL PROYECTO
| Aspecto | Valor |
|---------|-------|
| **Estado** | IDEA |
| **Prioridad** | P4 (Backlog) |
| **Desarrollo activo** | No |
| **Codigo existente** | No |
---
## NOTAS
1. **Estructura estandarizada** el 2026-01-24 segun SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
2. **Carpetas legacy** movidas a `_archive/` (environment, estados)
3. **10 archivos root** obligatorios - todos presentes
4. **3 subcarpetas** obligatorias - todas presentes (00-guidelines, inventarios, trazas)
---
*Sistema SIMCO v4.3.0 + NEXUS v4.0*
*Proyecto betting-analytics - Nivel CONSUMER (L2)*

View File

@ -1,47 +1,47 @@
# =============================================================================
# PROJECT-ENV-CONFIG.yml
# Configuración de Ambiente específica del proyecto BETTING-ANALYTICS
# =============================================================================
# Proyecto: BETTING-ANALYTICS - Análisis de Apuestas Deportivas
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# =============================================================================
project:
name: "BETTING_ANALYTICS"
slug: "betting-analytics"
description: "Plataforma de Análisis de Apuestas Deportivas"
status: "development"
port_block: 3090
ports:
frontend: 3090
backend: 3091
ml_service: 8003
database:
host: "localhost"
port: 5438 # Puerto asignado para betting-analytics (ver DEVENV-PORTS-INVENTORY.yml)
name: "betting_analytics"
user: "betting_user"
# password: Ver archivo .env local
urls:
frontend: "http://localhost:3090"
backend_api: "http://localhost:3091/api"
swagger: "http://localhost:3091/api/docs"
env_files:
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
stack:
backend: "NestJS + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
ml_service: "FastAPI + Python"
notes: |
- Proyecto en desarrollo inicial
- Servicio ML para análisis predictivo de apuestas
- Base de datos: betting_analytics (en instancia PostgreSQL compartida)
# =============================================================================
# PROJECT-ENV-CONFIG.yml
# Configuración de Ambiente específica del proyecto BETTING-ANALYTICS
# =============================================================================
# Proyecto: BETTING-ANALYTICS - Análisis de Apuestas Deportivas
# Actualizado: 2025-12-05
# Referencia: ~/workspace/core/devtools/environment/DEV-ENVIRONMENT-REGISTRY.yml
# =============================================================================
project:
name: "BETTING_ANALYTICS"
slug: "betting-analytics"
description: "Plataforma de Análisis de Apuestas Deportivas"
status: "development"
port_block: 3090
ports:
frontend: 3090
backend: 3091
ml_service: 8003
database:
host: "localhost"
port: 5438 # Puerto asignado para betting-analytics (ver DEVENV-PORTS-INVENTORY.yml)
name: "betting_analytics"
user: "betting_user"
# password: Ver archivo .env local
urls:
frontend: "http://localhost:3090"
backend_api: "http://localhost:3091/api"
swagger: "http://localhost:3091/api/docs"
env_files:
backend: "apps/backend/.env"
frontend: "apps/frontend/.env"
stack:
backend: "NestJS + TypeScript"
frontend: "React + TypeScript + Vite"
database: "PostgreSQL 15"
ml_service: "FastAPI + Python"
notes: |
- Proyecto en desarrollo inicial
- Servicio ML para análisis predictivo de apuestas
- Base de datos: betting_analytics (en instancia PostgreSQL compartida)

View File

@ -0,0 +1,81 @@
# ===============================================================================
# _inheritance.yml - Betting Analytics
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estandar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Nivel: CONSUMER (L2)
# Fecha: 2026-01-24
#
# ===============================================================================
tipo: CONSUMER
version: "1.0.0"
# -----------------------------------------------------------------------------
# HERENCIA
# -----------------------------------------------------------------------------
# Este proyecto hereda del workspace raiz.
# No hereda de template-saas ni erp-core por ser standalone.
hereda_de:
- path: "workspace-v2/orchestration/"
tipo: "workspace_root"
descripcion: "Directivas SIMCO, principios, y estandares del workspace"
elementos_heredados:
- directivas/simco/*
- directivas/principios/*
- directivas/triggers/*
- agents/perfiles/*
# -----------------------------------------------------------------------------
# EXPORTACION
# -----------------------------------------------------------------------------
# CONSUMERS no exportan a otros proyectos.
exporta_a: []
# -----------------------------------------------------------------------------
# MODULOS PROPIOS
# -----------------------------------------------------------------------------
# Modulos especificos de este proyecto (cuando se desarrollen).
modulos_verticales:
- id: "BET-001"
nombre: "Analisis Estadistico"
estado: "idea"
- id: "BET-002"
nombre: "Predicciones ML"
estado: "idea"
- id: "BET-003"
nombre: "Bankroll Management"
estado: "idea"
- id: "BET-004"
nombre: "Bet Tracker"
estado: "idea"
# -----------------------------------------------------------------------------
# REGLAS DE SINCRONIZACION
# -----------------------------------------------------------------------------
regla_sincronizacion: |
Este proyecto es STANDALONE. No recibe propagaciones automaticas
de otros proyectos excepto:
- Actualizaciones de directivas SIMCO del workspace
- Security fixes globales
Sincronizacion manual cuando sea necesario.
sla_sincronizacion:
security_fixes: "24h"
directivas_simco: "siguiente_sesion"
features: "no_aplica"
# -----------------------------------------------------------------------------
# NOTAS
# -----------------------------------------------------------------------------
notas:
- "Proyecto en fase IDEA (P4) - sin desarrollo activo"
- "Standalone - no tiene dependencia de template-saas ni erp-core"
- "Cuando inicie desarrollo, evaluar si adoptar patrones de template-saas"