Skip to content

套餐与订阅 ​

套餐 ​

套餐决定租户能用哪些功能。在「租户套餐」中新建套餐,从平台「菜单管理」里勾选菜单,再在「租户配置」中把套餐分配给租户(一个租户可以有多个套餐)。

字段说明
编码全局唯一
名称 / 排序显示用
状态停用的套餐不再授予菜单,也不参与试用天数计算
试用天数新租户未填写到期时间时,取其已启用套餐中最长的试用天数作为到期日
菜单权限引用平台菜单表 e_upms_menu

租户全部会话(包括租户管理员)只能看到已启用套餐内的菜单,租户的角色编辑器也只能从这些菜单中分配权限。菜单只在「菜单管理」维护一份,修改套餐后对所有使用该套餐的租户生效。

订阅 ​

租户的订阅只有一个日期:到期时间 expireDate,为空表示永不到期。

试用 ​

新建租户时如果没有填写到期时间,取其已启用套餐中最长的试用天数,从创建时起算;套餐都没有设置试用天数则不设到期。

状态 ​

状态由到期时间与宽限天数在每次读取时推导,不落库:

状态条件能否使用
Active 生效未到期,或没有到期时间✅
Grace 宽限已过到期时间,仍在 grace-days 内✅
Expired 过期超过宽限期❌ 拒绝登录

租户配置中的 状态 开关(启用 / 锁定)独立于到期时间:锁定后无论是否到期都拒绝登录。

在线会话 ​

租户在用户已登录时过期或被锁定,其会话会在下一次请求时被注销并返回 401,前端回到租户登录页并显示原因。为避免每个请求都读库,状态会缓存 status-cache-seconds 秒;超管端修改租户后缓存立即失效。

配置 ​

yaml
erupt:
  tenant:
    subscription:
      grace-days: 7            # 到期后的宽限天数,默认 0
      status-cache-seconds: 30 # 订阅状态缓存秒数,默认 30

续期 ​

erupt 不负责收费。在你自己的支付逻辑收款成功后调用 TenantSubscriptionService#extend 延长到期时间:

java
@Resource
private TenantSubscriptionService tenantSubscriptionService;

public void onPaid(Long tenantConfigId) {
    // 从原到期时间顺延;已经过期则从当前时间起算
    tenantSubscriptionService.extend(tenantConfigId, Period.ofYears(1), LocalDateTime.now());
}

查询订阅 ​

租户会话可通过 GET /erupt-api/tenant/info 获取自己的租户 ID、名称、订阅状态、到期时间与已启用套餐,用于在前端提示续费。

贡献者

The avatar of contributor named as YuePeng YuePeng

页面历史

Released under the Apache-2.0 License.