Usuarios¶

¿Qué es?¶

El módulo de Usuarios gestiona las cuentas de acceso al portal web de Clic2Track. Cada usuario está vinculado a un empleado del sistema y tiene un nombre de usuario (login), contraseña, perfil de acceso y opcionalmente un rol con permisos granulares. Los usuarios son quienes pueden iniciar sesión en el portal para supervisar y administrar las operaciones.

Vista principal¶

La tabla muestra todas las cuentas de usuario con las siguientes columnas:

Usuario — Nombre del usuario con foto de perfil o avatar de iniciales (cargada desde el empleado vinculado), y debajo el login (nombre de usuario). Ancho 220 px.
Estado — Badge: Activo (verde) o Inactivo (gris). Ancho 100 px, ordenable.
Perfil — Badge que indica el nivel de acceso:
Supervisor (azul de marca) — Perfil 2.
Empleado (gris) — Perfil 1. Ancho 120 px, ordenable.
Rol — Badge con el nombre del rol asignado (azul de marca) o badge gris "Sin rol" si no tiene rol asignado. Ancho 220 px.

Filtros¶

Buscar por nombre o usuario... — Campo de texto libre.
Estado — Selector: Activos (por defecto), Inactivos, Todos.
Perfil — Selector: Todos, Empleado, Supervisor.
Rol — Autocompletado que busca en /roles/search.

Ordenación por defecto¶

Ordenada por nombre ascendente (A → Z).

Acciones disponibles¶

Exportar¶

Botón de exportación en la barra de la tabla. Descarga un archivo usuarios. Requiere permiso users: export.

Acciones masivas¶

Al seleccionar uno o más usuarios aparece la barra flotante con cuatro pestañas:

Pestaña Estado¶

Activar — Reactiva los usuarios seleccionados.
Inactivar — Desactiva los usuarios seleccionados. Requiere permiso users: edit.

Pestaña Perfil¶

Selector: Empleado (perfil 1) o Supervisor (perfil 2).
Botón Aplicar — Cambia el perfil de todos los seleccionados. Requiere permiso users: edit.

Pestaña Rol¶

Selector desplegable con todos los roles disponibles.
Botón Aplicar — Asigna el rol seleccionado a todos los usuarios marcados. Requiere permiso users: edit.

Pestaña Notificar¶

Título — Texto del encabezado de la notificación push.
Mensaje — Cuerpo de la notificación.
Quién envía — Campo opcional con el nombre del remitente.
Botón Enviar — Envía la notificación a los dispositivos de los usuarios seleccionados. Confirma con "Enviado a N dispositivo(s)". Requiere permiso users: send.

Al hacer clic en cualquier fila de la tabla se abre el modal de edición. No hay modal de creación — los usuarios se crean a través de la importación masiva o automáticamente al registrar empleados.

Nombre — Solo lectura. Muestra el nombre del empleado vinculado (no editable aquí).
Login — Campo de texto editable. Es el nombre de usuario para iniciar sesión (obligatorio).
Contraseña — Campo que muestra "••••••••" si ya tiene contraseña establecida, o "Toca para cambiar contraseña..." si no. Al hacer clic, abre un popup flotante con:
Campo Contraseña (nueva).
Campo Confirmar (debe coincidir).
Botón Aceptar — Valida que ambos campos coincidan antes de cerrar el popup.
Botón Cancelar — Cierra el popup sin cambiar. La contraseña solo se actualiza cuando se guarda el modal principal.
Perfil — Selector: Empleado (1) o Supervisor (2).
Activo — Toggle para activar/desactivar la cuenta.
Rol — Selector desplegable de roles disponibles. (Sin rol) para desvincular.

Muestra la foto del empleado vinculado (cargada automáticamente en segundo plano) o el avatar de iniciales si no hay foto.

Guardar cambios¶

Botón Guardar envía los cambios. Si la contraseña fue modificada en el popup, se incluye en la petición. Recarga la tabla al guardar correctamente.

Importación masiva de usuarios (users-bulk)¶

La página #/users-bulk permite crear o actualizar múltiples usuarios a la vez mediante una hoja de cálculo.

Columnas de la hoja¶

#	Columna	Tipo	Notas
1	Empleado	Autocompletado	Nombre del empleado. Al escribir, sugiere empleados existentes del sistema
2	Login	Texto	Nombre de usuario para acceder al portal
3	Contraseña	Texto	Contraseña inicial. Las celdas se muestran enmascaradas
4	Perfil	Dropdown	`Empleado` (1) o `Supervisor` (2)
5	Activo	Dropdown	`Sí` o `No`

Comportamiento del autocompletado de Empleado¶

Al escribir en la columna Empleado, aparece una lista desplegable con los empleados que coinciden. Al seleccionar uno, el sistema registra el ID del empleado internamente para crear la vinculación correcta.

Contraseña en la hoja¶

Las celdas de contraseña tienen un comportamiento especial: - Al hacer clic en una celda de contraseña, aparece un popup flotante con dos campos (contraseña + confirmar) para capturar la contraseña de forma segura. - La celda muestra asteriscos (***) en lugar del valor real.

Validación y guardado¶

Las filas completamente vacías se ignoran.
Se valida que el empleado exista en el sistema.
Si el login ya existe, actualiza el usuario existente (upsert).
Al guardar, el botón muestra el progreso.

Perfiles de usuario¶

Perfil	Código	Badge	Acceso típico
Empleado	1	Gris	Acceso básico o nulo al portal
Supervisor	2	Azul	Puede ver y gestionar su equipo
Administrador	3/4	Morado	Acceso completo (se asigna internamente)

Permisos¶

Acción	Permiso requerido
Ver usuarios	`users: view`
Editar usuario	`users: edit`
Exportar	`users: export`
Importar	`users: import`
Enviar notificaciones	`users: send`

Páginas relacionadas¶

Empleados — Cada usuario está vinculado a un empleado. El nombre y foto del usuario provienen del empleado.
Roles y permisos — Los roles que se asignan a los usuarios se definen en este módulo.
Configuración — El usuario puede cambiar su propia contraseña desde Configuración.

Preguntas frecuentes¶

¿Por qué no hay botón "Nuevo usuario"? Los usuarios se crean a través de la importación masiva o de forma automática. Si necesitas crear un usuario individual, usa la importación masiva con una sola fila.

¿Qué diferencia hay entre Perfil y Rol? El Perfil (Empleado/Supervisor) controla el nivel de acceso general a la app móvil. El Rol controla los permisos específicos dentro del portal web (qué módulos puede ver, crear, editar, etc.).

¿Un usuario puede tener múltiples roles? No. Cada usuario tiene un solo rol asignado a la vez. Para cambiar el rol, selecciona el usuario y usa la pestaña Rol en las acciones masivas, o edita el usuario individualmente.

¿Inactivar un usuario elimina su acceso inmediatamente? Sí. Al inactivar un usuario, ya no puede iniciar sesión en el portal ni en la app.

¿Puedo enviar notificaciones a usuarios inactivos? No. Las notificaciones push solo llegan a dispositivos con la app activa y con tokens de Firebase registrados.