feat: grant transition plan to existing users

docs/tasks/T-633.md

@@ -58,4 +58,25 @@
 
 ## 状态
 
-DOING。
+DONE。
+
+## 实施结果
+
+- 新增 `grant_plan_to_existing_users()` 批量服务：执行时锁定套餐和启用的非后台用户，按同产品仍有效或处于宽限期的权益跳过已有会员，并在单事务中复用 `grant_software_entitlement()`。
+- 新增 `grant_existing_users_plan` management command。默认只预演；实际执行必须同时提供 `--execute` 和与当前范围一致的 `--expected-grant-count`。
+- 命令按套餐 ID 精确选择启用套餐，统一要求非空原因；输出只包含套餐、产品和数量统计。
+- 新增 5 条专项测试，覆盖只读预演、普通用户范围、正式权益保护、重复执行、人数不匹配拒绝和异常整批回滚。
+
+## 验证结果
+
+- `manage.py check`：通过，0 issues。
+- `manage.py makemigrations --check --dry-run`：No changes detected；本任务无迁移。
+- `manage.py test apps.licensing.tests.ExistingUserPlanGrantCommandTests`：5 tests OK。
+- SQLite 完整 `apps.licensing` 回归共 35 条，其中 33 条通过；2 条既有多连接并发测试因 SQLite 表级锁返回 `database table is locked`，与本任务断言无关，未误记为全量通过。
+- `compileall apps/licensing` 与 `git diff --check`：通过。
+- 生产 MySQL 8.4 执行前备份：`/root/cmhub-t633-backup-20260722_164956/cmhub-before-t633.sql.gz`，SHA256 为 `ae53d3edd329a3ed16e55958f2a93453f420b5026bbb3294edb6b4e91ad17162`，本地副本校验一致。
+- 线上预演：`eligible=30`、`skipped_existing=0`、`grant_count=30`；按预期人数执行成功。
+- 执行后：测试套餐权益 30 条、不同用户 30 个、`granted` 事件 30 条、席位 3030 条；后台账号权益 0，缺少有效权益的目标用户 0，重复有效权益用户 0。
+- 反向预演：`eligible=30`、`skipped_existing=30`、`grant_count=0`，证明重复执行不会重复授予。
+- 真实 API Key 抽样返回 `access_source=entitlement`、`entitlement_status=active`、套餐“测试”，点数余额保持 148。
+- 执行期间线上有 4 个生图任务运行，聚合点数同期减少 2 点并新增一条关联调用的 `consume -2` 流水；这是并发生成业务变化，不是授权命令写账。