teacher-earnings-2026-10-15.md 9.6 KB
老师结课、复习和收入优化交付记录
代码基线：7bb38260e49e21dec0f466e4de713f868aa7b365。目标网关版本：2026-10-15-teacher-earnings-v12。本轮完成源码与本地验收，尚未部署生产，也未修改任何线上历史工资。
已实现
- 老师可直接结束课程，反馈后补。事务仍校验身份、课程状态、学习批次、课时凭据，保存完课工资快照、扣课时并生成适用复习计划；后补反馈不重做结课。独立 feedbackStatus 区分待补和已提交。
- 销课记录和结课结果显示实际课酬，合法零元与工资待核对分开。无统一固定单价、无测试账号工资特例。
- 复习首次完成按数据库生成的北京时间完成时间计薪。当天 1 元、逾期 0 元、未来拒绝，重试返回原凭据；状态与收入同事务。行锁后取实际服务器时间，避免请求排队跨午夜仍使用请求开始时间。旧 content_update 入口同样受规则约束。
- 首页仅显示全部今日任务，按每页 100 条完整加载后显示；发送 scope 与明确日期兼容旧接口，并在客户端过滤非今日记录，计数与列表一致。每条“查看计划”进入该任务详情；底部只保留“查看全部学员复习计划”，进入完整日历。没有任务、全部完成与加载失败分别呈现。
- 首页、我的、销课和复习工资使用后台同一计算规则与净收入视图。老师收入是累计已记账收入，与工资实际发放分开；不再按课次数乘 20／40 元估算。缺失工资依据计入待核对数量。
- 老师浏览日历、销课、工资、课程详情等页面保留现有底部导航。复习页去除内容区重复的“返回复习任务”，沿用左上角返回；练习中未提交离开有提示，提交中禁止离开；完成后有继续今日、返回原列表及首页，原列表日期、学生、页码与滚动位置可恢复。缓存隔离账号、日期、筛选和业务数据版本，跨页／标签写入失效；首页今日列表单独按登录账号、会话与北京时间自然日缓存到 sessionStorage，返回首页、切回前台和同日重载页面均复用，跨日／切换账号／新登录重新加载；手动刷新保留。服务器确认复习成功后更新缓存任务及计数，不重拉列表。
- 历史错计提供只读核对工具、后台筛选和逐条纠正入口。原凭据不可改写；未结算来源净额冲销，草稿行移除，已审核／已发放原单保留，后续草稿记唯一关联调整。理由、原金额、调整金额和工资单可导出。没有运行历史纠正。
验证证据
| 检查 | 结果及限制 |
|---|---|
| Node / 数据库回归 | 211 项通过；真实 PostgreSQL DDL、触发器、约束与事务在 PGlite 执行 |
| 移动端 ChromeHeadless | 228 项通过，含未反馈结课、防重复提交、完整今日列表和按登录／日期缓存 |
| 管理端 ChromeHeadless | 271 项通过，含纠正权限、理由和承接草稿版本检查 |
| 双端生产构建 | 通过；存在原有 SCSS budget 与 CommonJS 警告 |
| cloud:validate | 11 个函数校验通过 |
| 本地动作覆盖检查 | 122 个使用动作检查，missing 为空 |
| 浏览器页面 | 本地生产构建＋隔离接口数据：当天／逾期完成、金额、首页缓存复用、手动刷新错误态、导航通过；360px／390px 截图已人工查看，姓名和工资不互相挤压 |
| 组合迁移 | 一笔事务安装，连续执行两次通过，原完课和反馈记录保留 |
复现：npm run test:server、npm run test:mobile:ci、npm run test:admin:ci、npm run build、npm run cloud:validate、npm run app:actions:audit:local。浏览器验收：npm run teacher-earnings:browser，截图／结果写入忽略目录 tmp/teacher-earnings-qa/，不会连接线上账号。
PGlite 单连接的并发调用会排队，不能证明生产 PostgreSQL 多连接并发性能。浏览器模拟数据不能证明线上账号、手机浏览器或微信 WebView 已通过。
性能实测及边界
以下为最初 4 条预览版本的查询阶段测量，不代表后来“全部今日任务＋当天缓存”版本的首载性能；后者首载请求量随当天任务数变化。
固定 10,000 条任务，40 条今天任务，原始与修改后 appReviewPage 使用同一 PGlite 数据库和现有索引。先各预热 4 次，再按 AB／BA 交替各测 20 次，不注入网络延迟。原始首页请求 pending／20 条，修改后请求 today／4 条并省略日历和学员元数据。
| 测量 | 原版 | 修改后 |
|---|---|---|
| p50 | 120.66 ms | 34.90 ms |
| p75 | 124.43 ms | 35.90 ms |
| p95 | 134.27 ms | 36.39 ms |
| 页面数据 SQL 数 | 6 | 3 |
| 序列化响应 | 28,665 bytes | 2,046 bytes |
| 首页结果中的今日任务 | 0 | 4 |
| 错误率 | 0/20 | 0/20 |
p75 查询阶段下降约 71%。这是本地 SQL 和序列化测量，排除了真实网络、版本查询和浏览器渲染，不等于五条真实路径已经达成 50% 提速。最初缺少索引的探测中，新查询反而更慢，因此保留索引核验作为发布检查；没有据此盲目添加生产索引。原始采样见 perf/teacher-review-2026-10-15.json。
复现：准备基线提交的 scripts/cloud/mobile-teaching.js，执行 npm run teacher-earnings:benchmark -- --baseline=/绝对路径/mobile-teaching.js。线上须核查现有 CommonModel/company/model/item、CommonModel/company/model/general、DailyStudyRecord/company/id、MemoryPracticeRecord/company/user/time 与 coach/status 索引和实际执行计划。
以下仍待同一隔离账号、设备、网络下交替各测至少 10 次，报告 p50／p75／p95、请求数、响应体积及错误率：
- 老师首页：从导航到今日任务和收入均可使用。
- 今日复习：从入口到任务列表可操作。
- 复习内容：从任务点击到单词可操作。
- 完成复习：从点击提交到服务端确认且页面显示结果。
- 工资明细：从入口到真实金额明细可核对。
仍需关注：累计课酬读取规范化工资来源及历史规则，特定学员复习仍可能等待旧数据同步；本轮未将旧同步改成无监控的后台任务，也未宣称这两条路径已提速。
线上只读核对
2026-10-15 11:43 北京时间只读检查公开 migration_status：HTTP 200，现网仍为 2026-10-14-member-credit-v11，尚无 app_review_complete。只检查版本，不触碰账号或业务数据。
本轮环境检查：未提供 XIAOSHU_SESSION_TOKEN 或 XIAOSHU_MASTER_KEY。因此没有核对录音中的钱老师账号、10 月 13 日课程与真实错计名单，不能把测试数据当作业务清单。
在已授权环境设置现有管理员会话（不要把凭据写进文档或终端参数），使用明确老师编号和年份范围：
npm run teacher-earnings:audit -- --check
npm run teacher-earnings:audit -- --coach-id=实际编号 --from=YYYY-MM-DD --to=YYYY-MM-DD --output=/私有路径/核对目录
工具只读查询，输出课程／学习批次／保存计划／既定周期／任务归属／错计凭据及工资单状态。按实际结课日核对 1、2、3、5、7、9、11、14、17、21 天；缺少完成日或索引时列出限制。无适用学习内容的课不要求生成单词复习任务。历史手工转交必须结合转交审计解释，不能直接按当前预约老师覆盖。错计接口要求 beijing-day-v1 标记，旧网关不会被误当作完整清单。
先核对唯一老师身份和年份，再运行；输出私有 JSON，不进入 Git。清单完成后逐笔确认，不自动批量冲销、不自动发放。
发布与回滚
发布需确认本次提交版本，按计划另行执行。本轮没有运行以下写入步骤。
- 确认现网已具备 member-enrollment、mobile-teaching、lesson-study-batches、payroll-integrity 前置安装及 Parse 类。读取线上网关版本和发布文件哈希，确认同步任务空闲、既有索引和关键表结构。
- 在可信环境设置主密钥和现有经理会话。
npm run teacher-earnings:migrate只输出 SQL 哈希，不执行；审核哈希后使用--apply --backup-dir=/私有绝对路径。脚本验证身份和活动同步任务，先保存一致性表数据、函数及列定义，再将四份兼容 SQL 作为单事务执行；失败回滚，成功回读函数和字段。临时函数限定操作者、15 分钟过期且 finally 清理。不要复用同一个备份目录覆盖上次备份。 - 核对 readback 三项均为 true、备份可读取。发布
xiaoshu.app.gateway、xiaoshu.ops.gateway、xiaoshu.ops.gateway.v3，再发布本次移动端与管理端构建；确认 migration_status 为目标版本。保留线上原始文件备份。 - 用隔离账号执行真实闭环和金额回读：不填反馈结课→只扣一次→待补反馈→补交不重复记薪；当天／昨天任务分别 1／0；旧客户端重试、新客户端并发、跨日重试；老师、明细、后台、导出金额一致。再核对录音账号只读清单。
- 分别完成手机浏览器、真实微信 WebView 和上述五条路径性能验收，再开放发布范围。具体历史工资调整只执行已核对的单条记录。
回滚优先退回前端文件，必要时回退后端展示逻辑；数据库新增账本、调整凭据、防重约束、当天资格规则和已发生的真实账务必须保留。不得删除凭据、改回金额或恢复可绕过资格判断的完成函数。历史纠正不通过删行撤回；如纠正依据有误，另行审核财务调整。新旧客户端仍使用同一数据库守卫。