Files
gmTouringMiniApp/product-docs/光明区文旅全域地图及AI导览POC/working/上级细化任务范围差异分析 V1.0.md
T

12 KiB
Raw Blame History

上级细化任务范围差异分析 V1.0

文档版本 创建日期 文档状态 版本简述
V1.0 2026-07-29 当前版本 分析上级最新地图/POI任务与三份附件、历史总 PRD 及当前工程之间的差异

目录

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、路线、模拟打卡、积分徽章、个人中心
S216 页功能版规划 地图缩放、渐进展示、分类筛选、点位详情 路线、真实定位打卡、分享、商城、挑战和优惠券
S346 页总规划 文旅数据汇集、地图发现、长期数据运营背景 会员、交易、后台、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 确保只有审核通过内容可见
dataSourcesourceReference 追溯信息来源
copyrightStatus 控制图片和内容使用权
reviewedByreviewedAt 追溯审核责任
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。