init: 项目初始提交 - NeoZQYY Monorepo 完整代码

packages/shared/src/neozqyy_shared/money.py

@@ -0,0 +1,23 @@
+# -*- coding: utf-8 -*-
+"""金额精度工具 — 人民币（CNY）统一使用 Decimal + ROUND_HALF_UP。
+
+业务约定：所有金额字段保留 2 位小数（分），与数据库 numeric(*, 2) 对齐。
+"""
+from decimal import Decimal, ROUND_HALF_UP
+
+CNY_SCALE = 2
+_QUANT = Decimal("0." + "0" * CNY_SCALE)
+
+
+def round_cny(amount: Decimal) -> Decimal:
+    """人民币金额四舍五入到分。"""
+    return amount.quantize(_QUANT, rounding=ROUND_HALF_UP)
+
+
+def to_cny(value) -> Decimal:
+    """将任意数值转为 Decimal 并四舍五入到分。
+
+    接受 int / float / str / Decimal；
+    不可解析时抛出 decimal.InvalidOperation。
+    """
+    return round_cny(Decimal(str(value)))