# 会员历史课时流水补导验收（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 个业务数据集已完成当晚同步，也未更新夜间成功标志。未核实身份的账号不得通过放宽校验来补流水。