> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Entidades do Midaz

> Veja como as entidades principais do Midaz (Organizações, Ledgers, Ativos, Portfólios, Contas, Segmentos e Saldos) se conectam para potencializar operações financeiras em escala.

Este diagrama mostra como os principais blocos de construção do Midaz se conectam para dar suporte a operações financeiras em escala. A Figura 1 dá uma visão geral de como o sistema funciona.

<Frame caption="Figura 1. O Midaz e seus domínios interconectados e estrutura modular.">
  <img src="https://mintcdn.com/lerian-49cb71fc/vdBt8wfgjsNRO1rf/images/pt/d2/midaz-entities-v3.svg?fit=max&auto=format&n=vdBt8wfgjsNRO1rf&q=85&s=37fd98a6596b831b7faf0084488065ab" alt="Blocos de construção principais do Midaz e como seus domínios interconectados se encaixam para dar suporte a operações financeiras em escala" width="1530" height="1395" data-path="images/pt/d2/midaz-entities-v3.svg" />
</Frame>

## Componentes principais

***

### Midaz

O Midaz está no centro. Ele coordena tudo, da persistência de dados à lógica de negócio.

### Camada de dados

Todos os dados fluem para a **camada de dados** persistente. Essa camada dá ao sistema durabilidade, consistência e performance.

## Domínios e relacionamentos

***

### Organizações

Cada organização é um ambiente distinto no Midaz. Ela pode conter um ou vários ledgers, com base em como você estrutura os seus dados.

### Ledgers

Um ledger contém toda a atividade financeira. Ele rastreia saldos, armazena ativos e viabiliza transações. Todo ledger pertence a uma organização.

A partir daqui, o sistema se ramifica em:

* **Ativos**: definem o tipo de valor que você rastreia.
* **Portfólios**: agrupam contas relacionadas sob um propósito compartilhado.

### Ativos

Os Ativos definem as unidades de valor, como BRL, USD, pontos ou tokens. Cada conta usa um ativo específico.

### Portfólios

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

### Contas e Segmentos

Uma conta pertence a um portfólio e representa um saldo individual. Os **Segmentos** agrupam contas, para que você possa isolar dados por cliente, produto, região ou qualquer outra dimensão.

Os **Tipos de Conta** classificam contas por natureza e propósito. Eles viabilizam o roteamento de transações e a validação operacional entre categorias de conta.

### Saldo

Um **Saldo** representa o valor líquido que uma **Conta** mantém de um determinado **Ativo** em um **Ledger** específico.

* Uma conta pode manter **vários saldos**. Cada um tem uma `balanceKey` (por exemplo, `default`, `collateral`, `operational`) para particionar fundos sem dividir a conta.
* Uma **conta externa** tem apenas um saldo (`default`).
* Se você omitir `balanceKey` em uma transação, o Midaz usa o saldo padrão.
* O Midaz deriva saldos automaticamente a partir das operações do ledger. Você pode listá-los, buscá-los ou (em cenários de administração ou teste) ajustá-los manualmente.
* A chave de cache do Valkey inclui `balanceKey` no seu formato: `balance:{transactions}:<orgId>:<ledgerId>:<alias>#<balanceKey>`.

### Transações

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

### Entidades de Rotas Contábeis

As [entidades de Rotas Contábeis](/pt/products/midaz/transaction-routing-entities) estendem o Midaz. Elas criam um sistema estruturado que garante anotações corretas e direções corretas de fluxo financeiro.

Ele tem duas partes:

* **Rotas de Operação:** definem comportamentos atômicos de transação. Cada rota define como o Midaz anota e direciona um movimento financeiro, com base nas suas regras de negócio e padrões contábeis.
* **Rotas Contábeis:** orquestram várias Rotas de Operação em eventos financeiros balanceados. Quando a validação de rota está habilitada nas configurações do ledger, elas impõem a estrutura de transação configurada. (A API chama isso de `transactionRoute`.)

Esse par define a estrutura da transação. Quando você habilita a validação de rota nas configurações do ledger, o Midaz valida as transações em relação à rota configurada.

## Obtenha ajuda

***

<Tip>
  **Precisa de ajuda para projetar a sua configuração do Midaz?**

  O nosso serviço de consultoria pode ajudar você a adaptar a estrutura às necessidades da sua organização. Isso vale tanto para quem começa do zero quanto para quem otimiza uma configuração existente.

  [Fale conosco](https://lerian.studio/contact) para saber mais.
</Tip>
