升鲜宝 SaaS 租户订阅系统数据库设计与功能说明

版本：2026 企业级版本
架构模式：每租户独立数据库 + SaaS 平台主库
运行环境：阿里云 RDS + ECS + Nginx

---

一、系统目标

本系统用于：

• 租户注册与生命周期管理

• 套餐定义与价格管理

• 订阅与续费管理

• 自动计费与账单生成

• 模块授权与配额控制

• 到期冻结与欠费停用

• 审计与可追溯

---

二、系统分域设计（DDD）

---

三、数据库表结构定义

所有表均位于：saas_master_db

---

1️⃣ Tenant 域（租户管理）

---

1.1 tenant（租户主表）

功能说明

• 每个租户唯一

• 控制整体状态

• 到期时间作为拦截依据

• 与 subscription 形成一对多

---

1.2 tenant_admin

---

2️⃣ Catalog 域（套餐与价格）

---

2.1 saas_plan

---

2.2 saas_plan_module

模块示例

---

2.3 saas_price_component

---

2.4 saas_price_tier

---

3️⃣ Subscription 域（订阅管理）

---

3.1 tenant_subscription

---

3.2 subscription_change

---

4️⃣ Billing 域（计费与账单）

---

4.1 tenant_invoice

---

4.2 tenant_invoice_item

---

5️⃣ Payment 域（支付）

---

5.1 tenant_payment

---

6️⃣ Entitlement 域（授权快照）

---

6.1 tenant_entitlement_snapshot

---

四、系统功能说明

---

1️⃣ 租户生命周期

• 注册 → 试用 → 订阅 → 到期 → 冻结

• 试用期自动计算 trial_end_time

• 到期自动进入宽限期

---

2️⃣ 自动续费流程

---

3️⃣ 升级 / 降级规则

• 升级：按剩余天数计算补差价

• 降级：下周期生效

---

4️⃣ 欠费停用机制

---

5️⃣ 模块授权优先级

---

6️⃣ 配额控制示例

quota_json 示例：

---

五、企业级扩展方向

• API 调用次数计费

• 存储空间计费

• 渠道分账

• 企业信用额度

• 财务凭证自动生成

---

六、成熟度等级

当前设计达到 L4。

---

七、总结

该设计满足：

• 每租户独立数据库

• 分片扩展

• 自动计费

• 商业化运营

• 企业级隔离

• 成本域支持