Skip to content

Usuários ​

Gestão de usuários por empresa. Cada criação/alteração grava o usuário e um evento de outbox na mesma transação — então o provisionamento de usuário sincroniza para os nodes locais (login offline).

MétodoRotaAuthDescrição
GET/api/usersusers:readlista usuários da empresa atual
POST/api/usersusers:writecria usuário (emite evento de sync)
GET/api/users/:idusers:readdetalhe + roles
PATCH/api/users/:idusers:writeatualiza (nome, ativo)
POST/api/users/:id/deactivateusers:writedesativa (lógico, nunca apaga)
POST/api/users/:id/rolesusers:manage_rolesatribui um role
DELETE/api/users/:id/roles/:roleIdusers:manage_rolesremove um role

Criar usuário ​

bash
curl -X POST $BASE/api/users -H "authorization: Bearer <token>" -H 'content-type: application/json' \
  -d '{ "email": "recepcao@clinica.example", "password": "********", "fullName": "Recepção 1", "roleIds": [] }'

A senha trafega como hash bcrypt no payload do evento (nunca em texto puro), sobre transporte criptografado, para permitir login offline após sincronizar.