forked from wangziqi/gongxue-base
55 lines
2.8 KiB
Markdown
55 lines
2.8 KiB
Markdown
# 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 中存在位于横向快捷操作容器可视区之外的按钮，但容器自身裁切且页面宽度未溢出；正式重构时应改为明确的滚动、折叠或响应式操作布局。
|
||
|
||
## 复现
|
||
|
||
```bash
|
||
# 应用内浏览器视觉 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`
|