Clientes (Pessoas)
Clientes são representados pelo modelo Pessoa (Person) com diferentes tipos conforme o contexto.
Tipos de Pessoa
| Tipo | Descrição |
|---|---|
organization | Tenant/organização que usa a plataforma |
customer | Cliente de uma organização |
contact | Contato secundário |
Campos do Cliente
| Campo | Descrição |
|---|---|
| Nome | Nome ou razão social |
| Apelido | Nome fantasia |
| Nome legal | Razão social completa |
| Tipo de documento | CPF ou CNPJ |
| Número do documento | Normalizado (apenas dígitos) |
| Natureza | natural (pessoa física) ou juridical (pessoa jurídica) |
| Data de nascimento | Opcional |
| Endereços | Lista de endereços (JSON) |
| Telefones | Lista de telefones (JSON) |
| E-mails | Lista de e-mails (JSON) |
| Sites | Lista de websites (JSON) |
| Tags | Lista de tags para categorização |
| Notas | Observações internas |
| Dados personalizados | Campos customizados (JSON) |
Hierarquia
Clientes pertencem a uma organização via o campo parent_id:
Organização (type=organization, parentId=null)
├── Cliente A (type=customer, parentId=org_id)
├── Cliente B (type=customer, parentId=org_id)
└── Contato (type=contact, parentId=org_id)
Validações
- Número de documento único dentro da organização
- Código externo (
external_id) único por organização - Restrições no formato do documento: CPF (11 dígitos) ou CNPJ (14 dígitos)
Capturas de tela
Lista de clientes
A tela /dashboard/customers lista clientes da organização com busca por nome, documento ou e-mail. A tabela mostra documento, e-mail, total de contas de cobrança vinculadas e MRR consolidado.
Detalhe do cliente
A página /dashboard/customers/[id] reúne dados cadastrais, contas de cobrança vinculadas, assinaturas, faturas, pagamentos, NF-e e auditoria — tudo em um único contexto para suporte e financeiro.
