d8497e3b5e
- Moved backend/ to apps/backend/ (submodule) - Moved database/ to apps/database/ (submodule) - Moved frontend/ to apps/frontend-web/ (submodule) - Updated .gitmodules references - Created apps/_MAP.md - Updated CLAUDE.md v0.1.0 -> v2.0.0 Part of: TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS Sprint 5 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
258 lines
6.5 KiB
Markdown
258 lines
6.5 KiB
Markdown
# 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
|