From a2ed69075fcd89c94e1bb5ed9a9e3731c1760868 Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Mon, 2 Feb 2026 18:01:13 -0600 Subject: [PATCH] [BET] docs: Create CLAUDE.md project instructions file --- CLAUDE.md | 263 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 263 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..fe9a402 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,263 @@ +# 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:** 0.1.0 +**Actualizado:** 2026-02-02 + +--- + +## 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 +├── backend/ <- (vacío - a definir) +├── frontend/ <- (vacío - a definir) +├── database/ <- (vacío - a definir) +├── docs/ +│ └── (documentación específica del proyecto) +└── orchestration/ + ├── _inheritance.yml <- Definición de herencia + ├── _MAP.md <- Mapa de documentación + ├── BOOTLOADER.md + ├── CONTEXT-MAP.yml + ├── DEPENDENCY-GRAPH.yml + ├── PROJECT-PROFILE.yml + ├── PROJECT-STATUS.md + ├── MAPA-DOCUMENTACION.yml + ├── TRACEABILITY.yml + ├── 00-guidelines/ + ├── 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