chore: sync latest project updates
Some checks failed
CI / verify (push) Has been cancelled

This commit is contained in:
lyf
2026-07-03 14:42:38 +08:00
parent 8b2c36677e
commit 8fed715235
106 changed files with 6030 additions and 121 deletions

View File

@@ -10,11 +10,11 @@
## 结论
本次测试确认:导览首页到搜索、搜索结果到设施详情/路线预览、路线页外预览返回内预览等主路径已经可以渲染,浏览器或系统返回也能在若干场景中恢复上一页;搜索筛选状态从设施详情返回后仍能保留,是一个正向结果。
本次测试确认:导览首页到搜索、搜索结果到设施详情/路线预览、路线页外预览返回内预览等主路径已经可以渲染,浏览器或系统返回也能在若干场景中恢复上一页;搜索筛选状态从设施详情返回后仍能保留,是一个正向结果。
但用户逻辑闭环仍未完成。当前问题不是页面打不开,而是用户在进入二级页面后缺少稳定的页面级返回、取消、重置和继续路径;部分关键按钮只 `toast``console.log`,导致任务停在中间态。尤其是搜索页不能重新输入关键词、设施页不能真正选择起点、路线页不能继续到“目标位置确认/导航完成”,这些都属于闭环断点。
需要特别说明:当前产品能力仍应表述为“内 3D 展示 + POI/位置预览”。源码中的提示也明确指出正式路线数据尚未接入,不能把现有路径宣传为真实内路线规划或实时导航。
需要特别说明:当前产品能力仍应表述为“内 3D 展示 + POI/位置预览”。源码中的提示也明确指出正式路线数据尚未接入,不能把现有路径宣传为真实内路线规划或实时导航。
## 当前已验证正向路径
@@ -22,9 +22,9 @@
| --- | --- | --- |
| 首页导览 -> 点击搜索框 -> 搜索页 | 成功进入 `/pages/search/index` | 搜索页默认关键词为“卫生间”。 |
| 搜索页 -> 结果卡片“查看” -> 路线页 | 最终可渲染路线详情页 | 首次进入时出现过短暂空白,后续编译完成后恢复。 |
| 路线页 -> 查看外地图 -> 返回预览 | 可切换到 `outdoor-preview`,并通过按钮回到 `preview` | `handleViewOutdoorMap``handleReturnToPreview` 有明确状态切换。 |
| 路线页 -> 查看外地图 -> 返回预览 | 可切换到 `outdoor-preview`,并通过按钮回到 `preview` | `handleViewOutdoorMap``handleReturnToPreview` 有明确状态切换。 |
| 搜索页 -> 设施卡片 -> 设施详情 -> 浏览器返回 | 可回到搜索页 | 测试中搜索筛选状态保留,例如“无障碍”过滤未丢失。 |
| 首页内 3D 主 CTA | 已从“开始馆内导航”调整为“选择目标地点”并跳搜索页 | 避免直接进入未完成的路线规划态。 |
| 首页内 3D 主 CTA | 已从“开始馆内导航”调整为“选择目标地点”并跳搜索页 | 避免直接进入未完成的路线规划态。 |
## 浏览器验证问题
@@ -62,14 +62,14 @@
用户路径:搜索页 -> 结果“查看” -> 路线详情页 -> 点击“查看目标位置”
观察结果按钮只显示“正式路线数据尚未接入可先查看馆内三维位置”的提示没有切换到目标位置高亮、POI 卡片、3D 定位或可恢复状态。
期望闭环:在真实路线数据未接入前,按钮文案和行为应稳定落到“位置预览”:例如高亮目标 POI、展示楼层/区域/说明、提供返回搜索和查看外参考入口。
期望闭环:在真实路线数据未接入前,按钮文案和行为应稳定落到“位置预览”:例如高亮目标 POI、展示楼层/区域/说明、提供返回搜索和查看外参考入口。
影响:用户已经选择目标,但点击后没有获得更多可操作信息,会误以为目标定位失败或导航不可用。
源码证据:
- `src/services/navAssets.ts:3`:路线不可用提示为“正式路线数据尚未接入,可先查看馆内三维位置”。
- `src/pages/route/detail.vue:333``src/pages/route/detail.vue:338``handleShowTargetLocation``uni.showToast`
- `src/pages/route/detail.vue:329``src/pages/route/detail.vue:341`外预览有状态切换和返回,但目标位置按钮没有同等状态落点。
- `src/pages/route/detail.vue:84`外预览文案说明真实馆内路线需等待 `route_graph/nav_data` 接入。
- `src/pages/route/detail.vue:329``src/pages/route/detail.vue:341`外预览有状态切换和返回,但目标位置按钮没有同等状态落点。
- `src/pages/route/detail.vue:84`外预览文案说明真实馆内路线需等待 `route_graph/nav_data` 接入。
建议:短期把该动作改为“高亮目标位置/查看位置详情”,并切换到明确的 preview 子状态;中期接入 POI 坐标后,在 3D 视图中定位目标点;正式导航能力上线前,不使用“开始导航/路线规划已完成”等表述。
@@ -140,7 +140,7 @@
| 设施起点取消 | 设施详情 -> 选择起点 -> 取消 | 返回设施详情,不丢失目标设施。 |
| 设施起点确认 | 设施详情 -> 选择起点 -> 确认 -> 查看位置 | 路线页能读取目标和起点;未接真实路线时明确展示预览态。 |
| 路线目标预览 | 搜索结果“查看” -> 路线页 -> 查看目标位置 | 页面出现目标位置高亮或目标卡片,不只 toast。 |
| 路线外返回 | 路线页 -> 查看外地图 -> 返回预览/返回内 3D | 状态回到内预览,目标对象不丢失。 |
| 路线外返回 | 路线页 -> 查看外地图 -> 返回预览/返回内 3D | 状态回到内预览,目标对象不丢失。 |
| 二级页返回 | 搜索 -> 设施详情/路线页 -> 点击页面返回 | 返回上一页,搜索关键词和筛选保留。 |
| 顶部 tab 误触 | 路线页 -> 点击“讲解” -> 再回导览 | 行为符合产品定义;若会丢失路线上下文,应有明确提示或可恢复路径。 |
| 首次加载路线 | 清缓存或首次打开 -> 搜索结果“查看” -> 路线页 | 不出现无反馈白屏;至少显示 loading、失败重试和返回。 |
@@ -149,5 +149,5 @@
- 本报告接续旧会话的浏览器自动化结果,没有在当前会话重新启动 H5 服务或重复跑全量点击。
- 本报告只覆盖 H5 用户逻辑闭环,不覆盖 mp-weixin。
- 真实内路线规划、定位、到达判定不在当前已验证能力内;需等待 `route_graph/nav_data` 接入并完成独立验证。
- 真实内路线规划、定位、到达判定不在当前已验证能力内;需等待 `route_graph/nav_data` 接入并完成独立验证。
- 当前文档只新增测试报告,不修改业务实现。