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

# Glossário

> Consulte os principais termos financeiros e da plataforma Lerian, explicados em linguagem simples para públicos técnicos e de negócio.

Este glossário define os principais termos financeiros e da plataforma utilizados em toda a documentação da Lerian. Ele foi elaborado para ajudar gerentes de produto, equipes comerciais e qualquer pessoa nova em infraestrutura financeira a compreender rapidamente a linguagem usada em nossos guias.

***

## A

***

### Account (Conta)

A unidade fundamental de armazenamento de valor em um ledger. Uma conta mantém um saldo denominado em um asset específico (ex.: BRL, USD). Contas podem representar contas de clientes, contas internas de liquidação, contas de cobrança de taxas ou qualquer outro contêiner para rastreamento de valor.

### Account Type (Tipo de conta)

Uma classificação que define a natureza e o propósito de uma conta — como corrente, poupança, custódia (escrow) ou liquidação. Os tipos de conta permitem o roteamento adequado de transações e garantem que as regras de negócio sejam aplicadas de forma consistente entre as categorias de conta.

### Asset (Ativo)

Uma unidade de valor rastreada no ledger. Assets podem ser moedas tradicionais (BRL, USD, EUR), moedas digitais (BTC, ETH) ou unidades personalizadas como pontos de fidelidade ou créditos acadêmicos. Cada conta está vinculada a exatamente um asset.

### Atomic (Atômico / Atomicidade)

Uma propriedade das transações onde todas as operações são bem-sucedidas juntas ou falham juntas — não há execução parcial. Se uma transação envolve três operações (um débito, um crédito e uma taxa), ou as três acontecem ou nenhuma acontece. Isso previne eventos financeiros incompletos.

### Audit trail (Trilha de auditoria)

Um registro cronológico de cada ação e transação no sistema. Trilhas de auditoria são imutáveis — uma vez registradas, não podem ser modificadas ou excluídas. Isso é essencial para conformidade regulatória (SOX, GLBA) e resolução de disputas.

***

## B

***

### Balance (Saldo)

O valor atual de um asset mantido em uma conta. O Midaz rastreia três tipos de saldo: **available** (disponível — pode ser usado imediatamente), **on hold** (retido — reservado para transações pendentes) e **scale** (escala — o número de casas decimais usado para precisão).

### Blast radius (Raio de impacto)

O alcance do impacto caso ocorra uma falha, configuração incorreta ou incidente de segurança. Em contextos de multi-tenancy, o blast radius se refere a quantos tenants são afetados quando algo dá errado no escopo de um tenant. O modo DATABASE minimiza o blast radius porque cada tenant tem um banco de dados totalmente isolado; uma falha ou corrupção de dados afeta apenas aquele tenant. O modo SCHEMA tem um blast radius mais amplo porque os tenants compartilham o mesmo processo de banco de dados. Veja também: **DATABASE mode**, **SCHEMA mode**, **Tenant isolation**.

### BYOC (Bring Your Own Cloud)

Um modelo de implantação onde você executa o software da Lerian em sua própria infraestrutura — seja nuvem pública (AWS, GCP, Azure), nuvem privada ou on-premises. Isso oferece controle total sobre residência de dados, segurança e escalabilidade. Veja também: **SaaS**.

***

## C

***

### CEL (Common Expression Language)

Uma linguagem de expressões leve e segura, projetada para avaliar condições de forma rápida e determinística. No ecossistema Lerian, o Tracer usa CEL para definir regras de validação de transações — permitindo que analistas criem regras type-safe sem necessidade de deploys de código.

### Child account (Conta filha)

Uma subconta criada sob uma conta principal, tipicamente usada para orçamento ou organização. Por exemplo, a conta poupança de um cliente pode ter contas filhas para "Fundo de Férias" e "Fundo de Emergência", cada uma rastreando seu próprio saldo enquanto se acumula na conta principal.

***

## D

***

