betting-analytics/CLAUDE.md

CLAUDE.md - Betting Analytics

Hereda de: ../../CLAUDE.md (workspace-v2) Sistema: SIMCO v4.0.0 + NEXUS v4.0 Proyecto: betting-analytics Tipo: CONSUMER (STANDALONE) Versión: 2.0.0 Actualizado: 2026-02-06

---

EXTENSIONES LOCALES

Este archivo EXTIENDE (no reemplaza) las reglas del workspace.

Para reglas base, ver: ../../CLAUDE.md

Las directivas SIMCO del workspace se heredan automáticamente. Este documento especifica únicamente las extensiones y personalizaciones locales para Betting Analytics.

---

DESCRIPCIÓN DEL PROYECTO

Betting Analytics es un proyecto en fase IDEA (P4) para proporcionar herramientas de análisis estadístico, predicciones y gestión de bankroll para apostadores de deportes.

Características Planeadas

• Análisis estadístico de eventos deportivos
• Predicciones basadas en datos históricos
• Gestión de bankroll (capital management)
• Seguimiento de apuestas (Bet Tracker)
• Reportes de rendimiento
• Herramientas de análisis ML (futuro)

Estado Actual

Aspecto	Valor
Fase	IDEA
Madurez	Conceptual
Completitud	0%
En Producción	No
Prioridad	P4 (Backlog)

Módulos Planeados (Verticales)

ID	Módulo	Descripción	Estado
BET-001	Análisis Estadístico	Análisis de estadísticas deportivas	idea
BET-002	Predicciones	Predicciones basadas en ML	idea
BET-003	Bankroll Management	Gestión de capital	idea
BET-004	Bet Tracker	Seguimiento de apuestas	idea

---

STACK TECNOLÓGICO

Estado: A definir (proyecto en fase de concepto)

Backend: Por definir
Frontend: Por definir
Database: Por definir
Analytics: Por definir
ML: Por definir

---

HERENCIA Y SINCRONIZACIÓN

Patrón de Herencia

Este proyecto hereda del workspace raíz (workspace-v2/orchestration/):

betting-analytics/
  └─ orchestration/
       └─ _inheritance.yml
            └─ hereda de: workspace-v2/orchestration/

Regla de Sincronización

Betting Analytics es un proyecto STANDALONE.

• NO recibe propagaciones automáticas de otros proyectos
• Recibe actualizaciones de:
  • Directivas SIMCO del workspace (siguientes sesiones)
  • Security fixes globales (24h máximo)

Reglas Especiales P4 (Backlog)

- Solo documentación y planeación permitidos
- Sin desarrollo de features hasta promoción a P3
- Evaluaciones conceptuales OK
- No requiere CI/CD activo

---

ESTRUCTURA LOCAL

betting-analytics/
├── CLAUDE.md                           <- Este archivo
├── AGENTS.md
├── INVENTARIO.yml
├── README.md
├── apps/                              <- Componentes de aplicacion
│   ├── _MAP.md
│   ├── backend/                       <- (submodulo - a definir)
│   ├── database/                      <- (submodulo - a definir)
│   └── frontend-web/                  <- (submodulo - a definir)
├── docs/
│   └── (documentación específica del proyecto)
└── orchestration/
    ├── _inheritance.yml
    ├── _MAP.md
    ├── inventarios/
    ├── tareas/
    └── trazas/

---

ALIAS LOCALES

Alias	Descripción	Ruta
@LOCAL-ORCHESTRATION	Orchestration local de betting-analytics	orchestration/
@LOCAL-DOCS	Documentación específica del proyecto	docs/
@LOCAL-TAREAS	Tareas del proyecto	orchestration/tareas/
@LOCAL-INVENTARIOS	Inventarios locales	orchestration/inventarios/
@BET-PROFILE	Perfil del proyecto	orchestration/PROJECT-PROFILE.yml
@BET-INHERITANCE	Definición de herencia	orchestration/_inheritance.yml

---

DIRECTIVAS HEREDADAS

Las siguientes directivas se heredan automáticamente del workspace raíz:

Obligatorias (SIEMPRE cargar)

1. ../../orchestration/directivas/principios/PRINCIPIO-CAPVED.md
2. ../../orchestration/directivas/simco/SIMCO-TAREA.md
3. ../../orchestration/directivas/simco/SIMCO-GIT.md
4. ../../orchestration/directivas/simco/SIMCO-EDICION-SEGURA.md

Sistema NEXUS v4.0

@NEXUS               -> orchestration/directivas/simco/SIMCO-CONTEXT-MANAGEMENT-V2.md
@DEF_CHECKPOINT      -> orchestration/_definitions/protocols/CHECKPOINT-PROTOCOL.md
@DEF_RECOVERY        -> orchestration/_definitions/protocols/RECOVERY-PROTOCOL.md
@DEF_CHK_POST        -> orchestration/_definitions/checklists/CHECKLIST-POST-TASK.md

Triggers Automáticos

• TRIGGER-FETCH-OBLIGATORIO
• TRIGGER-COMMIT-PUSH-OBLIGATORIO
• TRIGGER-COHERENCIA-CAPAS
• TRIGGER-INVENTARIOS-SINCRONIZADOS
• TRIGGER-CIERRE-TAREA-OBLIGATORIO

---

REGLAS CRITICAS APLICABLES

RC1: FETCH ANTES DE OPERAR

git fetch origin && git log HEAD..origin/main --oneline
# Si hay output → git pull
# Luego: git status

RC2: COMMIT + PUSH OBLIGATORIO

git add . && git commit -m "[BET] tipo: descripción" && git push origin main

RC4: Flujo DDL-WSL (cuando inicie backend)

1. Modificar .sql
2. Recrear BD en WSL: @TRIGGER-DDL-WSL
3. Verificar
4. Commit + Push

RC5: SSOT de Inventarios

- Métricas locales: projects/betting-analytics/orchestration/inventarios/
- Nunca leer del workspace si existe versión local

---

VALIDACIONES LOCALES

Cuando inicie desarrollo (promoción a P3), requerirá:

# Backend (a definir)
npm run build && npm run lint && npm run test

# Frontend (a definir)
npm run build && npm run lint && npm run typecheck

# DDL (si aplica)
./scripts/recreate-database.sh

---

PROPAGACIÓN

Política de propagación: NO APLICA

Betting Analytics es STANDALONE. No se propaga a otros proyectos ni recibe propagaciones automáticas (excepto security fixes del workspace).

---

CIERRE DE TAREAS (OBLIGATORIO)

Para toda tarea completada:

1. Ejecutar: @DEF_CHK_POST (orchestration/_definitions/checklists/CHECKLIST-POST-TASK.md)
2. Verificar:
   • Git status = clean
   • Commits en log
   • Documentación actualizada
   • Inventarios sincronizados
3. Solo entonces: marcar completada

---

NOTAS IMPORTANTES

• Proyecto en fase IDEA - Sin desarrollo activo en este momento
• Prioridad P4 (Backlog) - Esperar promoción a P3 para iniciar desarrollo
• Solo documentación y planeación permitidas en esta fase
• Considerar regulaciones de apuestas por jurisdicción antes de desarrollo
• Stack pendiente de definición - Evaluar adopción de patrones de template-saas cuando inicie

---

Sistema: SIMCO v4.0.0 | Tipo: Instrucciones de Proyecto Extensión