[Desatualizado]Fluxo de funcionamento
Gestão de Portfolio — Fluxograma e Apresentação de Negócio
Propósito: apresentar de ponta a ponta o funcionamento do módulo de Gestão de Portfolio para audiência de negócio. Cobre desde o setup inicial da empresa até o ciclo operacional de contratos, parcelas, baixas, inadimplência e visão de clientes na carteira. Cada fluxo traz o diagrama visual + regras de negócio chave.
1. O que é este módulo
Entidades principais (em uma frase cada)
| Entidade | O que é |
|---|---|
| Empresa | A pessoa jurídica dona da carteira (cliente da Nagro). |
| Portfolio (Carteira) | Agrupamento de carteiras. Uma empresa pode ter várias. |
| Carteira | Agrupamento obrigatório dentro de um portfolio. Onde os contratos vivem efetivamente (nome técnico: SubPortfolio). |
| Template de Contrato | Molde que define como os contratos serão preenchidos. |
| Dictionary | Catálogo da plataforma com os campos base de cada tipo de instrumento. |
| Contrato | Instrumento jurídico-financeiro com participantes, parcelas e garantias. |
| Participante | Credor, devedor ou garantidor do contrato (sempre um Client). |
| Parcela (Pagamento) | Obrigação de pagamento individual com vencimento. |
| Baixa | Registro de recebimento de uma parcela. |
| Colateral | Garantia (real ou fidejussória) vinculada ao contrato. |
| Client | Pessoa física ou jurídica cadastrada no AgRisk, que aparece nos contratos. |
2. Hierarquia geral
3. Fluxo 1 — Setup inicial da empresa
4. Fluxo 2 — Templates e o Dictionary
| Princípio | Implicação |
|---|---|
| Template é um snapshot | O template captura as camadas 1 e 2 do Dictionary no momento da criação. Fica autocontido — não consulta o Dictionary depois. |
| Mudanças no Dictionary não afetam templates existentes | Quando o AgRisk evolui o Dictionary, só novos templates capturam a mudança. |
| Refresh opcional do snapshot | A empresa pode optar por atualizar um template existente para a versão mais nova do Dictionary, preservando a camada 3 (customizações próprias). |
| Tipo OTHER | Quando o template é do tipo OTHER, a camada 2 fica vazia — toda especificidade vem da camada 3. |
5. Fluxo 3 — Criação de um contrato
6. Fluxo 4 — Ciclo de vida do contrato
1.
2.
7. Fluxo 5 — Ciclo de vida da parcela
OVERDUE move parcelas PENDING ou PARTIALLY_PAID com dueDate ultrapassado para OVERDUE.PARTIALLY_PAID vai para OVERDUE, o histórico de baixas anteriores é preservado (no campo receivedAmount acumulado).DEFAULTED lê o daysToDefault do contrato (configurável por contrato) e move parcelas em atraso há mais de N dias.daysToDefault não estiver configurado no contrato, a transição automática para DEFAULTED não ocorre — só manual.8. Fluxo 6 — Registro de uma baixa (recebimento)
| Campo | Origem | Significado |
|---|---|---|
calculatedInterestAmount | Sistema | Juros que o sistema calculou (baseado em dailyInterestPercentage × dias de atraso). Imutável. |
chargedInterestAmount | Usuário | Juros efetivamente cobrados. Pode ser igual ou diferente do calculado. |
calculatedFineAmount / chargedFineAmount | Mesma lógica | Multa calculada vs. cobrada. |
calculatedDiscountAmount / chargedDiscountAmount | Mesma lógica | Desconto calculado vs. concedido. |
9. Fluxo 7 — Cancelamento de uma baixa (correção de erro)
10. Fluxo 8 — Inadimplência e jobs programados
| Cenário | Recomendação |
|---|---|
Cliente comunica formalmente que não vai pagar antes do prazo daysToDefault | Manual — gestor marca DEFAULTED imediatamente. |
| Cliente apenas atrasou, ainda há expectativa de regularização | Deixa o automático rodar — gestor não interfere. |
| Operação está em processo de renegociação | Manual — gestor marca RENEGOTIATED quando o novo contrato é criado. |
| Erro operacional (parcela criada errada) | Manual — gestor marca CANCELLED. |
11. Fluxo 9 — Visão de Clientes na Carteira
DEBTOR em pelo menos um contrato não cancelado.collectionStatus:Cliente → collectionStatus) avalia e detecta transições, emitindo eventos de domínio (ex.: cliente entrou em CRITICAL) para consumo futuro por módulos de cobrança/notificação.12. Visão consolidada — Fluxo end-to-end
13. Conceitos-chave
13.1. Hierarquia + Visibilidade
"Cada empresa organiza seus contratos em um ou mais portfolios (silos isolados, geralmente por safra, filial ou tipo de operação). Dentro de cada portfolio existem uma ou mais carteiras — é onde os contratos efetivamente vivem (por gestor, região, produto, etc.). Quem vê o quê é controlado por atribuição direta ao portfolio ou à carteira — não há mágica."
13.2. Templates flexíveis com snapshot
"Cada tipo de contrato (CPR, CCB, duplicata) tem campos pré-definidos pela plataforma, e a empresa adiciona campos próprios conforme sua operação. Quando o template é criado, ele captura uma fotografia dos campos base — se a plataforma evoluir depois, contratos antigos continuam funcionando. A empresa decide quando atualizar."
13.3. Modelo de participantes flexível
"Em vez de um único 'cliente', cada contrato tem participantes tipados: credores, devedores e garantidores. Suporta cessão, cofinanciamento, devedores solidários e avalistas — situações comuns em crédito agro."
13.4. Snapshot duplo nas baixas
"Quando uma baixa é registrada, o sistema captura dois snapshots: o que ele calculou (multa, juros) e o que foi efetivamente cobrado. Isso permite registrar acordos comerciais (desconto, perdão de mora) sem perder rastreabilidade."
13.5. Sem editar, só cancelar
"Baixas são imutáveis após criação. Para corrigir erros, cancela e cria nova — modelo padrão da indústria financeira. Garante auditoria completa."
13.6. Inadimplência híbrida
"O sistema monitora automaticamente (job noturno) quando parcelas vencem, calcula encargos diariamente e propaga o status para o contrato. Em paralelo, o gestor pode intervir manualmente quando reconhece formalmente uma inadimplência ou registra uma renegociação."
13.7. Cliente na carteira em tempo real
"A visão de clientes mostra quem deve, quanto deve, há quanto tempo. Calculado em tempo de leitura — sempre reflete o estado atual. Detecta transições (ex.: cliente entrou em CRITICAL) e fica pronto para integrar com módulos futuros de cobrança e notificação."
Modificado em 2026-06-02 14:59:53