# _MAP: MGN-005 - Catalogos

**Modulo:** MGN-005
**Nombre:** Catalogos Maestros
**Fase:** 02 - Core Business
**Story Points:** 30 SP
**Estado:** Migrado GAMILIT
**Ultima actualizacion:** 2025-12-05

---

## Resumen

Sistema de catalogos maestros genericos para listas de valores reutilizables: paises, monedas, unidades, categorias, etc.

---

## Metricas

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

---

## Requerimientos Funcionales (5)

| ID | Archivo | Titulo | Prioridad | Estado |
|----|---------|--------|-----------|--------|
| RF-CATALOG-001 | [RF-CATALOG-001.md](./requerimientos/RF-CATALOG-001.md) | CRUD Catalogos | P0 | Migrado |
| RF-CATALOG-002 | [RF-CATALOG-002.md](./requerimientos/RF-CATALOG-002.md) | Items de Catalogo | P0 | Migrado |
| RF-CATALOG-003 | [RF-CATALOG-003.md](./requerimientos/RF-CATALOG-003.md) | Catalogos Jerarquicos | P1 | Migrado |
| RF-CATALOG-004 | [RF-CATALOG-004.md](./requerimientos/RF-CATALOG-004.md) | Catalogos de Sistema | P1 | Migrado |
| RF-CATALOG-005 | [RF-CATALOG-005.md](./requerimientos/RF-CATALOG-005.md) | Busqueda y Filtrado | P1 | Migrado |

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

---

## Especificaciones Tecnicas

*Pendiente de creacion*

---

## Historias de Usuario

*Pendiente de creacion*

---

## Implementacion

### Database

| Objeto | Tipo | Schema |
|--------|------|--------|
| catalogs | Tabla | core_catalogs |
| catalog_items | Tabla | core_catalogs |
| catalog_hierarchies | Tabla | core_catalogs |

### Backend

| Objeto | Tipo | Path |
|--------|------|------|
| CatalogsModule | Module | src/modules/catalogs/ |
| CatalogsService | Service | src/modules/catalogs/catalogs.service.ts |
| CatalogsController | Controller | src/modules/catalogs/catalogs.controller.ts |

---

## Dependencias

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

**Requerido por:** MGN-010 (Financial), MGN-011 (Inventory), Verticales

---

## Trazabilidad

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

---

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