# 附件总结与需求差异分析 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 S1：POC 建设方案

S1 定义了一个 7 天、前后端并行、用于客户展示的 POC。内容包含全域地图、POI、AI 问答或路线、路线展示、模拟打卡、积分徽章和个人中心，并给出约 10 页、Node.js/Python、JSON/SQLite 等候选表达。

S1 的主要价值是确认 POC 性质、7 天约束和演示导向。其 AI 与模拟打卡方案已被最新用户决策调整；候选技术栈也不构成后端技术强制要求。

### 2.2 S2：16 页功能版规划

S2 细化地图缩放、POI 渐进展示、分类筛选、榜单、点位详情、路线、真实定位打卡、游记分享、积分商城、挑战和优惠券等功能。

S2 同时包含 POC 可借鉴的交互细节和生产运营能力。当前只吸收地图、POI、真实定位打卡、积分与徽章相关内容；路线、分享、商城、挑战和优惠券不进入本期。

### 2.3 S3：46 页三期总规划

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 天排期或完成定义中。高德供应商已经确定，但凭证类型、接入层次和安全限制仍是技术确认，不应被误写为产品方向未定。
