Usuarios
Identidad que inicia sesión o se autentica con un token, con nombre, idioma y apariencia.
- Nombre API:
users - Dominio: Autenticación
- Módulos: Administración
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Nombre | name | Texto | Sí | Nombre visible del usuario |
| Correo electrónico | email | Correo electrónico | Sí | Correo electrónico asociado al usuario (no modificable) |
| Correo verificado | emailVerified | Binario | Sí | Indica si el correo electrónico está verificado |
| Rol de permisos | roleId | Referencia | El rol cuyas líneas dan acceso de negocio a este usuario. Sin rol, el usuario solo ve su módulo personal. | |
| Idioma | locale | Localidad | Idioma a usar en la aplicación | |
| Formato de fecha | maskDateFormat | Constante | Sí | Cómo se muestran las fechas en pantalla para ti. Los datos guardados siguen en formato ISO. |
| Formato de hora | maskTimeFormat | Constante | Sí | Cómo se muestra la hora en pantalla para ti. Los datos guardados siguen en formato HH:mm. |
| Decimales | viewDecimalPlaces | Número Entero | Decimales en pantalla para ti. Vacío usa el valor de la organización. | |
| Unidad en pantalla | viewUnitMode | Constante | Sí | Unidad en vistas para ti. Organización usa el valor de la organización. |
| Apariencia | uiColorMode | Constante | Modo oscuro o claro de la aplicación. Organización usa el valor de la organización. | |
| Imagen de perfil | image | Imagen | Imagen usada como avatar del usuario | |
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Claves de sistemas remotos y tipos de id opcionales. Un valor por par de sistema y tipo en este registro. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Marca de tiempo | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Marca de tiempo | Sí | |
| Suspendido por | bannedBy | Usuario | ||
| Suspendido el | bannedAt | Marca de tiempo | Cuándo el usuario fue suspendido de la plataforma | |
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Rol de permisos roleId | Roles | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook users.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un usuario. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios del usuario. | App · WebMCP · API · MCP · CLI |
| Suspender | ban | Suspender al usuario y revocar sesiones activas. | App · WebMCP · API · MCP · CLI |
| Reactivar | unban | Restaurar el acceso de un usuario suspendido. | App · WebMCP · API · MCP · CLI |
| Eliminar | delete | Elimina el usuario y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.
| Acción | Nombre API |
|---|---|
| Suspender | ban |
| Reactivar | unban |