立项原因:会员空间平台的销售提成每月人工核算,业务员按当月累计可计提回款走超额累进阶梯,跨档要自动切段;合同带折扣时还要按折扣率命中系数档,在总额上一次生效。原来的实现用浮点乘除,月底对账常差几分钱,跨档理解也不一致,财务、业务员和主管各算一遍、各得一个数。业务背景:提成是直接发给人的钱,一分钱都不能含糊,必须有一套可复算、可对账、结果唯一的算法内核,被结算服务、对账脚本和业务员自助查询三处共同调用,而不是各自再实现一遍。
点击空白处退出提示
立项原因:会员空间平台的销售提成每月人工核算,业务员按当月累计可计提回款走超额累进阶梯,跨档要自动切段;合同带折扣时还要按折扣率命中系数档,在总额上一次生效。原来的实现用浮点乘除,月底对账常差几分钱,跨档理解也不一致,财务、业务员和主管各算一遍、各得一个数。业务背景:提成是直接发给人的钱,一分钱都不能含糊,必须有一套可复算、可对账、结果唯一的算法内核,被结算服务、对账脚本和业务员自助查询三处共同调用,而不是各自再实现一遍。
引擎只做一件事:给定本笔可计提回款、当月此前累计、阶梯表、合同折扣率与折扣系数表,返回本笔提成与逐段明细。①金额全程以「分」为单位的 int 表示,不出现元、不出现浮点;②阶梯按累计可计提回款超额累进,一笔跨档自动切段,每段独立算额并给出区间、段金额、费率、段提成四列,便于业务员自己对账;③折扣系数在总额上一次性生效,不逐段打折,避免「先打折再分段」和「先分段再打折」两种口径打架;④运算用 int 加 Fraction 保持精确,只在函数末尾按 ROUND_HALF_UP 取整到分一次,不做中间取整;⑤入参同时接受元组与字典两种写法,调用方不必改数据形状;⑥纯函数、无 I/O、无第三方依赖,同一输入永远同一输出,可直接嵌进结算服务、对账脚本与自助查询。
我独立完成算法设计、边界定义、实现与自测。精度方案:全程 int 分与 Fraction,末尾单次 ROUND_HALF_UP,杜绝中间取整误差累积。自测:python -m unittest 25 个用例全通过,覆盖跨档切段(月度累计 4,800,000 分、本笔 400,000 分、500bp 与 600bp 两档 → 10,000 + 12,000 = 22,000 分)、折扣系数命中与不命中、阶梯边界点、零值与负数输入拒绝、大额不溢出;另加一条静态检查脚本扫描源码,确认无 float、无 Decimal、无真除法,确保精度方案不被后续改动悄悄破坏。上述跨档样例可一键复现,结果与文档一致。



评论