# 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)

```yaml
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

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

### RC2: COMMIT + PUSH OBLIGATORIO

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

### RC4: Flujo DDL-WSL (cuando inicie backend)

```bash
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á:

```bash
# 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