以下三家公司与全部数字均为教学假设,用于演示商业化计算,不代表任何真实企业。
额度不是一个数字
在定价文档里,额度通常被写成一个数字:每席位每月 500 次。但在计费系统里,额度不能只是一个计数器。计数器只能回答「还剩多少次」,回答不了「这些次数从哪来、什么时候过期、能不能结转」。一旦出现赠送额度、试用额度、结转额度或加购包,计数器就会立刻失效。
更合适的模型是「授予」(grant)。每一次额度发放都是一条授予记录,包含四个字段:来源、数量、生效时间、到期时间。来源区分套餐内额度、加购包、结转额度;到期时间决定消费顺序;数量决定这一条授予还能被扣多少。
LumenDesk 的每席位 500 次是套餐内授予,每月重置;如果客户上月有未用完的额度并允许结转,就会额外产生一条结转授予,到期时间通常早于本月套餐授予。两条授予同时存在时,扣减顺序会直接影响客户实际能用多少。
把额度建模成授予,还有一个好处:所有变更都可以用「追加一条记录」表达,而不是修改一个余额。追加赠送、追加加购、追加冲正,都是新增授予或新增负向授予。余额是这些记录的和,不是一个被反复覆盖的字段。这样即使扣错了,也能沿着记录回滚,而不是猜原来是多少。
扣减顺序:先到期,后来源
当一个客户同时持有多条授予时,扣减顺序必须固定,否则同一个用量在不同时间会扣出不同结果。常用顺序是:
- 先扣最早到期的授予,避免额度过期作废。
- 到期时间相同时,按来源排序:结转、套餐、加购。
- 到期时间与来源都相同时,按授予 ID 排序,保证结果可复现。
第一条是客户价值最大化的顺序。结转额度通常月底到期,套餐额度下月才重置;如果先扣套餐额度,结转额度就会白白过期。客户不会认为这是系统设计,只会认为自己被扣了两次。
第二条是商业优先级的体现。结转额度是客户已经付过钱的,套餐额度是当期权益,加购包是额外购买。先扣结转、再扣套餐、最后扣加购,能让客户感知到「赠送和结转先用」,减少争议。这个顺序不是唯一的,但必须写进合同或产品说明,不能由实现细节决定。
第三条看起来只是技术细节,实际决定了可测试性。两条授予的到期时间和来源完全相同,如果不定义最终排序,扣减结果就依赖数据库返回顺序。今天跑出来是 A,明天跑出来是 B,测试会间歇性失败,对账会出现无法解释的一分钱差额。
一次扣减的账本恒等式
不管顺序怎么定,一次扣减都必须满足两个恒等式:
额度内用量 + 超额用量 = 本次总用量
已消耗授予 + 剩余授予 = 扣减前的有效授予总量
第一个恒等式保证没有用量凭空消失。第二个恒等式保证额度没有被多扣或漏扣。两个式子都很简单,但在并发扣减、失败重试、跨月结算的场景里,它们是最有效的自检。
下面这段代码把授予、扣减与单席位账单串起来。扣减函数不修改传入的授予,而是返回新的剩余集合,调用方可以把它写进账本,也可以丢弃后重放。
// file: src/ops/07-2-quota-deduction.ts
// tier: L1
// verify: node --test test/ops/07-2-quota-deduction.test.ts
// 额度扣减:授予按到期时间消费,额度耗尽后进入超额计价。
export type GrantSource = "rollover" | "plan" | "addon";
export type Grant = {
id: string;
units: number;
expiresAt: number;
source: GrantSource;
};
export type Deduction = {
grantedUnits: number;
overageUnits: number;
remaining: readonly Grant[];
};
const SOURCE_ORDER: Record<GrantSource, number> = { rollover: 0, plan: 1, addon: 2 };
/** 只保留未过期且仍有余额的授予,按到期时间、来源、ID 排序。 */
export function activeGrants(grants: readonly Grant[], at: number): Grant[] {
return grants
.filter((grant) => grant.expiresAt > at && grant.units > 0)
.sort(
(a, b) =>
a.expiresAt - b.expiresAt ||
SOURCE_ORDER[a.source] - SOURCE_ORDER[b.source] ||
a.id.localeCompare(b.id),
);
}
/** 扣减一次用量,不修改传入的授予;剩余授予按同样的顺序返回。 */
export function deduct(grants: readonly Grant[], units: number, at: number): Deduction {
if (!Number.isInteger(units) || units < 0) {
throw new Error("units 必须是非负整数");
}
let left = units;
const remaining: Grant[] = [];
for (const grant of activeGrants(grants, at)) {
const used = Math.min(grant.units, left);
left -= used;
if (grant.units > used) {
remaining.push({ ...grant, units: grant.units - used });
}
}
return { grantedUnits: units - left, overageUnits: left, remaining };
}
/** 超额费用,单位美分。 */
export function overageChargeCents(overageUnits: number, priceCentsPerUnit: number): number {
return overageUnits * priceCentsPerUnit;
}
/** 单席位账单 = 席位费 + 超额次数 × 超额单价。 */
export function billSeatCents(
plan: { seatPriceCents: number; includedUnits: number; overagePriceCents: number },
usedUnits: number,
at: number,
): number {
const included: Grant = {
id: "plan",
units: plan.includedUnits,
expiresAt: Number.MAX_SAFE_INTEGER,
source: "plan",
};
const deduction = deduct([included], usedUnits, at);
return plan.seatPriceCents + overageChargeCents(deduction.overageUnits, plan.overagePriceCents);
}
export const LUMENDESK_SEAT = {
seatPriceCents: 4_900,
includedUnits: 500,
overagePriceCents: 4,
} as const;
代码里的 activeGrants 先过滤掉已过期和余额为零的授予,再按到期时间、来源、ID 排序。deduct 按这个顺序逐条消费,剩下的授予原样返回。整个过程没有副作用,同一组输入永远得到同一组输出。
用一个例子走一遍。假设某席位有一条 100 次的结转授予(到期时间 1,000)和一条 500 次的套餐授予(到期时间 2,000),本次用 550 次。扣减先消费结转的 100 次,再消费套餐的 450 次,剩余套餐 50 次,超额 0 次。如果把顺序倒过来,先扣套餐,结转的 100 次就会过期作废,客户实际可用额度从 600 次变成 500 次。
按席位还是按账号汇总
额度可以按席位独立分配,也可以按账号汇总后共享。两种口径在平均用量下结果相同,在用量不均时差异明显。
LumenDesk 选择按席位分配:1,920 个席位 × 500 次 = 960,000 次包含额度;实际月对话量 1,190,400 次;超额 1,190,400 − 960,000 = 230,400 次。按每次 0.04 美元计,超额收入 230,400 × 0.04 = 9,216 美元。这个结果与按席位逐条计算再汇总一致,因为每个席位的额度相同、超额单价也相同。
差异出现在席位之间用量不均时。假设一个两席位客户,A 席位用了 2,300 次,B 席位只用了 200 次。按席位计算:A 超额 2,300 − 500 = 1,800 次,B 没有超额,合计 1,800 次,超额费 1,800 × 0.04 = 72 美元。按账号汇总:总用量 2,500 次,总包含额度 2 × 500 = 1,000 次,超额 1,500 次,超额费 60 美元。
两种口径差 12 美元。差的不是算术,而是风险分配:按席位分配时,重度席位不能占用轻度席位的闲置额度,公司收得更准;按账号汇总时,轻度席位的额度补贴了重度席位,客户体验更好,但公司承担了更多长尾成本。
LumenDesk 选按席位,是因为它的客户是中小 SaaS 公司,席位之间的用量差异很大。如果改成账号汇总,P99 席位的超额会被大量闲置席位吸收,超额收入下降,而成本并不会下降。对一个毛利率 82.7% 的产品来说,这不是致命问题;但对一个毛利率 47.5% 的产品,同样的选择可能直接吃掉几个点的毛利。
口径必须在合同里写清楚。最糟糕的情况是销售按账号汇总报价,系统按席位扣减,客户在第一次账单里就发现对不上。口径不是实现细节,它是价格结构的一部分。
超额计价与单席位毛利
LumenDesk 的每席位账单由两部分组成:49 美元的席位费,加上超出 500 次之后的 120 次超额,每次 0.04 美元,合计 4.80 美元。每席位月收入 53.80 美元。
成本侧,620 次对话 × 0.015 美元 = 9.30 美元。单席位毛利 = 53.80 − 9.30 = 44.50 美元,毛利率 = 44.50 ÷ 53.80 = 82.7%。这个数与整站口径一致:1,920 个席位 × 53.80 美元 = 103,296 美元 MRR;1,920 × 44.50 = 85,440 美元月度毛利。
超额部分的毛利明显低于额度内部分。额度内 500 次的收入是 49 美元,成本 7.50 美元,毛利 41.50 美元,毛利率 84.7%;超额 120 次的收入是 4.80 美元,成本 1.80 美元,毛利 3.00 美元,毛利率 62.5%。两部分混合后得到 82.7%。
这个结构说明,超额单价不是越高越好。0.04 美元是单次变动成本 0.015 美元的 2.67 倍,已经把超额毛利压到 62.5%。如果再把超额单价提高,毛利率会上升,但客户会把超额理解成惩罚,开始压缩必要用量、拆分账号或迁移。超额定价的目标不是最大化超额收入,而是让重度用量被覆盖成本,同时保留升级到更高档位的空间。
反过来,如果超额单价低于成本,超额部分就是负毛利。LumenDesk 的 P99 客户单次成本 0.12 美元,远高于 0.04 美元的超额单价,这正是第 3 章讨论的长尾负毛利。额度扣减系统本身没有错,它只是忠实执行了价格表;错的是价格表没有按上下文长度分层。
预扣与结算:流式场景
按次计费的产品可以在调用结束后再扣减,流式产品不行。一次长会话可能持续几十分钟,期间持续产生 token;如果等结束后再扣,额度可能在会话中途被其他请求耗尽,系统无法在当下决定是否继续服务。
常见做法是「预扣 + 结算」:会话开始时按预估用量预扣一笔额度,会话过程中周期性结算实际用量,会话结束时释放未使用的预扣。预扣太少,会话中途会超额;预扣太多,客户的可用额度会被短期占用,并发会话多时尤其明显。
预扣不是账单,它只是额度账本上的临时占用。账本要区分「已预扣」「已结算」「已释放」三种状态,否则同一个会话的额度会被重复计算。会话超时或客户端断连时,预扣必须有一个明确的释放期限,不能永远挂着。
失败与重试也要对齐 6.1 的计量口径。LumenDesk 按「一次成功返回的对话」计量,失败调用和重试不计入客户额度;但失败调用产生的推理成本是真实发生的,会计入变动成本。这意味着额度账本和成本账本的口径天然不同:一个按成功计量,一个按实际消耗计量。两个账本不能互相推导,必须分别记录。
6.2 的幂等键在这里同样关键。一次扣减请求超时后重试,如果没有幂等键,额度会被扣两次。扣减接口应该以「计量事件 ID」作为幂等键,同一个事件 ID 第二次到达时直接返回第一次的结果,而不是再扣一次。
结转与过期:额度的负债属性
未使用的额度不是免费的。客户已经为它付过钱,供应商也承诺在有效期内提供对应的服务,所以在财务上它更接近一项负债,而不是一项可以随手清零的权益。
这带来两个管理动作。第一,额度账本要能回答「当前未使用的有效额度有多少」,这个数会进入收入运营报表,和 MRR、递延收入一起看。第二,额度过期要有明确的规则和通知,不能在客户不知情的时候静默清零。静默清零省下的是当期成本,损失的是续费时的信任。
结转是另一种选择:允许本月未用完的额度延到下月。结转对客户友好,但会让负债累积,也让成本预测变难,因为用量可以在月底集中释放。如果决定结转,至少要设三个约束:结转上限、结转次数、结转后的到期时间。没有约束的无限结转,等于把订阅制变成了预付费池,收入的可预测性反而下降。
从成本角度看,未使用额度不产生推理成本,但它占用容量承诺。供应商合同里的承诺量、限流阈值、峰值容量,都要按「可能被用掉的额度」而不是「实际用掉的额度」来准备。额度负债和容量成本是两本账,不能因为当月没人用就认为没有成本。
中途变更:加席位、升档、退款
客户不会只在月初变更。加席位、升档、降档、退款都可能发生在月中,每一种都会让额度账本变复杂。
加席位时,新增席位的包含额度通常按剩余天数折算。比如一个账期 30 天,第 16 天加一个席位,新增席位只能获得剩余 15 天的额度,而不是整月 500 次。折算比例必须在合同里定义,否则客户会认为自己付了整月钱却只拿到半个月额度。
升档时,新套餐的额度从变更时刻起生效,旧套餐已发放的额度不收回。客户可能同时持有旧套餐的剩余额度和新套餐的额度,扣减顺序仍然按到期时间与来源排序。不要为了「避免重复发放」而把旧额度清零,那会让客户觉得升档吃亏。
降档时,已经消耗的额度不追回,剩余额度按新套餐上限截断。截断应该发生在下一个账期,而不是立即生效;立即截断会让客户在降档当天突然超额,体验很差。
退款时,账本只追加冲正记录,不修改原始扣减。原始扣减记录了「当时扣了什么」,冲正记录记录了「后来退了多少」,两条记录合起来才是完整事实。直接删除原始扣减会让审计轨迹断裂,8.2 的对账会找不到依据。
额度扣减与价格表的分工
额度扣减回答「这次用量里有多少在额度内、多少在额度外」,价格表回答「额度外的每一次值多少钱」。两个问题分开,系统才能独立演进。
如果把额度写进价格规则,比如一条规则同时包含「500 次以内 49 美元、超出部分 0.04 美元」,调额度就变成了调价格,调价格也会影响额度。更麻烦的是,额度是客户级状态,价格是全局配置,两者的变更频率和审批人完全不同。混在一张表里,一次额度调整可能触发全量价格缓存失效。
分开之后,账单行的组装顺序是:先由额度账本算出超额次数,再由价格表解析超额单价,两者相乘得到超额金额,最后加上席位费。任何一个环节失败,都能定位到具体是哪一层,而不是面对一个「总价不对」的黑盒。
审计时,额度账本和计价行通过计量事件 ID 关联。同一个事件在账本里记录「扣了哪条授予」,在计价行里记录「用了哪条规则」。两条记录合起来,才能回答客户「这 0.04 美元是怎么来的」。
额度系统的测试样例
额度扣减的测试不需要很多用例,但必须覆盖边界。最小的一组是:
- 用量为 0:不扣任何授予,剩余不变。
- 用量刚好等于额度:超额为 0,剩余为 0。
- 用量比额度多 1:超额为 1,剩余为 0。
- 用量远超额度:超额等于用量减额度,剩余为 0。
- 授予刚好在扣减时刻过期:该授予不参与扣减。
- 授予在扣减后一秒过期:该授予参与扣减。
- 同一事件重复扣减:第二次不改变余额。
再加一条性质测试:对任意用量,grantedUnits + overageUnits 必须等于输入用量,remaining 的总和必须等于扣减前有效授予总量减去 grantedUnits。这两个恒等式能抓住大多数实现错误,包括并发下的漏扣和重复扣。
随机用例也值得跑。固定几组授予,随机生成用量与扣减时刻,断言两个恒等式始终成立,并断言同一组输入重复执行得到完全相同的结果。额度扣减是纯函数,纯函数最容易用这种方式验证;一旦引入数据库和并发,性质测试仍然可以作为最后一道防线。
小结
- 额度在计费系统里是一组带来源与到期时间的授予,不是一个可覆盖的计数器。
- 扣减顺序先按到期时间,再按来源,最后按 ID;顺序必须固定且可复现。
- 一次扣减要满足两个恒等式:额度内加超额等于总用量,已消耗加剩余等于扣减前总量。
- LumenDesk 每月包含额度 960,000 次,实际用量 1,190,400 次,超额 230,400 次,超额收入 9,216 美元。
- 按席位分配与按账号汇总在用量不均时结果不同,两席位例子相差 12 美元,口径必须写进合同。
- 单席位收入 53.80 美元、成本 9.30 美元、毛利 44.50 美元,毛利率 82.7%。
- 流式场景用预扣加结算,预扣不是账单,必须有释放期限与幂等键。
- 中途变更只追加记录,不修改历史;退款用冲正,不删除原始扣减。
阅读导航:上一节:7.1 价格表与规则引擎 · 下一节:7.3 计费失败的兜底 。
常见错误与边界
- 用单一余额计数器管理额度,遇到结转、赠送、加购时无法区分来源与到期时间。
- 扣减顺序依赖数据库返回顺序,同一组授予在不同时间扣出不同结果。
- 按账号汇总与按席位分配混用,销售报价与系统账单口径不一致。
- 预扣没有释放期限,会话超时后额度被永久占用,客户可用额度越来越小。
- 重复事件没有幂等键,重试导致同一笔用量被扣两次。
- 退款时直接删除原始扣减,审计轨迹断裂,对账无法解释差额。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。