Răsfoiți Sursa

docs(release): verify November 18 morning batch in production

彭峰 2 zile în urmă
părinte
comite
6cf8192f9a

+ 322 - 0
docs/qa/morning-batch-release-2026-11-18.json

@@ -0,0 +1,322 @@
+{
+  "checkedAt": "2026-11-18T03:21:11.834719+00:00",
+  "sourceCommit": "ee9af726ebe98b460bf1d57e8bb5f0be8564859c",
+  "includedCommits": [
+    "13f60cd",
+    "b783c73",
+    "d0d986a",
+    "ee9af72"
+  ],
+  "web": [
+    {
+      "role": "admin",
+      "releaseId": "admin-morning-batch-ee9af726ebe9-20261118T031403515Z",
+      "commit": "ee9af726ebe98b460bf1d57e8bb5f0be8564859c",
+      "filesVerified": 96,
+      "routes": [
+        "admin/members",
+        "admin/learning-reports",
+        "admin/login",
+        "admin/payroll"
+      ]
+    },
+    {
+      "role": "mobile",
+      "releaseId": "mobile-morning-batch-ee9af726ebe9-20261118T031407139Z",
+      "commit": "ee9af726ebe98b460bf1d57e8bb5f0be8564859c",
+      "filesVerified": 105,
+      "routes": [
+        "pages/home/index",
+        "pages/shop/baobiao",
+        "pages/his/his",
+        "pages/companion/index",
+        "pages/stu/stu_abc"
+      ]
+    }
+  ],
+  "cdn": [
+    {
+      "id": "8225377758",
+      "status": "task_done",
+      "processing": 0,
+      "succeed": 1,
+      "failed": 0,
+      "total": 1
+    },
+    {
+      "id": "8225383878",
+      "status": "task_done",
+      "processing": 0,
+      "succeed": 1,
+      "failed": 0,
+      "total": 1
+    }
+  ],
+  "backend": [
+    {
+      "path": "xiaoshu/app/gateway",
+      "hash": "3a19f924ed7c7fe0b96877877511b7f353106607aced3647bcc9b51904b11900",
+      "changed": true
+    },
+    {
+      "path": "xiaoshu/ops/gateway",
+      "hash": "c4ace02b182ee45104d19587f005db660f6641a40b43cb8fb828b255eeadb9c0",
+      "changed": false
+    },
+    {
+      "path": "xiaoshu/ops/gateway-v3",
+      "hash": "53d58c5097c544ee58f329021e9c8461493c1c260a0e385cbdb070884069659a",
+      "changed": false
+    }
+  ],
+  "tests": {
+    "mobileWorkflow": 147,
+    "backend": 19,
+    "reportStyles": 6,
+    "mobileBuild": true,
+    "adminBuild": true
+  },
+  "pdf": [
+    {
+      "file": "admin-chinese.pdf",
+      "pages": 2,
+      "bytes": 626294
+    },
+    {
+      "file": "admin-english.pdf",
+      "pages": 2,
+      "bytes": 406482
+    },
+    {
+      "file": "admin-full.pdf",
+      "pages": 3,
+      "bytes": 1080014
+    },
+    {
+      "file": "teacher-chinese.pdf",
+      "pages": 2,
+      "bytes": 499087
+    },
+    {
+      "file": "teacher-english.pdf",
+      "pages": 2,
+      "bytes": 377734
+    },
+    {
+      "file": "teacher-full.pdf",
+      "pages": 3,
+      "bytes": 1058570
+    }
+  ],
+  "browser": {
+    "reportRoles": [
+      {
+        "role": "admin",
+        "pdfs": 3,
+        "measures": [
+          {
+            "variant": "full",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "700",
+            "meaningFont": "16px",
+            "rows": 36,
+            "overflow": 0,
+            "breakInside": "avoid"
+          },
+          {
+            "variant": "english",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "600",
+            "meaningFont": null,
+            "rows": 18,
+            "overflow": 0,
+            "breakInside": "avoid"
+          },
+          {
+            "variant": "chinese",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "400",
+            "meaningFont": null,
+            "rows": 18,
+            "overflow": 0,
+            "breakInside": "avoid"
+          }
+        ],
+        "reportReadable": null,
+        "pdfDownloadAvailable": null,
+        "errors": [],
+        "blocked": []
+      },
+      {
+        "role": "teacher",
+        "pdfs": 3,
+        "measures": [
+          {
+            "variant": "full",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "700",
+            "meaningFont": "16px",
+            "rows": 30,
+            "overflow": 0,
+            "breakInside": "avoid"
+          },
+          {
+            "variant": "english",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "600",
+            "meaningFont": null,
+            "rows": 15,
+            "overflow": 0,
+            "breakInside": "avoid"
+          },
+          {
+            "variant": "chinese",
+            "tableFont": "16px",
+            "promptFont": "16px",
+            "promptWeight": "400",
+            "meaningFont": null,
+            "rows": 15,
+            "overflow": 0,
+            "breakInside": "avoid"
+          }
+        ],
+        "reportReadable": null,
+        "pdfDownloadAvailable": null,
+        "errors": [],
+        "blocked": []
+      },
+      {
+        "role": "student",
+        "pdfs": 0,
+        "measures": [],
+        "reportReadable": true,
+        "pdfDownloadAvailable": false,
+        "errors": [],
+        "blocked": []
+      }
+    ],
+    "trainingWidths": [
+      320,
+      390,
+      1024,
+      390
+    ],
+    "readingRoles": [
+      {
+        "role": "teacher",
+        "width": 390,
+        "defaultRandom": true,
+        "manualSelectionPreserved": true,
+        "aiRequests": 0,
+        "dataWrites": 0
+      },
+      {
+        "role": "teacher",
+        "width": 1024,
+        "defaultRandom": true,
+        "manualSelectionPreserved": true,
+        "aiRequests": 0,
+        "dataWrites": 0
+      },
+      {
+        "role": "student",
+        "width": 390,
+        "defaultRandom": true,
+        "manualSelectionPreserved": true,
+        "aiRequests": 0,
+        "dataWrites": 0
+      }
+    ],
+    "libraryWidths": [
+      390,
+      1024
+    ]
+  },
+  "api": {
+    "checkedAt": "2026-11-18T03:16:22.581Z",
+    "realExistingTeacherSession": true,
+    "courseSelectionUnchanged": true,
+    "unitResults": [
+      {
+        "units": 7,
+        "ms": 268,
+        "exactProgressMatch": true
+      },
+      {
+        "units": 3,
+        "ms": 120,
+        "exactProgressMatch": true
+      },
+      {
+        "units": 4,
+        "ms": 228,
+        "exactProgressMatch": true
+      }
+    ],
+    "unitApiSamples": [
+      210,
+      153,
+      165,
+      120,
+      279,
+      127,
+      116,
+      128,
+      109,
+      192
+    ],
+    "unitApiPercentiles": {
+      "p50": 128,
+      "p75": 192,
+      "p95": 279
+    },
+    "comparison": "post-release API latency; not paired full-API baseline",
+    "wordResults": [
+      {
+        "words": 30,
+        "fullBytes": 45072,
+        "compactBytes": 8865,
+        "fullMs": 206,
+        "compactMs": 173,
+        "teachingDataAndProgressUnchanged": true
+      },
+      {
+        "words": 1,
+        "fullBytes": 1652,
+        "compactBytes": 447,
+        "fullMs": 128,
+        "compactMs": 95,
+        "teachingDataAndProgressUnchanged": true
+      }
+    ],
+    "businessWriteRequests": 0
+  },
+  "finance": {
+    "beforeAt": "2026-11-18T03:13:06.200Z",
+    "afterAt": "2026-11-18T03:18:56.471Z",
+    "unchanged": {
+      "users": true,
+      "profile": true,
+      "operations": true,
+      "transactions": true,
+      "reservations": true,
+      "creditFunctions": true,
+      "ledgers": true
+    },
+    "creditOperationCount": 5,
+    "associatedTransactionCount": 35,
+    "reservationRows": 6
+  },
+  "businessWriteRequests": 0,
+  "nativeAppPackagePublished": false,
+  "limits": [
+    "Browser viewports; not physical device or printer acceptance",
+    "Training and reading interaction checks use public assets with isolated data; no AI generation or submissions",
+    "API p75 is post-release sampling, not paired old/new full-API measurement"
+  ]
+}

