# _MAP: MGN-009 - Reports

**Modulo:** MGN-009
**Nombre:** Reportes y Dashboards
**Fase:** 02 - Core Business
**Story Points:** 35 SP
**Estado:** RF Documentados
**Ultima actualizacion:** 2025-12-05

---

## Resumen

Sistema de reportes y dashboards con generador de reportes, exportacion multi-formato y programacion automatica.

---

## Metricas

| Metrica | Valor |
|---------|-------|
| Story Points | 35 SP |
| Requerimientos (RF) | 4 |
| Especificaciones (ET) | 0 (pendiente) |
| User Stories (US) | 0 (pendiente) |
| Tablas DB | ~7 |
| Endpoints API | ~18 |

---

## Requerimientos Funcionales

| ID | Titulo | Prioridad | SP |
|----|--------|-----------|---:|
| [RF-REPORT-001](./requerimientos/RF-REPORT-001.md) | Reportes Predefinidos | P0 | 10 |
| [RF-REPORT-002](./requerimientos/RF-REPORT-002.md) | Dashboards | P0 | 10 |
| [RF-REPORT-003](./requerimientos/RF-REPORT-003.md) | Report Builder | P1 | 10 |
| [RF-REPORT-004](./requerimientos/RF-REPORT-004.md) | Reportes Programados | P1 | 5 |

**Indice completo:** [INDICE-RF-REPORT.md](./requerimientos/INDICE-RF-REPORT.md)

---

## Especificaciones Tecnicas

*Pendiente de documentacion*

---

## Historias de Usuario

*Pendiente de documentacion*

---

## Implementacion

### Database

| Objeto | Tipo | Schema |
|--------|------|--------|
| report_definitions | Tabla | core_reports |
| report_executions | Tabla | core_reports |
| dashboards | Tabla | core_reports |
| dashboard_widgets | Tabla | core_reports |
| custom_reports | Tabla | core_reports |
| report_schedules | Tabla | core_reports |
| report_recipients | Tabla | core_reports |

### Backend

| Objeto | Tipo | Path |
|--------|------|------|
| ReportsModule | Module | src/modules/reports/ |
| ReportsService | Service | src/modules/reports/reports.service.ts |
| DashboardsService | Service | src/modules/reports/dashboards.service.ts |
| ReportBuilderService | Service | src/modules/reports/report-builder.service.ts |
| SchedulerService | Service | src/modules/reports/scheduler.service.ts |
| ExportService | Service | src/modules/reports/export.service.ts |

---

## Dependencias

**Depende de:** MGN-001 (Auth), MGN-004 (Tenants), MGN-008 (Notifications)

**Requerido por:** Verticales

---

## Trazabilidad

Ver: [TRACEABILITY.yml](./implementacion/TRACEABILITY.yml)

---

**Generado por:** Requirements-Analyst
**Fecha:** 2025-12-05
