A conta é a verdade
Uma conta é o contêiner de saldo — a verdade que vive dentro do Ledger. Ela registra exatamente quanto de um asset guarda, construído a partir de cada movimentação para dentro e para fora. É só isso que ela faz, e isso é deliberado: a conta permanece limpa e confiável porque não carrega dados confusos de identidade do mundo real. Na câmara-forte, a conta é o cofre numerado. Ele guarda valor; não guarda o seu nome, seus documentos ou seu número de telefone.
O Holder é a pessoa ou empresa
Um Holder é o dono do mundo real que está por trás da conta — a pessoa ou empresa que você registra. Este é o cadastro do cliente: nome, número do documento, dados de contato. Registrar esses donos é um trabalho próprio, frequentemente chamado de cadastro de pessoas — acompanhar as pessoas e empresas com as quais o seu negócio lida. Por que manter o Holder separado da conta? Por duas razões:
- Um dono pode ter muitas contas. O dono é registrado uma vez; as contas se vinculam a ele.
- O Ledger permanece confiável. Os dados de identidade mudam com frequência e às vezes são sensíveis — você não quer que fiquem emaranhados nos registros que comprovam seus saldos.
Aliases: nomes amigáveis para contas
As contas são identificadas por IDs longos e únicos — precisos, mas nada divertidos de digitar ou lembrar. Então você dá a elas nomes mais amigáveis. É aqui que dois termos de sonoridade parecida se confundem — eles fazem coisas diferentes:
- Um alias é um identificador amigável para uma conta — um apelido como
marketing-fundpara você não precisar lidar com um ID longo. - Um alias account é um registro que vincula os dados bancários do mundo real de um dono (banco, agência, número da conta) a uma conta subjacente no Ledger.
De volta à câmara-forte. O alias é o adesivo com o apelido no cofre (“Fundo de marketing”) para que a equipe não precise do número do cofre. O alias account é a ficha de índice da recepção que vincula os dados bancários externos de um cliente a qual cofre é o dele.
Por que se dar ao trabalho de toda essa separação
Separar esses papéis parece trabalho extra, mas compra para você flexibilidade real:
- Um Holder, muitas contas, sem duplicar o dono a cada vez.
- Aliases amigáveis para que pessoas e sistemas referenciem contas sem IDs longos.
- Alias accounts que conectam a múltiplos bancos e sistemas externos — sem nunca poluir o registro limpo de valor do Ledger.
Em resumo
- Uma conta é o contêiner de saldo — a verdade dentro do Ledger, livre de dados de identidade.
- Um Holder é o dono do mundo real que você registra — a pessoa ou empresa (cadastro de pessoas). Um Holder pode ser dono de muitas contas.
- Um alias é um apelido amigável apontando para uma das suas contas.
- Um alias account é um registro que vincula dados bancários do mundo real a uma conta do Ledger.
- Manter esses papéis separados compra flexibilidade mantendo o Ledger limpo.
Veja na LerianVeja essas ideias na prática: Contas e Alias accounts.

