Clientes
Todas las cuentas de tu sitio en una lista: quién se registró, quién verificó, quién está bloqueado, y el interruptor que impide iniciar sesión.
Un cliente es un miembro del sitio visto desde el panel: un registro de un modelo con cuentas activadas, identificado por su identidad (normalmente un correo). No hay una tabla de clientes aparte. Si tu workspace tiene dos modelos de cuentas -por ejemplo members y wholesale- el área Clientes lista ambos, con una pestaña por modelo.
El área está junto a Comercio y Equipo en la navegación del panel. Aparece en cuanto al menos un modelo tiene cuentas activadas; antes te remite a Modelos.
La lista
Busca por identidad, filtra por estado y por empresa cuando el modelo la declara. Cada fila muestra el campo de visualización del registro (o la identidad si está vacío), el modelo, el estado y el último inicio de sesión.
active: puede iniciar sesión.pending: registrado, correo aún sin verificar. Solo existe si el modelo exige verificación.suspended: inicio de sesión rechazado, todas las sesiones terminadas.
Un bloqueo tras demasiados intentos fallidos no es un estado: la fila muestra bloqueado hasta y caduca por sí solo.
La página de detalle
La tarjeta de la cuenta y tres pestañas: Perfil (los campos del registro, solo lectura; Editar abre el mismo diálogo de registro que Modelos), Pedidos y Carritos de este cliente. El perfil es el registro, así que editarlo requiere models:edit; las dos pestañas requieren orders:view y carts:view.
Suspender y reactivar
Suspender bloquea el inicio de sesión e invalida todos los tokens de acceso y de refresco del cliente: la siguiente petición con un token antiguo se rechaza. Los pedidos, los carritos y el propio registro se conservan. Una cuenta pending no se puede suspender: verificarla se convertiría, si no, en una forma de activarla.
Reactivar deja que el cliente vuelva a iniciar sesión y limpia cualquier bloqueo. Ambas acciones se rechazan si la cuenta ya está en el estado destino, así que un agente que reintenta una llamada no puede cambiarla dos veces.
Pedidos e invitados
Un pedido de un miembro con sesión iniciada queda vinculado a ese miembro. Un pedido de invitado se vincula después, cuando el invitado se registra y verifica el mismo correo: "mis pedidos" se rellena retroactivamente. Desde el detalle del pedido también puedes vincular o desvincular un cliente a mano.
Empresas (B2B)
En la pestaña Auth del modelo de cuentas indicas un campo de empresa (una relación con tu modelo de empresas) y un campo de rol en la empresa (un select como buyer / approver). La lista de Clientes gana entonces una columna y un filtro Empresa, los pedidos y carritos se listan por empresa, y un pedido congela el nombre de la empresa en el checkout para que un cambio de nombre posterior no reescriba el historial. Nada de la empresa se expone en la API pública.
Permisos
customers:view: ver el área, la lista y el detalle. Por defecto en el rol Viewer.customers:manage: suspender y reactivar. Por defecto en el rol Editor.
Vincular un cliente a un pedido modifica el pedido, así que requiere orders:manage.
Desde MCP y Spotlight
La misma superficie está disponible para agentes: list_customers (modelo, estado, búsqueda, empresa, paginación), get_customer (resumen más los datos del registro), suspend_customer y unsuspend_customer. get_model devuelve la configuración auth del modelo y update_model fija los campos de empresa. list_orders y get_order devuelven customerId, companyId y companyName (null en pedidos de invitado), y list_orders acepta un filtro companyId, así que los pedidos de una empresa llegan a un agente por el mismo camino. Consulta el catálogo de herramientas.
Siguientes pasos
- Autenticación de miembros: el flujo de registro e inicio de sesión que implementa tu sitio.
- Comercio: pedidos, carritos y checkout.
- Miembros y roles: quién del equipo recibe qué permiso.