---
id: "EPIC-BA-001"
title: "EPIC BA-001: Fundamentos"
type: "EPIC"
status: "Planned"
phase: "01-fase-alcance-inicial"
story_points: 0
budget: "TBD"
sprint: "Sprint-1"
labels: ["fundamentos", "auth", "api", "mvp"]
created_date: "2026-01-04"
updated_date: "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](../README.md)
- **Vision:** [../../00-vision-general/VISION-PRODUCTO.md](../../00-vision-general/VISION-PRODUCTO.md)
- **Arquitectura:** [../../00-vision-general/ARQUITECTURA-GENERAL.md](../../00-vision-general/ARQUITECTURA-GENERAL.md)
- **Board:** [../../planning/Board.md](../../planning/Board.md)

---

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