betting-analytics/docs/01-fase-alcance-inicial/BA-001-fundamentos/README.md

id	title	type	status	phase	story_points	budget	sprint	labels	created_date	updated_date
EPIC-BA-001	EPIC BA-001: Fundamentos	EPIC	Planned	01-fase-alcance-inicial	0	TBD	Sprint-1	fundamentos auth api mvp	2026-01-04	2026-01-04

EPIC BA-001: Fundamentos

Fase: 01 - Alcance Inicial Estado: Planned Sprint: Sprint-1 (planificado)

---

Descripcion

Esta EPIC establece los fundamentos tecnicos del proyecto Betting Analytics, incluyendo:

• Configuracion inicial del backend NestJS
• Sistema de autenticacion con JWT
• API base con validaciones
• Estructura de base de datos inicial
• Configuracion de Docker para desarrollo

---

Objetivos

1. Autenticacion completa - Login, registro, refresh tokens
2. API REST funcional - Endpoints base con validacion
3. Base de datos - Esquema inicial con TypeORM
4. Docker - Ambiente de desarrollo containerizado
5. Documentacion - API documentada con Swagger

---

Alcance

Incluido

• Modulo de autenticacion (auth)
• Modulo de usuarios (users)
• Configuracion de base de datos
• Docker Compose para desarrollo
• Documentacion Swagger

Excluido

• Modulos de negocio (data, analytics, predictions)
• Frontend
• ML Engine
• Deploy a produccion

---

Requerimientos Funcionales

ID	Titulo	Estado
RF-BA-001	Sistema de autenticacion JWT	Pendiente
RF-BA-002	Gestion de usuarios	Pendiente
RF-BA-003	API REST base	Pendiente

---

User Stories

ID	Titulo	SP	Estado
US-BA-001	Configurar autenticacion JWT	8	Backlog
US-BA-002	Registro de usuarios	5	Backlog
US-BA-003	Login de usuarios	5	Backlog
US-BA-004	Refresh de tokens	3	Backlog
US-BA-005	Estructura base de datos	5	Backlog

Total Story Points estimados: 26 SP

---

Metricas

Metrica	Estimado	Real
Story Points	26	-
RF	3	0
US	5	0
Completion	0%	-

---

Dependencias

Entradas

• Ninguna (EPIC inicial)

Salidas

• BA-002 (Ingestion) depende de autenticacion
• BA-003 (Analytics) depende de API base

---

Estructura de Carpeta

BA-001-fundamentos/
├── README.md                 # Este archivo
├── _MAP.md                   # Mapa de navegacion
├── requerimientos/           # RFs
│   ├── _MAP.md
│   └── RF-BA-001.md
├── especificaciones/         # ETs
│   ├── _MAP.md
│   └── ET-BA-001.md
├── historias-usuario/        # US
│   ├── _MAP.md
│   └── US-BA-001.md
└── implementacion/           # Trazabilidad
    ├── TRACEABILITY.yml
    ├── DATABASE.yml
    └── BACKEND.yml

---

Referencias

• Fase: ../README.md
• Vision: ../../00-vision-general/VISION-PRODUCTO.md
• Arquitectura: ../../00-vision-general/ARQUITECTURA-GENERAL.md
• Board: ../../planning/Board.md

---

Creado: 2026-01-04 Actualizado: 2026-01-04 Responsable: @Backend-Agent