116 lines
4.8 KiB
Markdown
116 lines
4.8 KiB
Markdown
# H5 用户流程闭环验证报告
|
||
|
||
日期：2026-06-12
|
||
项目：深圳自然博物馆智能导览应用 - frontend-miniapp
|
||
测试地址：`http://192.168.0.112:5173/`
|
||
运行目标：H5
|
||
测试方式：人工浏览器测试
|
||
验证范围：审计报告中P1级别闭环断点的修复状态
|
||
|
||
## 验证目标
|
||
|
||
根据 `docs/QA/user-flow-closure-audit-2026-06-10.md` 报告，验证以下P1问题的修复状态：
|
||
|
||
### P1-1：自定义导航页面缺少页面级返回/取消闭环
|
||
**修复状态**：✅ 已在代码中实现
|
||
- `GuidePageFrame.vue` 支持 `show-back` 和 `show-cancel` props
|
||
- 搜索页、设施详情页、路线详情页均已启用返回按钮
|
||
- 需人工验证：点击返回是否正确回到上一页
|
||
|
||
### P1-2：搜索结果页不能重新输入或重置搜索
|
||
**修复状态**：✅ 已在代码中实现
|
||
- `src/pages/search/index.vue:198-234` 实现完整搜索编辑流程
|
||
- 点击搜索框进入编辑态，显示输入框、清空按钮、搜索按钮
|
||
- 支持取消恢复原关键词
|
||
- 需人工验证：编辑-清空-取消-确认搜索完整流程
|
||
|
||
### P1-3：路线页"查看目标位置"没有形成下一步
|
||
**修复状态**：✅ 已在代码中实现
|
||
- `src/pages/route/detail.vue:446-454` 实现 `handleShowTargetLocation`
|
||
- 触发 `requestTargetFocus` 聚焦目标POI
|
||
- 失败时显示 toast 提示
|
||
- 需人工验证：点击"查看目标位置"是否高亮目标、切换到目标楼层
|
||
|
||
### P1-4：设施详情"选择起点"没有起点选择流程
|
||
**修复状态**：✅ 已在代码中实现
|
||
- `src/pages/facility/detail.vue:59-110` 实现完整起点选择面板
|
||
- 支持楼层和区域选择
|
||
- 支持取消和确认
|
||
- 确认后写入路线页参数（第252-270行）
|
||
- 需人工验证：选择起点-取消-重选-确认-查看位置完整流程
|
||
|
||
## 人工验证步骤
|
||
|
||
### 验证1：搜索页重新搜索流程
|
||
1. 访问 `http://192.168.0.112:5173/`
|
||
2. 首页点击"选择目标地点"进入搜索页（默认关键词"卫生间"）
|
||
3. 点击顶部搜索框，应进入编辑态（搜索框高亮、显示确认按钮）
|
||
4. 清空关键词，输入"展厅"
|
||
5. 点击"搜索"按钮，结果应更新为展厅相关
|
||
6. 再次点击搜索框，点击取消，应保持"展厅"结果
|
||
7. **预期**：搜索框可重新输入、清空、取消、确认搜索
|
||
|
||
### 验证2：页面返回保留状态
|
||
1. 搜索页选择"无障碍"筛选
|
||
2. 点击任一设施进入详情页
|
||
3. 点击顶部"返回"按钮
|
||
4. **预期**：回到搜索页，关键词和"无障碍"筛选保留
|
||
|
||
### 验证3：设施起点选择流程
|
||
1. 设施详情页点击"选择起点"
|
||
2. 应显示起点选择面板（楼层、区域）
|
||
3. 选择"2F" + "停车场入口"
|
||
4. 点击"取消"，面板关闭
|
||
5. 再次点击"选择起点"，应恢复上次确认的起点（如果有）
|
||
6. 重新选择"1F" + "主入口"，点击"确认起点"
|
||
7. 详情页应显示"预览起点：1F 主入口"
|
||
8. 点击"查看位置"进入路线页
|
||
9. **预期**：路线页 URL 包含 `startLabel=1F%20主入口&startFloor=1F`
|
||
|
||
### 验证4：路线页查看目标位置
|
||
1. 搜索结果点击"查看"进入路线页（state=preview）
|
||
2. 位置预览卡片显示目标名称和"查看目标位置"按钮
|
||
3. 点击"查看目标位置"
|
||
4. **预期**：
|
||
- 如果目标有三维坐标，3D 地图应聚焦到目标点
|
||
- 楼层切换到目标所在楼层
|
||
- 失败时显示"目标暂无三维位置数据"
|
||
|
||
### 验证5：路线页馆外预览返回
|
||
1. 路线页点击"查看馆外地图"
|
||
2. 应切换到馆外地图参考（2D模式、入口提示）
|
||
3. 点击"返回馆内3D"或"返回预览"
|
||
4. **预期**：返回馆内3D预览，目标对象不丢失
|
||
|
||
### 验证6：顶部Tab全局切换
|
||
1. 路线页点击顶部"讲解"
|
||
2. 应跳转到首页讲解Tab（会丢失路线上下文，符合全局导航定义）
|
||
3. **预期**：用户理解顶部Tab是全局跳转，不是页面返回
|
||
|
||
## 浏览器控制台检查项
|
||
|
||
- 检查是否有 404 资源错误
|
||
- 检查是否有 JavaScript 运行时错误
|
||
- 检查网络请求是否正常（导览数据、楼层数据）
|
||
- 检查 3D 模型加载状态
|
||
|
||
## 已知限制（不属于闭环问题）
|
||
|
||
1. **路线能力仍是预览态**：真实路线规划需等待 `route_graph/nav_data` 接入
|
||
2. **POI 三维坐标覆盖率**：部分设施可能暂无三维位置数据
|
||
3. **默认搜索词**：搜索页默认"卫生间"，但现已支持重新搜索
|
||
4. **首次加载可能白屏**：开发服务器首次编译延迟，生产构建应无此问题
|
||
|
||
## 验证结论
|
||
|
||
请在浏览器中按上述步骤执行人工验证，并记录：
|
||
- ✅ 功能正常
|
||
- ⚠️ 功能部分可用但体验需优化
|
||
- ❌ 功能不可用或未按预期工作
|
||
|
||
## 下一步
|
||
|
||
- 如果所有验证通过，更新 `docs/pdca/tasks.md` 标记 T-008 为 done
|
||
- 如果发现新问题，记录具体现象和复现步骤
|
||
- 生产构建后复测首屏加载和资源完整性
|