# _MAP: MGN-002 - Usuarios

**Modulo:** MGN-002
**Nombre:** Usuarios
**Fase:** 01 - Foundation
**Story Points:** 35 SP
**Estado:** Migrado GAMILIT
**Ultima actualizacion:** 2025-12-05

---

## Resumen

Gestion completa de usuarios del sistema incluyendo CRUD, perfiles, preferencias, activacion/desactivacion y busqueda.

---

## Metricas

| Metrica | Valor |
|---------|-------|
| Story Points | 35 SP |
| Requerimientos (RF) | 5 |
| Especificaciones (ET) | 2 |
| User Stories (US) | 4 |
| Tablas DB | 3 |
| Endpoints API | 14 |

---

## Requerimientos Funcionales (5)

| ID | Archivo | Titulo | Prioridad | Estado |
|----|---------|--------|-----------|--------|
| RF-USER-001 | [RF-USER-001.md](./requerimientos/RF-USER-001.md) | CRUD de Usuarios | P0 | Migrado |
| RF-USER-002 | [RF-USER-002.md](./requerimientos/RF-USER-002.md) | Perfil de Usuario | P0 | Migrado |
| RF-USER-003 | [RF-USER-003.md](./requerimientos/RF-USER-003.md) | Preferencias | P1 | Migrado |
| RF-USER-004 | [RF-USER-004.md](./requerimientos/RF-USER-004.md) | Activacion/Desactivacion | P1 | Migrado |
| RF-USER-005 | [RF-USER-005.md](./requerimientos/RF-USER-005.md) | Busqueda de Usuarios | P1 | Migrado |

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

---

## Especificaciones Tecnicas (2)

| ID | Archivo | Titulo | RF Asociados | Estado |
|----|---------|--------|--------------|--------|
| ET-USERS-001 | [ET-users-backend.md](./especificaciones/ET-users-backend.md) | Backend Users | RF-USER-001 a RF-USER-005 | Migrado |
| ET-USERS-002 | [ET-USER-database.md](./especificaciones/ET-USER-database.md) | Database Users | RF-USER-001 a RF-USER-003 | Migrado |

---

## Historias de Usuario (4)

| ID | Archivo | Titulo | RF | SP | Estado |
|----|---------|--------|----|----|--------|
| US-MGN002-001 | [US-MGN002-001.md](./historias-usuario/US-MGN002-001.md) | Crear Usuario | RF-USER-001 | 5 | Migrado |
| US-MGN002-002 | [US-MGN002-002.md](./historias-usuario/US-MGN002-002.md) | Editar Usuario | RF-USER-001 | 3 | Migrado |
| US-MGN002-003 | [US-MGN002-003.md](./historias-usuario/US-MGN002-003.md) | Gestionar Perfil | RF-USER-002 | 5 | Migrado |
| US-MGN002-004 | [US-MGN002-004.md](./historias-usuario/US-MGN002-004.md) | Configurar Preferencias | RF-USER-003 | 3 | Migrado |

**Backlog:** [BACKLOG-MGN002.md](./historias-usuario/BACKLOG-MGN002.md)

---

## Implementacion

### Database

| Objeto | Tipo | Schema |
|--------|------|--------|
| users | Tabla | core_users |
| user_profiles | Tabla | core_users |
| user_preferences | Tabla | core_users |

### Backend

| Objeto | Tipo | Path |
|--------|------|------|
| UsersModule | Module | src/modules/users/ |
| UsersService | Service | src/modules/users/users.service.ts |
| UsersController | Controller | src/modules/users/users.controller.ts |

### Frontend

| Objeto | Tipo | Path |
|--------|------|------|
| UsersPage | Page | src/features/users/pages/UsersPage.tsx |
| UserDetailPage | Page | src/features/users/pages/UserDetailPage.tsx |
| ProfilePage | Page | src/features/users/pages/ProfilePage.tsx |

---

## Dependencias

**Depende de:** MGN-001 (Auth)

**Requerido por:** MGN-003 (Roles), MGN-004 (Tenants), MGN-011 (RRHH)

---

## Trazabilidad

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

---

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