### DSL (Domain-Specific Language)

Uma linguagem de programação projetada para um domínio específico, em vez de ser de propósito geral. No ecossistema Lerian, o Flowker usa uma DSL para definir workflows financeiros — permitindo que equipes descrevam fluxos de trabalho de forma declarativa, sem precisar escrever código de aplicação.

### Double-entry accounting (Contabilidade de partida dobrada)

Um princípio contábil onde cada movimentação financeira é registrada como pelo menos duas operações: um débito de uma conta e um crédito em outra. Isso garante que o sistema esteja sempre balanceado — o total de todos os débitos é igual ao total de todos os créditos. O Midaz aplica partida dobrada automaticamente em cada transação.

***

## E

***

### ERP (Enterprise Resource Planning)

Um sistema de software de gestão empresarial — como SAP, Oracle ou NetSuite — que integra processos essenciais como contabilidade, compras e inventário. ERPs são fontes de dados comuns para conciliação com o Matcher.

### External account (Conta externa)

Uma conta especial no Midaz (com prefixo `@external/`) que representa valor entrando ou saindo do sistema de fora. Por exemplo, quando um estudante se matricula em uma disciplina, créditos se movem de `@external/available-courses` para a conta do estudante. Contas externas atuam como limites entre seu ledger e o mundo externo.

***

## F

***

### Fail closed (Falha fechada)

Uma postura de segurança em que um sistema nega o acesso por padrão quando não consegue verificar uma condição exigida, em vez de permitir o acesso e arriscar uma brecha. Na multi-tenancy da Lerian, a resolução de tenants é fail-closed: se o tenant não puder ser identificado a partir do JWT, ou se a configuração do tenant não puder ser obtida, a requisição é rejeitada — nunca servida contra dados padrão, compartilhados ou de outro tenant. Veja também: **Isolamento de tenant**, **Multi-tenancy**.

***

## H

***

### Helm Chart

Um pacote de configuração para Kubernetes que define como uma aplicação deve ser implantada, configurada e gerenciada em um cluster. No ecossistema Lerian, Helm Charts são fornecidos para simplificar o deployment BYOC — empacotando todas as configurações necessárias para rodar os produtos da Lerian na sua infraestrutura.

***

## I

***

### Idempotency (Idempotência)

A propriedade de que uma operação produz o mesmo resultado seja executada uma ou múltiplas vezes. Em sistemas financeiros, isso previne transações duplicadas — se uma solicitação de pagamento é acidentalmente enviada duas vezes, a idempotência garante que o dinheiro se mova apenas uma vez.

### Immutable (Imutável / Imutabilidade)

Uma propriedade que significa "não pode ser alterado ou excluído após a criação". No Midaz, todas as transações e registros de auditoria são imutáveis — uma vez registrados, existem permanentemente. Isso garante a integridade dos dados para conformidade e auditoria.

***

## K

***

### Kubernetes

Uma plataforma para executar e gerenciar aplicações de software em escala em múltiplos servidores. O Kubernetes automatiza a implantação, o escalonamento e a recuperação — garantindo que as aplicações continuem disponíveis mesmo quando servidores individuais falham. Obrigatório para deployments BYOC dos produtos da Lerian.

***

## L

***

### Ledger

O livro financeiro central que registra todas as transações, saldos e operações de uma organização. Pense nele como a fonte única de verdade para as finanças de uma unidade de negócio. Uma organização pode ter múltiplos ledgers para diferentes finalidades (ex.: operações de varejo, tesouraria).

***

## M

***

### Metadata (Metadados)

Informações adicionais anexadas a entidades como contas, transações ou organizações. Metadados são armazenados como pares chave-valor e podem conter qualquer dado personalizado que seu negócio precise — como o ID externo de um cliente, o número de referência de uma transação ou um código de departamento. Não afetam a lógica do ledger, mas enriquecem os registros para relatórios e integração.

### Multi-tenancy

