dinero-best-practices

此技能旨在為在 JavaScript 與 TypeScript 環境中使用 Dinero.js 函式庫管理金錢的開發者提供專家建議。它專為軟體工程師、全端開發人員與金融應用架構師設計，協助處理貨幣精確度、不可變性與型別安全邏輯的複雜挑戰。該技能提供關於避免浮點數誤差、錯誤貨幣四捨五入及不當縮放等常見陷阱的實務指導，確保您的金融程式碼穩健且適用於正式環境。

• 驗證物件建立模式，確保金額以貨幣最小單位作為整數傳遞，以防止精確度損失。

• 提供算術運算建議，強制使用 allocate 取代除法，並指導如何使用縮放後的數值進行百分比運算。

• 執行精確度管理，協助開發者在標準的 number 計算機與處理大額財務的 bigint 計算機之間做出選擇。

• 指導 Tree-shaking 與模組匯入，確保套件體積保持精簡，並確保 bigint 與標準精確度模組的相依性匹配。

• 推廣不可變性原則，提醒開發者所有運算皆會回傳新物件，這對預測性狀態管理至關重要。

• 提供貨幣格式化明確規則，包含如何處理如 JPY 等零指數貨幣，以及如何正確修剪小數位數。

• 當匯入 dinero.js、dinero.js/currencies 或 dinero.js/bigint 時觸發，以維護架構一致性。

• 支援複雜金融計算的除錯，例如增值稅（VAT）分配、多幣種轉換以及基於百分比的價格調整。

• 適用於程式碼審查、重構階段，或在專案中建立新的金融模組時使用。

• 基於金錢運算複雜且需要特殊抽象化以避免標準 JavaScript 數字陷阱的原則運行。

• 協助彌合財務精確度的業務需求與 IEEE 754 浮點數實際限制之間的鴻溝。