[BET] docs: Create CLAUDE.md project instructions file
This commit is contained in:
Adrian Flores Cortes
parent
63c285f535
commit
a2ed69075f
263
CLAUDE.md
Normal file
263
CLAUDE.md
Normal file
@ -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
|
||||
Loading…
Reference in New Issue
Block a user