Acciones de visibilidad de UI

ModuloCatalogos

Perfil sugeridoAdministracion

PermisoSTAFF_TYPES: WRITE / ADMIN

EstadoValidado

Objetivo

Catalogar las acciones del sistema que controlan la visibilidad de elementos especificos de la UI para cada tipo de personal. Estas acciones complementan a las acciones ya existentes (SHOW_LOGS, AGENDA_PARAMETERS, etc.) y permiten restringir quien ve o utiliza ciertos botones, columnas y secciones de configuracion. La administracion se hace desde la ruta /manage-hcpsTypes/hcpTypes/actions.

Como esta organizada la pantalla

La pantalla de Acciones muestra una tabla con las acciones del sistema. Cada accion tiene una clave, una descripcion, su fecha de alta y un status. La pantalla permite crear, editar y eliminar acciones.

Adicionalmente, desde la pestana Tipos de personal se configura que acciones estan permitidas para cada tipo.

Catalogo de acciones

Visibilidad general

Clave	Que controla	Cuando activarla
MOVE_AGENDA_TO_BREAK	Habilita u oculta el boton "Mover a pausa" dentro del seguimiento de consultas para agendas en sala de espera, en consulta o en recepcion.	Para personal que si puede pausar el flujo de una consulta desde seguimiento.
REQUEST_RECEPTION_MOVE	Habilita el boton "Solicitar recepcion" en el segmento "En consulta" del seguimiento de consultas.	Para personal medico o de enfermeria que necesite devolver pacientes a recepcion sin sacarlos de la consulta.
SHOW_SERVICES_CONFIG	Muestra u oculta el acordeon "Configuraciones" dentro del dialogo de crear o editar un Servicio.	Para personal administrativo o de facturacion que requiera modificar opciones avanzadas (facturable, cortesia, externo, extras, puntos).
SHOW_AGENDA_MEDICAL_GROUPS_CONFIG	Muestra u oculta el acordeon "Configuracion de agenda" dentro del dialogo de crear o editar Personal Medico.	Para personal responsable de la agenda medica que necesite habilitar o deshabilitar agendas, asignar nombres personalizados y grupos medicos.

Columna Status por modulo

Permiten mostrar u ocultar la columna Status (y su boton de activacion/desactivacion) en las listas correspondientes. Si la accion no esta asignada al tipo de personal, la columna simplemente no aparece.

Clave	Modulo
SHOW_STATUS_COLUMN_PATIENTS	Pacientes
SHOW_STATUS_COLUMN_MEDICAL_STAFF	Personal Medico
SHOW_STATUS_COLUMN_USERS	Usuarios
SHOW_STATUS_COLUMN_SERVICES	Servicios
SHOW_STATUS_COLUMN_MODULES	Modulos
SHOW_STATUS_COLUMN_SUBMODULES	Submodulos
SHOW_STATUS_COLUMN_NOTIFICATIONS	Notificaciones
SHOW_STATUS_COLUMN_AUTOMATIONS	Automatizaciones

Acciones disponibles

• Crear accion: dialogo de alta con clave, descripcion y un interruptor de estado (activo por defecto).
• Editar accion: ajustar clave, descripcion o cambiar el estado activo/inactivo.
• Activar o desactivar: la accion deja de estar disponible en los flujos donde aplica.
• Eliminar: requiere STAFF_TYPES: ADMIN. Solo se recomienda cuando la accion nunca fue asignada a un tipo de personal.

Permisos

• STAFF_TYPES: WRITE para crear, editar y configurar acciones en tipos de personal.
• STAFF_TYPES: ADMIN para eliminar acciones.

Antes de empezar

• Tener claras las claves de accion que requiere cada tipo de personal de la clinica.
• Tener definidos los tipos de HCP en la pestana Tipos de personal.
• Verificar que las acciones del sistema (las claves) se encuentren activas antes de asignarlas a un tipo.

Paso a paso - Crear una nueva accion de visibilidad

1. Entrar a Catalogos -> Acciones.
2. Hacer clic en Nueva accion.
3. Capturar la clave en mayusculas con guiones bajos (por ejemplo SHOW_STATUS_COLUMN_PATIENTS). Los espacios se convierten automaticamente.
4. Escribir una descripcion breve que indique que controla la accion.
5. Verificar que el interruptor de Estado este en Activo (es el valor por defecto).
6. Confirmar con Guardar.

Paso a paso - Asignar acciones de visibilidad a un tipo de personal

1. Entrar a Catalogos -> Tipos de personal y acciones.
2. En la pestana Tipos, localizar el tipo al que se le asignaran las acciones.
3. Hacer clic en el icono Configurar acciones (icono de claqueta).
4. En el drawer lateral, activar las palancas correspondientes a las acciones de visibilidad que apliquen al tipo.
5. Confirmar.

Resultado esperado

• La accion queda registrada en el catalogo y disponible para asignarse a cualquier tipo de personal.
• Cuando un usuario con el tipo correspondiente inicia sesion, la accion queda disponible y la UI muestra u oculta los elementos que controla.
• El sistema muestra mensaje de exito al guardar.

Errores comunes

Situacion	Que hacer
La accion no se aplica al usuario	Confirmar que el tipo de HCP del usuario tenga la accion asignada.
El boton o la columna siguen apareciendo a pesar de desactivar la accion	Verificar que la modificacion se haya guardado. Si la pantalla estaba abierta, refrescar o volver a iniciar sesion.
La fecha de alta de la accion aparece vacia	La accion fue dada de alta antes de que existiera el registro de fecha. Las altas nuevas si muestran la fecha.
No se puede eliminar una accion	Verificar que se cuente con STAFF_TYPES: ADMIN. Si la accion ya fue asignada a algun tipo, considerar desactivarla en lugar de eliminarla.

Permisos sugeridos

• STAFF_TYPES: WRITE para administracion cotidiana.
• STAFF_TYPES: ADMIN cuando se requiera eliminar acciones obsoletas.

Recomendaciones operativas

• Definir desde el inicio que acciones de visibilidad necesita cada tipo de personal de la operacion.
• No entregar todas las acciones a todos los tipos. Asignar unicamente las que el rol necesite para reducir superficie de error.
• Para vistas donde se quiere ocultar la columna Status de un modulo especifico, basta con no asignar la accion correspondiente a ese tipo.
• Documentar internamente que claves de visibilidad estan activas y para que tipo, para que los cambios futuros sean consistentes.
• Si una accion se desactiva, los usuarios que la tenian asignada dejaran de ver el elemento relacionado al volver a iniciar sesion o recibir la actualizacion en tiempo real.

Relacion con otros modulos

• Tipos de personal: las acciones de visibilidad se asignan por tipo desde la pestana Tipos.
• Usuarios: el tipo de HCP del usuario determina que acciones de visibilidad le aplican.
• Modulos especificos: cada accion de visibilidad se aplica en su modulo correspondiente:
  • REQUEST_RECEPTION_MOVE -> Seguimiento de consultas.
  • MOVE_AGENDA_TO_BREAK -> Seguimiento de consultas.
  • SHOW_SERVICES_CONFIG -> Dialogo de Servicio.
  • SHOW_AGENDA_MEDICAL_GROUPS_CONFIG -> Dialogo de Personal Medico.
  • SHOW_STATUS_COLUMN_* -> Listas de los modulos correspondientes.
• Acciones del sistema: estas acciones conviven con el catalogo general de acciones documentado en la pagina Acciones del sistema.