Cadastro documental

​

Identidade do cadastro

Um cadastro é a dupla organização + documento. O mesmo CNPJ em duas organizações são dois cadastros independentes, e criar de novo o mesmo documento devolve o cadastro que já existe em vez de duplicar.

​

Situação do cadastro

​

Documentos do cadastro

Cada arquivo entregue vira um documento do cadastro, com versão e marca de vigência (isCurrent). Nada é sobrescrito: a alteração contratual nova não apaga a antiga, ela vira a versão vigente e a anterior continua consultável. O ciclo de vida de um documento está em Análise documental.

​

Dados básicos oficiais

O cadastro carrega os dados oficiais do CNPJ ou CPF (razão social, situação cadastral, quadro societário) e pode ser atualizado sob demanda. É contra esses dados que os checks de titularidade confrontam o que foi lido no arquivo.

​

Dados declarados pelo cliente

Tudo o que o cliente respondeu nos formulários das solicitações daquele cadastro fica no próprio cadastro, agrupado por formulário: campos prontos e campos livres. Só entra resposta enviada; a sugestão que ninguém confirmou não é declaração do cliente.

• A resposta mais recente vale. Quando o mesmo campo foi respondido de novo, as respostas anteriores ficam no histórico do campo, e a tela marca Alterado.
• Contestação fica marcada. O campo em que a pessoa discordou do dado oficial sugerido aparece como Contestado.
• Cada campo tem o nome da variável da esteira. É a chave form.<modelo>.<campo>, a mesma dos dados de entrada que fórmulas e regras usam. No toolbox, clicar no nome copia.

No cadastro de pessoa física, a tela também mostra onde ela foi declarada como sócia nos formulários de empresas.

​

Quadro societário

Para um cadastro COMPANY, a plataforma monta o quadro de sócios e administradores juntando quatro origens: O formulário só preenche lacuna: completa o CPF de quem a fonte oficial mostra mascarado e acrescenta o sócio que o quadro ainda não tem. O que o cliente declarou e não casou com ninguém do quadro aparece à parte, em Informados no formulário e fora do quadro, em vez de sumir.

​

Corrigir um sócio

Um operador pode corrigir nome, vínculo, participação e documento de um sócio. A correção fica guardada como da equipe, e a consulta à fonte oficial não a sobrescreve depois. Na tela, o sócio corrigido leva a marca Corrigido pela equipe.

​

Cadastro próprio do sócio

Uma pessoa do quadro pode ganhar cadastro próprio (o CPF dela vira um Registry PERSON), ligado ao da empresa. É assim que se pede documento de sócio sem sair do dossiê da empresa.

​

Contatos

Cada pessoa (o titular do cadastro e cada sócio) tem uma lista de contatos guardada pelo documento dela, e não por solicitação. A lista junta três origens: O mesmo par de e-mail e telefone é o mesmo contato, venha de onde vier. Quem recebe os envios automáticos (como a etapa Solicitação da esteira e o quadro de partes do contrato) é o primeiro da lista: o contato fixado pela equipe, quando existe um; sem escolha, o mais recente. A tela diz o motivo ao lado do contato que recebe. Remover um contato guardado o tira da lista, e o mesmo contato vindo de envios anteriores some junto. Um contato que só existe no histórico pode ser ocultado. Nos dois casos, ele só volta se for usado num envio depois disso.

​

Renovação periódica

O cadastro tem plano de renovação: a data em que ele precisa ser revisitado e para quem o pedido vai. A renovação pode vir da política (POLICY) ou ser uma exceção manual daquele cadastro (MANUAL), com data e contatos próprios. Sem contatos definidos no cadastro, a renovação vai para os destinatários da última solicitação enviada. Quando a renovação dispara, ela cria uma solicitação com origin: RENEWAL, e o cadastro entra em RENEWING. Pausar a renovação é reversível com um clique e mantém o dossiê inteiro.

​

Trilha de auditoria e integridade

Toda ação sobre o cadastro e sobre cada documento entra numa trilha append-only: quem fez, quando, com que id de evento. Não existe update nem delete de linha de trilha, correção se faz gravando uma linha nova. Cada parecer emitido é selado com um contentHash. A rota de integridade recalcula o hash do conteúdo armazenado e compara com o selo gravado na trilha, o que responde “este parecer é o mesmo que foi emitido na época?” sem depender de confiança no banco.

​

Remoção

Cadastro nunca é apagado de verdade: a remoção é lógica (soft delete). E remover exige permissão própria (can-remove-registry), concedida a Administrador, Owner, Superuser e Gestor de Crédito. Analista e coordenador não removem.