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

# Mapa de conceitos

> Entenda como Organizações, Ledgers, Ativos, Contas, Rotas e Transações se relacionam antes de configurar o Módulo Midaz.

O Módulo Midaz usa um conjunto enxuto de objetos centrais, mas eles dependem uns dos outros de forma rígida. Se o usuário não compreende essa estrutura, a UI parece arbitrária. Esta página é o caminho mais curto para o modelo mental.

## Hierarquia central

***

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/BiSm5XjyifxTTX_7/images/pt/console/midaz-core-hierarchy.jpg?fit=max&auto=format&n=BiSm5XjyifxTTX_7&q=85&s=439ec88a9763b29bb0ebc6a2d0a21be1" alt="" width="1669" height="935" data-path="images/pt/console/midaz-core-hierarchy.jpg" />
</Frame>

### O que cada objeto representa

***

| Objeto          | O que representa                                                                | Por que existe antes ou depois                                               |
| --------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `Organização`   | O dono legal ou operacional da configuração                                     | É a fronteira de nível superior. Nada abaixo dela existe sem ela.            |
| `Ledger`        | O ambiente contábil onde saldos e movimentos são registrados                    | Agrupa a estrutura que um time vai operar no dia a dia.                      |
| `Ativo`         | A unidade de valor movimentada no Ledger, como `BRL` ou `USD`                   | Contas e Transações dependem dele.                                           |
| `Conta`         | Um contêiner de saldo que pode enviar ou receber valor                          | Transações acontecem entre Contas.                                           |
| `Tipo de Conta` | Uma classificação estrutural como `checking`, `treasury` ou `expense`           | Torna-se importante quando o Ledger exige validação por tipo.                |
| `Portfólio`     | Um agrupamento de Contas, normalmente por cliente ou estrutura de carteira      | Útil para relatórios e organização, mas não é pré-requisito para toda Conta. |
| `Segmento`      | Uma tag de classificação para Contas, como departamento, região ou tier         | Útil quando o negócio precisa segmentar ou agrupar por política.             |
| `Titular`       | A pessoa ou entidade dona das Contas em fluxos de CRM                           | Necessário quando a titularidade da Conta é relevante operacionalmente.      |
| `Alias`         | Um identificador legível para encontrar ou referenciar uma Conta                | Especialmente importante na criação de Transações.                           |
| `Rota Contábil` | O conjunto de regras que valida participantes e define o comportamento contábil | Transforma uma solicitação de movimento em um padrão contábil consistente.   |
| `Transação`     | O movimento de saldo de fato registrado no Ledger                               | É o resultado final de toda a configuração.                                  |

## Como uma Transação realmente depende da configuração anterior

***

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/BiSm5XjyifxTTX_7/images/pt/console/midaz-transaction-dependency.jpg?fit=max&auto=format&n=BiSm5XjyifxTTX_7&q=85&s=225a6beb197c53a29b0600029572a11d" alt="" width="1774" height="887" data-path="images/pt/console/midaz-transaction-dependency.jpg" />
</Frame>

Se qualquer um desses pré-requisitos estiver faltando, a página de Transações fica confusa, porque o operador tenta completar um movimento que o modelo do Ledger ainda não consegue suportar.

## Leitura prática da UI

***

Use esta interpretação ao orientar os usuários:

• `Fundação` define onde o sistema vive: Organização, Ledger, Ativo.

• `Contábil` define as regras de participação e contabilização: Tipos de Conta e Rotas Contábeis.

• `Contas` define quem mantém os saldos e como eles são classificados: Contas, Titulares, Aliases, Segmentos, Portfólios.

• `Transações` é onde a estrutura configurada é exercitada.

• `Plugins` estende o modelo depois que o comportamento central já está funcionando.

## Onde os usuários costumam se perder

***

<AccordionGroup>
  <Accordion title="Conta vs Titular vs Alias">
    A Conta é o contêiner de saldo. O Titular é a identidade do dono nos fluxos de CRM. O Alias é apenas uma forma amigável de referenciar a Conta.
  </Accordion>

  <Accordion title="Tipo de Conta vs Segmento vs Portfólio">
    O Tipo de Conta controla a classificação estrutural e a validação. O Segmento é um rótulo de agrupamento. O Portfólio é um agrupamento operacional de Contas, geralmente em torno de uma carteira ou estrutura de cliente.
  </Accordion>

  <Accordion title="Rota Contábil vs Transação">
    A Rota é a regra reutilizável. A Transação é o movimento individual que segue essa regra.
  </Accordion>

  <Accordion title="Por que o Ledger importa tão cedo">
    Quase todos os objetos abaixo dele têm escopo no Ledger. Usuários que tratam o Ledger como um contêiner cosmético geralmente configuram Contas e Rotas errados depois.
  </Accordion>
</AccordionGroup>

<Tip>
  Combine esta página com [Configuração](/pt/lerian-console/midaz-console/midaz-console-setup-path) ao fazer onboarding de novos usuários. Uma página explica o modelo; a outra explica a ordem.
</Tip>