member-ledger-backfill-2026-10-14.md 3.1 KB

会员历史课时流水补导验收(2026-10-14)

原因

此前仅许诺完成四类历史流水样本补导;账户余额同步不等于充值、扣减明细同步。Mac 夜间直接接口执行器在业务数据之前的账号身份冲突处阻塞,未进入财务流水阶段。因此其他会员余额存在,但页面查不到完整历史流水。

本次直接使用已部署管理鉴权接口,从旧 WXAPP user_point_list 分账户持续分页读取;没有使用同步桥、没有执行充值或结课。

实际结果

  • 四类账户完整核验 159 名学员,636 份服务端回执,17,105 条来源记录;本次新增 16,879 条。
  • 默认“正常、学习中”会员列表现为 162 人,其中 158 人已完成四类历史流水核验。4 人(ID 77、53、52、23)没有可靠的旧系统身份映射,保留待核验,不按相同数字 ID 强行关联。
  • 张洪睿(1562)经用户明确确认是陪练老师;旧系统 GroupID=3。备份后事务内仅修正 identityType 为 coach,记录修改前后及确认依据。真实接口回读确认陪练列表可见、会员列表不再显示。已有账号的直接同步分支保留新系统身份及余额。
  • 176 条早期导入流水存在精确 8 小时时区偏移。仅在旧来源键、业务编号、用户、增减数量、原余额、原始说明、操作人完全匹配,且无创建/更新时间、无新系统业务单或已确认来源哈希时修正;逐条保存前后审计。其余冲突继续拒绝覆盖。
  • 1,206 个账号的四类余额逐项比较未变;CreditTransaction、ReviewReward、LessonRecord、PayrollLine 的数量及全行校验和均未变化。

初始候选清单包含非默认列表中的停用账号、旧陪练身份及管理账号,服务端身份校验拒绝这些导入。批次原始报告仍标为 partial,不能描述为所有账号或全量夜间同步成功。

验证与发布

  • node --test scripts/tests/member-credit-ledger.test.mjs:6 项通过,含分页、成套充值/退回、体验限制、结课、预留、时区修复与幂等保护。
  • npm run cloud:validate:11 个云函数定义通过。
  • 服务端按业务编号集合与来源哈希重新计算 636 份回执校验和,全部一致。
  • 真实页面抽查:曾知行 63 条、胡竣敏 94 条,首屏各 20 条并可展开余额明细。曾知行重复补导新增 0 条,流水总数及版本不变。
  • 已备份实际线上函数,只替换经测试的财务导入模块;xiaoshu.ops.gateway.v3、xiaoshu.ops.gateway、xiaoshu.sync.direct-v1 发布后全文回读一致。无需数据库结构迁移,无前端修改或发布。

私有备份、批次回执、源数据及浏览器验证存于本机权限受限目录 /Users/mac/.local/state/xiaoshu/cloud-releases/2026-10-14-member-credit-ledger/,不提交凭据及逐人原始数据。

保留的边界

夜间任务的其他账号身份冲突仍是独立阻塞;本次财务补导不代表原 9 个业务数据集已完成当晚同步,也未更新夜间成功标志。未核实身份的账号不得通过放宽校验来补流水。