Associados — Campos

1. `users` (responsável e paciente)

Mesma tabela. Distinção por status / responsible_code.

Identidade e contato

Campo	Tipo	Notas
`id`	serial	PK
`user_code`	uuid	Público, UNIQUE
`fullname`	varchar	Nome completo (busca)
`associate_name`	varchar	Nome
`associate_last_name`	varchar	Sobrenome
`email_account`	varchar	Login / contato
`mobile_number`	varchar	Telefone
`associate_cpf`	varchar	CPF
`associate_rg`	varchar	RG
`associate_rg_issuer`	varchar	Órgão
`associate_birth_date`	varchar	Nascimento
`gender`	varchar
`nationality`	varchar
`marital_status`	varchar
`avatar_url`	varchar

Endereço

Campo	Notas
`street`, `street_number`, `complement`, `neighborhood`, `city`, `state`, `cep`	Form dados pessoais
`delivery_address`	JSONB (entrega) — se usado em pedidos

Funil e tipo

Campo	Tipo	Notas
`associate_status`	int	Fases 1–5 do app de cadastramento
`status`	varchar	`Associado` · `patient`
`invalid_fields`	text/json	Campos inválidos do funil
`created_date` / `date_created`	timestamp	Coluna “Criado”

Vínculo responsável ↔ paciente

Campo	Onde	Papel
`responsible_code`	no paciente	FK → `users.user_code` do responsável
`responsible_type`	no responsável (funil)	`himself` · `another` · `pet`
`patient_user_code`	no responsável	Ponteiro do funil (`another`) → paciente cadastrado; pré-seleciona beneficiário em Serviços; não é flag “ativo” editável no painel

Relação canônica para listar pacientes: WHERE responsible_code = :associate_user_code.

Clínica / prescritor

Campo	Notas
`reason_treatment_text`	Motivo (texto)
`ciap_codes`	CIAP2 (JSON/texto)
`prescriber`	Nome texto livre
`prescriber_code`	Código opcional (não obrigatório vincular a `professionals`)
`date_prescription`	Data da receita
`prescription`	Receita (preferir também `users_files` doc_kind=prescription)

Anotações e termo

Campo	Notas
`annotations`	JSON array — anotações da equipe
`adhesion_term`	Ref do termo — vazio até módulo termos ativo
`handbook`	Manual / observações livres se existir

Documentos (junction)

Preferir users_files + files. A UI usa metadados de arquivo (doc_type, side, subject); documents_folder_id é server-side.

2. Anotações — shape JSON

[
 {
 "id": "uuid-ou-timestamp",
 "text": "Retornar contato amanhã",
 "date_created": "2026-07-12T15:00:00.000Z",
 "userName": "Maria Silva",
 "user_code": "uuid-do-system-user"
 }
]

Persistência: PATCH em users.annotations (string JSON ou JSONB conforme coluna).

3. `users_files` + tipos de documento

Ver apps/kunk/src/lib/documentKinds.js:

key	Label UI	prefix	doc_kind	subject
`identity_responsible`	Documento do Associado	`doc-associado-`	`identity`	`responsible`
`identity_patient`	Documento do paciente	`doc-paciente-`	`identity`	`patient`
`prescription`	Receita	`receita-`	`prescription`	—
`report`	Laudo	`laudo-`	`report`	—
`exam`	Exame	`exame-`	`exam`	—

Filename: {prefix}{nome}-{sobrenome}-{user_code}.{ext} (sem acentos/espaços).

4. `services` — beneficiário do atendimento

Campos existentes + ajuste:

Campo	Tipo	Obrigatório	Notas
`associate_user_code`	uuid	sim	Sempre o responsável
`associate_name` / `associate_email`	snapshot	sim / não	Do responsável
`patient_user_code`	uuid	novo (nullable)	Paciente escolhido; `null` = atendimento ao responsável
`patient_name`	varchar	não	Snapshot do nome do paciente (ou vazio se só responsável)

Observações / calendário: se patient_user_code preenchido, template inclui bloco Responsável + Paciente; senão só associado.

Campo / UI histórico	Motivo
`partner` / PartnerForm	Sem aba Parceiro
`bvid`	Não disponível neste produto
payload `contract`	UI trata módulo de termos como indisponível
`responsible_for` ativo na UI	Substituído por seleção em Serviços