Tema
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étodo | Rota | Auth | Descrição |
|---|---|---|---|
| GET | /api/users | users:read | lista usuários da empresa atual |
| POST | /api/users | users:write | cria usuário (emite evento de sync) |
| GET | /api/users/:id | users:read | detalhe + roles |
| PATCH | /api/users/:id | users:write | atualiza (nome, ativo) |
| POST | /api/users/:id/deactivate | users:write | desativa (lógico, nunca apaga) |
| POST | /api/users/:id/roles | users:manage_roles | atribui um role |
| DELETE | /api/users/:id/roles/:roleId | users:manage_roles | remove 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.