架构与系统设计 / 系统课时
套餐与功能项设计
套餐与功能项设计
本课完成一套可落库的套餐模型,把套餐名称、功能开关、版本价格和默认资源额度拆分管理,并通过版本冻结避免租户权益随后台修改而意外变化。
学习目标
- 区分套餐、功能项、套餐版本和权益配置的职责
- 使用关系表表达功能开关与默认资源额度
- 掌握价格存储、版本发布和后续变更的关键边界
先拆清五类业务对象
套餐是面向运营人员展示的产品,例如“基础版”和“专业版”;功能项是可授权的最小能力,例如导出报表、成员数量和存储空间。套餐本身只负责名称、编码与上下架状态,不直接承载会频繁变化的价格和额度。
套餐版本保存某次正式发布的商业规则,包括计费周期、价格、币种和版本号。权益配置连接套餐版本与功能项:布尔型功能记录是否启用,额度型功能记录默认数量。这样既能复用功能目录,又能保留历史订阅所依赖的旧版本。

数据表的最小设计
下面示例使用 MySQL,价格统一保存为最小货币单位,避免浮点数误差。quota_value 只对额度型功能有意义,开关型功能可保持为空。
DROP TABLE IF EXISTS saas_plan_entitlement;
DROP TABLE IF EXISTS saas_plan_version;
DROP TABLE IF EXISTS saas_feature_item;
DROP TABLE IF EXISTS saas_plan;
CREATE TABLE saas_plan (
id BIGINT PRIMARY KEY,
plan_code VARCHAR(64) NOT NULL UNIQUE,
plan_name VARCHAR(100) NOT NULL,
status VARCHAR(20) NOT NULL
);
CREATE TABLE saas_feature_item (
id BIGINT PRIMARY KEY,
feature_code VARCHAR(64) NOT NULL UNIQUE,
feature_name VARCHAR(100) NOT NULL,
value_type VARCHAR(20) NOT NULL
);
CREATE TABLE saas_plan_version (
id BIGINT PRIMARY KEY,
plan_id BIGINT NOT NULL,
version_no INT NOT NULL,
billing_cycle VARCHAR(20) NOT NULL,
price_cent BIGINT NOT NULL,
currency CHAR(3) NOT NULL,
publish_status VARCHAR(20) NOT NULL,
UNIQUE KEY uk_plan_version (plan_id, version_no),
CONSTRAINT fk_version_plan FOREIGN KEY (plan_id) REFERENCES saas_plan(id)
);
CREATE TABLE saas_plan_entitlement (
plan_version_id BIGINT NOT NULL,
feature_id BIGINT NOT NULL,
enabled TINYINT(1) NOT NULL,
quota_value BIGINT NULL,
PRIMARY KEY (plan_version_id, feature_id),
CONSTRAINT fk_entitlement_version FOREIGN KEY (plan_version_id)
REFERENCES saas_plan_version(id),
CONSTRAINT fk_entitlement_feature FOREIGN KEY (feature_id)
REFERENCES saas_feature_item(id)
);
INSERT INTO saas_plan VALUES (1, 'PRO', '专业版', 'ACTIVE');
INSERT INTO saas_feature_item VALUES
(101, 'REPORT_EXPORT', '报表导出', 'SWITCH'),
(102, 'MEMBER_LIMIT', '成员数量', 'QUOTA');
INSERT INTO saas_plan_version VALUES
(1001, 1, 1, 'MONTH', 9900, 'CNY', 'PUBLISHED');
INSERT INTO saas_plan_entitlement VALUES
(1001, 101, 1, NULL),
(1001, 102, 1, 50);
SELECT p.plan_code, v.version_no, f.feature_code,
e.enabled, e.quota_value
FROM saas_plan p
JOIN saas_plan_version v ON v.plan_id = p.id
JOIN saas_plan_entitlement e ON e.plan_version_id = v.id
JOIN saas_feature_item f ON f.id = e.feature_id
ORDER BY f.feature_code;预期结果:
plan_code | version_no | feature_code | enabled | quota_value
PRO | 1 | MEMBER_LIMIT | 1 | 50
PRO | 1 | REPORT_EXPORT | 1 | NULL查询结果说明专业版第 1 版开放报表导出,并为每个租户提供 50 个成员名额。实际生产中可使用自增主键或分布式 ID,示例中的固定 ID 仅用于保证脚本可重复理解。
发布版本而不是覆盖配置
草稿版本允许修改价格与权益;一旦发布,就不再原地更新。需要调价或增减额度时,新建更高版本号,再让新订阅或指定租户切换到新版本。旧订阅继续引用原版本,历史账单和权益判断因此保持可追溯。
套餐下架也不等于删除版本。下架只阻止新购,已订阅租户仍需读取原版本。数据库层可保留 publish_status,应用层限制已发布版本的更新和删除。
权益落地时的边界
价格建议使用整数最小货币单位,例如 99 元保存为 9900 分,并同时记录 ISO 币种。多币种价格不要塞进一个字段,可为同一版本扩展独立价格表,或按币种生成不同可售版本。
默认额度是订阅建立时的基线,不应直接等同于租户当前剩余额度。租户购买扩容包、获得临时赠送或被管理员调整时,应在租户权益层记录覆盖值或增量值,最终额度再由“版本默认值 + 租户调整”计算。
提示:功能编码一旦被业务代码引用,应保持稳定。显示名称可以修改,但不要通过改名替换原编码。
验收检查
完成设计后,至少验证三个场景:同一套餐可以发布多个版本;同一功能项可被多个版本复用;修改新版本的额度不会影响仍引用旧版本的租户。只要这三项成立,套餐目录与租户权益就已经实现了解耦。
本课总结
- 套餐负责产品身份,套餐版本负责某次可售规则,功能项负责最小授权能力
- 版本权益配置同时表达功能开关和默认资源额度
- 已发布版本应保持不可变,价格使用最小货币单位保存
下一课预告
下一课将把套餐版本绑定到租户订阅,继续处理试用期、续费周期、状态迁移和套餐变更历史。