# 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
- 如果发现新问题，记录具体现象和复现步骤
- 生产构建后复测首屏加载和资源完整性