# 上级细化任务范围差异分析 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 三份附件的可用信息

| 来源 | 可继续使用 | 仅作背景或移出本专项 |
|---|---|---|
| S1：POC 建设方案 | 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。
