主题对照

金额表示与分摊守恒

归纳金额的精确表示,以及等额分摊时舍入差额和整数余数的处理方式。

9 张卡片 · 6 本书

本层 9 张卡片 · 含下级覆盖 9 张卡片

本主题的卡片

架构师之路 · 58到家数据库30条军规解读

金额字段选择精确数值

金额需要明确币种与最小单位,并选精确数值表示:

  • 整数最小单位便于避免小数舍入歧义。
  • 定点 DECIMAL 也能精确存储;FLOAT、DOUBLE 则是近似值。

例如人民币 100.01 元可记为整数 10001 分;这是表示方式示例,并不规定所有币种都以“分”为最小单位。不能把原文“禁用小数”扩展成禁用所有小数类型。金额计算还须约定舍入与溢出规则。

查看卡片与原书出处

架构师之路 · 再议58到家数据库军规

等额摊销舍入产生差额

100 元均摊三天,若每天独立保留两位小数为 33.33 元,三天合计仅 99.99 元。

除法产生的余数在逐期舍入时被丢失,原总额与明细对账就会出现差额。此问题与数据库字段是否为整数不同,关键是分摊算法必须守住总额。参见[[整数分配并处理余数]]。

查看卡片与原书出处

架构师之路 · 再议58到家数据库军规

整数分配并处理余数

把 100 元先表示为 10000 分,可避免金额存储依赖浮点近似;但 10000 仍不能被 3 整除。

分摊时须明确把余数分配给某一期,例如 3334、3333、3333 分,确保明细合计等于原额;谁承担余数应由业务规则确定。参见[[等额摊销舍入产生差额]]。

查看卡片与原书出处

软件系统架构:使用视点和视角与利益相关者合作(原书第2版) · 其他视角

多币种明确汇率来源与历史值

涉及不同货币时,除显示格式,还需决定何时换算、使用当前还是历史汇率、从何取得及是否保留原币和历史金额。度量转换同样要考虑精度。原书说明这些是架构关注点,未展开结算报价、舍入或时效规则,不能据此认定任意实时汇率可重算历史交易。

查看卡片与原书出处

支付平台架构:业务、规划、设计与实现 · 账务系统

单式记账法与复式记账法的选择

单式记账法只对每笔经济业务做单方面记录,账户设置不完整,无法核对正确性,适合规模小、业务单一的个人或小微商户;复式记账法对每笔业务在两个或以上相互关联的账户中做等额双重记录,能反映交易双方资金的完整来龙去脉并支持试算平衡,因此第三方支付机构这类需要多方对账核算的场景必须采用复式记账法。发散:选择哪种记账法本质上取决于系统是否需要”自证清白”——只要涉及多方资金流转并要接受审计,复式记账几乎是唯一选项,因为它把可核验性内建在了记录结构里。

查看卡片与原书出处

高性能电子商务平台构建_架构、设计与开发 · 商城套件的设计与实现

促销要能分摊

店铺级满减、代金券、赠品会影响多个商品的实际支付价,订单生成时需要把优惠分摊到订单商品行,才能支撑后续结算、退款和佣金计算。发散:促销设计必须预先考虑逆向流程。

查看卡片与原书出处

企业应用架构模式

货币类别用浮点

大量软件在处理钱,书中所讨论的平台缺少合用的内建货币抽象,于是常见两类错误:把美元和日元直接相加,以及舍入时悄悄丢掉零头。货币模式用一个值对象同时保存金额和币种,金额存成整数分或定点小数,绝不用浮点。加减先校验币种,不同币种相加直接报错;按比例算税用乘法,在多方之间分钱用分配器;币种换算交给转换器对象,因为有的换算规则规定了取整方式。实际性能仍须按当前数据量和实现测量。参见[[货币分配器零误差分账]]、[[值对象不可变防别名]]。

查看卡片与原书出处

设计模式之禅(第2版)

整数金额须约定单位

整数可表示约定最小单位的金额,避免把二进制浮点数当作十进制金额的精确存储。书店示例把3200当作32元,展示时除以100。

不能因此假设所有货币、业务都固定两位小数。还需约定单位、范围和舍入规则;例中price*90/100会截去余数,乘法还可能溢出。这里只分析原代码,未运行或推广为生产金额实现。

查看卡片与原书出处

设计模式之禅(第2版)

奇数拆分扣款不守恒

同一笔以分计的交易,SteadyDeduction用rint(amount/2.0)取整,再从两个余额各扣同一个halfMoney。奇数分没有整数的一半,两个相同整数之和必为偶数,无法与奇数交易额相等。

按源码静态演算:1分各扣0,总扣0;3分各扣2,总扣4;5分各扣2,总扣4。rint在恰好中间时取偶数,不是普通“逢五进一”。原示例1234分恰可均分,掩盖了此问题;这是读者依据已读代码的反例,未实际扣款或运行。

API依据:JDK25 Math.rint,https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Math.html#rint(double) ,2026-10-26实际核验。

查看卡片与原书出处
辅助阅读:卢曼编号

按卢曼编号阅读

点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。

未编号或编号待整理

来源书籍

来源书籍

企业应用架构模式

系统架构类

Skill 版本:v23

书籍类型:经典原理

清单覆盖 3/6

177 张卡片

来源书籍

架构师之路

系统架构类

Skill 版本:v15

书籍类型:未标注

类别清单尚未核对

317 张卡片