Schema: Cliente¶

Schema para cadastro de clientes (pessoa física ou jurídica).

Campos Obrigatórios¶

# Identificação Johnny.Decimal
jd_id: "21.XX"           # ID único no sistema JD
jd_area: "Comercial"     # Área 20-29
jd_categoria: "Clientes" # Categoria 21

# Metadados
tipo: "cliente_pf"       # cliente_pf | cliente_pj
titulo: "Nome do Cliente"
data_criacao: "YYYY-MM-DD"
data_modificacao: "YYYY-MM-DD"
tags: [cliente, pessoa-fisica]  # ou pessoa-juridica
status: "ativo"          # ativo | inativo | prospecto

# Dados principais
nome_completo: "NOME COMPLETO"

Campos Pessoa Física (cliente_pf)¶

cpf: "XXX.XXX.XXX-XX"
rg: "XXXXXXX"
data_nascimento: "YYYY-MM-DD"
local_nascimento: "Cidade/UF"
nacionalidade: "Brasileiro(a)"
sexo: "M"                # M | F
estado_civil: "Solteiro" # Solteiro | Casado | Divorciado | Viúvo | União Estável

# Filiação
pai: "Nome do Pai"
mae: "Nome da Mãe"

Campos Pessoa Jurídica (cliente_pj)¶

cnpj: "XX.XXX.XXX/XXXX-XX"
razao_social: "Razão Social Ltda"
nome_fantasia: "Nome Fantasia"
inscricao_estadual: "XXXXXXX"
inscricao_municipal: "XXXXXXX"
data_fundacao: "YYYY-MM-DD"

# Representante Legal
representante_nome: "Nome do Representante"
representante_cpf: "XXX.XXX.XXX-XX"
representante_cargo: "Sócio Administrador"

Campos de Contato¶

telefone: "+55XXXXXXXXXXX"   # Formato WhatsApp
telefone_secundario: ""
email: "email@exemplo.com"
email_secundario: ""

# Endereço
endereco_rua: "Rua Exemplo"
endereco_numero: "123"
endereco_complemento: "Apto 101"
endereco_bairro: "Centro"
endereco_cidade: "Curitiba"
endereco_uf: "PR"
endereco_cep: "80000-000"

Campos de Documentos Anexados¶

# Array de documentos com URLs do MinIO
anexos:
  - tipo: "cnh"
    descricao: "CNH - Carteira Nacional de Habilitação"
    url: "https://s3.danardi.msgy.ai/clientes/XXXXXXXXXXX/cnh_2026-02-01.pdf"
    data_upload: "2026-02-01"
    validade: "2035-08-14"

  - tipo: "passaporte"
    descricao: "Passaporte Brasileiro"
    url: "https://s3.danardi.msgy.ai/clientes/XXXXXXXXXXX/passaporte_2026-02-01.pdf"
    data_upload: "2026-02-01"
    validade: "2034-12-26"

  - tipo: "visto"
    descricao: "Visto Americano B1/B2"
    url: "https://s3.danardi.msgy.ai/clientes/XXXXXXXXXXX/visto_eua_2026-02-01.jpg"
    data_upload: "2026-02-01"
    validade: "2035-10-27"
    pais: "EUA"
    tipo_visto: "B1/B2"

Tipos de Anexos Suportados¶

Tipo	Descrição
`cnh`	Carteira Nacional de Habilitação
`rg`	Documento de Identidade
`cpf`	Comprovante de CPF
`passaporte`	Passaporte
`visto`	Visto de entrada em país estrangeiro
`comprovante_residencia`	Comprovante de residência
`contrato_social`	Contrato social (PJ)
`procuracao`	Procuração
`certidao`	Certidões em geral
`outro`	Outros documentos

Campos de Integração¶

# PostgreSQL
pg_table: "clients"
pg_id: "uuid-do-registro"

# Neo4j
neo4j_node_id: "uuid-do-node"

Campos Específicos de Documentos¶

CNH¶

cnh_numero: "XXXXXXXXXXX"
cnh_categoria: "B"        # A | B | AB | C | D | E
cnh_primeira_habilitacao: "YYYY-MM-DD"
cnh_validade: "YYYY-MM-DD"
cnh_emissao: "YYYY-MM-DD"

Passaporte¶

passaporte_numero: "XXXXXXXX"
passaporte_emissao: "YYYY-MM-DD"
passaporte_validade: "YYYY-MM-DD"
passaporte_autoridade: "DPF/XXX/XX"

Visto¶

visto_pais: "EUA"
visto_tipo: "B1/B2"
visto_numero: "XXXXXXX"
visto_emissao: "YYYY-MM-DD"
visto_validade: "YYYY-MM-DD"
visto_consulado: "Porto Alegre"
visto_entradas: "M"       # M (múltiplas) | S (única)

Exemplo Completo (PF com Anexos)¶

---
jd_id: "21.01"
jd_area: "Comercial"
jd_categoria: "Clientes"
tipo: "cliente_pf"
titulo: "João da Silva"
data_criacao: "2026-02-01"
data_modificacao: "2026-02-01"
tags: [cliente, pessoa-fisica, curitiba]
status: "ativo"

nome_completo: "JOÃO DA SILVA"
cpf: "123.456.789-00"
rg: "12345678 SSP/PR"
data_nascimento: "1985-05-15"
local_nascimento: "Curitiba/PR"
sexo: "M"

pai: "José da Silva"
mae: "Maria da Silva"

telefone: "+5541999999999"
email: "joao@email.com"

cnh_numero: "12345678901"
cnh_categoria: "B"
cnh_validade: "2030-05-15"

anexos:
  - tipo: "cnh"
    descricao: "CNH"
    url: "https://s3.danardi.msgy.ai/clientes/12345678900/cnh_2026-02-01.pdf"
    data_upload: "2026-02-01"
    validade: "2030-05-15"

pg_table: "clients"
pg_id: "uuid-xxxxx"
---

Notas¶

URLs: Sempre usar URLs externas do MinIO para garantir acesso permanente
Formatos aceitos: PDF, JPG, PNG, WEBP
Nomenclatura: {tipo}_{data}.{ext} (ex: cnh_2026-02-01.pdf)
Organização MinIO: clientes/{cpf_cnpj_sem_pontos}/{arquivo}