Initial commit: gmTouringMiniApp project

This commit is contained in:
周瑞哲
2026-07-30 16:04:34 +08:00
commit ebcae02d35
201 changed files with 49545 additions and 0 deletions
@@ -0,0 +1,30 @@
# 用户需求决策记录 V1.0
| 文档版本 | 创建日期 | 文档状态 | 版本简述 |
|---|---|---|---|
| V1.0 | 2026-07-29 | 已确认 | 记录附件之外由用户补充确认的产品与技术边界 |
## 决策记录
| 决策 ID | 决策 | 状态 | 对需求的影响 |
|---|---|---|---|
| U-01 | 前端采用当前 `map-gm-app` 中的 uni-app 框架 | 已确认 | 以现有 Vue 3、TypeScript、Pinia 工程为研发基线 |
| U-02 | 7 天交付为 POC,不是正式版本 | 已确认 | 只验证最小主流程,不承诺生产级账号、后台、风控和多端能力 |
| U-03 | 目标端暂定微信小程序 | 已确认 | 本期不验收 H5、App、Android 小程序或其他平台 |
| U-04 | 当前只在 iOS 端验证 | 已确认 | 验收结论仅覆盖实际记录的 iOS、微信及基础库组合 |
| U-05 | 暂不规定最低微信基础库版本和具体 iPhone 型号 | 暂缓 | 不作为当前阻塞项;每次测试仍需记录实际环境 |
| U-06 | 地图能力使用高德地图 API | 已确认 | 高德为本期地图能力供应商;具体 Key 类型与接入方式由技术确认 |
| U-07 | 高德凭证已提供 | 已确认 | 文档只记录脱敏尾号 `...554f`,禁止保存或传播完整值 |
| U-08 | AI 与路径规划本期暂不处理,已有相关工作不纳入本 PRD | 已确认 | 移出本期页面、主流程、接口、指标、排期和验收 |
| U-09 | 打卡必须使用真实定位 | 已确认 | 只有实时取得的定位通过距离校验后才能完成打卡和发放奖励 |
| U-10 | 产品内虚拟定位测试能力本期不开发 | 已确认 | 不提供坐标输入、位置切换、调试开关或模拟成功能力 |
| U-11 | 用户匿名使用 | 已确认 | 不建设微信登录、手机号登录或正式会员账户 |
| U-12 | 个人中心只保存本机数据 | 已确认 | 打卡、积分和徽章不跨设备同步,清缓存或卸载可能丢失 |
| U-13 | 原 Q-12 的演示对象、验收签字人、网络和投屏暂不考虑 | 暂缓 | 不作为当前研发基线阻塞项 |
## 使用规则
- 用户补充决策的优先级高于三份附件和产品细化建议。
- 本记录不保存高德完整 Key、微信密钥或其他可用凭证。
- “暂缓”表示本期不要求关闭,不表示该问题已经永久取消。
- 若后续决策与本表冲突,应新增版本并同步更新 PRD、差异分析和验收口径。
@@ -0,0 +1,58 @@
# 用户需求决策记录 V1.1
| 文档版本 | 创建日期 | 文档状态 | 版本简述 |
|---|---|---|---|
| V1.0 | 2026-07-29 | 已归档 | 记录 POC、平台、高德、定位、匿名和本机数据等用户决策 |
| V1.1 | 2026-07-29 | 当前版本 | 新增上级细化任务,将当前专项收敛为全域地图探索与 POI 数字化展示 |
## 目录
- [1. 决策记录](#1-决策记录)
- [2. 最新任务覆盖关系](#2-最新任务覆盖关系)
- [3. 使用规则](#3-使用规则)
## 1. 决策记录
| 决策 ID | 决策 | 状态 | 对需求的影响 |
|---|---|---|---|
| U-01 | 前端采用当前 `map-gm-app` 中的 uni-app 框架 | 已确认 | 以现有 Vue 3、TypeScript、Pinia 工程为研发基线 |
| U-02 | 7 天交付为 POC,不是正式版本 | 已确认 | 只验证最小主流程,不承诺生产后台、多端和长期运营能力 |
| U-03 | 目标端暂定微信小程序 | 已确认 | 本期不验收 H5、App、Android 小程序或其他平台 |
| U-04 | 当前只在 iOS 端验证 | 已确认 | 验收结论仅覆盖实际记录的 iOS、微信及基础库组合 |
| U-05 | 暂不规定最低微信基础库版本和具体 iPhone 型号 | 暂缓 | 不作为当前阻塞项;每次测试仍需记录实际环境 |
| U-06 | 地图能力使用高德地图 API | 已确认 | 高德为本期地图供应商;具体 Key 类型与接入方式由技术确认 |
| U-07 | 高德凭证已提供 | 已确认 | 文档只记录脱敏尾号 `...554f`,禁止保存或传播完整值 |
| U-08 | AI 与路径规划本期暂不处理,已有相关工作不纳入本 PRD | 已确认 | 移出本期页面、主流程、接口、指标、排期和验收 |
| U-09 | 若后续建设打卡,必须使用真实定位 | 已确认但不属于当前专项 | 当前地图/POI 专项不建设打卡与位置权限;规则保留给后续独立需求 |
| U-10 | 产品内虚拟定位测试能力本期不开发 | 已确认 | 当前专项不建设任何定位能力,也不提供坐标输入或模拟位置入口 |
| U-11 | 用户匿名使用 | 已确认 | 当前专项无需登录、会员或用户身份 |
| U-12 | 若后续建设个人中心,只保存本机数据 | 已确认但不属于当前专项 | 当前专项不建设个人中心、打卡、积分、徽章或本机用户资产 |
| U-13 | 原 Q-12 的演示对象、验收签字人、网络和投屏暂不考虑 | 暂缓 | 不作为当前研发基线阻塞项 |
| U-14 | 上级细化任务当前集中在全域地图导览和 POI 点位数字化展示 | 已确认 | 当前 P0 主流程收敛为地图浏览、分类探索、marker、摘要与详情 |
| U-15 | 全域地图用于呈现深圳市光明区整体文旅资源分布并支持地图化探索 | 已确认 | 地图默认视野、覆盖口径、分类和 POI 上图成为核心验收项 |
| U-16 | POI 至少包含名称、图片、经纬度、简介、开放时间、推荐指数和特色标签 | 已确认 | 七类信息进入 P0 数据合同、详情页和验收矩阵 |
## 2. 最新任务覆盖关系
U-14 至 U-16 是本次上级细化任务的最新范围输入,优先级高于旧总 PRD 对当前 P0 的描述。处理规则如下:
| 历史能力 | 当前专项处理 | 说明 |
|---|---|---|
| 全域地图、分类、marker、POI 摘要和详情 | 保留为 P0 | 直接支撑 U-14 至 U-16 |
| 名称、图片、经纬度、简介、开放时间、推荐指数、特色标签 | 保留并升为 P0 必看字段 | 用户最新明确要求 |
| AI 问答、AI 路线和知识库 | 不在本专项 | U-08 已明确暂缓 |
| 路径规划、polyline 和实时导航 | 不在本专项 | U-08 已明确暂缓 |
| 真实定位、打卡和距离校验 | 移入后续需求池 | U-09 的规则仍有效,但当前上级任务不要求交付 |
| 积分、徽章、任务和个人中心 | 移入后续需求池 | 不再进入当前页面、数据、接口、指标、排期和验收 |
| 虚拟定位 | 不在本专项 | 不建设产品内测试入口 |
| 正式登录和跨设备资产 | 不在本专项 | 当前匿名浏览无需用户资产 |
历史总 PRD `光明区文旅全域地图及AI导览POC产品需求文档 V1.1` 保留为阶段性记录;当前地图/POI 专项的研发与验收应以 `光明区文旅全域地图及POI数字化展示产品需求文档 V1.0` 为准。
## 3. 使用规则
- 用户最新补充和上级细化任务的优先级高于三份附件及历史 PRD。
- 本记录不保存高德完整 Key、微信密钥或其他可用凭证。
- “当前专项不做”不等于永久取消;后续恢复时必须单独确认范围、指标、接口和排期。
- “暂缓”表示本期不要求关闭,不表示已经验证或形成正式兼容承诺。
- 若后续决策与本表冲突,应新增版本,并同步更新专项 PRD、范围差异分析和验收口径。
@@ -0,0 +1,23 @@
# 光明区文旅全域地图及AI导览POC附件索引
| 文档版本 | 创建日期 | 版本简述 |
|---|---|---|
| V1.0 | 2026-07-29 | 建立三份原始附件的来源、版本和用途索引 |
| V1.1 | 2026-07-29 | 补充用户最新决策的优先级说明,并关联用户需求决策记录 |
| V1.2 | 2026-07-29 | 关联上级地图/POI细化任务及当前专项 PRD |
## 原始附件
为避免复制约 86 MB 的二进制文件,本项目目录仅保存索引,原始附件继续保存在仓库根目录的 `files/` 目录。
| 来源编号 | 原始文件 | 文件特征 | 在需求分析中的用途 | SHA-256 |
|---|---|---|---|---|
| S1 | `files/光明区文旅全域地图及AI导览POC建设方案.docx` | 2026-07-28 最后修改;4 页;21 个正文段落 | 定义当前 POC 的目标、范围、页面类型、7 天计划和技术候选;作为当前范围的最高优先级来源 | `6e138804fbbaf088a6f2c139594ecfa4690b6d144da4b6604d3c2cb1a073e53e` |
| S2 | `files/文旅小程序三期规划方案202607091517.pptx` | 2026-07-09 10:17 最后修改;16 页 | 补充地图、筛选、榜单、AI、路线、打卡、徽章、积分兑换、挑战和优惠券的功能表达;作为功能细化来源 | `6f1a134c4770ec942ad1960cfd286308afb983d987d6f86ff61ac767ec8d0635` |
| S3 | `files/文旅小程序三期规划方案20260709.pptx` | 2026-07-09 07:10 文档属性时间;46 页 | 提供问题背景、用户旅程、三期路线、运营方案、预算、实施周期和项目风险;作为整体路线来源 | `ad2f9e88a013b899a2570dcc000fcb03785dd019d426e78287f57ccfddc566cf` |
## 使用规则
三份附件之间发生冲突时采用 `S1 > S2 > S3`。附件之外的用户最新决策记录在 `用户需求决策记录 V1.1.md` 中,其优先级高于三份附件;当前工程事实用于约束技术现状,但不能覆盖用户明确的产品决策。
S1 未定义的内容可由 S2 或 S3 补充,但不会因此自动纳入 7 天 POC。S1 中的 AI、路径规划和模拟打卡原始表达,已被后续用户决策替换;上级最新任务又将当前专项进一步收敛为“全域地图探索 + POI 数字化展示”。打卡必须真实定位的规则保留给后续到点互动需求,但打卡、奖励和个人中心不属于当前专项。当前研发与验收以 `光明区文旅全域地图及POI数字化展示产品需求文档 V1.0.md` 为准,所有推导内容须标记为产品细化、假设、待确认或暂缓。
@@ -0,0 +1,195 @@
# 上级细化任务范围差异分析 V1.0
| 文档版本 | 创建日期 | 文档状态 | 版本简述 |
|---|---|---|---|
| V1.0 | 2026-07-29 | 当前版本 | 分析上级最新地图/POI任务与三份附件、历史总 PRD 及当前工程之间的差异 |
## 目录
- [1. 分析结论](#1-分析结论)
- [2. 最新任务拆解](#2-最新任务拆解)
- [3. 与附件和历史 PRD 的差异](#3-与附件和历史-prd-的差异)
- [4. 本专项范围](#4-本专项范围)
- [5. POI 字段细化](#5-poi-字段细化)
- [6. 全域覆盖口径](#6-全域覆盖口径)
- [7. 当前工程影响](#7-当前工程影响)
- [8. 输入缺口与风险](#8-输入缺口与风险)
- [9. 产物关系](#9-产物关系)
## 1. 分析结论
上级最新任务不是在历史总 PRD 上增加两个功能,而是对当前研发任务进行范围收敛。本期只保留两项 P0:
1. 将深圳市光明区本期经确认的文旅资源进行全域地图化展示和探索。
2. 将每个 POI 以统一数字档案展示,至少包含名称、图片、经纬度、简介、开放时间、推荐指数和特色标签。
因此,当前核心流程应为:
`打开全域地图 -> 查看光明区资源分布 -> 切换主分类 -> 点击 marker -> 查看 POI 摘要 -> 进入 POI 详情 -> 返回继续探索`
真实定位打卡、积分、徽章和个人中心虽然在上一版总 PRD 中属于 P0,但不直接支撑最新上级任务,已整体移入后续需求池。AI 与路径规划继续排除。“全域地图导览”本期不是路线导航的同义词,只指地图浏览、分类探索、marker 联动和 POI 查看。
## 2. 最新任务拆解
| 原始表达 | 可开发定义 | 验收落点 |
|---|---|---|
| 全域地图导览 | 打开光明区默认视野,浏览、拖动、缩放、分类、选点和查看 POI | 地图核心脚本和 iOS 真机用例 |
| 光明区整体文旅资源分布 | 将经确认基准清单中的有效 POI 全部上图 | 基准清单有效上图覆盖率 |
| 地图化探索 | 从地图和分类发现 POI,不依赖登录或当前位置 | 分类准确率、marker 联动和返回恢复 |
| POI 点位数字化展示 | 统一字段、字典、审核、发布、状态和详情展示 | POI 数据合同和字段验收矩阵 |
| 名称、图片、经纬度、简介、开放时间、推荐指数、特色标签 | 七类信息全部进入 P0 | 已发布 POI 必看字段完整率 100% |
最新任务没有给出 POI 基准清单、总量、分类、推荐指数规则或内容来源。这些不能靠研发自行编造,必须作为 Day 0/Day 1 输入关闭。
## 3. 与附件和历史 PRD 的差异
### 3.1 三份附件的可用信息
| 来源 | 可继续使用 | 仅作背景或移出本专项 |
|---|---|---|
| S1POC 建设方案 | 7 天 POC、全域地图、POI、演示导向 | AI、路线、模拟打卡、积分徽章、个人中心 |
| S2:16 页功能版规划 | 地图缩放、渐进展示、分类筛选、点位详情 | 路线、真实定位打卡、分享、商城、挑战和优惠券 |
| S3:46 页总规划 | 文旅数据汇集、地图发现、长期数据运营背景 | 会员、交易、后台、AI、多语种和三期完整建设 |
### 3.2 历史总 PRD 到专项 PRD
| 维度 | 历史总 PRD V1.1 | 地图/POI 专项 PRD V1.0 | 处理原因 |
|---|---|---|---|
| 主流程 | 地图 -> POI -> 定位 -> 打卡 -> 奖励 -> 个人中心 | 地图 -> 分类 -> marker -> 摘要 -> 详情 | 最新上级任务收敛 |
| 页面 | 地图、详情、打卡反馈、个人中心 | 地图、详情;摘要为浮层 | 去除非必要页面 |
| 用户身份 | 匿名本机用户 | 无需用户身份 | 当前只有只读探索 |
| POI 信息 | 通用详情和打卡资格 | 七类必看字段及治理字段 | 上级明确字段要求 |
| 定位/打卡 | P0 | 后续需求池 | 不支撑当前两项任务 |
| 积分/徽章 | P0 | 后续需求池 | 不支撑当前两项任务 |
| AI/路线 | 已排除 | 继续排除 | 用户已确认暂缓 |
| 数据模型 | POI + 定位 + 任务 + 奖励 + 本机状态 | POI + 分类 + 标签 + 数据版本 | 删除范围外数据 |
| 验收 | 地图、定位、距离、奖励、存储 | 覆盖率、字段、映射、筛选、性能 | 与当前目标一致 |
| 7 天计划 | 四类页面及完整到点互动 | 两个业务页面和完整 POI 数据验收 | 降低范围风险,增加数据审核投入 |
历史总 PRD 不删除、不覆盖,用于保留决策过程;但不能与专项 PRD 混合作为同一期研发合同。
## 4. 本专项范围
### 4.1 P0
- 光明区默认地图视野、拖动和缩放。
- 审核通过、已发布且坐标合法的 POI marker。
- “全部”与已确认主分类单选。
- marker、摘要卡和详情通过同一 `poiId` 联动。
- 摘要卡展示核心图文、官方推荐指数和特色标签。
- 详情展示名称、图片、GCJ-02 经纬度、简介、开放时间、官方推荐指数和特色标签。
- 加载、空、失败、重试、图片占位和 POI 下线状态。
- POI 数据、分类、标签、坐标、图片、审核和发布校验。
- 基准清单覆盖率或审核样本有效上图率。
- 高德能力接入、微信小程序构建和 iOS 真机验证。
### 4.2 条件 P1
- POI 名称或别名搜索。
- 特色标签组合筛选。
- 街道维度筛选。
- 光明区行政边界。
- POI 聚合或视野分级展示;当完整数据量导致性能或可点击性不达标时升为 P0。
- 推荐指数排序、坐标复制或其他已验证外部动作。
- 已有稳定业务 API 替代本地审核 JSON。
### 4.3 不在本专项
- AI、知识库、AI 路线和模型接口。
- 路径规划、polyline、实时或外部导航。
- 当前位置、位置权限、真实/虚拟定位、距离和打卡。
- 积分、徽章、任务、挑战、排行和个人中心。
- 登录、会员、收藏、评论、游记和个性化推荐。
- CMS、运营/商户后台、交易、支付、核销和数据大屏。
- Android、H5、App、其他小程序和正式设备矩阵。
## 5. POI 字段细化
### 5.1 用户明确字段
| 字段 | 产品规则 | 缺失处理 |
|---|---|---|
| 名称 | 审核后的正式名称 | 不允许发布 |
| 图片 | 至少一张合法封面,详情可有图集 | 发布前缺失不允许;运行失败用占位图 |
| 经度、纬度 | 有限数值,统一 GCJ-02,并核验目标区域 | 不允许上图 |
| 简介 | 摘要 `summary` 与详情 `description` 均非空 | 不允许发布 |
| 开放时间 | 支持已知、未知、需预约、临时关闭状态 | 未知显示“开放时间待确认” |
| 推荐指数 | 暂按官方人工配置 `1-5` 整数 | 缺失或越界不允许发布 |
| 特色标签 | 受控字典,每个 POI `1-5` 个 | 缺失、重复或引用失效标签不允许发布 |
### 5.2 为可运行必须补充的字段
| 字段 | 作用 |
|---|---|
| `id` | 保证 marker、摘要和详情稳定关联 |
| `categoryCode` | 支持主分类探索 |
| `coordinateSystem` | 防止不同坐标系直接混用 |
| `address` | 提供位置文本,帮助核对 POI |
| `publishStatus` | 区分草稿、发布和下线 |
| `reviewStatus` | 确保只有审核通过内容可见 |
| `dataSource``sourceReference` | 追溯信息来源 |
| `copyrightStatus` | 控制图片和内容使用权 |
| `reviewedBy``reviewedAt` | 追溯审核责任 |
| `updatedAt` | 展示和判断信息时效 |
| `datasetVersion` | 保证地图、摘要和详情不串版 |
## 6. 全域覆盖口径
“全域覆盖”不是 marker 数量多或视觉上铺满地图。建议口径:
`基准清单有效上图覆盖率 = 已发布且可从地图到达完整详情的基准 POI 数 / 双人冻结的基准清单 POI 数 * 100%`
“成功上图”同时要求:审核通过、发布成功、必填字段合法、GCJ-02 坐标合法、marker 可见、摘要可打开、详情可访问。
边界规则:
- 基准清单必须从项目方认可的权威来源总表生成;总表须声明资源类型范围、地理范围、统计截止日期、出具方和版本。
- 来源总表或基准清单未确认、数量为 0、缺少双人签字时,不得计算全域覆盖率。
- 来源总表中的排除项须建立独立台账,由内容负责人提出、产品负责人复核;字段不全、坐标错误、图片缺失或来不及处理不能作为排除理由。
- 缺字段、缺图片、坐标非法或审核未通过的基准 POI 仍计入分母。
- 清单冻结后的变更必须记录新旧版本、证据、提出人和复核人,不能为提高覆盖率静默删除失败记录。
- 没有官方基准清单时,只能表述“覆盖本期审核样本”,并计算样本有效上图率。
## 7. 当前工程影响
当前工程可确认的基线为 uni-app、Vue 3、TypeScript、Pinia、uview-plus、UnoCSS、请求封装、UniPages 路由和微信小程序构建命令。
当前缺口:
- 首页仍请求 GitHub 示例接口,未进入文旅地图。
- 应用名称仍为 `unisave`,配置中存在测试 AppID 表达。
- 未发现地图、marker、POI、高德或数据校验业务代码。
- 请求层仍使用模板协议,错误辅助可能输出完整请求配置。
- 当前测试只覆盖通用工具,没有 POI 校验、筛选或 marker 映射用例。
建议 7 天 POC 默认使用本地审核 JSON,减少新建后端、接口协议、合法域名和现场网络风险。地图接入不能把微信原生 `map` 自动等同于高德底图;Day 1 必须确认高德 Key 类型和高德在本期承担的具体能力。
## 8. 输入缺口与风险
| 缺口 | 推荐默认项 | 截止 | 未关闭影响 |
|---|---|---|---|
| 权威来源总表、排除台账、双人冻结基准清单、POI/图片总量 | Day 0 内容与产品签字冻结 | Day 0 | 不能宣称全域覆盖,也不能确认 7 天容量 |
| 主分类和标签字典 | 一个主分类、`1-5` 个标签 | Day 0 | 阻塞筛选和发布 |
| 推荐指数口径和配置人 | 官方人工 `1-5`,只展示 | Day 0 | 阻塞必填字段可信性 |
| 图片来源、版权和域名 | 核心图随包或审核 HTTPS CDN | Day 1 | 阻塞图片发布和真机加载 |
| POI 数据来源 | 本地审核 JSON | Day 0 | 影响仓储与接口工作量 |
| 高德 Key 类型和允许能力 | 官方最小调用验证 | Day 1 | 阻塞地图 P0 |
| 高德显示/服务职责 | 按客户要求验证目标官方方案 | Day 1 | 影响架构和供应商验收 |
| 实际微信 AppID 和权限 | 项目方确认配置 | Day 1 | 阻塞体验版和真机 |
| 完整 POI 数量和重叠情况 | 超过 100 或指标失败启用聚合 | Day 2 | 影响性能和可点击性 |
主要风险不是页面数量,而是数据输入不足。没有基准清单、坐标、图片版权和推荐责任,即使地图页面完成,也不能形成可信的“光明区全域文旅资源数字化”交付结论。
7 天排期还必须受容量约束。当前默认假设最多处理并逐点验收 `50` 个 POI、`200` 张图片资产;Day 0 应以实际人力和抽测工时重算。超过可用人时须增加内容/测试人力、明确降级为审核样本或调整交付日期,不能在总量未知时承诺全量完成。
## 9. 产物关系
| 文档 | 定位 | 当前使用方式 |
|---|---|---|
| `附件总结与需求差异分析 V1.1` | 三份附件和上一阶段决策汇总 | 历史过程资料 |
| `光明区文旅全域地图及AI导览POC产品需求文档 V1.1` | 上一阶段“地图 + POI + 打卡 + 奖励”总 PRD | 历史基线,不用于当前专项研发 |
| `用户需求决策记录 V1.1` | 最新用户和上级任务决策 | 当前决策来源 |
| `上级细化任务范围差异分析 V1.0` | 当前专项与历史范围差异 | 评审辅助材料 |
| `光明区文旅全域地图及POI数字化展示产品需求文档 V1.0` | 地图/POI 专项研发和验收文档 | 当前交付主文档 |
当前专项以最新决策记录和地图/POI 专项 PRD 为准。后续若恢复打卡、奖励、AI 或路径规划,应建立独立需求版本,不能直接混入本专项 P0。
@@ -0,0 +1,180 @@
# 附件总结与需求差异分析 V1.0
| 文档版本 | 创建日期 | 版本简述 |
|---|---|---|
| V1.0 | 2026-07-29 | 汇总三份附件,识别重叠、差异、冲突与当前 POC 范围 |
## 目录
- [分析口径](#分析口径)
- [三份附件摘要](#三份附件摘要)
- [共同需求主线](#共同需求主线)
- [附件差异](#附件差异)
- [主要冲突与处理建议](#主要冲突与处理建议)
- [需求缺口](#需求缺口)
- [当前范围建议](#当前范围建议)
## 分析口径
### 信息标记
| 标记 | 含义 |
|---|---|
| 已确认 | 用户在对话中明确指定,或附件中存在一致、明确的约束 |
| 资料事实 | 附件原文表达,不代表已完成业务或技术验证 |
| 产品细化 | 为使需求可开发、可测试而补充的建议规则,需评审确认 |
| 🔶 **假设** | 资料未提供,但为了形成初稿而采用的临时判断 |
| 🔵 **待确认** | 会影响范围、方案、排期或验收,不能由产品文档代替决策的问题 |
### 来源优先级
1. `S1`:POC 建设方案,最后修改时间最晚,直接定义 7 天 POC。
2. `S2`:16 页功能版 PPT,补充具体功能形态。
3. `S3`:46 页总规划 PPT,描述完整三期和运营方向。
## 三份附件摘要
### S1POC 建设方案
S1 将当前项目定位为用于快速验证、效果展示和能力证明的智慧文旅全域导览 Demo,而非正式生产系统。建设主线为“地图 + 点位 + 线路 + 互动”,验证全域地图、POI 数字化展示、AI 问答与路线规划、互动打卡四类能力。
资料定义的核心演示过程为:打开地图 → 查看资源 → 查看 POI → 输入游玩需求 → AI 生成路线 → 地图展示路线 → 模拟打卡获得徽章。明确列出首页地图、POI 详情、AI 助手、路线结果、打卡徽章、个人中心六类页面,同时称“约 10 个页面”,但未说明其余页面或计数方式。
工期为 7 天,资源为前端 1 人、后端/AI 1 人、UI 设计支持。技术候选为小程序 + 地图 API、Node.js/Python、JSON/SQLite、大模型 API + 文旅知识库。S1 没有量化验收指标、数据样本规模、AI 合同、异常策略或正式交付清单。
### S216 页功能版规划
S2 聚焦功能演示,覆盖全域地图、分类、筛选、POI 详情、榜单、路线、AI 问答路线规划、打卡分享、游记、积分兑换、徽章、榜单挑战和优惠券。
它对地图交互的描述最具体:地图多级缩放和拖拽,核心地标默认高亮,POI 随缩放渐进展示;支持“吃、住、行、游、购、娱”分类以及景点、美食、住宿、活动、无障碍等组合筛选;POI 详情含图集、开放时间、简介、电话、票价、评分、标签及收藏、打卡、预约、导航等动作。
S2 还将 AI 路线输入细化为主题、时长、节奏、特色等偏好,将路线结果定义为一日/多日路线、途经 POI、服务点和地图动线。相较 S1,它明显扩展了正式运营能力,尤其是游记审核与积分、积分商城和二维码核销、优惠券状态及到店核销、榜单挑战和用户画像;这些能力不应默认进入 7 天 POC。
### S346 页三期总规划
S3 说明了产品问题:文旅信息分散导致信息过载,缺乏本地化个性化规划工具,导航、预订、攻略等体验割裂。产品希望服务游客、商家和运营监管方,并形成探索发现、规划决策、导航体验、分享沉淀的游客旅程。
总规划采用三期递进表达:一期 L2 建设全域地图、POI、主题路线、打卡积分和基础 CMS;二期 L3 建设营销、订单、支付、分账、商户和数据看板;三期 L4 建设 AI 路线、AI 客服/助手、多语种导游及其他智能能力。规划周期和预算分别为一期 2 个月、29 万至 45 万元,二期 4.5 个月、50 万至 65 万元,三期 2 个月、19 万至 25 万元,总预算称不低于 98 万元,并建议总预算 20% 至 30% 的弹性备用金。
S3 还提出后续运营方向:基础运营、活动策划、惠民补贴、港澳及入境游客推广;相关能力包括 320+ 点位内容中台、预约、会员、消费券、多语言和跨境支付等。这些是长期产品及运营路线,不是 S1 的 POC 交付承诺。
## 共同需求主线
三份资料可以归纳为同一条产品主线:以光明区全域 POI 数据为基础,以地图作为用户发现入口,通过筛选、详情和 AI 路线降低决策成本,再用导航、打卡、徽章和分享完成行中互动及用户沉淀。
```mermaid
flowchart LR
A[文旅资源数据] --> B[全域地图与POI]
B --> C[搜索/分类/筛选]
C --> D[POI详情与决策]
D --> E[预设或AI路线]
E --> F[地图路线展示/导航]
F --> G[打卡/徽章/积分]
G --> H[分享与行为沉淀]
H --> I[内容和运营优化]
```
共同出现且可确认为产品核心的能力包括:
- 全域地图、POI 定位与详情。
- 分类浏览、筛选和地图点位联动。
- 用户偏好输入、AI 理解、个性化路线生成和地图结果展示。
- 路线关联景点、餐饮、住宿等 POI。
- 打卡、徽章或积分反馈以及分享表达。
- 行为数据记录,为后续运营和正式用户体系提供基础。
## 附件差异
| 维度 | S1POC 方案 | S2:功能版 PPT | S3:总规划 PPT |
|---|---|---|---|
| 文档目的 | 7 天 Demo 验证 | 功能展示与细化 | 三期建设和运营提案 |
| 当前交付范围 | 约 10 页,六类页面 | 13 个业务功能主题 | 一期至三期、三端及运营服务 |
| 地图 | 全域地图验证 | 缩放、渐进 POI、分类、筛选、榜单 | 地图数据底座和商业字段预留 |
| AI | 问答及个性化路线 | 偏好理解、路线生成、实时数据描述 | 三期 AI 路线、客服、助手、多语种导游 |
| 互动 | 模拟打卡、积分、徽章 | 真实定位表述、游记、分享、商城核销、挑战 | 账户、流水、规则、风控与会员成长 |
| 交易 | POC 后扩展 | 优惠券、积分商品核销 | 订单、支付、退款、分账、商户和对账 |
| 后台 | POC 未纳入 | 功能隐含运营配置 | CMS、商户后台、数据看板和监管 |
| 工期 | 7 天 | 未单列当前功能工期 | 一期 2 个月,二期 4.5 个月,三期 2 个月 |
| 指标 | 无量化阈值 | 定性描述增长价值 | 有运营方向,无可信产品基线和目标值 |
## 主要冲突与处理建议
| 冲突 | 影响 | 处理建议 |
|---|---|---|
| S1 为 7 天 POC,S2/S3 包含生产级运营和交易 | 若不切范围,工期与功能严重失配 | 当前 PRD 建议只承诺可演示主流程;交易和正式运营进入后续需求池 |
| S1 列出六类页面,却称约 10 页 | 设计、研发和验收计数不一致 | 以六类业务页面为基线,浮层和子流程是否拆页由评审决定;最终页数作为 P0 待确认项 |
| “AI 问答”“AI 导览”“AI 路线规划”混用 | AI 交互、接口、知识和验收不同 | POC 必做路线需求理解与生成;开放问答、语音讲解分别列为条件范围或后续范围 |
| “模拟打卡”与“到点自动定位校验”并存 | 决定是否申请位置权限、登录和远端存储 | 7 天版默认演示模拟打卡;真实 LBS 打卡仅在账号、隐私和真机条件就绪时替换 |
| 路线既称实时导航又称地图展示 | 直线、道路级路径和外部导航的成本差异大 | POC 必做 POI 顺序与地图连线;道路级路线及导航跳转需地图能力确认 |
| AI 生成依赖实时路况/客流 | 当前未给出实时数据源 | POC 不承诺实时客流;路线仅使用已审核 POI 和已提供的静态营业信息 |
| POC 已有积分徽章,S3 又将完整积分体系放后续 | 容易将本地演示状态误认为正式资产 | POC 仅展示可重置的模拟积分/徽章;正式账户、流水、规则和风控后置 |
| “全域”没有样本规模和准确率 | 无法判断内容是否完成 | 开工前锁定 POI 数量、分类、坐标系、必填字段和抽检规则 |
## 需求缺口
### 产品和用户
- 未定义当前演示的决策者、验收人和目标体验设备。
- 未定义本地游客、港澳游客、亲子、研学等人群中谁是 POC 首要对象。
- 未定义用户是否匿名、是否微信登录、个人中心保存哪些数据。
- 未定义底部导航、页面拆分和首页信息架构。
### 数据和内容
- 未提供 POC POI 样本数、来源、坐标系、图片版权和内容审核责任。
- POI 字段在附件间不一致,缺少必填性、枚举和缺失值规则。
- 榜单热度、评分、推荐指数、特色标签没有计算或运营规则。
- 知识库资料、版本、更新和引用方式未定义。
### AI 和路线
- 未定义一次性路线生成还是多轮问答,是否需要流式输出。
- 未定义路线输入的必填项、输出 JSON 结构、POI 映射和失败降级。
- 未定义不存在点位、闭馆、重复点位、距离不可行等约束。
- 未定义模型供应商、内容安全、数据出境、费用和时延限制。
### 技术和合规
- 地图供应商、Key、调用配额、微信域名白名单和坐标口径未定。
- 正式微信 AppID、主体权限、位置隐私声明、网络环境未定。
- 后端语言、数据存储、部署环境和正式接口协议仍是候选。
- 没有性能、错误恢复、日志、监控、隐私、内容安全和无障碍要求。
### 项目和验收
- 7 天内的数据、设计、地图/AI 账号等前置材料未明确由谁、何时提供。
- 没有源码、设计稿、数据包、接口文档、测试报告、部署说明等交付清单。
- 没有可量化成功指标,也没有演示失败时的预置路线和静态数据兜底。
## 当前范围建议
🔶 **假设**:以下范围以 S1 为当前交付基线,并用 S2、S3 细化体验;需由项目决策人在范围评审中确认。
### POC 必做
- 微信小程序方向的全域地图首页、样本 POI 点位和分类筛选。
- POI 摘要卡与详情展示。
- AI 偏好输入、基于审核 POI 的路线生成。
- 路线结果列表、地图 marker 和 polyline 展示。
- 模拟打卡、模拟积分和徽章反馈。
- 个人中心汇总演示记录。
- 全主流程的加载、空、失败和重试状态。
### 条件范围
- 关键词搜索和榜单:数据量与演示需要明确时纳入。
- 真实定位打卡:仅在隐私配置、权限和真机验证就绪时纳入。
- 开放式景点问答:仅在知识库、内容安全和 API 稳定时纳入。
- 微信分享卡片或海报:需锁定素材和分享形态。
- 道路级路线、外部地图导航:依赖地图服务商能力及 Key。
### 后续阶段
- 游记发布、内容审核和 UGC 运营。
- 正式积分账户、流水、规则、风控、商城和二维码核销。
- 优惠券、活动预约、商户、商品、订单、支付、退款、分账和对账。
- CMS、商户后台、数据看板和监管端。
- 实时客流/路况、多轮 AI、语音讲解、AI 客服、多语种和 AR。
- 正式会员、用户画像、分层运营、港澳推广及跨境支付。
当前 PRD 已按上述范围形成 V1.0 评审稿。所有“产品细化”与“假设”必须在范围评审中确认后,才能转为正式基线。
@@ -0,0 +1,200 @@
# 附件总结与需求差异分析 V1.1
| 文档版本 | 创建日期 | 文档状态 | 版本简述 |
|---|---|---|---|
| V1.0 | 2026-07-29 | 已归档 | 汇总三份附件,提出“地图 + AI 路线 + 模拟打卡”POC 范围建议 |
| V1.1 | 2026-07-29 | 当前版本 | 根据用户最新决策,将本期收敛为“地图 + POI + 真实定位打卡 + 本机奖励”POC |
## 目录
- [1. 分析口径](#1-分析口径)
- [2. 三份附件摘要](#2-三份附件摘要)
- [3. 附件共同主线](#3-附件共同主线)
- [4. 最新决策及优先级](#4-最新决策及优先级)
- [5. 范围差异与处理](#5-范围差异与处理)
- [6. 当前 POC 范围](#6-当前-poc-范围)
- [7. 仍需补齐的输入](#7-仍需补齐的输入)
- [8. 现有工程核对](#8-现有工程核对)
- [9. V1.0 到 V1.1 变更清单](#9-v10-到-v11-变更清单)
- [10. 一致性结论](#10-一致性结论)
## 1. 分析口径
### 1.1 信息标记
| 标记 | 含义 |
|---|---|
| 已确认 | 用户明确决定,或当前工程中可直接核实的事实 |
| 资料事实 | 三份附件中的原始描述,不自动等于本期承诺 |
| 产品细化 | 为形成可开发、可测试需求而补充的规则 |
| 假设 | 资料不足时采用的临时判断,错误时需要调整方案 |
| 待技术确认 | 产品方向已定,但具体实现或凭证属性需研发验证 |
| 暂缓 | 本期不关闭,也不作为交付阻塞项 |
### 1.2 来源优先级
当前采用 `用户最新决策 > 当前工程事实 > S1 POC 建设方案 > S2 功能版规划 > S3 三期总规划`
因此,附件中的 AI、路径规划、模拟打卡和多端表达,即使原先属于 POC 描述,也已被用户最新决策替换。它们只保留为来源事实或后续方向,不能继续出现在本期 P0、主流程和验收中。
## 2. 三份附件摘要
### 2.1 S1POC 建设方案
S1 定义了一个 7 天、前后端并行、用于客户展示的 POC。内容包含全域地图、POI、AI 问答或路线、路线展示、模拟打卡、积分徽章和个人中心,并给出约 10 页、Node.js/Python、JSON/SQLite 等候选表达。
S1 的主要价值是确认 POC 性质、7 天约束和演示导向。其 AI 与模拟打卡方案已被最新用户决策调整;候选技术栈也不构成后端技术强制要求。
### 2.2 S216 页功能版规划
S2 细化地图缩放、POI 渐进展示、分类筛选、榜单、点位详情、路线、真实定位打卡、游记分享、积分商城、挑战和优惠券等功能。
S2 同时包含 POC 可借鉴的交互细节和生产运营能力。当前只吸收地图、POI、真实定位打卡、积分与徽章相关内容;路线、分享、商城、挑战和优惠券不进入本期。
### 2.3 S346 页三期总规划
S3 描述一期至三期的完整文旅小程序、运营后台、商户交易、会员体系、AI 服务、多语言和长期运营方案,周期远大于 7 天。
S3 用于理解长期方向和资料背景,不作为当前 POC 的研发合同。交易、正式账户、后台、AI 和多端建设均需后续独立立项。
## 3. 附件共同主线
三份附件的长期产品主线可以归纳为:文旅数据汇集、地图发现、信息决策、行程辅助、到点互动、用户资产和运营迭代。
```mermaid
flowchart LR
A[文旅 POI 数据] --> B[地图与分类发现]
B --> C[POI 摘要和详情]
C --> D[路线或导航辅助]
D --> E[到点打卡]
E --> F[积分和徽章]
F --> G[账户与运营]
```
当前 POC 只截取其中可在 7 天内独立验证的部分:`A → B → C → E → F`。路线或导航辅助、正式账户和运营不属于本期交付。
## 4. 最新决策及优先级
| 主题 | 最新决策 | 状态 | 对附件内容的处理 |
|---|---|---|---|
| 交付性质 | 7 天 POC,不是正式版本 | 已确认 | S3 正式一期及生产能力全部后置 |
| 开发框架 | 当前 `map-gm-app` uni-app 工程 | 已确认 | 以前端现状作为适配基线 |
| 目标平台 | 微信小程序 | 已确认 | 不验收 H5、App 或其他小程序 |
| 验证系统 | 仅 iOS | 已确认 | Android 不进入本期兼容验收 |
| 具体环境 | 暂不定最低基础库和具体机型 | 暂缓 | 只记录实际测试环境,不承诺覆盖区间 |
| 地图供应商 | 高德地图 API | 已确认 | 不再把供应商作为开放产品问题 |
| 地图凭证 | 已提供,脱敏尾号 `...554f` | 已确认 | 完整值不进入文档或前端源码 |
| AI | 本期不处理 | 已确认 | 移出 P0、页面、接口、指标和排期 |
| 路径规划 | 本期不处理 | 已确认 | 不绘制路线、不做导航、不定义路线模型 |
| 打卡 | 必须使用真实定位 | 已确认 | S1 的模拟打卡方案失效 |
| 虚拟定位 | 产品内测试能力本期不开发 | 已确认 | 不提供坐标切换或假打卡开关 |
| 身份 | 匿名使用 | 已确认 | 不建设登录和正式会员体系 |
| 个人中心 | 只保存本机数据 | 已确认 | 不建设服务端资产和跨设备同步 |
| Q-12 | 暂不考虑 | 暂缓 | 不作为当前阻塞项 |
## 5. 范围差异与处理
| 差异 | 附件或 V1.0 口径 | V1.1 口径 | 处理理由 |
|---|---|---|---|
| POC 主流程 | 地图 → POI → AI 路线 → 模拟打卡 | 地图 → POI → 真实定位 → 半径校验 → 打卡 → 奖励 → 本机回看 | 用户最新决策 |
| 地图供应商 | 待确认 | 高德地图 API 已确认 | 用户最新决策 |
| 地图技术形态 | 供应商、Key、路线能力混为一项 | 供应商已定;Key 类型、显示载体和安全限制待技术确认 | 产品决策与实现决策分离 |
| AI 页面 | P0 | 本期删除 | 本期不处理 AI |
| 路线结果页 | P0 | 本期删除 | 本期不处理路径规划 |
| 路线 polyline | P0/P1 | 本期删除 | 不保留隐性路线工作量 |
| 打卡模式 | 默认模拟,真实定位为条件范围 | 只允许真实定位成功 | 用户最新决策 |
| 打卡降级 | 可用模拟方式继续演示 | 定位失败不得打卡或授奖 | 防止假结果冒充真实定位 |
| 虚拟位置测试 | 未形成独立边界 | 产品内能力明确不做 | 控制测试工具侵入产品范围 |
| 用户身份 | 假设匿名 | 已确认匿名 | 用户最新决策 |
| 个人资产 | 假设本机保存 | 已确认本机保存 | 用户最新决策 |
| 兼容范围 | iOS + Android | 微信小程序,仅 iOS 验证 | 用户最新决策 |
| 最低基础库/机型 | P0 待确认 | 暂缓 | 不作为 7 天开工阻塞项 |
| 演示对象/投屏 | P0 待确认 | 暂缓 | 用户明确暂不考虑 |
## 6. 当前 POC 范围
### 6.1 必做范围
- 高德地图相关能力接入、地图拖动缩放和光明区默认视野。
- 审核后的样本 POI marker、分类、筛选、摘要和详情。
- 微信小程序按需申请位置权限并取得当前真实位置。
- 统一 GCJ-02 坐标,按 POI 可配置半径执行距离校验。
- 定位拒绝、系统定位关闭、精确位置不可用、超时、精度不足和越界处理。
- 首次有效打卡、重复打卡幂等、积分和徽章反馈。
- 匿名本机持久化、个人中心回看和演示数据重置。
- iOS 微信小程序实测及异常恢复验证。
### 6.2 条件范围
- POI 名称搜索:只有样本规模和搜索数据支持时纳入。
- 官方推荐排序:只有来源和配置明确时纳入,不制作虚假算法榜单。
- POI 电话、预约或外部链接:只有数据和微信端行为验证通过时显示。
### 6.3 明确不在本期
- AI 助手、AI 问答、AI 路线和相关知识库。
- 路径规划、路线结果、polyline、道路路线、实时导航和动态重排。
- 产品内虚拟定位、坐标输入、测试位置切换或假打卡开关。
- 正式登录、会员、服务端积分、跨设备同步和生产级防作弊。
- Android、H5、App、支付宝等端的本期验收。
- CMS、运营后台、UGC、交易、支付、优惠券、核销和数据大屏。
## 7. 仍需补齐的输入
### 7.1 Day 1 技术确认
| ID | 事项 | 默认处理 | 是否阻塞对应功能 |
|---|---|---|---|
| T-01 | 已提供高德 Key 的类型、所属账号、额度、白名单和可用 API | 不猜测 Key 类型;先做最小调用验证 | 是,阻塞高德在线能力 |
| T-02 | 高德是直接提供底图显示,还是通过小程序 SDK/Web Service 提供 LBS 数据 | 采用能在微信小程序稳定运行的官方方案 | 是,阻塞地图技术方案 |
| T-03 | 微信 AppID、位置隐私声明和接口权限是否配置可用 | Day 1 真机申请一次定位 | 是,阻塞真实定位 |
| T-04 | POI 坐标、坐标系、打卡半径和审核负责人 | 统一 GCJ-02;未单配半径时暂用 `200m` | 是,阻塞目标 POI 打卡 |
### 7.2 内容输入
- POC POI 样本数量、分类、图片、简介、开放时间和合法使用来源。
- 每个可打卡 POI 的准确坐标、可安全到达的实际测试点和奖励配置。
- 徽章名称、图标、说明及每个任务的积分值。
### 7.3 非阻塞暂缓项
- 最低微信基础库版本、具体 iPhone 型号和覆盖范围。
- 最终演示对象、签字人、网络和投屏环境。
- AI、路径规划和已有相关能力的后续接入方式。
- 产品内虚拟定位测试能力。
## 8. 现有工程核对
当前工程可以确认的技术基线为 uni-app、Vue 3、TypeScript、Pinia、`pinia-plugin-persist-uni`、uview-plus、UnoCSS、请求封装、文件路由和微信小程序构建命令。
工程仍是通用模板:首页请求 GitHub 示例接口,应用名称仍为 `unisave`,生成配置中的微信 AppID 仍为测试值。代码中未发现高德地图、`map` 业务页面、`getLocation`、POI、真实定位打卡、距离校验、积分或徽章实现。
因此,“有人已经做好”的能力不在当前工作区可见范围内。V1.1 不把外部或并行工作的 AI/路径能力算作当前工程已完成,也不修改任何业务代码。
## 9. V1.0 到 V1.1 变更清单
| 文档区域 | V1.1 变更 |
|---|---|
| 执行摘要与问题陈述 | 删除 AI 路线价值主张,聚焦地图发现和真实到点互动验证 |
| 产品目标与指标 | 删除 AI 成功率、路线合理性和返回时延;新增定位判定、越界误放行和奖励幂等指标 |
| 用户旅程 | 改为地图 → POI → 定位授权 → 范围校验 → 打卡 → 本机回看 |
| P0/P1/范围外 | AI 和路径全部移出;真实定位由条件范围升为 P0;虚拟定位明确排除 |
| 产品方案 | 删除 AI 服务、路线几何和 Fixture 路线;增加定位、距离校验和本机奖励状态 |
| 页面 | 删除 AI 助手和路线结果;收敛为地图、POI 详情、打卡反馈、个人中心 |
| 功能需求 | 删除 `AI-*``ROUTE-*`;新增 `LOC-*` 和真实定位版 `CHECK-*` |
| 业务规则 | 删除 AI 路线规则;新增坐标、精度、时效、半径、权限和本机资产规则 |
| 数据模型 | 删除路线请求/结果;增加定位样本、打卡任务、打卡记录和本机状态版本 |
| 接口 | 删除 AI/路线接口;高德和微信定位能力单独定义 |
| 埋点 | 删除 AI/路线事件;禁止记录精确定位和轨迹 |
| 非功能需求 | 兼容范围改为仅 iOS 验证;最低基础库和具体机型暂缓 |
| 工程适配 | 按当前模板现状描述,不声明业务能力已完成 |
| 验收和排期 | 改为现场真实定位、权限异常、越界和本机持久化验证 |
| 决策表 | Q-01、Q-10、Q-11 关闭;Q-02/Q-05 部分关闭;Q-07 至 Q-09 后置;Q-12 暂缓 |
## 10. 一致性结论
V1.1 的本期唯一主流程为:
`打开地图 → 浏览/筛选 POI → 查看详情 → 获取真实定位 → 校验距离与有效半径 → 完成打卡 → 获得积分/徽章 → 个人中心本机回看`
AI、路径规划、模拟或虚拟定位、多端、正式账户和服务端资产不得重新出现在 P0、页面导航、数据模型、接口、指标、7 天排期或完成定义中。高德供应商已经确定,但凭证类型、接入层次和安全限制仍是技术确认,不应被误写为产品方向未定。