Estruturando entidades para altos volumes de transação
Particionamento por Organizações, Ledgers e Contas
Se o seu banco processa milhões de transações por dia, distribua a carga entre muitas contas, ledgers ou organizações. Por exemplo, segmente clientes pela inicial do sobrenome, ou atribua um ledger separado para cada região. Cada ledger do Midaz é um livro independente.Operações orientadas a locks
O Midaz aplica as mudanças de saldo de cada transação em um único script Lua do Redis. O script verifica cada saldo contra o estado atual antes de gravar, então uma transação recusada não altera nenhum saldo. A conta@external ignora as verificações de piso de saldo e de overdraft. Ela pode ficar negativa sem limite, então as transações contra ela nunca falham por falta de fundos disponíveis. Cada transação ainda é confirmada atomicamente. Todas as operações são aplicadas, ou nenhuma é.
Escalonamento horizontal de serviços
O ledger do Midaz roda como um único serviço que reúne onboarding, transações, CRM e Fees. Você o escala adicionando instâncias. Comece pequeno e adicione instâncias conforme a demanda cresce. Para cargas altas, faça o deploy de várias instâncias do serviço do ledger atrás de um load balancer. Use o escalonamento de pods do Kubernetes (K8s).CQRS e réplicas de leitura
O Midaz usa CQRS (Command Query Responsibility Segregation) para separar as operações de escrita e leitura. Você otimiza cada caminho de forma independente. Direcione cargas pesadas de relatórios e consultas para réplicas de leitura. Isso mantém as confirmações de transações rápidas.Processamento em lote e transações N:N
Quando possível, agrupe operações relacionadas em uma única transação. Isso reduz a sobrecarga. Use transações N:N para trabalhos em massa, como pagamentos em massa. Por exemplo, um lote de 100 débitos e 100 créditos costuma ser mais rápido do que 100 transações separadas. Isso funciona quando as operações pertencem ao mesmo conjunto lógico. O Midaz processa essas transações N:N em uma única confirmação atômica.Monitoramento e escalonamento iterativo
Monitore as métricas principais: latência de transação, throughput, uso de recursos (CPU e memória) e desempenho do banco de dados. Use as ferramentas de observabilidade do Midaz (OpenTelemetry e Grafana), ou envie as métricas para sua própria stack de monitoramento. Escale horizontal ou verticalmente antes de atingir um limite de desempenho. O Midaz é modular, então você faz o deploy das partes que precisa.Lidando com Operações multimoeda e multientidade
Estratégias multimoeda
O Midaz aceita várias moedas com uma conta separada para cada moeda. Cada transação movimenta um único ativo. Para escalar bem:- Configure cada ativo de moeda que você precisa.
- Trate a lógica específica de moeda (como arredondamento e taxas de conversão) na sua camada de integração.
- Para conversão frequente de moeda, como negociação forex, execute a conversão em um serviço separado. O Midaz registra os débitos e créditos, mas um serviço externo de taxas de câmbio fornece as taxas.
- Raramente você precisa de um ledger separado por moeda, a menos que a política exija. Em vez disso, use tipos de conta e a API de roteamento de transações para agrupar contas por moeda para relatórios claros.
- Se uma moeda cobre a maioria das transações, mantenha todas as moedas no mesmo ledger. Se as operações multimoeda ficarem complexas demais, divida-as em um ledger separado por grupo de moeda.
Múltiplas Entidades: consolidação e separação
Para um banco que opera em vários países ou entidades legais:- Use a hierarquia de organizações para segmentar entidades. Dê a cada entidade sua própria moeda base, ativos locais e ledgers.
- Modele transações entre entidades como movimentos externos. Uma organização credita sua conta externa, e a outra debita a própria conta.
- Você pode rodar várias organizações em uma única instância do Midaz. Aloque recursos suficientes: as mesmas instâncias do ledger processam as requisições de todas as organizações, então o volume total importa.
- Você pode fazer o deploy de uma instância separada do Midaz por entidade isolada, mas perde a visibilidade unificada. Um único cluster com separação interna de organizações costuma ser mais prático.
Boas práticas de otimização de desempenho
Indexação e consultas
Use as APIs do Midaz para ler dados, não consultas diretas ao banco de dados. Essas APIs carregam índices predefinidos para os identificadores principais: contas, portfólios e transações.Indexação de campos de metadados personalizados
Crie os índices que você precisa explicitamente pela API de Índice de Metadados. Por padrão, o Midaz não indexa campos de metadados personalizados. Os clientes preenchem esses campos como pares chave-valor planos. Consultas ou filtros frequentes em campos não indexados podem disparar varreduras completas da coleção. Essas varreduras ficam mais lentas conforme o volume de dados cresce. Crie um índice quando você usar regularmente um campo de metadados personalizado em filtros de busca. Com um índice, o MongoDB encontra os documentos rápido e reduz o tempo de resposta das consultas. Recomendações:- Indexe apenas os campos de metadados que você consulta com frequência.
- Não indexe campos raramente acessados, porque cada índice extra adiciona sobrecarga de escrita.