# _MAP: MGN-007 - Audit

**Modulo:** MGN-007
**Nombre:** Auditoria y Logs
**Fase:** 02 - Core Business
**Story Points:** 30 SP
**Estado:** RF Documentados
**Ultima actualizacion:** 2025-12-05

---

## Resumen

Sistema de auditoria que registra acciones, cambios y eventos de seguridad para trazabilidad y cumplimiento normativo.

---

## Metricas

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

---

## Requerimientos Funcionales

| ID | Titulo | Prioridad | SP |
|----|--------|-----------|---:|
| [RF-AUDIT-001](./requerimientos/RF-AUDIT-001.md) | Audit Trail | P0 | 10 |
| [RF-AUDIT-002](./requerimientos/RF-AUDIT-002.md) | Access Logs | P0 | 8 |
| [RF-AUDIT-003](./requerimientos/RF-AUDIT-003.md) | Security Events | P0 | 8 |
| [RF-AUDIT-004](./requerimientos/RF-AUDIT-004.md) | Consultas y Reportes | P1 | 5 |

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

---

## Especificaciones Tecnicas

*Pendiente de documentacion*

---

## Historias de Usuario

*Pendiente de documentacion*

---

## Implementacion

### Database

| Objeto | Tipo | Schema |
|--------|------|--------|
| audit_logs | Tabla | core_audit |
| access_logs | Tabla | core_audit |
| security_events | Tabla | core_audit |
| audit_reports | Tabla | core_audit |

### Backend

| Objeto | Tipo | Path |
|--------|------|------|
| AuditModule | Module | src/modules/audit/ |
| AuditTrailService | Service | src/modules/audit/audit-trail.service.ts |
| AccessLogService | Service | src/modules/audit/access-log.service.ts |
| SecurityEventService | Service | src/modules/audit/security-event.service.ts |
| AuditQueryService | Service | src/modules/audit/audit-query.service.ts |
| AuditInterceptor | Interceptor | src/modules/audit/audit.interceptor.ts |

---

## Dependencias

**Depende de:** MGN-001 (Auth), MGN-002 (Users), MGN-004 (Tenants)

**Requerido por:** Ninguno (transversal)

---

## Trazabilidad

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

---

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