Files
gongxue-base/docs/refactor/taro-h5-browser-qa-20260712.md
2026-07-12 19:26:57 +08:00

2.8 KiB
Raw Blame History

Taro H5 浏览器验收记录2026-07-12

验收范围

  • 产物:学生端、租户后台、平台后台 H5
  • 浏览器Codex 应用内 Chromium 浏览器
  • 视口:桌面 1440x900、移动 390x844
  • 数据:本地 mock API不连接生产数据库或第三方 provider
  • 流程:首屏渲染、控制台、页面溢出、每个门户至少一个主入口交互

为了让应用内浏览器直接访问本地 API视觉验收使用相同代码的 preview 构建。验收结束后必须重新生成 production 构建并重跑静态及交互烟测preview 产物不能用于发布。

结果

门户 桌面首屏 移动首屏 控制台 error/warn 页面级横向溢出 主入口交互
学生端 通过 通过 0 0 开始刷题 进入题库页
租户后台 通过 通过 0 0 学生运营 进入学生运营页
平台后台 通过 通过 0 0 租户管理 进入租户管理页

独立 Chrome 业务交互烟测另行覆盖三端完整关键链路,最终结果为 33/33。Taro H5 runtime 加固后Input 探针验证挂载前 before-mount 和挂载后 after-mount 均正确同步Button 探针连续切换 loading 200 次loading DOM 节点保持同一引用,子节点数始终为 1,显示状态为 none -> inline-block -> none

发现与前端重构约束

  1. 当前界面可用且响应式基础成立,但仍是功能原型,不代表视觉设计已达到正式商用标准。
  2. 移动端无页面级横向滚动;顶部导航采用横向可滚动模式,属于既有设计行为。
  3. 学生端构建入口约 500 KiB,且存在多个超过 244 KiB 的异步资源。前端重构必须建立路由拆包、资源预算和低端移动网络首屏指标,不能在当前入口继续无约束叠加组件。
  4. 租户后台工作台 DOM 中存在位于横向快捷操作容器可视区之外的按钮,但容器自身裁切且页面宽度未溢出;正式重构时应改为明确的滚动、折叠或响应式操作布局。

复现

# 应用内浏览器视觉 QA 必须先生成三套 preview 产物。
npm run build:taro:h5:preview

# 该命令保持运行并打印三个门户 URL若检测到 production 产物会直接拒绝启动。
npm run serve:taro:h5:qa

# 视觉 QA 结束后必须重新生成 production 产物preview 产物不得发布。
npm run build:taro:h5:student
npm run build:taro:h5:tenant
npm run build:taro:h5:platform
npm run smoke:taro:h5
npm run smoke:taro:h5:interaction

截图证据保存在本机临时目录 /tmp,不进入发布仓库:

  • tiku-student-desktop-1440x900.png
  • tiku-student-mobile-390x844.png
  • tiku-tenant-desktop-1440x900.png
  • tiku-tenant-mobile-390x844.png
  • tiku-platform-desktop-1440x900.png
  • tiku-platform-mobile-390x844.png