Parayı Float tutmak: teklifle faturanın kuruşu neden tutmuyor
Bir teklif sisteminde şu şikayet geldi: müşteriye gösterilen tutar ile kesilen faturanın tutarı bazen bir kuruş farklı oluyordu. Her seferinde değil, belirli tutarlarda.
Neden oluyor
İkili kayan noktalı sayılar ondalık kesirleri tam tutamıyor. 0.1 + 0.2 sonucunun 0.30000000000000004 olması bunun bilinen örneği. Tek bir işlemde fark görünmez; ama bir teklif tutarı şu zinciri geçiyor:
taban fiyat
→ indirim düşülür
→ opsiyonel hizmetler eklenir
→ KDV hesaplanır
→ toplam bulunur
Her adımda küçük bir sapma birikiyor. Sonra aynı zincir fatura tarafında bir kez daha, belki biraz farklı sırayla çalıştırılıyor. İki sonuç birbirini tutmuyor.
Asıl sorun tek bir hesap yerinin olmaması
Bizim durumumuzda daha ciddi bir şey de vardı: indirim mantığı üç ayrı yerde yaşıyordu — admin panelindeki önizlemede, teklif sayfasında ve fatura üretiminde. Üçü aynı şeyi yapmıyordu. Panelde %10 indirim girildiğinde ekranda 9.000 ₺ görünürken, müşteriye gösterilen ve tahsil edilen tutar 10.000 ₺ idi.
Bu bir yuvarlama hatası değil, mimari bir hata. Ve tek çözümü var: parayla ilgili tek bir soru soran tek bir modül.
export function calculateOfferTotals(
offer: OfferPricingInput,
optionalServices: OptionalServiceInput[] = []
): OfferTotals
Fiyat gösteren, tahsil eden ve fatura kesen her yer bunu çağırıyor. Bir daha ıraksayamazlar.
Her adımda kuruşa yuvarlayın
Float ile devam edecekseniz — mevcut bir şemayı taşımak her zaman mümkün olmuyor — her ara değeri bir sonrakine geçmeden önce yuvarlayın:
function toKurus(value) {
return Math.round((Number.isFinite(value) ? value : 0) * 100) / 100;
}
Number.isFinite kontrolü önemli: veritabanından gelen bozuk bir değer NaN üretirse, o NaN zincirin sonuna kadar yayılıyor ve faturaya NaN ₺ olarak yazılıyor. Sıfıra düşürmek en azından görünür bir hata bırakıyor.
Sınır durumlarını test edin
Bu tür hatalar ancak belirli sayılarla ortaya çıkıyor, o yüzden testler somut olmalı:
it("keeps the totals to the kuruş", () => {
const t = calculateOfferTotals({
price: 3333.33, discountType: "PERCENT", discountValue: 3
});
expect(t.discountAmount).toBe(100);
expect(t.netPrice).toBe(3233.33);
expect(t.taxAmount).toBe(646.67);
expect(t.total).toBe(3880);
});
Ayrıca kontrol edilmesi gerekenler: %100 indirim negatife düşürmemeli, sabit indirim fiyatı aşamamalı, negatif hizmet fiyatı toplamı azaltmamalı.
Doğrusu: tam sayı olarak kuruş
Yeni bir şema tasarlıyorsanız parayı ondalık değil, tam sayı kuruş olarak tutun. 3.880,00 ₺ veritabanında 388000 olarak durur. Kayan nokta hiç devreye girmez, tüm aritmetik tam sonuç verir, yalnızca gösterim katmanında ikiye bölersiniz.
Maliyeti: mevcut bir sistemde bu bir veri taşıması demek ve parayı taşıyorsunuz — yani dikkatli yapılması gereken bir iş. Ama tek seferlik.