Uma arquitetura multi-tenant precisa isolar dados entre clientes e também respeitar as unidades jurídicas e contábeis dentro de cada fundo. Autorização de tela é insuficiente quando consultas e processos de fundo operam sobre uma base compartilhada.
Chaves de tenant, fundo, classe e série têm funções diferentes. Misturá-las numa única coluna permite que relatórios, filas e integrações reutilizem dados de outro contexto sem que a interface exiba qualquer sinal de erro.
A questão decisiva é como demonstrar a passagem entre o fato, o controle e seu efeito. Neste artigo, examinamos o desenho tecnológico com foco em documentos identificáveis, responsabilidades específicas e reconciliação que possa ser refeita depois de uma revisão, fiscalização ou auditoria. O desenho é uma referência metodológica: seu uso depende das regras e dos contratos do fundo envolvido.
O que está em jogo: documentos, posições e decisões
A documentação inicial envolve cadastros de tenant, fundo, classe e usuário. A partir dessa fonte, surgem informações que precisam ser reconhecidas com significado preciso: tenant_id, fundo_id, classe_id e alçadas. Não se trata de reunir todos esses elementos em uma pasta, mas de distinguir qual deles autoriza uma ação, qual representa uma estimativa e qual demonstra um evento consumado. Essa distinção ajuda a evitar que dois profissionais olhem o mesmo relatório e atribuam estados diferentes à operação.
Participam do processo engenharia, segurança, administrador e suporte. Embora suas tarefas se relacionem, o responsável pelo dado não é necessariamente quem decide, executa ou valida. Uma matriz simples deve atribuir a cada atividade uma fonte de informação, um aprovador, uma condição de conclusão e uma forma de comprovação. É particularmente relevante identificar RLS efetiva também nas integrações e jobs, pois esse vínculo determina a ordem correta das etapas.
Como estruturar o controle sem transformar a operação em uma planilha maior
Defina isolamento no banco, autorização no backend e contexto obrigatório em cada tarefa assíncrona. Teste acesso cruzado, filtros omitidos e consultas agregadas. Contabilização e rateio usam a unidade pertinente, enquanto trilhas registram o contexto em que o evento ocorreu.
A implementação precisa reunir quatro camadas, mantidas logicamente separadas:
| Camada | Pergunta que deve responder | Evidência esperada |
|---|---|---|
| Fonte | De onde veio a informação? | Cadastros de tenant, fundo, classe e usuário |
| Regra | Com que parâmetro ela foi interpretada? | Cláusula, política ou versão do controle |
| Decisão | Quem assumiu responsabilidade pelo resultado? | Registro identificável de revisão e aprovação |
| Execução | Qual efeito ocorreu de fato? | Políticas, consultas, trilhas e teste de vazamento |
Uma interface útil exibe os estados de validação, a versão dos parâmetros e as pendências atribuídas. Alterações manuais devem preservar autor, data e justificativa; informações importadas precisam trazer origem e data-base.
Em temas de identidade e privacidade, a pergunta central não é quantos dados se consegue coletar, mas quais são estritamente necessários e por qual finalidade. Para tenant_id, fundo_id, classe_id e alçadas, o controle deve distinguir quem pode visualizar os documentos, quem pode concluir a revisão e quem pode consultar somente o resultado de elegibilidade. O acesso excepcional exige justificativa, registro e revogação verificável; a retenção deve observar a legislação aplicável, sem presumir que um prazo único sirva para todo documento.
Sequência de execução e pontos de aprovação
Um fluxo controlado pode ser organizado em sete etapas. A ordem deve ser adaptada às regras de cada fundo, mas a documentação de cada passagem não é opcional do ponto de vista da rastreabilidade:
- 1.Abrir o registro: vincular cadastros de tenant, fundo, classe e usuário a um identificador estável, preservando a versão recebida e a data da sua captura.
- 2.Qualificar os dados: conferir tenant_id, fundo_id, classe_id e alçadas, incluindo unidades, datas, relações entre pessoas e vínculo com fundo, classe ou ativo.
- 3.Selecionar regras aplicáveis: localizar o documento ou parâmetro vigente na data relevante.
- 4.Examinar dependências: verificar RLS efetiva também nas integrações e jobs. Quando a condição falha, o sistema precisa impedir a próxima etapa ou solicitar decisão justificada.
- 5.Registrar aprovação: identificar quem revisou o material, qual escopo foi aceito e se houve ressalvas.
- 6.Executar e observar o efeito: registrar o resultado financeiro, societário, documental ou tecnológico, conforme aplicável.
- 7.Reconciliar e encerrar: confrontar políticas, consultas, trilhas e teste de vazamento; registrar diferenças e, quando necessário, abrir uma pendência cuja resolução possa ser rastreada.
Exemplo prático: uma decisão que atravessa várias áreas
Uma administradora gerencia duas gestoras com classes de fundos distintas. Um operador pode ter permissão para visualizar ambos os fundos, mas isso não autoriza combinar saldos das classes no mesmo fechamento.
Considere agora uma alteração no cenário depois do primeiro processamento: usuário integra duas gestoras com perfis diferentes. A resposta depende da natureza do evento: às vezes basta ajustar uma projeção; em outras situações é preciso fazer nova aprovação, comunicação, lançamento ou ato jurídico. Por essa razão, a evidência não deve conter apenas o número final. Deve guardar também os insumos e decisões que explicam sua formação.
Considere a situação de usuário integra duas gestoras com perfis diferentes. A resposta correta tende a exigir suspensão de uma permissão, revisão do cadastro ou diligência adicional, conforme o contexto. Nenhum dos eventos deve ser resolvido simplesmente sobrescrevendo o registro anterior. A trilha precisa mostrar quando a alteração foi conhecida, por quem, qual decisão foi adotada e quais acessos ou instruções sofreram efeito.
Falhas recorrentes e como reconhecê-las antes do fechamento
1. Confundir o documento com o efeito. A falha típica é consulta backend ignora escopo de cliente. O controle preventivo é separar estados como recebido, validado, aprovado, executado e conciliado. Assim, uma etapa pode estar documentalmente completa sem que a operação tenha produzido o efeito correspondente.
2. Ignorar condições e exceções. A dependência crítica é RLS efetiva também nas integrações e jobs. Ela não é mero detalhe administrativo: pode alterar o momento ou a validade da ação. O sistema deve pedir uma decisão explícita quando a condição não for comprovada e não converter ausência de documentação em aprovação presumida.
3. Perder a versão aplicável. Informações sobre tenant_id, fundo_id, classe_id e alçadas podem ser atualizadas depois da primeira revisão. Sem data-base e versão, o operador não sabe se uma divergência decorre de erro, atualização legítima ou uso simultâneo de critérios distintos. Preservar snapshots e eventos de retificação mantém os resultados reconstituíveis.
4. Encerrar sem conciliar. O processo parece resolvido porque a tarefa saiu da fila, mas ainda existem diferenças entre os registros utilizados para conferir políticas, consultas, trilhas e teste de vazamento. Encerrar uma atividade não é o mesmo que fechar uma obrigação. O painel deve manter visíveis pendências, prazo, titular e risco, ainda que a etapa principal tenha sido finalizada.
Responsabilidades, segregação e limites da automação
A segregação técnica não altera o regime jurídico de patrimônio de classes ou as competências dos prestadores. Controles de isolamento exigem provas automatizadas, revisões de privilégios e monitoramento contínuo.
Um controle eficaz separa pelo menos a produção da informação, a revisão independente quando exigida, a autorização e a execução. Dependendo do porte e do desenho do prestador, uma pessoa pode desempenhar mais de uma função, mas a política de alçadas precisa registrar o tratamento do conflito de interesses e a justificativa de exceções. Para eventos materiais, convém que o registro mostre a base documental que sustentou a autorização.
Separação visual não significa isolamento de dados. A regra precisa ser testada contra os documentos e o processo real antes de gerar efeitos financeiros, societários ou regulatórios.
Indicadores de qualidade e de risco operacional
Três medidas são particularmente úteis para acompanhar a maturidade de arquitetura multi-tenant:
- ●Falhas de isolamento em testes adversariais: acompanhar o resultado por período, classe e motivo de exceção, não apenas a média agregada. O indicador perde valor quando a equipe muda o critério de contagem sem registrar a alteração.
- ●Operações sem contexto completo: comparar a base atual com uma linha de partida, separando ocorrências identificadas automaticamente das reconhecidas pela revisão humana.
- ●Permissões excessivas por função: acompanhar a evolução da pendência até a conciliação documental ou financeira definitiva; registrar os casos não resolvidos e o prazo de atuação.
Roteiro de implantação e validação antes de escalar
Modelo de informação e regras. Defina identificadores, estados e campos obrigatórios para tenant_id, fundo_id, classe_id e alçadas. Desenhe a regra com participação de quem responde por ela; diferencie campos que exigem interpretação daqueles calculáveis automaticamente. Documente a origem e a validade temporal das referências.
Prova de execução com dados controlados. Teste o fluxo normal e um cenário adverso: usuário integra duas gestoras com perfis diferentes. Verifique duplicidades, dados incompletos, atualizações posteriores, troca de responsável e indisponibilidade de integrações. Não use dados pessoais ou financeiros reais em laboratórios sem base e controles adequados.
Reconciliação paralela. Durante a adoção, compare o resultado novo com as fontes relevantes para políticas, consultas, trilhas e teste de vazamento e com o fluxo atual. Registre diferenças sem presumir que o sistema legado é sempre correto; identifique a evidência que justifica cada ajuste. A passagem para produção deve depender de critérios de aceite definidos previamente.
Perguntas frequentes
Quais evidências tornam o processo verificável?
A resposta depende do ato praticado, mas começa com cadastros de tenant, fundo, classe e usuário, os parâmetros utilizados e a identificação de quem revisou o material. Em seguida, é necessário mostrar o efeito nos registros pertinentes: políticas, consultas, trilhas e teste de vazamento. Uma captura de tela isolada prova pouco quando não permite consultar a versão do documento, as condições analisadas e a data de eficácia do ato.
O que pode ser automatizado e o que requer decisão humana?
Cálculos repetíveis, extração de campos, consistências formais e comparações com regras aprovadas são bons candidatos a automação. Situações que envolvem RLS efetiva também nas integrações e jobs, interpretação contratual ou impacto material exigem um desenho explícito de revisão. Automatizar não significa retirar responsabilidade do participante regulado, mas tornar sua decisão informada e verificável.
Referências regulatórias e conclusão
A avaliação regulatória deve considerar, conforme o participante e a atividade, as obrigações de prevenção à lavagem de dinheiro e financiamento do terrorismo da Resolução CVM 50, a LGPD e as regras contratuais aplicáveis. Identidade e classificação de risco são informações dinâmicas. Evidência criptográfica, assinatura ou autenticação não dispensam deveres de diligência, qualidade do cadastro nem revisão periódica.
Para aprofundar a verificação, consulte as fontes primárias abaixo e confirme a redação vigente, inclusive anexos, documentos específicos do fundo e alterações posteriores:
O desafio correspondente de operação de fundos está no artigo das 10h: Classes e séries em FIP sob a RCVM 175: impactos na operação, contabilidade e tecnologia. A análise tecnológica não substitui a definição operacional de direitos, responsáveis e evidências.