A capacidade de uma única implantação atender múltiplos clientes independentes — chamados **tenants** — com isolamento completo de dados entre eles. Na Lerian, o multi-tenancy está disponível em deployments **SaaS** (sempre ativo) e **BYOC Multi-Tenant**. O isolamento é garantido no nível da aplicação por meio de um claim `tenantId` no JWT. Veja também: **Tenant**, **Isolamento de tenant**.

***

## O

***

### Onboarding domain (Domínio de onboarding)

A parte do Midaz responsável por estruturar seu ecossistema financeiro — criando organizações, ledgers, assets, contas, portfólios e segmentos. Esta é a fase de "configuração" antes que qualquer transação ocorra.

### Operation (Operação)

A unidade atômica de movimentação no ledger — um único débito ou crédito. Cada transação é composta por uma ou mais operações, proporcionando rastreabilidade precisa para conformidade e relatórios.

### Operation Route (Rota de operação)

Um template reutilizável que define as regras para uma "perna" de uma transação financeira — especificando quais contas participam, em qual direção (origem/destino) e sob qual anotação contábil.

### Organization (Organização)

A entidade de negócio de nível superior no Midaz — tipicamente um banco, fintech ou subsidiária. Cada organização possui seus próprios ledgers, configurações e controles de acesso.

***

## P

***

### Pix

O sistema de pagamentos instantâneos do Brasil, operado pelo Banco Central do Brasil (BACEN). O Pix permite transferências em tempo real 24/7 entre pessoas, empresas e entidades governamentais. No ecossistema Lerian, o plugin Pix conecta o Midaz à rede Pix, gerenciando iniciação de pagamentos, liquidação e gestão de taxas.

### Portfolio (Portfólio)

Um agrupamento de contas pertencentes ao mesmo cliente, unidade de negócio ou finalidade. Por exemplo, um único cliente pode possuir contas corrente, poupança e investimento em diferentes moedas — um portfolio as agrupa para uma visão unificada.

### Plugin

Uma extensão opcional que adiciona funcionalidades a um produto específico da Lerian. Exemplos incluem Pix (pagamentos instantâneos), TED (transferências bancárias) e Payments (boletos e pagamento de contas). Plugins são executados dentro da arquitetura de um produto anfitrião, não de forma standalone — hoje, todos os plugins disponíveis estendem o Midaz.

***

## R

***

### Reconciliation (Reconciliação)

O processo de comparar dois conjuntos de registros — por exemplo, seu ledger interno com extratos bancários — para verificar se correspondem. O Matcher automatiza esse processo aplicando regras de correspondência e sinalizando discrepâncias.

***

## S

***

### SaaS (Software as a Service)

Um modelo de implantação onde a Lerian gerencia a infraestrutura para você. Você acessa a plataforma por meio de APIs sem se preocupar com servidores, escalabilidade ou manutenção. Veja também: **BYOC**.

### Segment (Segmento)

Uma classificação aplicada a contas que compartilham características — como níveis de cliente (VIP, Estudante, Empresarial) ou divisões regionais. Segmentos permitem regras, preços e benefícios diferenciados em toda a sua base de clientes.

### Service-centric architecture (Arquitetura centrada em serviços)

Um modelo arquitetural em que a configuração e a infraestrutura são organizadas em torno de serviços, em vez de tenants. Na multi-tenancy da Lerian, uma entidade Tenant contém os metadados de identidade, enquanto uma entidade Service contém a configuração de infraestrutura (credenciais de banco de dados, detalhes de conexão, modo de isolamento). Essa separação significa que o mesmo tenant pode ter diferentes modos de isolamento entre produtos distintos, e um serviço pode ser reconfigurado de forma independente da identidade do tenant. Veja também: **Multi-tenancy**, **Isolamento de tenant**.

### Settlement (Liquidação)

