瀏覽代碼

docs: record writing review and selection release

彭峰 8 小時之前
父節點
當前提交
54a6207421
共有 1 個文件被更改,包括 38 次插入 和 0 次删除
  1. 38 0
      docs/qa/writing-notes-and-selection-release-2026-11-02.md

+ 38 - 0
docs/qa/writing-notes-and-selection-release-2026-11-02.md

@@ -0,0 +1,38 @@
+# 选词后续调整与语法写作笔记抗遗忘发布(2026-11-02)
+
+用户明确授权“现在上线更新一版”。已发布此前尚未上线的 `8cd0f73` 选词调整及 `5b3713b` 语法写作课笔记抗遗忘,应用源提交为 `5b3713be3b57c1d30c354d2f8e9a31f3d289d0b0`。
+
+## 发布范围与版本
+
+- 手机端:`https://h5.xiaoshu.pro`,release `mobile-5b3713be3b57-20261102T064635669Z`,105 个文件,源站与公网 SHA-256 均一致;CDN 刷新任务 `8050494956`。
+- 后端:仅更新 `xs_lesson_complete(text,text,text,numeric,timestamp with time zone,text,jsonb)`,并在应用网关替换 `recordDetailData`、`appReviewPage`,新增 `notesReviewSourceSql`。所有其他线上网关函数逐一比较、保持不变,保留了其他任务已发布的同步修复。
+- 管理端无待发布的页面变更,未重新发布;公网清单仍为 `c4a837ec02ac-20261102T042104457Z`。此前已上线的报表字号、复习期学员筛选保持在现有线上版本中。
+
+结课 SQL 函数体哈希:
+
+- 原版本:`89422d2477048838f3fa55b828972d69c9d9b4c372820ba763c643066614f1fc`
+- 新版本:`ba250977dcb923d1be157d6f7185feb80aef8ea38725d15f9948b2aeb1bfa0bd`
+
+应用网关哈希:
+
+- 原版本:`daf32e16ca4ada49c025becefd9d8126d5bfa40b6c7426c3ea62002e060900c4`
+- 新版本:`a8f27027e749f44b9ba28b9e3b7a4eebbe09026f19a797536562c9b2b97d29a9`
+
+## 验证
+
+- 本次重新执行 76 项相关后端测试及手机端生产构建,全部通过。源提交还已有完整移动端 331/331 通过记录。
+- SQL 和应用网关均完成正式回读哈希校验,网关 `migration_status` 正常。
+- 正式发布后,以真实分配老师身份、只读事务验证已有语法写作来源记录 `869707`、复习任务 `869717`(计划日期 2026-10-18):空词表被识别为笔记复习,学习记录授权通过,任务在当天列表可见。没有提交该任务或产生真实复习工资。
+- 无版本参数的手机端清单指向本次 release,默认入口以及选词、训练、复习、复习日历、课程详情路由均与当前入口哈希一致;标准公网验证另覆盖八条入口/深层路由。
+- 正式公网前端配隔离 API 浏览器验证:1024/375/320px 无横向溢出或单词与操作按钮重叠,批量操作靠右;第一遍和第二遍可全选、取消例外并继续学习,连续通过两遍使用不同的保存标识,第三遍无全选/重学操作。
+- 正式公网笔记复习页面在 375/320/1024px 显示说明及 48px 高“结束复习”按钮;仅发送一次模拟完成请求,成功响应后显示完成,无页面错误。
+
+浏览器操作使用隔离 API,不是线上真实课程结课、实际工资入账或微信实机验收。生产只读样本证明现有任务可访问;新结课生成十轮任务及费用规则由本地真实 SQL 流程测试和线上函数体一致性支撑。
+
+## 发布过程与回滚证据
+
+私有证据及旧入口、清单、网关、SQL 定义保存在:`/Users/mac/.local/state/xiaoshu/cloud-releases/2026-11-02-writing-notes/`。
+
+最初的只读校验取样查询超时,改为先取有限来源再使用数值关联查询后通过;没有改动业务数据。SQL 发布脚本起初用字符串替换参数拼接函数体,使正则中的 `$'` 被 JavaScript 当成替换指令,DDL 校验失败,事务回滚且正式函数未变化。已改用回调返回替换体,并新增完整函数体一致性检查,再正式发布成功。
+
+只更新指定函数和手机端资源,旧静态资源未删除。没有重新执行同步任务、补写历史已结课课程缺失的复习计划,或改写已有工资凭据。临时核验函数均在执行后删除并确认清理。