02｜客户管理
客户租户、套餐与服务生命周期
管理已经购买或试用建站服务的客户，不重复建设销售CRM或OA项目。
客户定义
这里的客户管理不是销售CRM
平台管理已经购买或试用建站服务的客户企业、账号、套餐、配额、站点和服务状态。
TENANT
客户租户管理
页面：客户列表、客户详情、开通向导、状态、负责人、OA项目引用
模块目标
建立客户数据、权限、配额和站点的隔离边界。
主流程
输入企业资料/关联OA项目→校验重复→选择区域和套餐→创建tenant→分配内部服务人员→邀请企业主。
关键规则
- 一个客户企业默认一个tenant；集团可创建多个organization，但共享租户需明确合同边界。
- OA项目只保存oa_project_id和快照；不在平台管理OA任务。
- 客户编码、企业域名、统一社会信用信息等用于疑似重复提示，不自动合并。
- 租户状态：草稿→待激活→正常→暂停→过期→归档。
异常边界
- 同一企业多合同是否共租户由商业规则决定。
- 创建失败需回滚未完成配额，不发送无效邀请。
- 跨租户移动站点禁止；只能通过受控迁移复制。
核心数据
tenant、organization、contact、oa_project_ref、internal_owner_assignment
接口 / 事件
POST /tenants；POST /tenants/{id}:activate；tenant.activated/suspended
验收标准
- 任意客户数据、缓存、文件路径和任务均携带tenant_id。
- 重复开通有明确提示；未激活租户不能创建站点。
- OA员工离职后服务范围重新分配，不影响客户账号。
PACKAGE
套餐、功能与配额
页面：套餐版本、客户订阅、配额使用、到期与变更记录
模块目标
控制客户可以创建多少站点、使用哪些模板/组件、空间、带宽、发布和数据保留能力。
主流程
选择package_version→生成subscription→分配quota→实时计量→阈值提醒→续费/升级/降级/过期。
关键规则
- 套餐版本不可覆盖历史；客户订阅保存购买时快照。
- 配额至少包含站点数、存储、月流量、成员数、域名数、发布频率、AI额度。
- 达到80%提醒，100%按能力阻止新增但不破坏线上站点。
- 升级即时增加配额；降级先做影响检查，不能让已有资源直接丢失。
异常边界
- 过期进入宽限期：禁止新建/发布，线上站点按合同继续或维护。
- 计量延迟时使用安全额度，事后对账，不能重复扣减。
核心数据
package、package_version、subscription、quota_definition、quota_usage
接口 / 事件
subscription.activated/changed/expired；GET /me/quotas
验收标准
- 并发创建站点时不超配额。
- 套餐变更有前后版本、操作者和生效时间。
- 总后台可按客户查看配额来源、占用对象和释放记录。
客户生命周期
开通、服务、暂停、到期和归档规则
| 状态 | 进入条件 | 客户可做 | 系统联动 |
|---|---|---|---|
| 草稿 | 总后台录入但未完成套餐/企业主 | 不可登录 | 允许删除无业务数据草稿 |
| 待激活 | 租户、套餐、企业主邀请已创建 | 企业主完成验证和服务条款确认 | 激活后开放创建站点 |
| 正常 | 订阅有效且无风险冻结 | 按权限创建、编辑、预览、发布和查看数据 | 正常计量、提醒和监控 |
| 暂停 | 欠费、客户申请、安全或合规原因 | 默认只读；是否保留网站在线由暂停策略决定 | 终止发布任务、撤销写权限、发送通知 |
| 过期/宽限 | 订阅到期未续费 | 查看和导出允许范围内数据；禁止新增/发布 | 60/30/15/7天和到期后多级提醒 |
| 归档 | 宽限结束且符合归档条件 | 只读或不可登录 | 站点下线/静态归档、释放资源、按数据类型保留 |
| 销毁 | 保留期结束且审批完成 | 不可访问 | 个人/内容数据销毁；合同、审计、财务按法定周期保留 |