Overview do domínio · Pessoas
Registro único de pessoas
O domínio Pessoas mantém o registro único de toda pessoa física ou jurídica que se relaciona com o escritório em qualquer papel: cliente, contraparte, parceiro, associado, perito, juiz, servidor, prestador, advogado externo ou usuário interno. Ele concentra a identidade civil, os dados cadastrais e a origem desse relacionamento com o escritório.
Os demais domínios referenciam a Pessoa em vez de manter cadastros próprios. Esse registro conecta clientes e partes, vínculos profissionais e associativos, contas de acesso, unidades de negócio, atividades e compromissos.
Conceitos principais
| Conceito | Significado |
|---|---|
| Pessoa | Pessoa física ou jurídica que se relaciona com o escritório. |
| Papel na Relação | Condição em que a Pessoa se relaciona com o escritório, distinta do Perfil de Acesso que define o que um usuário pode fazer. |
| Núcleo responsável | Setor responsável pelo cadastro, usado na definição do alcance de acesso. |
| Origem do Cliente | Unidade, momento e forma de apuração da chegada da pessoa ao escritório. |
| Indicação e canal de chegada | Quem trouxe a pessoa e por qual meio ela chegou. |
| Relacionamento entre Pessoas | Laço de família ou amizade entre pessoas cadastradas. |
| Registro de relacionamento | Expectativa, Preferência, Afinidade ou Atenção registrada sobre a Pessoa, com autoria e data. |
| Unidade de atendimento habitual | Escritório físico onde a pessoa costuma ser atendida, informado no cadastro. |
| Nota de atendimento | Registro simplificado de atendimento na ficha, com texto, satisfação, autor e data; distinto do Registro de Atendimento. |
| Representado e Representação | O Representado integra um catálogo institucional; a Representação o vincula ao advogado externo. Isso evita duplicar cadastros de empresas e órgãos apenas para registrar quem o advogado representa. |
| Conta da Pessoa | Conta de acesso vinculada à Pessoa. É opcional; pessoa sem conta é o caso comum. |
| Cliente da Carteira | Vínculo que indica a Carteira à qual o cliente pertence hoje. |
| Alcance efetivo | Conjunto de registros que o ator pode ler e alterar. |
Os atributos, classificações e relações estão detalhados em Entidades e relacionamentos.
Escopo e fronteiras
Pessoas reúne os dados civis, contatos, endereços, documentos de identificação, contas bancárias (dados bancários) e inscrição na OAB. Também mantém papéis, núcleos responsáveis, originação, indicação, canais de chegada, laços de família e amizade e o catálogo de Representados.
O domínio oferece consulta de aniversariantes, checklist de documentos, trilha de alterações e importação de cadastros legados. O cadastro pode iniciar vínculos cuja gestão pertence a outros domínios:
| Domínio responsável | Relação com Pessoas |
|---|---|
| Identidade e acesso | Gerencia usuários, contas, perfis de acesso e identidade Appwrite; Pessoas pode iniciar a criação da conta. |
| Expansão | Gerencia Carteiras, Clientes da Carteira, transferências, Associações e Participações Associativas. |
| Quadro de Pessoal | Gerencia vínculos profissionais e lotações; a lotação participa da definição do alcance do ator. |
| Organização | Gerencia núcleos, áreas e unidades de negócio; uma Pessoa jurídica pode representar uma unidade. |
| Processos, Atendimento e Entrevistas | Referenciam a Pessoa como cliente, parte ou participante em seus registros e solicitações. |
| Workspace | Referencia a Pessoa em atividades e compromissos. |
| Documentos e dossiês; Integrações | Vinculam dossiês, anexos, espelhos Projuris e tickets DigiSac à Pessoa. |
| Histórico | Mantém o histórico operacional unificado consultado a partir da Pessoa. |
Atores e responsabilidades
| Ator | Responsabilidade |
|---|---|
| Usuários autenticados | Consultam pessoas e informações relacionadas dentro do seu alcance. |
| Operadores com Acesso de Núcleo ou superior | Cadastram pessoas, confirmam documentos e mantêm o catálogo de Representados. |
| Autores, membros de núcleos responsáveis e associados de carteira | Consultam e editam as pessoas que estão no seu alcance. |
| Operadores com acesso institucional | Alcançam todas as pessoas; a abertura de contas exige Acesso Global. |
| Gestão de Expansão Institucional (EXPINS) | Gerencia a condição de cliente, o vínculo com Carteiras e a abertura de Associações. |
| Presidência (PRES) | Altera a originação após o cadastro. |
As condições de acesso e suas exceções estão em Regras de negócio; as necessidades dos atores estão em Histórias do usuário.
Visão geral do cadastro
O cadastro reúne a identidade e os dados da Pessoa e, conforme seus papéis e os dados informados, pode abrir uma conta de acesso ou uma Associação, criar a Carteira própria do parceiro, vincular um cliente à Carteira e registrar quem um advogado externo representa. O registro de unidades de negócio pertence a Organização.
Superfícies entregues
O domínio disponibiliza o acervo em /pessoas, o cadastro em etapas em /pessoas/nova, a ficha em /pessoas/{id} e a edição em /pessoas/{id}/editar. A ficha reúne Atendimento, Atividades, Documentos e dossiê, relações, entrevistas, processos e o painel Cadastro completo. A relação entre essas superfícies, seus Route Handlers e as operações sem consumidor visual está no Sitemap.
Os fluxos críticos complementam as Histórias do usuário. Os campos, operações e respostas estão na API Reference.