betting-analytics/orchestration/00-guidelines/CONTEXTO-PROYECTO.md

137 lines
3.2 KiB
Markdown

# Contexto del Proyecto - Betting Analytics
## Identificación
| Campo | Valor |
|-------|-------|
| **Nombre** | Betting Analytics Platform |
| **Código** | betting-analytics |
| **Nivel** | 2A (Standalone) |
| **Estado** | Planificación |
| **Progreso** | 0% |
| **Versión** | 0.0.1 |
| **Creado** | 2025-12-05 |
| **Path** | `/home/isem/workspace-v1/projects/betting-analytics/` |
---
## Descripción
Plataforma de análisis y estadísticas para apuestas deportivas. El proyecto está actualmente en fase de planificación.
**Funcionalidades previstas:**
- Análisis estadístico de eventos deportivos
- Tracking de resultados y ROI
- Predicciones basadas en ML
- Dashboard de rendimiento
- Gestión de bankroll
---
## Stack Tecnológico (Propuesto)
| Capa | Tecnología |
|------|------------|
| **Frontend** | React 18 + TypeScript + Vite + Tailwind CSS |
| **Backend** | Express.js / NestJS + TypeScript |
| **Database** | PostgreSQL 15+ |
| **ML** | Python + FastAPI (predicciones) |
---
## Estructura del Proyecto
```
betting-analytics/
├── apps/
│ ├── backend/ # API REST (vacío)
│ ├── database/ # DDL y migraciones (vacío)
│ └── frontend/ # SPA React (vacío)
├── docs/ # Documentación
│ ├── 00-vision-general/
│ ├── 01-analisis-referencias/
│ ├── 02-definicion-modulos/
│ ├── 03-requerimientos/
│ ├── 04-modelado/
│ ├── 05-user-stories/
│ ├── 06-test-plans/
│ ├── 07-devops/
│ ├── 90-transversal/
│ ├── 95-guias-desarrollo/
│ └── 97-adr/
└── orchestration/ # Sistema NEXUS
├── 00-guidelines/
├── inventarios/
├── trazas/
└── ...
```
---
## Variables del Proyecto
```yaml
# Para uso en delegaciones SIMCO
PROJECT_NAME: betting-analytics
PROJECT_PATH: /home/isem/workspace-v1/projects/betting-analytics
# Database (propuesto)
DB_NAME: betting_analytics
DB_DDL_PATH: apps/database/ddl
DB_SEEDS_PATH: apps/database/seeds
# Backend (propuesto)
BACKEND_ROOT: apps/backend
BACKEND_SRC: apps/backend/src
# Frontend (propuesto)
FRONTEND_ROOT: apps/frontend
FRONTEND_SRC: apps/frontend/src
```
---
## Estado Actual
| Aspecto | Estado |
|---------|--------|
| Documentación | Estructura creada, sin contenido |
| Base de datos | No iniciado |
| Backend | No iniciado |
| Frontend | No iniciado |
| Tests | No iniciado |
---
## Próximos Pasos
1. [ ] Definir alcance y requerimientos
2. [ ] Documentar visión general en `docs/00-vision-general/`
3. [ ] Diseñar modelo de datos
4. [ ] Crear épicas y user stories
5. [ ] Iniciar desarrollo del MVP
---
## Herencia de Directivas
Este proyecto hereda directivas de:
1. **Core Global:** `core/orchestration/directivas/`
2. **Principios:** `core/orchestration/directivas/principios/`
3. **SIMCO:** `core/orchestration/directivas/simco/`
---
## Referencias
| Recurso | Path |
|---------|------|
| Core orchestration | `/home/isem/workspace-v1/core/orchestration/` |
| Catálogo global | `/home/isem/workspace-v1/core/catalog/` |
---
*Contexto del proyecto - Sistema NEXUS + SIMCO v2.2.0*
*Última actualización: 2025-12-08*