docs: add existing user plan grant task

2026-07-22 16:41:57 +08:00
parent 2604a59d67
commit 09d13ff64a
3 changed files with 70 additions and 0 deletions
@@ -2146,3 +2146,10 @@
 - admin：软件授权应用索引只显示“会员套餐”和“用户会员”；软件订单、事件、设备观测及历史授权模型继续注册、保留直接管理地址和历史数据。`licensing.0005` 只修改两个模型的显示名称。
 - 验证：5 条不依赖数据库的模式/合约/宽限期/admin 单元测试通过；`manage.py check`、迁移一致性、编译与 `git diff --check` 通过；非法模式按预期阻止启动。数据库 API/admin 定向测试已尝试，但旧远程 MySQL `43.128.3.240` 拒绝连接，本机 MySQL 又不接受项目账号，因此未取得数据库集成测试结果。
 - 发布约束：当前部署保持 `open`；切 `shadow` / `enforce` 前必须在可用 MySQL 测试库补跑 T-632 数据库集成回归，并核对桌面端状态页。
+
+## 2026-07-22 规划：T-633 存量用户批量授予过渡测试套餐
+
+- 线上只读核对：存在且仅存在一个启用的 `cmshopee`“测试”套餐；当前有 30 个启用的非后台账号、1 个启用的后台账号，数据库尚无 `SoftwareEntitlement`。
+- 方案：新增默认只预演的 `grant_existing_users_plan` 命令。实际执行必须指定套餐 ID、非空原因、`--execute` 和与预演一致的预期授予人数；默认排除后台/超级用户，并跳过已有同产品有效或宽限期权益的账号。
+- 安全边界：批量授予必须在单事务中锁定套餐和目标用户，逐项复用 `grant_software_entitlement()` 生成套餐快照、席位和授权事件；任一失败整批回滚。不得直接写权益表，不修改订阅模式、点数、充值、软件订单或生成任务。
+- 发布顺序：任务文档提交后实现命令和测试；线上部署后先备份数据库，再预演、按预演人数执行并抽样验证订阅状态。测试结束后的正式套餐切换另行立项。