# MGN-005: Catalogos

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

---

## Descripcion

Sistema de catalogos maestros genericos que permite definir y gestionar listas de valores reutilizables en todo el sistema: paises, estados, monedas, unidades de medida, categorias, etc.

---

## Funcionalidades Principales

1. **CRUD de Catalogos** - Crear, editar, eliminar catalogos
2. **Items de Catalogo** - Gestionar items dentro de cada catalogo
3. **Catalogos Jerarquicos** - Soporte para catalogos con estructura de arbol
4. **Catalogos de Sistema** - Catalogos predefinidos no eliminables
5. **Busqueda y Filtrado** - Busqueda eficiente en catalogos grandes

---

## Casos de Uso

- Catalogo de paises con codigos ISO
- Catalogo de monedas con simbolos y formatos
- Catalogo de unidades de medida
- Catalogo de categorias de productos
- Catalogo de tipos de documentos
- Catalogos personalizados por tenant

---

## Dependencias

**Este modulo depende de:**
- MGN-001 Auth
- MGN-004 Tenants (para aislamiento multi-tenant)

**Modulos que dependen de este:**
- MGN-010 Financial (monedas, tipos de cuenta)
- MGN-011 Inventory (unidades, categorias)
- Verticales (catalogos especificos)

---

## Documentacion

- **Requerimientos:** [requerimientos/](./requerimientos/)
- **Especificaciones:** [especificaciones/](./especificaciones/)
- **User Stories:** [historias-usuario/](./historias-usuario/)
- **Trazabilidad:** [implementacion/TRACEABILITY.yml](./implementacion/TRACEABILITY.yml)

---

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