> ## 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

> Aprenda a trabalhar com as entidades principais, contas e transações do Midaz

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.

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

## 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 Rotas Contábeis

As [entidades de Rotas Contábeis](/pt/midaz/transaction-routing-entities) 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 Contábeis (`transactionRoute` na API):** 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.

<Tip>
  **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](https://lerian.studio/contact) para saber mais.
</Tip>
