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

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