xiaoshu-app/docs/qa/lesson-records-2026-10-13

上课记录与抗遗忘转交验收

版本：2026-10-13-lesson-records-v10。前端在本地验证，未发布前端；配套数据库迁移和云函数已发布并回读源码校验。

入口与行为

• 左侧「记录管理 → 上课记录」：姓名、会员 ID、授课老师、门店、课程和日期筛选，默认全部历史，北京时间倒序；按真实课次去重计数。
• 每页 20 / 50 / 100；指定会员可查看全部；导出保持筛选条件，并检查跨页快照，变化时要求重试。
• 会员详情复用同一列表；排课中心、会员详情和集中列表使用同一反馈详情。历史原始点评完整保留，未记录字段不猜测补写。
• 管理员可转交本课或该学员全部已有未完成复习，包含逾期、今天、未来。预览展示数量、日期、原陪练和影响课次，必须填写原因。
• 转交有版本校验、事务、幂等回执和逐任务审计。与复习完成使用同一任务行锁；新陪练可读取所接任务的来源词表，原陪练不能继续提交已转交任务。
• 原授课老师、已完成任务、历史工资和后续新课默认陪练不变。新陪练完成任务按新归属计薪一次。
• 夜间同步显式保护已转交任务；页面触发旧接口刷新也保护归属和完成状态，冲突留痕。

验证结果

检查	结果
管理后台测试	266 通过
学生／老师端测试	218 通过
服务端测试	192 通过
双前端生产构建	通过；已有样式预算/CommonJS 警告
云函数语法、动作覆盖	11 个定义有效，120 个调用动作无缺失
线上隔离账号专项	16 项通过，包含并发、越权、停用陪练、旧同步保护和工资归属
线上教学业务回归	74 项通过；隔离数据已清理
本地浏览器连接真实后端	7 项通过：跨页、全部历史、日期、导出行数、反馈、窄屏、会员入口复用
部署回读	两版运营网关、移动端网关、直接同步函数均与本次代码一致；原通用管理网关未变

专项数据库测试覆盖同课次重复来源合并、55 节历史分页、姓名与日期组合计数、完整反馈、两种转交范围、逾期任务、重复请求、旧预览失效、完成/转交竞争、停用目标和跨帐套拒绝。线上并发测试使用独立请求连接；不会转交真实学员任务来做测试。

历史核对与定向补齐

• 截图会员 ID 1857：旧系统 4 节，新系统 4 节，逐条业务 ID 和反馈匹配。
• 客户口述姓名在旧系统实际匹配会员 ID 1825：初查旧 51、新 50；缺少 2026-10-13 20:38 的课次 877550（预约 875450）。
• 核实旧接口原始数据和真实师生身份，备份后进行事务回滚演练，再定向补齐 1 条学习、1 条上课、10 条已有未完成复习。
• 对应预约为未修改的原始导入记录（创建/修改时间一致、无新教学凭据）；事务锁内再次比对完整快照后同步旧状态。未重新结课或重新扣费。
• 重跑命中审计回执，无重复新增。回读旧/新均 51 节，51 条业务 ID 和反馈全部匹配；余额、充值流水和复习工资前后相同。
• 51 条真实历史已浏览器验证翻页、查看全部、倒序及 Excel 行数一致。

部署与证据

迁移入口：node scripts/migrate-lesson-records.mjs --apply，需要受保护环境里的主密钥和有效管理会话；迁移只建结构/函数，不自动转交现有任务。数据库迁移完成后发布两版运营网关、移动端网关和直接同步函数。

备份、部署校验、隔离验收结果、定向补齐前后数据和包含真实资料的截图/Excel 保存在本机受保护的 /Users/mac/.local/state/xiaoshu/cloud-releases/2026-10-13-lesson-records-v10/，不提交真实反馈、会话令牌或密钥。

独立存在的同步阻塞

Mac 23:00 LaunchAgent 已恢复并确认在调度。今晚全量同步因 legacy_account_identity_conflict 安全中止；本次定向补齐不能代表全量同步成功，未伪造检查点或完成状态。账号身份冲突仍需单独核对处理。

陪练选择交互补充

目标陪练改为白底、绿色高亮的页面内搜索列表，支持姓名片段和编号匹配、方向键/回车选择、Escape 收起及无匹配提示；范围改为单选项。修改搜索会清空旧目标与预览，未从结果中选定不能转交。后台测试 268 项通过，生产构建通过；真实后台浏览器检查搜索、键盘、空结果、白底样式与原有查询/导出流程通过。未提交真实转交，无后端变更。含真实姓名的截图保留在本机私有验收目录。

2026-10-14 展开区域自动定位

更换按钮在内容渲染后平滑滚动详情抽屉，让转交区域底部进入视野；展开或输入搜索时同样定位老师选择区域。只滚动详情抽屉，尊重系统减少动画设置，关闭组件后取消待执行定位。候选列表高度适配视口并独立滚动。真实浏览器在 1440×720 和 390×640 下检查面板底部、搜索框顶部和列表底部的实际坐标通过；268 项后台测试与生产构建通过。无云函数或业务数据改动。