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

***

![Hierarquia principal do Módulo Midaz, de Organização e Ledger até Ativos, Contas, Rotas e Transações](https://mintcdn.com/lerian-49cb71fc/vdBt8wfgjsNRO1rf/images/pt/d2/midaz-core-hierarchy.svg?fit=max\&auto=format\&n=vdBt8wfgjsNRO1rf\&q=85\&s=e167e9ad8dec77a1747253eebe7341ee)

### 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 registrada, como `checking`, `treasury` ou `expense`. Registrar uma é opcional, mas toda conta tem um tipo | 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 registrada no ledger | É o resultado de toda a configuração. |

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

***

![Como a criação de uma transação depende da configuração anterior de organização, ledger, ativos, contas e rotas contábeis](https://mintcdn.com/lerian-49cb71fc/TGLv2g3qhXqf0dqb/images/pt/d2/midaz-transaction-dependency.svg?fit=max\&auto=format\&n=TGLv2g3qhXqf0dqb\&q=85\&s=eb8c2514d32bf7cdac43c601cc53254c)

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, Account Types.

• `Accounting` define participação opcional e regras de lançamento: Accounting Routes e Operation 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

***

> [accordion] 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] Tipo de Conta vs Segmento vs Portfólio
>
> O Tipo de Conta é uma classificação registrada, e registrar uma é 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] 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] 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.

> [!TIP]
>
> Combine esta página com [Caminho de configuração](https://docs.lerian.studio/pt/products/midaz/console/midaz-console-setup-path.md) ao integrar novos usuários. Esta página explica o modelo. Caminho de configuração explica a ordem.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.