+ 36 - 0
docs/qa/morning-batch-release-2026-11-18.md

@@ -0,0 +1,36 @@
+# 2026-11-18 上午修改合并发布
+
+用户明确授权“把今天上午修改的一起上线”。已发布后台和师生共用H5及本次两个应用读取函数,没有发布原生安装包。
+
+## 范围与版本
+
+- `13f60cd`:三种单词报表明细16px;中文填英文的中文提示仍400字重。
+- `b783c73`:老师首页增加专项训练入口,沿用现有内容目录。
+- `d0d986a`:阅读语篇类型/题材默认随机,保留手动选择;每次生成仅解析随机字段,不把抽样结果写回选择框。
+- `ee9af72`:单元进度查询补充数值索引条件,生词本分页使用精简教学响应。
+
+从 `ee9af726ebe98b460bf1d57e8bb5f0be8564859c` 干净归档构建;核对当前线上 `f815b666e28a` 之后的全部前端差异均属于以上授权文件,保留此前线上字体、阅读答案、财务回执、导出及并发优化。
+
+- 后台:`admin-morning-batch-ee9af726ebe9-20261118T031403515Z`。
+- H5:`mobile-morning-batch-ee9af726ebe9-20261118T031407139Z`。
+- 应用gateway仅替换nodeUnitPage/newWordPage;SHA256由 `b9a93b478ba6a046f2e680a1add54f0347173d648f7527e34ad07cda8c3f3f7d` 变为 `3a19f924ed7c7fe0b96877877511b7f353106607aced3647bcc9b51904b11900`,两个运营gateway保持原哈希。没有整体覆盖当前gateway或修改运行环境。
+- CDN任务 `8225377758` / `8225383878` 均task_done,失败0。
+
+## 验证
+
+发布快照通过147项移动端流程、19项后端、6种真实报表组件样式检查;移动/后台构建均成功。构建已有CSS预算及CommonJS告警不等于失败,未声称全仓所有测试重跑。
+
+公网与源站清单一致,201个资源逐文件SHA256及9条深链入口核验通过。
+
+1. 用真实已有管理、老师、学生会话验证报表。后台逐份下载三种PDF,老师一次下载三份独立PDF;共6份14页,全部栅格化逐页检查,无内容缺失、行截断、重叠或空白页。六种表格/提示实际computed font均16px,中文提示400、行break-inside avoid,单元格溢出0。学生390px能看自己的学习记录,继续没有老师专属PDF下载按钮。
+2. 公网实际页面资源验证老师专项训练入口:320/390/1024及390加大字体,入口、目录和文章跳转正常,首页没有预先拉取目录;该交互使用隔离数据,未产生生产业务写入。
+3. 公网阅读设置页面:老师390/1024、学生390均默认随机;手动及混合随机选择保持正确。使用隔离重复文章回执阻止实际生成,没有调用AI或写入文章/成绩。
+4. 真实老师会话在公网390/1024下,生词本显示30词并实际发送compact:true;教材7单元可显示及勾选,无溢出/JavaScript错误。三个教材返回的全部单元、页数、学习进度与发布前逐项一致。
+5. 发布后实际单元API十次抽样p50/p75/p95为128/192/279ms;这是新版线上请求采样,不冒充全接口的同时间配对旧/新对比。30条生词响应45072→8865字节,1条1652→447字节;与同时读取的完整响应逐字段对照教学数据和计数一致。课时/费用写请求0。
+6. 发布前后只读核对原充值排查涉及的学生及门店:账户、资料、5条充值操作、35条相关流水、6条预留原始行、4类历史课时流水摘要及财务SQL函数定义均一致。仅是这些对象和时间段的核对,不推断全体用户账户在正常使用期间不会变化。
+
+JSON聚合证据见同名 `.json`。原始身份、响应、源码备份、日志、实际PDF和截图保存在 `/Users/mac/.local/state/xiaoshu/qa/2026-11-18-morning-release/`,未进入Git。验证使用浏览器视口,没有实体手机、实际打印机听测或实体设备验收。
+
+## 回滚
+
+已逐文件备份两个线上版本和原应用函数。私有 `rollback-web.py admin|mobile` 只在入口/清单仍属于本次时恢复旧入口并刷新CDN;保留旧hash资源,不清空桶。`backend-release.mjs rollback` 先核对当前仍为本次候选哈希,再恢复原code;发现后续版本即停止。无需更改或回滚学生业务数据。