O processo de finalizar uma transação financeira — transferindo os fundos efetivos entre instituições. Contas de liquidação no Midaz atuam como pontos de compensação onde o dinheiro é mantido temporariamente antes de ser movido ao destino final (ex.: via Pix ou TED para o banco central).

### SOX (Sarbanes-Oxley Act)

Uma lei federal dos Estados Unidos que exige padrões rigorosos de registro financeiro e auditoria para empresas de capital aberto. A conformidade com SOX requer trilhas de auditoria imutáveis e relatórios financeiros precisos — capacidades que o Midaz e o Matcher oferecem por design.

### Source-available (Código-fonte disponível)

Um modelo de licenciamento de software onde o código-fonte é publicamente acessível para inspeção, modificação e auto-hospedagem, enquanto certos usos comerciais podem exigir uma licença. Dentro do portfólio da Lerian, o **Midaz** e o **Fetcher** são source-available. Os demais produtos da Lerian (como Reporter, Matcher, Flowker e Tracer) não são source-available — estão disponíveis para clientes licenciados, com seus repositórios mantidos internamente.

### Streaming Hub

A borda de entrega de eventos da Lerian. O Streaming Hub consome os eventos da plataforma a partir do fluxo de eventos interno e os distribui para sistemas externos por meio de webhooks assinados, filas de mensagens ou uma API de extração — cuidando das novas tentativas de entrega e da verificação de assinaturas ao longo do caminho. É um produto de código fechado da Lerian, disponível para clientes licenciados.

***

## T

***

### Tenant

Uma entidade lógica que representa um cliente ou conta independente dentro de um deployment multi-tenant. Cada tenant possui seus próprios dados — organizações, ledgers, contas e transações — completamente isolados dos demais tenants. O tenant é identificado pelo claim `tenantId` no JWT emitido pelo Access Manager.

### Isolamento de tenant

A garantia de que os dados de um tenant nunca são acessíveis por outro tenant. Na Lerian, o isolamento é aplicado no nível de banco de dados: cada tenant opera em seu próprio banco, e o middleware da plataforma roteia cada requisição com base no `tenantId` presente no JWT. Não existe caminho na API para acessar dados de outro tenant. Veja também: **Multi-tenancy**, **Tenant**.

### Terraform

Uma ferramenta de automação de infraestrutura que provisiona e gerencia recursos cloud — servidores, bancos de dados, redes, grupos de segurança — por meio de arquivos de configuração declarativos. A Lerian fornece templates Terraform para configurar infraestrutura BYOC na AWS, GCP ou Azure.

### TED (Transferência Eletrônica Disponível)

O sistema brasileiro de transferência bancária eletrônica para transferências de alto valor ou no mesmo dia entre instituições financeiras. Diferente do Pix, o TED opera apenas em horário comercial. No ecossistema Lerian, o plugin TED conecta o Midaz à rede TED.

### Transaction (Transação)

Uma movimentação de valor entre contas. Transações podem envolver múltiplas operações (débitos e créditos) e são processadas atomicamente — ou todas as operações são bem-sucedidas, ou nenhuma é. Isso garante que nenhum evento financeiro parcial ocorra.

### Transaction domain (Domínio de transações)

A parte do Midaz responsável por executar movimentações financeiras — processando transações, atualizando saldos e mantendo trilhas de auditoria.

### Rota Contábil (Accounting Route / Transaction Route)

Um blueprint completo de transação composto por múltiplas Rotas de Operação. Por exemplo, uma rota "Transferência Pix" define todos os débitos e créditos envolvidos, garantindo conformidade de partida dobrada cada vez que esse tipo de transação é executado. Chamada de **Rota Contábil** no Lerian Console e na documentação do produto; exposta como `transactionRoute` na API.

***

## W

***

### Webhook

Uma notificação automática enviada de um sistema para outro quando um evento específico ocorre. Por exemplo, o Matcher pode enviar um webhook para sua instância JIRA quando uma exceção de conciliação é encontrada, criando automaticamente um ticket para sua equipe investigar.
