Pular para o conteúdo principal
Este diagrama mostra como os principais blocos de construção do Midaz se conectam para suportar operações financeiras em escala. Em , você pode encontrar uma visão geral do funcionamento do sistema.

​
Componentes principais

​
Midaz

No centro de tudo. O Midaz coordena tudo, desde persistência de dados até lógica de negócio, para que você possa focar no que importa.

​
Camada de dados

Todos os dados fluem para a camada de dados persistente, garantindo durabilidade, consistência e desempenho em todo o sistema.

​
Domínios e relacionamentos

​
Organizações

Cada organização representa um ambiente distinto usando o Midaz. Ela pode conter um ou vários ledgers, dependendo de como você estrutura seus dados.

​
Ledgers

Ledgers são onde toda a atividade financeira acontece. Eles rastreiam saldos, armazenam ativos e processam transações. Cada ledger pertence a uma organização. A partir daqui, o sistema se ramifica em:
  • Ativos: definem que tipo de valor é rastreado.
  • Portfólios: agrupam contas relacionadas sob um propósito compartilhado.

​
Ativos

Ativos definem as unidades de valor, como BRL, USD, pontos ou tokens. Cada conta está vinculada a um ativo específico.

​
Portfólios

Portfólios agrupam contas por lógica de negócio. Você pode ter quantos Portfólios precisar para organizar sua estrutura financeira. Cada portfolio contém uma ou mais contas.

​
Contas e Segmentos

Contas estão vinculadas a Portfólios e representam saldos individuais. Elas são agrupadas por Segmentos, que ajudam você a isolar dados por cliente, produto, região ou qualquer outra dimensão. Segmentos facilitam o rastreamento e a geração de relatórios com precisão. Além disso, Contas podem ser logicamente classificadas por Tipos de Conta, que definem a natureza e o propósito das contas dentro da estrutura financeira, permitindo o roteamento adequado de transações e a validação operacional entre diferentes categorias de conta.

​
Saldo

Um Saldo representa o valor líquido que uma Conta possui de um determinado Ativo em um Ledger específico.
  • Uma conta pode ter múltiplos saldos, cada um identificado por um balanceKey (ex.: default, collateral, operational), para particionar fundos sem dividir contas.
  • Contas externas são limitadas a um único saldo (default).
  • Se balanceKey for omitido em uma transação, o saldo default é utilizado.
  • Saldos são derivados automaticamente das operações do ledger. Eles podem ser listados, consultados ou (em cenários de admin/teste) ajustados manualmente.
  • A chave de cache (Valkey) também inclui balanceKey no seu formato: <org_id>:<ledger_id>:<account_alias>:<balance_key>.

​
Transações

Transações movem valor entre contas. Cada transação é composta por operações (débitos e créditos). Isso mantém sua lógica consistente, rastreável e alinhada tanto com seu modelo de negócio quanto com suas políticas contábeis.

​
Entidades de roteamento de transações

As entidades de roteamento de transações estendem as capacidades do Midaz criando um ecossistema estruturado que garante anotações corretas e direções adequadas de fluxo financeiro. São compostas por:
  • Rotas de Operação: Definem comportamentos atômicos de transação, especificando como cada movimentação financeira é anotada e direcionada de acordo com regras de negócio e padrões contábeis predefinidos.
  • Rotas de Transação: Orquestram múltiplas Rotas de Operação em eventos financeiros balanceados, aplicando validação double-entry e mantendo a integridade das transações em todas as contas.
Essa dupla cria um ecossistema autogovernável onde as transações são automaticamente validadas quanto à anotação adequada e direção correta de fluxo.

​
Resumo

O Midaz oferece uma estrutura poderosa e modular:
  • Organizações gerenciam ledgers.
  • Ledgers contêm ativos, Portfólios e estruturas contábeis.
  • Portfólios contêm contas, agrupadas por segmento.
  • Transações movem valor e disparam tratamentos contábeis.
  • Todos os dados são sincronizados, rastreáveis e prontos para relatórios financeiros.
Precisa de ajuda para projetar sua configuração do Midaz?Nosso serviço de consultoria pode ajudar você a adaptar a estrutura às necessidades únicas da sua organização — seja começando do zero ou otimizando uma configuração existente.Fale conosco para saber mais.