Ledger (livro-razão)

// Saldo não é uma coluna: é a soma de lançamentos imutáveis.
// Partidas dobradas: todo valor SAI de uma conta e ENTRA em outra.
interface Lancamento {
  id: string;
  debito: string;   // conta de onde sai
  credito: string;  // conta onde entra
  centavos: number; // dinheiro em inteiro — nunca float
  motivo: string;
}

const livro: Lancamento[] = []; // append-only: sem UPDATE, sem DELETE

function lancar(l: Omit<Lancamento, "id">): Lancamento {
  if (l.centavos <= 0) throw new Error("valor deve ser positivo");
  if (l.debito === l.credito) throw new Error("contas distintas");
  const registro = { id: crypto.randomUUID(), ...l };
  livro.push(registro); // a única escrita permitida
  return registro;
}

// O saldo é DERIVADO — recontável, auditável, à prova de "de onde veio isso?"
function saldo(conta: string): number {
  return livro.reduce(
    (s, l) => s + (l.credito === conta ? l.centavos : 0) - (l.debito === conta ? l.centavos : 0),
    0
  );
}

// A invariante que dedura bugs: a soma do sistema inteiro é sempre zero.
function somaDoSistema(): number {
  return livro.reduce((s, l) => s + l.centavos - l.centavos, 0);
}

lancar({ debito: "banco:externo", credito: "cliente:ana", centavos: 10_000, motivo: "pix_in" });
lancar({ debito: "cliente:ana", credito: "cliente:bia", centavos: 2_500, motivo: "transferencia" });
// estorno NÃO apaga nada — é um lançamento no sentido contrário:
lancar({ debito: "cliente:bia", credito: "cliente:ana", centavos: 2_500, motivo: "estorno" });

console.log(saldo("cliente:ana")); // 10000
console.log(somaDoSistema());      // 0 — sempre