dinheiro-em-centavos

name	dinheiro-em-centavos
description	Ao lidar com valores monetários neste projeto (preços, totais, pagamentos, troco, relatórios), use SEMPRE inteiro de centavos (i64 no Rust, number de centavos no TS) — nunca float. Use ao adicionar campos de dinheiro, parsear entrada R$, somar/conferir valores ou criar DTOs.

Dinheiro é sempre centavos (inteiro)

Regra (ADR-0005): todo valor monetário é inteiro de centavos. Float (f64/REAL/number decimal) é proibido para dinheiro — acumula erro de arredondamento e quebra a reconciliação exata exigida pelo SC-004 (Σ formas de pagamento = Σ totais, R$ 0,00).

Como aplicar

• Rust: tipo domain::dinheiro::Dinheiro (envolve i64 de centavos). Use Dinheiro::de_centavos, .centavos(), .soma, .diferenca_piso_zero, parse_brl, to_brl.
• Colunas SQLite: *_centavos INTEGER.
• DTOs/IPC: trafegam centavos: i64/number. Formate para R$ 1.234,56 só na borda (UI) com lib/format.ts::brl ou Dinheiro::to_brl.
• Entrada do usuário (pt-BR, vírgula decimal): Dinheiro::parse_brl / parseBrlParaCentavos.
• Importação do legado (float "30.0000"): converta com valor_para_centavos (× 100, arredonda).

Erro a evitar

Nunca fazer preco * quantidade em float, nem armazenar REAL. Se vir f64/REAL/toFixed ligado a dinheiro, troque por centavos inteiros.