> ## 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 dependem umas das outras antes de você começar a configurar o Módulo Midaz.

O Módulo Midaz usa um pequeno conjunto de objetos principais com dependências explícitas. Organização, Ledger, Ativos e Contas são a configuração central. Você configura Tipos de Conta, registros de CRM, Portfólios, Segmentos e Rotas Contábeis quando o workflow precisa deles.

## Hierarquia principal

***

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/vdBt8wfgjsNRO1rf/images/pt/d2/midaz-core-hierarchy.svg?fit=max&auto=format&n=vdBt8wfgjsNRO1rf&q=85&s=e167e9ad8dec77a1747253eebe7341ee" alt="Hierarquia principal do Módulo Midaz, de Organização e Ledger até Ativos, Contas, Rotas e Transações" width="1089" height="766" data-path="images/pt/d2/midaz-core-hierarchy.svg" />
</Frame>

### O que cada objeto representa

***

| Objeto             | O que ele representa                                                                             | Por que ele existe antes ou depois                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| `Organization`     | O proprietário legal ou operacional da configuração                                              | É o limite de nível mais alto. Nada abaixo dele existe sem ele.                           |
| `Ledger`           | O ambiente contábil onde saldos e movimentações são registrados                                  | Ele agrupa a estrutura que uma equipe vai operar no dia a dia.                            |
| `Asset`            | A unidade de valor movimentada no ledger, como `BRL` ou `USD`                                    | Contas e transações dependem dele.                                                        |
| `Account`          | Um contêiner de saldo que pode enviar ou receber valor                                           | As transações acontecem entre contas.                                                     |
| `Account Type`     | Uma classificação opcional, como `checking`, `treasury` ou `expense`                             | Use quando as regras configuradas de conta ou rota precisarem dela.                       |
| `Portfolio`        | Um agrupamento de contas, geralmente por estrutura de cliente ou carteira                        | Útil para relatórios e organização, mas não é um pré-requisito para toda conta.           |
| `Segment`          | Um agrupamento persistido de contas com escopo de ledger, como por departamento, região ou nível | Útil quando o negócio precisa de fatiamento ou agrupamento por política.                  |
| `Holder`           | A pessoa ou entidade que possui contas em fluxos de CRM                                          | Necessário quando a titularidade da conta importa operacionalmente.                       |
| `Alias`            | Um identificador legível por humanos usado para encontrar ou se referir a uma conta              | Especialmente importante na criação de transações.                                        |
| `Accounting Route` | Um conjunto opcional de regras para participantes da transação e comportamento de lançamento     | O Midaz aplica as regras de rota configuradas quando a validação de rota está habilitada. |
| `Transaction`      | A movimentação de saldo real registrada no ledger                                                | É o resultado de toda a configuração.                                                     |

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

***

<Frame>
  <img src="https://mintcdn.com/lerian-49cb71fc/TGLv2g3qhXqf0dqb/images/pt/d2/midaz-transaction-dependency.svg?fit=max&auto=format&n=TGLv2g3qhXqf0dqb&q=85&s=eb8c2514d32bf7cdac43c601cc53254c" alt="Como a criação de uma transação depende da configuração anterior de organização, ledger, ativos, contas e rotas contábeis" width="1964" height="739" data-path="images/pt/d2/midaz-transaction-dependency.svg" />
</Frame>

Os pré-requisitos necessários dependem das configurações da Transação e do Ledger. Uma transação exige Ativos e Contas. Ela exige uma Rota Contábil apenas quando a validação de rota está ativada.

## Leitura prática da interface

***

Use esta interpretação quando você orientar usuários:

• `Foundation` define onde o sistema vive: Organization, Ledger, Asset.

• `Accounting` define participação opcional e regras de lançamento: Account Types e Accounting Routes.

• `Accounts` define quem mantém saldos e como você os classifica: Accounts, Holders, Aliases, Segments, Portfolios.

• `Transactions` exercita a estrutura configurada.

• `Plugins` estende o modelo depois que o comportamento principal já funciona.

## 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 de CRM. Uma Conta de Alias é um Instrumento de CRM opcional vinculado a um Titular e a uma Conta de Ledger existente. O `alias` da própria Conta é o seu identificador amigável.
  </Accordion>

  <Accordion title="Tipo de Conta vs Segmento vs Portfólio">
    O Tipo de Conta é uma classificação opcional. Segmento e Portfólio são agrupamentos persistidos de Contas com escopo de ledger. Eles não são meros rótulos nem relacionamentos diretos com o Titular.
  </Accordion>

  <Accordion title="Rota Contábil vs Transação">
    A Rota é uma regra reutilizável opcional. A Transação é a movimentação individual. O Midaz a verifica em relação às regras de rota configuradas apenas quando a validação de rota está ativada.
  </Accordion>

  <Accordion title="Por que o ledger importa tão cedo">
    Quase todo objeto abaixo dele tem escopo de ledger. Usuários que tratam o ledger como um contêiner cosmético geralmente configuram mal contas e rotas depois.
  </Accordion>
</AccordionGroup>

<Tip>
  Combine esta página com [Caminho de configuração](/pt/products/midaz/console/midaz-console-setup-path) ao integrar novos usuários. Esta página explica o modelo. Caminho de configuração explica a ordem.
</Tip>
