Просмотр исходного кода

docs: record combined learning improvements production release

彭峰 12 часов назад
Родитель
Сommit
1c2de596bb

+ 2 - 2
docs/qa/coach-student-history-fix-2026-11-02.md

@@ -1,4 +1,4 @@
-# 2026-11-02 老师学习记录学员列表漏显修复(未上线)
+# 2026-11-02 老师学习记录学员列表漏显修复(已上线)
 
 ## 问题及真实数据核查
 
@@ -25,6 +25,6 @@
 - 用候选函数在正式数据库中只读验证:计然可进入首屏,学习记录权限检查通过;该老师的正常学员列表由 2 人变为 3 人,查询约 99 毫秒,未混入停用、删除或非学员账号。上一版无限保留历史学员的逻辑已替换。
 - 用现有真实数据只读模拟 11 月 2 日、11 月 22 日和 11 月 23 日,计然分别为显示、显示、不显示;未修改正式服务时间、复习任务或完成状态。这是候选代码验证,不代表正式业务入口已经更新。
 - 核查期间未修改用户、排课、学习记录或同步状态。临时诊断函数执行后已清理。
-- 按用户此前“只推代码、暂不上线”的要求,本次修复仅提交、推送,未更新正式网关或前端。三份报表的待发布字号调整也未上线。
+- 最初按用户要求仅提交推送;后续已获得联合发布授权,并选择性更新正式学员筛选函数。正式处理函数以裘斯涵老师身份验证可返回计然,见 [联合发布记录](combined-learning-release-2026-11-02.md)。
 
 受限本机证据目录:`~/.local/state/xiaoshu/cloud-releases/2026-11-02-coach-student-jiran/`,保存网关基线、只读查询结果、候选代码计划、`preflight-result.json`、`review-data.json` 和 `review-boundary-result.json`。

+ 41 - 0
docs/qa/combined-learning-release-2026-11-02.md

@@ -0,0 +1,41 @@
+# 2026-11-02 选词、复习期筛选及报表字号联合发布
+
+## 发布范围
+
+按用户“把这次选词优化、计然的复习期筛选,还有报表字体调整等一起上线”的授权,发布源代码 `c4a837ec02ac8d9548ed9a6cc4a0e99405fa4970`。
+
+- `f71d433`:常驻小号认识/不认识按钮、全选本页及批量判断、识词结果自动按最多 100 个顺序保存、失败幂等重试与加载偏移校正。
+- `02d76e0`:正常学员仍有当前排课,或分配给该老师的有效未完成复习任务计划在今天及以后时,继续出现在学习记录列表。替换 `3726173` 的永久保留历史学员逻辑。
+- `cf86940`:三份学习报表使用最新字号——英文单词 24px、中文释义 18px、音标/例句 14px、填空题目 20px。管理端和手机端下载同步。
+
+## 正式版本
+
+| 应用 | 发布编号 | 公网文件 SHA-256 校验 | 无版本参数入口 |
+| --- | --- | --- | --- |
+| 管理端 https://admin.xiaoshu.pro | `c4a837ec02ac-20261102T042104457Z` | 96 个一致 | 4 条深层入口,另核对学习报表页 |
+| 手机端 https://h5.xiaoshu.pro | `mobile-c4a837ec02ac-20261102T042104958Z` | 105 个一致 | 8 条深层入口,另核对选词页 |
+
+后端仅替换正式 `xiaoshu.app.gateway` 的 `coachStudentPage`,其余函数逐项保持一致。发布前重新备份并校验并发变化,发布后代码回读哈希一致。未覆盖整份本地网关,未迁移数据库或批量修改业务数据。
+
+前端先上传资源并核对源站文件,再更新版本清单、入口和刷新 CDN。两端无版本参数的版本清单及业务页面入口均为本次版本。旧版静态资源保留。
+
+## 验证
+
+- 同一应用源码此前已通过移动端 327 项、管理端 348 项,共 675 项前端回归;之后的源码提交仅增加其他操作记录。本次重新通过 27 项发布及相关后端检查、11 个云函数定义校验,并重新完成两端生产构建。既有样式体积及 CommonJS 警告仍存在。
+- 正式网关代码回读一致;在服务器上以裘斯涵老师的真实用户对象执行已发布的正式 `e_user_list` 处理函数,返回计然高中(1802),学员列表为 3 人,学习记录权限检查通过。当前未完成复习的最后计划日为 2026-11-22。
+- 真实数据只读模拟:11 月 2 日、11 月 22 日仍显示计然;没有新增排课或复习时,11 月 23 日移出。未修改复习完成状态或服务时间。
+- 两端构建产物逐项核对最新四类报表字号;手机端已包含批量判断和重试状态。
+- 浏览器加载正式 H5 静态资源,使用隔离接口和测试账号检查:1024px、375px、320px 均无横向溢出或长单词遮挡按钮;全选后排除一个词,只训练排除的词;205 个认识词按 100/100/5 保存且只计数一次;页面无运行时异常。
+
+浏览器交互验收使用隔离业务数据,老师学员筛选验收使用正式数据库及已部署处理函数;上述结果不代表微信实机、实体打印或真实课堂写入验收。
+
+## 备份及回退
+
+受限本机目录:`~/.local/state/xiaoshu/cloud-releases/2026-11-02-combined-learning/`。
+
+- 网关发布前完整基线:`app-gateway-prepublish.json`;候选及变更哈希:`gateway-plan.json`;发布/验收回执:`cloud-published.json`、`cloud-verification.json`。
+- 两端旧入口及版本清单:`admin/baseline/`、`mobile/baseline/`;本次没有内容不同的同名资源覆盖。
+- 静态上传、CDN 刷新、文件校验及源码检查:各端上传日志、`cdn-refresh.json`、`verification.json`、`source-check.json`。
+- 默认入口、真实数据边界及正式页面隔离交互验证:`default-entry-verification.json`、`review-boundary-result.json`、`browser/verification.json` 和截图。
+
+回退时先检查当前网关是否仍为本次哈希,再恢复所需的发布前函数版本;恢复对应端旧入口和版本清单、刷新 CDN。保留业务记录、复习分配及现有静态资源,不回退其他已完成的业务数据操作。

+ 2 - 2
docs/qa/teacher-word-selection-2026-11-02.md

@@ -1,4 +1,4 @@
-# 2026-11-02 老师选词操作优化(未上线)
+# 2026-11-02 老师选词操作优化(已上线)
 
 ## 问题与修改
 
@@ -21,4 +21,4 @@
 
 ## 发布状态
 
-仅提交、推送本次客户端修改、测试及记录,未部署前端或后端。此前待发布的报表字号和老师学员复习期筛选亦未随本任务上线。
+已按用户后续授权,与报表字号、老师学员复习期筛选一起发布至正式环境。发布版本、正式资源校验及回退记录见 [联合发布记录](combined-learning-release-2026-11-02.md)。