Administración de Constantes

Descripción, Propósito y Objetivo

NOTE

La vista de Administración de Constantes (o Enums) es el módulo técnico de la plataforma diseñado para gestionar las listas de valores predefinidos que alimentan los menús desplegables y parámetros estáticos de todo el sistema (como tipos de divisas, frecuencias de facturación, tipos de identificación o estados).

Una Constante (o Enumerador) es un valor de datos predefinido y estático dentro del sistema. Se compone de un Valor (el dato principal, como USD) y, opcionalmente, de un Complemento (información complementaria asociada al valor, como el símbolo $$ o una traducción).

El objetivo de esta vista es permitir a los superadministradores añadir y actualizar estas listas maestras en tiempo real sin necesidad de realizar cambios a nivel de código o base de datos.

---

Contexto de Uso

Este módulo es utilizado por los Administradores de Producto y Super Administradores para:

• Actualizar monedas y divisas: Habilitar nuevos tipos de monedas en el sistema para cobros de membresías (ej. ingresar la divisa EUR con su símbolo € en la lista currencies).
• Agregar frecuencias de pago: Añadir frecuencias operativas para contratos o nómina (ej. añadir Semi-annual a la lista frequencies).
• Parametrizar listas dinámicas: Configurar tipos de documentos de identificación o estados geográficos habilitados para el registro de usuarios.

---

Acciones Posibles

1. Visualizar y Listar Constantes por Categoría

Permite a los administradores listar todos los enumeradores registrados bajo una lista específica:

1. Seleccione la categoría de constantes requerida en el menú desplegable Menú/Lista de constantes (por ejemplo, currencies o frequencies).
2. El sistema listará inmediatamente en pantalla todos los valores registrados, mostrando su código, nombre y complementos asociados.

[Imagen ilustrativa: Listado de Constantes por Categoría]

2. Agregar una Nueva Constante

Para añadir un nuevo valor a una de las listas maestras:

1. Seleccione la lista de destino en el campo desplegable Menú/Lista de constantes.
2. Diligencie los campos requeridos:
   • Nuevo elemento (Valor): Ingrese la clave o valor principal de la constante (ej. USD o Weekly).
   • Complemento o subítem (Opcional): Ingrese la información adicional requerida según el tipo de lista (ej. el símbolo $$ para la moneda o un código de traducción).
3. Haga clic en el botón "Agregar" para guardar el nuevo elemento en la lista. Se verá reflejado de inmediato en todos los formularios del sistema que consuman ese enumerador.

[Imagen ilustrativa: Formulario Agregar Constante]

3. Eliminar una Constante

Para remover un elemento de la lista:

1. Ubique el elemento y haga clic en la acción de borrado (icono de papelera 🗑️ o botón de remoción).
2. Confirme la acción en la ventana emergente.

CAUTION

No elimine constantes que estén siendo utilizadas en registros históricos (como transacciones de membresías, perfiles de usuarios o procesos activos), ya que esto provocaría fallos de carga en el sistema al intentar recuperar el valor borrado.

[Imagen ilustrativa: Modal Confirmar Eliminación de Constante]

---

Permisos Técnicos Requeridos

El acceso a este panel requiere que el rol del usuario posea los siguientes privilegios:

• enums_read: Concede acceso a la vista, selección de listas y lectura de constantes.
• enums_update o enums_create: Permite la adición de nuevos elementos y complementos a las listas de constantes.
• enums_delete: Permite borrar elementos de las listas de constantes del sistema.