feat: refine guide explain UX and QA docs

docs/QA/user-flow-closure-verification-2026-06-12.md

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