xiaoshu-app/docs/qa/writing-notes-review-2026-11-02.md

语法写作课笔记抗遗忘（2026-11-02）

行为

小学、中学、高中语法写作课结课后，即使没有单词批次，也会在同一结课事务内创建空的课堂学习来源记录，并生成第 1、2、3、5、7、9、11、14、17、21 天共十轮抗遗忘任务。任务分配给预约的复习老师（无独立复习老师时沿用授课老师）；不填充虚构单词。重复结课不生成第二份，结课失败时记录和任务一同回滚。

复习日历、今日任务、学员筛选和汇总均包含这些任务。后端确认来源为同一学员的已结课语法写作预约后，返回笔记复习标记；前端显示课堂语法笔记、写作要点或课后练习提示及“结束复习”。普通缺失单词的记录继续保留原错误处理，不自动认作笔记任务。

结束复习复用现有 app_review_complete 和 SQL 计薪入口：30 分钟课按现行 0.5 元，60 分钟课按现行 1 元；计划当天由分配老师完成才计费。学生自主复习、逾期补做及防重复计费规则保持一致。未到计划日不能提前完成，不展示假成功。

本地验证

• 后端相关八个文件共 76 项测试通过，含三类课程与 30/60 分钟、十个日期、真实批次 SQL、空来源关联、任务老师、事务回滚、真实结课任务的计薪时长解析、提前完成拒绝、无单词按期完成及重复提交。
• 移动端学习模块定向集成测试 69/69 通过；完整移动端回归 331/331 通过。
• npm run build:mobile 通过，仅有既有构建预算及 CommonJS 提示。
• npm run cloud:validate 验证 11 个云函数定义通过。
• 只读独立代码审查未发现阻塞问题。
• 浏览器使用本地应用和隔离 API，375/320/1024px 均无横向溢出，“结束复习”按钮高 48px；结束只发送一次任务请求，服务端成功响应后显示完成状态，无页面错误。

本地浏览器证据：/Users/mac/.local/state/xiaoshu/qa/2026-11-02-writing-review/，含三个宽度的页面截图、完成截图、verification.json 和 browser-check.cjs。

交付边界

本次仅提交并推送代码，不发布前端、不更新线上云函数或 SQL，不补写历史已结课课程的缺失任务。浏览器验证使用隔离数据，不能当作线上真实课程或实际工资入账验收。上线时需要一并更新 xs_lesson_complete、应用网关（recordDetailData、notesReviewSourceSql、appReviewPage）及移动端。