Quartz 4

schema-cliente

3 min read

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.denardi.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.denardi.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.denardi.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

TipoDescrição
cnhCarteira Nacional de Habilitação
rgDocumento de Identidade
cpfComprovante de CPF
passaportePassaporte
vistoVisto de entrada em país estrangeiro
comprovante_residenciaComprovante de residência
contrato_socialContrato social (PJ)
procuracaoProcuração
certidaoCertidões em geral
outroOutros 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.denardi.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}

Graph View

Backlinks