Ver código fonte

docs: record cohort review transfer and reward reconciliation

彭峰 9 horas atrás
pai
commit
c4a837ec02

+ 47 - 0
docs/operations/legacy-review-transfer-cohort-reconciliation-2026-11-02.md

@@ -0,0 +1,47 @@
+# 其他学员复习老师切换核查与修复 · 2026-11-02
+
+## 范围和原因
+
+用户要求排查其他切换复习老师的学员,发现漏同步记录和费用时一并修复。本次为生产数据核对,不改变全局同步保护或调度,不覆盖已保存的新系统转交、完成或工资凭据。
+
+通过旧系统只读 `content_list` 读取 204 页、203,595 条复习记录,校验读取前后的总数及全部业务编号唯一;与新系统 203,805 条任务索引全量比对。发现除前一单独修复学员外,另 13 名学员有 2,121 条老师归属差异。
+
+- 其中 2 名学员的 1,720 条差异对应新系统已经完成的转交,具有 2026-10-28、10-29 的转交命令和逐任务审计。保留新系统归属,不以旧系统数据回退。
+- 另外 11 名学员有 401 条确实未跟进旧系统老师切换的任务,原因与前次相同:直连同步保留老师身份字段及不明版本修改,差异进入冲突记录。
+- 同时发现上述 11 名学员有完成状态滞后,以及已导入但仍为零元历史待核对的费用。
+
+全量编号比对另发现 20 条旧系统新生成、尚未完成的任务属于另一名不涉及本次转交差异的学员,无完成及收入凭据,私有留档,未纳入本次历史转交修复。没有将本次定向核对冒充全量同步完成。
+
+## 正式处理结果
+
+| 项目 | 数量或金额 |
+| --- | ---: |
+| 修复学员 | 11 名 |
+| 修复任务差异 | 435 条 |
+| 其中修正复习老师归属 | 401 条 |
+| 其中补齐完成状态和原系统完成时间 | 167 条 |
+| 另外核定已有历史待核对凭据 | 157 条 |
+| 本次核定收入凭据 | 324 条 |
+| 有效新增计薪 | 313 条,¥296.00 |
+| 重复复习不重复计薪 | 11 条,¥0.00 |
+| 本次解决同步冲突 | 435 条 |
+
+435 条任务中有 401 条涉及归属变更,其余仅补完成状态;167 条完成记录与上述任务有重叠,不能相加为任务总数。324 条核定凭据由 167 条新补完成凭据和 157 条已有历史凭据组成。
+
+本次新增收入包含 34 条 30 分钟课、279 条 60 分钟课,分别按 ¥0.50、¥1.00 计算。重复任务包括本次导入形成的 5 条副本,以及 6 条与既有有效收入对应的副本;均保留完成进度但不重复计薪。所有新增计薪均有来源课次、明确时长和计划当天完成证据。仍沿用用户此前确认的历史绑定老师核算口径,实际完成账号保持历史未知,不伪造老师或管理员操作身份。
+
+新系统原有转交,以及已有收入凭据的状态和完成时间差异均保留。特别是另 2 名学员的新系统转交不是待修复的旧系统漏同步。
+
+## 执行和验证
+
+1. 保存私有来源、任务、收入、核定、冲突及保护数据快照,确认无有效同步租约;写入前再次逐学员实时核对旧系统来源。
+2. 生产事务以全部任务快照做乐观版本检查,拒绝新系统转交、已有收入或来源身份变化。401 条归属变更增加版本和逐任务转交审计,保存幂等命令;补齐完成使用既有触发器生成历史零元凭据,再调用既有核定函数核算费用。
+3. 先完整事务试算并回滚。试算曾被既有计薪防重规则拦截,查明额外 6 条重复副本后将其明确核定为重复不计薪;没有绕过防重规则。最终试算回滚后的全部快照与执行前一致,才正式写入。
+4. 正式写入后回读 4,700 条范围内任务及全部相关凭据;原有 4,016 条原始收入凭据、703 条历史核定逐条一致。未计划修改的任务、全部账户、已有工资批次和明细,以及范围外全部学员任务均未改变。
+5. 管理端真实 `ops/payroll/review-rewards` 接口按 11 个老师/月范围分页读取,逐条验证全部 324 条本次核定凭据:313 条金额正确且显示「待结算」,11 条显示「重复复习,不重复计薪」。没有发放工资或刷新已有工资单。
+6. 正式操作再次执行返回 `alreadyApplied=true`;完整快照证明复跑没有改变任务、凭据、核定、账户、工资单或冲突。
+7. 直连同步、复习工资、时长口径、旧接口拉取、转交访问及课次转交共 54 项相关回归测试通过,失败 0。
+
+本次没有前后端代码或持久云函数发布。生产数据库和管理端接口已验收,浏览器和真机页面未验收;没有改变调度、设置结算就绪标记或执行全量同步。
+
+私有审计目录:`/Users/mac/.local/state/xiaoshu/cloud-releases/2026-11-02-review-transfer-audit/`。包含逐页来源、候选学员及排除依据、修复/收入计划、逐学员金额、试算与正式回执、前后快照、接口验收和回归日志。账号身份及生产逐条明细不提交 Git。