Tema
Pacientes
Cadastro de pacientes por empresa. Toda rota exige um token de usuário da empresa (Authorization: Bearer <token>); os registros são sempre escopados pela empresa atual (companyId do token), nunca por parâmetro.
| Método | Rota | Auth | Descrição |
|---|---|---|---|
| GET | /api/patients | Bearer | lista pacientes da empresa (filtros + paginação) |
| GET | /api/patients/convenios | Bearer | convênios disponíveis (para filtro e formulário) |
| GET | /api/patients/:id | Bearer | detalhe de um paciente |
| POST | /api/patients | Bearer | cadastra um paciente |
| PATCH | /api/patients/:id | Bearer | atualiza o cadastro (campos parciais) |
Listar pacientes
Aceita filtros por busca livre (q — nome, CPF, carteirinha ou prontuário), convenio (nome exato) e uf, além de paginação (page ≥ 1, perPage 1–100, padrão 9).
bash
curl "$BASE/api/patients?q=maria&convenio=Unimed&page=1&perPage=9" \
-H "authorization: Bearer <token>"A resposta é um envelope paginado com um resumo da empresa (independente dos filtros):
json
{
"items": [ { "id": "…", "prontuario": "10003", "nome": "Maria Silva", "cpf": "12345678901", "convenio": "Unimed", "celular": "61988887777" } ],
"total": 42,
"page": 1,
"perPage": 9,
"summary": { "total": 42, "novos": 3, "aniversariantes": 1 }
}Cadastrar paciente
bash
curl -X POST $BASE/api/patients -H "authorization: Bearer <token>" -H 'content-type: application/json' \
-d '{
"nome": "Maria Silva",
"cpf": "123.456.789-01",
"sexo": "F",
"nascimento": "1990-05-12",
"convenio": "Unimed",
"celular": "(61) 98888-7777"
}'DTO & validação
| Campo | Obrigatório | Regra |
|---|---|---|
nome | sim | string, 2–120 caracteres |
cpf | sim | CPF válido (dígitos verificadores); formatação é removida e armazenada como dígitos crus |
sexo | sim | F ou M |
nascimento | sim | data YYYY-MM-DD |
convenio | sim | string (nome do convênio; Particular zera a carteirinha) |
celular | sim | apenas dígitos, 10 ou 11 (formatação removida na entrada) |
carteirinha | não | string ou null |
cidade | não | string |
estado | não | string (UF) |
telefone | não | apenas dígitos, 10 ou 11, ou null |
email | não | e-mail válido |
CPF e telefones são normalizados para dígitos crus na entrada:
123.456.789-01→12345678901,(61) 98888-7777→61988887777. O CPF passa por validação dos dígitos verificadores. O número do prontuário é gerado pelo backend; não é enviado no cadastro.
PATCH /api/patients/:id aceita os mesmos campos, todos opcionais — apenas os enviados são alterados.