|
|
@@ -0,0 +1,47 @@
|
|
|
+# 2026-10-30 未发布更新上线记录
|
|
|
+
|
|
|
+## 发布范围
|
|
|
+
|
|
|
+按用户授权，提交并推送今天的代码，将尚未发布的相关更新部署至正式环境：
|
|
|
+
|
|
|
+- `11627fe`：学习记录词表默认隐藏中文，发音结束后显示该词释义；中断、翻页、离开页面不误显示。
|
|
|
+- `89ef58e`：Excel 词库批量预检、增量保存、逐行结果、失败重试和刷新恢复进度。
|
|
|
+- `1eee92a`：老师学习记录仅列出账号正常、且在该老师名下今天或以后仍有未完成、未取消排课的学员；处理失效的历史选择及分页。
|
|
|
+- `08619f7`：上线验收发现历史学员查询的数字转文本关联绕过现有索引，改用数字编号及模型字段关联。相关查询复用现有索引，无需迁移。
|
|
|
+
|
|
|
+缺失读音合成服务、结课后课表缓存刷新此前已经发布，本次保留这些线上行为。既有未跟踪迁移资料未提交。
|
|
|
+
|
|
|
+## 正式版本
|
|
|
+
|
|
|
+发布源代码：`08619f72519a857c836f4bd472653879f92b36ae`。
|
|
|
+
|
|
|
+| 应用 | 发布编号 | 公网文件校验 | 无版本参数页面入口 |
|
|
|
+| --- | --- | --- | --- |
|
|
|
+| 管理端 `https://admin.xiaoshu.pro` | `08619f72519a-20261030T031235709Z` | 96 个 SHA-256 一致 | 4 条通过 |
|
|
|
+| 移动端 `https://h5.xiaoshu.pro` | `mobile-08619f72519a-20261030T031236277Z` | 105 个 SHA-256 一致 | 8 条通过 |
|
|
|
+
|
|
|
+按后端、管理端、移动端顺序发布，源站文件回读通过后更新入口并刷新 CDN。未清空静态桶，旧版本资源保留。
|
|
|
+
|
|
|
+后端选择性更新 `xiaoshu.app.gateway` 的 `coachStudentPage`，以及 `xiaoshu.ops.gateway` / `xiaoshu.ops.gateway.v3` 的词库校验、预检、提交及状态函数；补充字段校验和结果汇总函数。与本次无关的线上函数逐项保持不变，发布后代码哈希回读一致。未整份覆盖线上网关，无新增表或字段迁移。
|
|
|
+
|
|
|
+## 验证
|
|
|
+
|
|
|
+- 全量前端测试：移动端 316 项、管理端 348 项通过。
|
|
|
+- 相关后端测试 41 项通过，覆盖词库导入、学员筛选、管理端读取和单词音频；数字关联调整后再次通过 5 项学员筛选测试。
|
|
|
+- 两端生产构建及 11 个云函数定义校验通过。原有样式体积和 CommonJS 警告仍存在，构建无错误。
|
|
|
+- 使用正式部署函数及真实数据库验证在排课老师的筛选：样本返回 4 位学员，服务端函数耗时约 222 毫秒。两位无当前排课的老师返回空列表。首次历史全量对比发生超时，修正索引关联后才继续发布前端；不将该次失败计为验收通过。
|
|
|
+- 正式运营接口创建专用目录和 8 条测试词，分 4 次增量提交完成；状态接口正确恢复进度，重放提交没有重复建词。预检样本约 1.56 秒，仅为本次测量。8 条词条及附表、1 个目录、1 个导入批次均已清理，审计记录保留。
|
|
|
+- 浏览器读取正式静态资源，以隔离接口和音频样本验证：中文在发音结束后显示、中断旧词不显示、刷新后恢复隐藏、不写学习结果、375px 无横向溢出；老师请求筛选范围且替换失效选择；管理端恢复上次导入并使用增量协议继续完成。
|
|
|
+
|
|
|
+浏览器交互检查使用隔离数据，后端业务检查使用专用测试数据及只读真实数据；上述结果不代表手机微信实机验收。
|
|
|
+
|
|
|
+## 回退及证据
|
|
|
+
|
|
|
+本机受限目录：`~/.local/state/xiaoshu/cloud-releases/2026-10-30-pending-updates/`。
|
|
|
+
|
|
|
+- 首次发布前后端基线及计划：`initial-backend-release/`。
|
|
|
+- 数字关联修正前后端基线、最终计划及回读：各网关 baseline、`gateway-plan.json`、`cloud-published.json`。
|
|
|
+- 两端入口、版本及被覆盖的同名资源备份：`admin/baseline/`、`mobile/baseline/`。
|
|
|
+- 后端业务、清理、静态文件及浏览器验证：`backend-verification.json`、`current-teachers-verification.json`、`test-batch-cleanup.json`、两端 `verification.json`、`browser-verification.json`。
|
|
|
+
|
|
|
+回退时恢复所需后端基线和两端旧入口、版本清单及同名资源，刷新对应 CDN；不删除现有词库、学习记录、TTS 缓存或已生成音频。
|
彭峰