Usuarios (Dashboard)

Requisitos previos de acceso

• Permiso (módulo): viewUsers
• Licencia/Feature: Ninguna.
• Contenedor del menú: GENERAL → grupo Dashboard

Qué es / cuándo usar

Panel analítico (solo lectura) de la base de usuarios. Muestra el total de registros y la composición de la base por tipo de cuenta (Persona Jurídica × Persona Física), nacionalidad (Brasileños × Extranjeros) y cuántos tienen cuenta digital (banking). Incluye también una consulta de registros por período. Úselo para hacer seguimiento del crecimiento de la base y el perfil de los clientes.

Requisitos previos

• Permiso: viewUsers en el rol (permiso doble — enum CPM + módulo en la DB).
• Licencia/Feature: Ninguna.
• Dependencias de otras pantallas: Carga la lista de usuarios (AccountService.getUsers).

Paso a paso

1. Acceda al menú Dashboard → Usuarios.
2. Espere a que se carguen las tarjetas y los gráficos.
3. (Opcional) Defina una fecha de inicio y una fecha de fin y haga clic en Buscar para ver la cantidad de registros en el período (total, brasileños, extranjeros).

Filtros y columnas

Indicador / Gráfico / Filtro	Qué muestra	Origen del dato
Cantidad de usuarios	Total de registros	users.length
Cantidad de empresas	Cuentas con account_type == '1' (Persona Jurídica)	filtro
Número de personas	Cuentas con account_type == '0' (Persona Física)	filtro
Brasileños / Extranjeros	Sin pasaporte = brasileño; con pasaporte = extranjero	presencia del campo passport
Con cuenta digital	Usuarios con bankingAccount	filtro
Tipo de cuenta (circular)	Persona Jurídica × Persona Física	totales
Nacionalidades (circular)	Brasileña × Extranjera	totales
Registros mensuales (barras)	Total por mes de registro	agrupamiento por mes del campo when
Fecha de inicio / Fecha de fin	Intervalo para la consulta de registros por período	enviadas a getQtyUsersByPeriod (CPM-UserController); el botón Buscar queda deshabilitado si la fecha de inicio es posterior a la de fin

Reglas de negocio / consideraciones

Atención

• La nacionalidad se infiere del pasaporte: el panel considera "extranjero" a todo usuario que tiene passport completado, y "brasileño" a los demás. No es un campo explícito de nacionalidad.
• Validación del filtro de período: el botón Buscar se bloquea cuando la fecha de inicio es posterior a la de fin.
• Error ≠ cero: una página de error indica un fallo en la lectura de la base de usuarios, no una base vacía.

Pantallas relacionadas

• Lista de usuarios
• Dashboard