Files
WenwuMap/2-task.md
T
selfrelease 2d847e154f chore: 初始化仓库
中华文明全图鉴——文物全图系统(PC Web 地图 + NestJS API + 管理后台)。
含三大 IP(文物南迁北归 / 国宝海外回归 / 博物馆手艺人)、AI 文物对话、
文物地图与详情、以及 demo-video-kit 演示视频生成工具。
2026-06-13 20:55:44 +08:00

42 KiB
Raw Blame History

中华文明全图鉴——文物全图系统任务拆解

1. 任务说明

本文档用于跟进《中华文明全图鉴——文物全图系统》的产品、设计、研发、数据、审核、内容和上线工作。

任务采用分级结构:

  • 阶段:按产品版本和实施路径划分。
  • 模块:按业务或技术模块划分。
  • 任务:拆到可分配、可验收、可跟进的最小工作项。

2. 状态约定

状态 含义
[ ] 未开始
[~] 进行中
[x] 已完成
[!] 阻塞
[-] 暂缓或取消

3. 优先级约定

优先级 含义
P0 MVP 必须完成,不完成不可上线
P1 重要功能,优先进入第一或第二阶段
P2 增强功能,可在稳定后迭代
P3 远期能力或探索性功能

阶段 0:项目启动与基础准备

0.1 项目管理准备

  • P0 确认项目负责人
  • P0 确认产品负责人
  • P0 确认技术负责人
  • P0 确认设计负责人
  • P0 确认内容负责人
  • P0 确认数据负责人
  • P0 确认阶段性交付节奏
  • P0 建立周会机制
  • P0 建立需求评审机制
  • P0 建立设计评审机制
  • P0 建立技术评审机制
  • P0 建立上线评审机制
  • P0 建立风险登记表
  • P0 建立问题跟进表
  • P0 建立版本发布记录

0.2 文档体系准备

  • P0 完成详细方案文档
  • P0 完成 1-prd.md
  • P0 完成 2-task.md
  • P0 编写 3-architecture.md 技术架构文档
  • P0 编写 4-data-model.md 数据模型文档
  • P0 编写 5-api.md API 设计文档
  • P1 编写 6-ui-flow.md 页面流程文档
  • P1 编写 7-audit-rules.md 审核规则文档
  • P1 编写 8-tag-system.md 标签体系文档
  • P1 编写 9-content-template.md 内容模板规范文档
  • P1 编写 10-launch-checklist.md 上线检查清单
  • P0 建立 11-progress-log.md 阶段进度与测试记录文档

0.3 协作工具准备

  • P0 确认代码仓库地址
  • P0 初始化 Git 分支规范
  • P0 初始化 Issue 管理方式
  • P0 初始化任务看板
  • P0 初始化产品文档目录
  • P0 初始化设计稿目录
  • P0 初始化数据样例目录
  • P0 初始化接口文档地址
  • P0 初始化测试用例目录
  • P0 初始化部署环境说明

0.4 合规与授权准备

  • P0 梳理第一批机构合作名单
  • P0 确认文物数据授权范围
  • P0 确认图片使用授权范围
  • P0 确认 3D 模型使用授权范围
  • P0 确认地图服务合规要求
  • P0 确认用户上传内容合规要求
  • P0 确认海外文物表述边界
  • P0 确认敏感坐标展示原则
  • P0 确认隐私政策初稿
  • P0 确认用户协议初稿

阶段 1MVP 国内文物地图

目标:完成国内重点文物地图、文物档案、机构后台、基础标签、基础审核和 PC Web 地图站 MVP。

1.1 产品需求细化

1.1.1 用户端需求

  • P0 确认 PC Web 地图站首页结构
  • P0 确认地图页核心交互
  • P0 确认附近文物列表规则
  • P0 确认文物详情页信息结构
  • P0 确认机构详情页信息结构
  • P0 确认搜索页功能范围
  • P0 确认筛选项范围
  • P0 确认收藏功能是否进入 MVP
  • P0 确认分享功能是否进入 MVP
  • P0 确认纠错入口是否进入 MVP
  • P1 确认研学入口是否展示但暂不实现
  • P1 确认故事内容的展示样式
  • P1 确认数字资产展示样式

1.1.2 后台需求

  • P0 确认后台用户角色
  • P0 确认机构用户权限范围
  • P0 确认管理员权限范围
  • P0 确认文物新增流程
  • P0 确认文物编辑流程
  • P0 确认文物发布流程
  • P0 确认文物撤回流程
  • P0 确认位置数据维护流程
  • P0 确认标签维护流程
  • P0 确认图片上传流程
  • P0 确认批量导入流程
  • P1 确认机构 API 接入流程

1.1.3 数据规则

  • P0 确认文物唯一编码规则
  • P0 确认文物门类枚举
  • P0 确认文物级别枚举
  • P0 确认文物状态枚举
  • P0 确认展出状态枚举
  • P0 确认坐标精度枚举
  • P0 确认数据来源枚举
  • P0 确认标签类型枚举
  • P0 确认字段必填规则
  • P0 确认字段校验规则
  • P0 确认数据导入模板字段

1.2 UI/UX 设计

1.2.1 视觉方向

  • P0 确认产品 Logo 方向
  • P0 确认主色方案
  • P0 确认 PC 端整体设计关键词
  • P0 确认“专业、权威、东方、现代、可探索”的视觉基调
  • P0 输出 PC 端情绪板
  • P0 输出文博参考案例分析
  • P0 输出地图产品参考案例分析
  • P0 确认 PC 地图底色方案
  • P0 确认字体层级方案
  • P0 确认卡片阴影和边框风格
  • P0 确认地图图例视觉风格
  • P0 确认文物卡片视觉风格
  • P0 确认详情页头图样式
  • P0 确认标签样式
  • P0 确认时间轴样式
  • P0 确认专业信息展示规范
  • P0 确认趣味化表达边界
  • P1 确认文物故事钩子样式
  • P1 确认一句话人设展示样式
  • P1 确认点位 hover 动效风格
  • P1 确认点位选中动效风格
  • P1 确认聚合展开动效风格
  • P1 确认路线叙事动效风格
  • P1 确认角色卡样式
  • P1 确认故事章节样式
  • P1 确认空状态样式
  • P1 确认加载状态样式
  • P1 确认错误提示样式

1.2.2 PC Web 页面设计

  • P0 设计 PC Web 地图站首页
  • P0 设计地图浏览页
  • P0 设计 PC 大屏地图主画布
  • P0 设计左侧筛选栏
  • P0 设计右侧详情抽屉
  • P0 设计顶部数据统计栏
  • P0 设计图层控制面板
  • P0 设计文物点位 hover 状态
  • P0 设计文物点位选中状态
  • P0 设计机构聚合点展开状态
  • P0 设计筛选结果数量变化反馈
  • P0 设计文物故事钩子展示模块
  • P0 设计数据来源和可信度展示模块
  • P0 设计专业信息与趣味文案共存布局
  • P0 设计地图点位弹层
  • P0 设计机构文物列表页
  • P0 设计文物详情页
  • P0 设计搜索页
  • P0 设计筛选弹层
  • P1 设计收藏列表页
  • P1 设计纠错反馈页
  • P1 设计分享海报页
  • P1 设计用户个人页
  • P1 设计关于项目页
  • P1 设计 1440px 大屏适配稿
  • P1 设计 1920px 大屏适配稿
  • P1 设计大屏展示模式效果稿
  • P1 设计首屏视觉冲击版方案
  • P1 设计探索引导动线方案

1.2.2.1 PC 趣味化体验设计

  • P1 定义文物故事钩子的文案规范
  • P1 定义文物角色化短句规范
  • P1 定义地图探索反馈规则
  • P1 设计“新发现”视觉标记
  • P1 设计“南迁路线”视觉叙事样式
  • P1 设计“离家文物”情绪化但克制的视觉样式
  • P1 设计文物卡片中的趣味信息位
  • P1 设计详情抽屉中的故事预览位
  • P1 设计用户首次进入地图的探索引导
  • P2 设计彩蛋式文物推荐入口
  • P2 设计成就或探索进度入口

1.2.3 后台页面设计

  • P0 设计后台登录页
  • P0 设计后台首页仪表盘
  • P0 设计文物列表页
  • P0 设计文物新增页
  • P0 设计文物编辑页
  • P0 设计文物详情预览页
  • P0 设计位置管理页
  • P0 设计标签管理页
  • P0 设计机构管理页
  • P0 设计用户管理页
  • P0 设计操作日志页
  • P1 设计批量导入页
  • P1 设计数据校验结果页
  • P1 设计内容编辑页

1.2.4 设计交付

  • P0 输出低保真原型
  • P0 组织低保真评审
  • P0 输出高保真设计稿
  • P0 组织高保真评审
  • P0 输出组件标注
  • P0 输出切图和图标资源
  • P0 输出交互说明
  • P0 输出 PC 端设计系统
  • P0 输出地图点位状态规范
  • P0 输出动效说明文档
  • P0 输出趣味化文案规范
  • P0 输出专业信息展示规范
  • P1 输出设计规范文档

1.3 技术架构与工程初始化

1.3.1 技术选型确认

  • P0 确认 PC Web 地图站技术栈
  • P0 确认管理后台技术栈
  • P0 确认后端技术栈
  • P0 确认数据库技术栈
  • P0 确认地图服务商
  • P0 确认对象存储服务商
  • P0 确认搜索方案
  • P0 确认缓存方案
  • P0 确认部署方案
  • P0 确认日志和监控方案

1.3.2 仓库初始化

  • P0 初始化 monorepo 或多仓库结构
  • P0 初始化 PC Web 地图站项目
  • P0 初始化 Web 后台项目
  • P0 初始化后端 API 项目
  • P0 初始化数据库迁移目录
  • P0 初始化共享类型定义目录
  • P0 初始化环境变量模板
  • P0 初始化 README
  • P0 初始化代码格式化配置
  • P0 初始化 lint 配置
  • P0 初始化提交规范
  • P0 初始化 CI 检查流程

1.3.3 环境准备

  • P0 准备本地开发环境
  • P0 准备开发数据库
  • P0 准备测试数据库
  • P0 准备开发对象存储桶
  • P0 准备测试对象存储桶
  • P0 准备开发 Redis
  • P0 准备测试 Redis
  • P0 准备开发地图 Key
  • P0 准备测试地图 Key
  • P0 准备后端开发域名
  • P0 准备后台开发域名
  • P0 准备 PC Web 地图站开发配置

1.4 数据库与数据模型

1.4.1 基础表设计

  • P0 设计 users 表
  • P0 设计 roles 表
  • P0 设计 permissions 表
  • P0 设计 user_roles 表
  • P0 设计 institutions 表
  • P0 设计 artifacts 表
  • P0 设计 artifact_locations 表
  • P0 设计 tags 表
  • P0 设计 tag_categories 表
  • P0 设计 artifact_tags 表
  • P0 设计 digital_assets 表
  • P0 设计 audit_logs 表
  • P0 设计 operation_logs 表

1.4.2 地理数据设计

  • P0 启用 PostGIS 扩展
  • P0 定义精确坐标字段
  • P0 定义模糊区域字段
  • P0 定义坐标精度字段
  • P0 定义位置有效期字段
  • P0 定义最新有效位置查询规则
  • P0 为坐标字段建立空间索引
  • P0 为机构位置建立空间索引
  • P0 设计附近文物查询 SQL
  • P0 设计地图范围查询 SQL
  • P1 设计位置历史轨迹查询 SQL

1.4.3 数据迁移

  • P0 编写初始数据库 migration
  • P0 编写枚举数据 seed
  • P0 编写基础标签 seed
  • P0 编写测试机构 seed
  • P0 编写测试文物 seed
  • P0 编写测试位置 seed
  • P0 验证 migration 可重复执行
  • P0 验证 seed 可在本地环境运行
  • P0 编写数据库回滚说明

1.5 后端基础能力

1.5.1 账号与权限

  • P0 实现后台账号登录
  • P0 实现 JWT 或 Session 鉴权
  • P0 实现密码加密存储
  • P0 实现退出登录
  • P0 实现当前用户信息接口
  • P0 实现角色列表接口
  • P0 实现权限校验中间件
  • P0 实现机构数据隔离
  • P0 实现管理员权限校验
  • P1 实现登录失败限制
  • P1 实现操作 IP 记录

1.5.2 机构接口

  • P0 实现机构列表接口
  • P0 实现机构详情接口
  • P0 实现机构新增接口
  • P0 实现机构编辑接口
  • P0 实现机构启用/禁用接口
  • P0 实现机构地图点位接口
  • P0 实现机构文物列表接口
  • P1 实现机构数据导入接口
  • P1 实现机构 API Token 管理接口

1.5.3 文物接口

  • P0 实现文物列表接口
  • P0 实现文物详情接口
  • P0 实现文物新增接口
  • P0 实现文物编辑接口
  • P0 实现文物发布接口
  • P0 实现文物撤回接口
  • P0 实现文物删除或归档接口
  • P0 实现文物按机构查询接口
  • P0 实现文物按门类查询接口
  • P0 实现文物按年代查询接口
  • P0 实现文物按标签查询接口
  • P0 实现文物搜索接口
  • P1 实现文物详情预览接口
  • P1 实现文物版本记录接口

1.5.4 位置接口

  • P0 实现文物位置新增接口
  • P0 实现文物位置编辑接口
  • P0 实现文物位置列表接口
  • P0 实现文物当前位置接口
  • P0 实现地图范围内文物点位接口
  • P0 实现附近文物接口
  • P0 实现位置精度权限控制
  • P0 实现位置数据有效期判断
  • P0 实现坐标合理性校验
  • P1 实现位置历史轨迹接口
  • P1 实现机构展厅位置接口

1.5.5 标签接口

  • P0 实现标签分类列表接口
  • P0 实现标签列表接口
  • P0 实现标签新增接口
  • P0 实现标签编辑接口
  • P0 实现标签启用/禁用接口
  • P0 实现文物绑定标签接口
  • P0 实现文物解绑标签接口
  • P0 实现按标签筛选文物接口
  • P1 实现标签来源记录接口
  • P1 实现标签变更日志接口

1.5.6 文件与数字资产接口

  • P0 实现文件上传签名接口
  • P0 实现图片上传接口
  • P0 实现图片资源绑定文物接口
  • P0 实现数字资产列表接口
  • P0 实现数字资产删除接口
  • P0 实现文件类型校验
  • P0 实现文件大小限制
  • P1 实现图片压缩处理
  • P1 实现图片缩略图生成
  • P1 实现 3D 模型上传接口

1.5.7 操作日志

  • P0 实现关键操作日志记录
  • P0 实现文物新增日志
  • P0 实现文物编辑日志
  • P0 实现文物发布日志
  • P0 实现位置修改日志
  • P0 实现标签修改日志
  • P0 实现机构数据修改日志
  • P0 实现后台登录日志
  • P0 实现日志查询接口
  • P1 实现日志导出接口

1.6 PC Web 地图站开发

1.6.1 Web 基础

  • P0 初始化 PC Web 地图站工程
  • P0 配置 Web 环境变量
  • P0 配置接口域名
  • P0 配置地图服务 Key
  • P0 实现全局请求封装
  • P0 实现接口错误处理
  • P0 实现全局加载状态
  • P0 实现基础路由结构
  • P0 实现基础主题样式
  • P0 实现埋点基础封装

1.6.2 首页

  • P0 实现首页入口布局
  • P0 实现快速进入地图按钮
  • P0 实现附近文物入口
  • P1 实现推荐文物模块
  • P1 实现专题入口模块
  • P1 实现搜索入口
  • P1 实现项目简介入口

1.6.3 地图页

  • P0 接入 Web 地图引擎
  • P0 实现用户定位授权
  • P0 实现定位失败兜底城市
  • P0 实现地图点位加载
  • P0 实现地图点位聚合
  • P0 实现地图拖拽后重新加载点位
  • P0 实现缩放级别监听
  • P0 实现 PC 大屏地图主画布布局
  • P0 实现左侧筛选栏
  • P0 实现右侧文物详情抽屉
  • P0 实现地图点位与右侧详情抽屉联动
  • P0 实现顶部数据统计栏
  • P0 实现国内文物数量统计展示
  • P0 实现在展/库藏/外借数量统计展示
  • P0 实现地图缩放级别对应展示策略
  • P0 实现文物点位 hover 状态
  • P0 实现文物点位选中状态
  • P0 实现聚合点展开动效
  • P0 实现详情抽屉切换动效
  • P0 实现筛选结果数量变化反馈
  • P0 实现文物故事钩子展示
  • P0 实现数据来源与可信度醒目展示
  • P0 实现专业信息与趣味短句并列展示
  • P0 实现蓝点国内在展图例
  • P0 实现库藏图例
  • P0 实现外借/巡展图例
  • P0 实现点位点击弹层
  • P0 实现机构点位点击后文物列表
  • P0 实现文物点位点击后详情卡片
  • P0 实现地图图例说明
  • P1 实现图层控制面板
  • P1 实现机构点图层开关
  • P1 实现文物点图层开关
  • P1 实现热力图层开关
  • P1 实现路线图层开关
  • P1 实现地图视野内结果列表同步
  • P1 实现新发现标记动效
  • P1 实现路线节点高亮反馈
  • P1 实现首次进入地图探索引导
  • P1 实现文物卡片趣味信息位
  • P1 实现全图/在家视图切换
  • P1 实现离家视图入口占位
  • P1 实现南迁视图入口占位

1.6.3.1 PC 大屏适配

  • P0 适配 1440px 宽度布局
  • P0 适配 1920px 宽度布局
  • P0 适配 2K 及以上大屏布局
  • P0 适配浏览器窗口缩放
  • P0 实现地图容器高度自适应
  • P0 实现侧边栏折叠与展开
  • P1 适配平板横屏浏览
  • P1 适配移动浏览器基础浏览

1.6.4 文物列表页

  • P0 实现机构文物列表
  • P0 实现附近文物列表
  • P0 实现列表分页加载
  • P0 实现列表空状态
  • P0 实现列表错误状态
  • P0 实现文物卡片组件
  • P0 实现点击进入详情
  • P1 实现按距离排序
  • P1 实现按年代排序
  • P1 实现按热度排序

1.6.5 搜索与筛选

  • P0 实现关键词搜索输入
  • P0 实现搜索结果列表
  • P0 实现搜索无结果状态
  • P0 实现搜索历史记录
  • P0 实现门类筛选
  • P0 实现年代筛选
  • P0 实现级别筛选
  • P0 实现机构筛选
  • P0 实现标签筛选
  • P1 实现筛选条件组合展示
  • P1 实现一键清空筛选

1.6.6 文物详情页

  • P0 实现文物基础信息展示
  • P0 实现文物图片展示
  • P0 实现文物当前位置展示
  • P0 实现文物展出状态展示
  • P0 实现文物机构信息展示
  • P0 实现文物标签展示
  • P0 实现数据来源展示
  • P0 实现详情页地图小窗
  • P1 实现故事章节展示
  • P1 实现流转时间轴展示
  • P1 实现收藏按钮
  • P1 实现分享按钮
  • P1 实现纠错入口
  • P2 实现角色卡展示
  • P2 实现 3D 模型入口

1.6.7 用户体系

  • P1 实现微信授权登录
  • P1 实现用户信息保存
  • P1 实现个人中心页
  • P1 实现收藏列表
  • P1 实现浏览历史
  • P1 实现纠错记录
  • P2 实现贡献值展示
  • P2 实现称号展示

1.7 Web 后台开发

1.7.1 后台基础

  • P0 初始化后台工程
  • P0 实现登录页
  • P0 实现登录态保持
  • P0 实现退出登录
  • P0 实现后台布局
  • P0 实现侧边菜单
  • P0 实现面包屑导航
  • P0 实现权限路由
  • P0 实现请求封装
  • P0 实现错误提示
  • P0 实现表格通用组件
  • P0 实现表单通用组件

1.7.2 仪表盘

  • P1 实现文物总数统计
  • P1 实现机构总数统计
  • P1 实现在展文物统计
  • P1 实现库藏文物统计
  • P1 实现待发布数据统计
  • P1 实现最近更新列表
  • P1 实现数据完整度提示

1.7.3 文物管理

  • P0 实现文物列表页
  • P0 实现文物关键词搜索
  • P0 实现文物门类筛选
  • P0 实现文物年代筛选
  • P0 实现文物级别筛选
  • P0 实现文物状态筛选
  • P0 实现文物新增表单
  • P0 实现文物编辑表单
  • P0 实现文物详情预览
  • P0 实现文物保存草稿
  • P0 实现文物提交发布
  • P0 实现文物撤回
  • P0 实现文物归档
  • P0 实现文物图片上传
  • P0 实现文物标签绑定
  • P1 实现批量操作
  • P1 实现文物版本历史

1.7.4 位置管理

  • P0 实现位置列表
  • P0 实现位置新增表单
  • P0 实现位置编辑表单
  • P0 实现地图选点
  • P0 实现经纬度手动录入
  • P0 实现坐标精度选择
  • P0 实现展出状态选择
  • P0 实现位置有效期设置
  • P0 实现位置来源选择
  • P0 实现当前位置标记
  • P1 实现位置历史查看
  • P1 实现展厅平面图引用

1.7.5 机构管理

  • P0 实现机构列表
  • P0 实现机构新增表单
  • P0 实现机构编辑表单
  • P0 实现机构启用/禁用
  • P0 实现机构账号绑定
  • P0 实现机构地址定位
  • P0 实现机构文物数量统计
  • P1 实现机构数据更新提醒
  • P1 实现机构 API Token 管理

1.7.6 标签管理

  • P0 实现标签分类列表
  • P0 实现标签分类新增
  • P0 实现标签分类编辑
  • P0 实现标签列表
  • P0 实现标签新增
  • P0 实现标签编辑
  • P0 实现标签启用/禁用
  • P0 实现标签类型选择
  • P0 实现标签排序
  • P1 实现标签使用次数统计
  • P1 实现标签变更日志

1.7.7 批量导入

  • P1 设计 Excel 导入模板
  • P1 实现模板下载
  • P1 实现文件上传
  • P1 实现导入预校验
  • P1 实现字段缺失提示
  • P1 实现枚举值错误提示
  • P1 实现坐标格式错误提示
  • P1 实现重复数据提示
  • P1 实现导入结果预览
  • P1 实现确认导入
  • P1 实现导入失败报告下载

1.7.8 操作日志后台

  • P0 实现操作日志列表
  • P0 实现按操作人筛选
  • P0 实现按操作类型筛选
  • P0 实现按时间筛选
  • P0 实现日志详情查看
  • P1 实现日志导出

1.8 搜索与筛选

  • P0 确认搜索字段范围
  • P0 实现数据库基础搜索
  • P0 实现名称模糊搜索
  • P0 实现机构名称搜索
  • P0 实现门类筛选
  • P0 实现年代筛选
  • P0 实现级别筛选
  • P0 实现状态筛选
  • P0 实现标签筛选
  • P0 实现分页返回
  • P0 实现排序规则
  • P1 接入 OpenSearch 或 Elasticsearch
  • P1 实现全文索引同步
  • P1 实现搜索高亮
  • P1 实现拼音或同义词搜索

1.9 种子数据建设

1.9.1 数据模板

  • P0 设计文物数据录入模板
  • P0 设计机构数据录入模板
  • P0 设计位置数据录入模板
  • P0 设计标签数据录入模板
  • P0 设计图片素材命名规则
  • P0 设计数据来源填写规则
  • P0 设计必填字段说明
  • P0 设计数据错误示例说明

1.9.2 数据采集

  • P0 确认第一批 5-10 家机构
  • P0 确认第一批 500-1000 件重点文物
  • P0 收集文物基础信息
  • P0 收集文物所在机构信息
  • P0 收集文物展厅或展柜信息
  • P0 收集文物高清图片
  • P0 收集文物来源资料
  • P0 收集文物简介文本
  • P1 收集文物流转历史
  • P1 收集文物故事资料
  • P1 收集文物数字资产

1.9.3 数据清洗

  • P0 清洗文物名称
  • P0 清洗年代字段
  • P0 清洗门类字段
  • P0 清洗级别字段
  • P0 清洗材质字段
  • P0 清洗尺寸字段
  • P0 清洗机构名称
  • P0 清洗地址字段
  • P0 清洗坐标字段
  • P0 去除重复文物记录
  • P0 检查必填字段缺失
  • P0 检查图片链接有效性
  • P0 检查数据来源完整性

1.9.4 数据入库

  • P0 导入机构数据
  • P0 导入文物基础数据
  • P0 导入位置数据
  • P0 导入标签数据
  • P0 导入图片资源
  • P0 生成全图唯一编码
  • P0 校验导入数量
  • P0 校验地图点位显示
  • P0 校验详情页展示
  • P0 校验后台可编辑

1.10 MVP 测试

1.10.1 接口测试

  • P0 编写账号登录接口测试
  • P0 编写机构接口测试
  • P0 编写文物接口测试
  • P0 编写位置接口测试
  • P0 编写标签接口测试
  • P0 编写文件上传接口测试
  • P0 编写地图点位接口测试
  • P0 编写搜索接口测试
  • P0 编写权限隔离测试

1.10.2 前端测试

  • P0 测试 PC Web 首页
  • P0 测试 PC Web 地图加载
  • P0 测试 PC Web 定位授权
  • P0 测试 PC Web 点位点击
  • P0 测试 PC Web 文物详情
  • P0 测试 PC Web 搜索筛选
  • P0 测试后台登录
  • P0 测试后台文物新增
  • P0 测试后台文物编辑
  • P0 测试后台位置维护
  • P0 测试后台标签管理
  • P0 测试后台机构管理

1.10.3 数据测试

  • P0 检查 1000 件文物是否可正常展示
  • P0 检查所有机构是否有有效坐标
  • P0 检查所有地图点位是否在合理范围内
  • P0 检查文物详情字段完整率
  • P0 检查图片加载成功率
  • P0 检查标签覆盖率
  • P0 检查数据来源完整率

1.10.4 性能测试

  • P0 测试地图首页首屏加载时间
  • P0 测试地图拖拽加载时间
  • P0 测试文物详情页加载时间
  • P0 测试搜索响应时间
  • P0 测试后台列表响应时间
  • P1 测试并发访问地图接口
  • P1 测试批量导入性能

1.10.5 安全测试

  • P0 测试未登录访问后台拦截
  • P0 测试机构用户越权访问
  • P0 测试普通用户访问后台接口
  • P0 测试文件上传类型限制
  • P0 测试敏感坐标权限控制
  • P0 测试操作日志记录完整性
  • P1 测试接口限流
  • P1 测试常见注入风险

1.11 MVP 上线

  • P0 准备生产环境数据库
  • P0 准备生产环境 Redis
  • P0 准备生产对象存储
  • P0 准备生产地图 Key
  • P0 配置生产域名
  • P0 配置 HTTPS 证书
  • P0 配置后端服务部署
  • P0 配置后台部署
  • P0 配置 PC Web 地图站生产环境
  • P0 配置日志采集
  • P0 配置错误监控
  • P0 完成数据库初始化
  • P0 完成种子数据导入
  • P0 完成 PC Web 地图站发布
  • P0 完成上线前回归测试
  • P0 完成上线公告
  • P0 完成上线后监控
  • P0 完成上线问题响应机制

阶段 2:全球版与海外发现体系

目标:支持海外文物线索提交、AI 初筛、专家复核、社区公示、发现者署名,以及全图/在家/离家/南迁视图。

2.1 海外文物数据模型

  • P1 设计 overseas_artifact_reports 表
  • P1 设计 source_evidences 表
  • P1 设计 audit_tasks 表
  • P1 设计 expert_reviews 表
  • P1 设计 public_notices 表
  • P1 设计 contribution_records 表
  • P1 设计 user_titles 表
  • P1 设计 report_status 枚举
  • P1 设计 source_confidence 枚举
  • P1 设计 overseas location_type 扩展
  • P1 设计发现者匿名展示字段
  • P1 设计证据附件字段
  • P1 编写数据库 migration
  • P1 编写测试数据 seed

2.2 用户提交海外线索

2.2.1 PC Web 提交入口

  • P1 增加“发现海外文物”入口
  • P1 实现提交须知页面
  • P1 实现海外机构名称输入
  • P1 实现文物名称输入
  • P1 实现文物门类选择
  • P1 实现所在国家选择
  • P1 实现所在城市输入
  • P1 实现地图选点
  • P1 实现精确/模糊位置选择
  • P1 实现照片上传
  • P1 实现来源链接填写
  • P1 实现来源说明填写
  • P1 实现匿名/署名选择
  • P1 实现提交前预览
  • P1 实现提交成功页
  • P1 实现提交记录列表
  • P1 实现审核进度查看

2.2.2 后端提交接口

  • P1 实现海外线索提交接口
  • P1 实现提交字段校验
  • P1 实现照片上传绑定
  • P1 实现坐标合法性校验
  • P1 实现重复提交初步判断
  • P1 实现提交后生成审核任务
  • P1 实现提交记录查询接口
  • P1 实现审核状态查询接口
  • P1 实现补充材料接口

2.3 AI 初筛

  • P1 确认 AI 初筛规则
  • P1 实现名称相似度查重
  • P1 实现机构相似度查重
  • P1 实现坐标聚类查重
  • P1 实现来源链接可访问性检查
  • P1 实现来源可信度评分
  • P1 实现反常识规则检测
  • P1 实现图片基础检测
  • P1 实现初筛结果记录
  • P1 实现初筛通过进入专家审核
  • P1 实现初筛疑似重复合并建议
  • P1 实现初筛失败原因展示
  • P2 实现图像相似度辅助判断

2.4 专家审核后台

  • P1 实现专家账号角色
  • P1 实现专家审核任务列表
  • P1 实现按地域筛选任务
  • P1 实现按门类筛选任务
  • P1 实现任务详情页
  • P1 展示用户提交信息
  • P1 展示 AI 初筛结果
  • P1 展示证据附件
  • P1 展示地图位置
  • P1 实现审核通过操作
  • P1 实现审核驳回操作
  • P1 实现要求补充材料操作
  • P1 实现审核意见填写
  • P1 实现审核日志记录
  • P2 实现双专家审核
  • P2 实现仲裁审核
  • P2 实现专家工作量统计

2.5 社区公示

  • P2 设计公示状态流转
  • P2 实现公示列表页
  • P2 实现公示详情页
  • P2 实现公示倒计时
  • P2 实现用户质疑入口
  • P2 实现质疑材料提交
  • P2 实现公示期结束自动转正式
  • P2 实现重大质疑转专家复核
  • P2 实现公示记录归档

2.6 发现者贡献体系

  • P1 设计贡献值计算规则
  • P1 设计称号升级规则
  • P1 实现贡献记录表
  • P1 实现审核通过后发放贡献值
  • P1 实现发现者署名展示
  • P1 实现匿名展示逻辑
  • P1 实现个人贡献值页面
  • P1 实现称号展示
  • P2 实现贡献排行榜
  • P2 实现徽章体系
  • P2 实现发现者证书

2.7 全图/在家/离家视图

  • P1 设计视图切换交互
  • P1 实现地图状态筛选参数
  • P1 实现全图视图
  • P1 实现在家视图
  • P1 实现离家视图
  • P1 实现海外红点图例
  • P1 实现海外模糊区域图例
  • P1 实现未知位置灰色问号
  • P1 实现全球地图点位加载
  • P1 实现海外机构聚合
  • P1 实现海外文物详情展示
  • P1 实现位置可信度展示

2.8 南迁路线专题

  • P2 整理南迁路线节点
  • P2 整理南迁相关文物清单
  • P2 设计南迁视图 UI
  • P2 设计紫色光环图例
  • P2 设计路线动画效果
  • P2 实现南迁路线数据模型
  • P2 实现路线节点接口
  • P2 实现路线地图渲染
  • P2 实现路线节点点击弹层
  • P2 实现节点历史内容展示
  • P2 实现文物与路线节点关联
  • P3 实现 AI 还原场景入口

2.9 用户举报与纠错

  • P1 实现文物详情纠错入口
  • P1 实现错误类型选择
  • P1 实现纠错说明填写
  • P1 实现证据上传
  • P1 实现纠错提交接口
  • P1 实现纠错任务后台
  • P1 实现纠错审核通过
  • P1 实现纠错驳回
  • P1 实现纠错成功贡献值发放
  • P1 实现被纠错数据重新复核

阶段 3:标签引擎与内容衍生

目标:建立标签规则、内容模板、AI 辅助生成、故事审核、研学/有声/3D 内容能力。

3.1 标签体系增强

  • P1 整理基础属性标签全集
  • P1 整理流转经历标签全集
  • P1 整理情感属性标签全集
  • P1 确认标签命名规范
  • P1 确认标签展示规范
  • P1 确认标签新增申请流程
  • P1 确认标签季度评审流程
  • P1 实现标签来源字段
  • P1 实现标签置信度字段
  • P1 实现标签审核状态
  • P1 实现 AI 推荐标签待确认状态
  • P1 实现标签组合查询
  • P2 实现标签权重
  • P2 实现标签使用统计

3.2 标签规则引擎

  • P2 设计 tag_rules 表
  • P2 设计规则条件结构
  • P2 设计规则触发结果结构
  • P2 实现规则新增
  • P2 实现规则编辑
  • P2 实现规则启用/禁用
  • P2 实现规则匹配服务
  • P2 实现文物标签组合匹配
  • P2 实现命中模板返回
  • P2 实现规则测试工具
  • P2 实现规则命中日志

3.3 文物故事系统

  • P1 设计 artifact_stories 表
  • P1 设计故事章节枚举
  • P1 实现故事新增
  • P1 实现故事编辑
  • P1 实现故事保存草稿
  • P1 实现故事提交审核
  • P1 实现故事发布
  • P1 实现故事撤回
  • P1 实现故事版本记录
  • P1 实现故事来源引用
  • P1 实现详情页故事展示
  • P2 实现特殊章节展示
  • P2 实现故事朗读入口

3.4 角色卡系统

  • P2 设计 artifact_personas 表
  • P2 定义 identity 字段
  • P2 定义 personality 字段
  • P2 定义 voice_tone 字段
  • P2 定义 catchphrase 字段
  • P2 定义 taboo_topics 字段
  • P2 定义 emotional_anchor 字段
  • P2 实现角色卡编辑后台
  • P2 实现角色卡审核流程
  • P2 实现角色卡发布
  • P2 实现详情页角色卡展示
  • P3 实现角色语音配置
  • P3 实现角色对话入口

3.5 内容模板库

  • P2 设计 content_templates 表
  • P2 确认模板类型枚举
  • P2 确认模板字段结构
  • P2 编写首批故事模板
  • P2 编写首批有声故事模板
  • P2 编写首批研学任务模板
  • P2 编写首批视频脚本模板
  • P2 编写首批社交海报模板
  • P2 实现模板新增
  • P2 实现模板编辑
  • P2 实现模板启用/禁用
  • P2 实现模板预览
  • P2 实现模板与标签规则绑定

3.6 AI 辅助生成

  • P2 确认 LLM 服务商或私有化模型
  • P2 确认 Embedding 模型
  • P2 确认 Reranker 模型
  • P2 设计 AI 调用网关
  • P2 设计提示词模板管理
  • P2 实现文物描述结构化提取
  • P2 实现标签推荐
  • P2 实现故事初稿生成
  • P2 实现角色卡初稿生成
  • P2 实现生成结果保存
  • P2 实现人工确认后发布
  • P2 实现 AI 生成日志
  • P2 实现 AI 调用失败重试
  • P2 实现 AI 成本统计
  • P2 实现敏感内容拦截

3.7 RAG 文物知识库

  • P2 确认知识库资料来源范围
  • P2 设计知识文档表
  • P2 设计文档切分规则
  • P2 实现文档上传
  • P2 实现文档解析
  • P2 实现文档切块
  • P2 实现向量生成
  • P2 实现向量入库
  • P2 实现语义检索
  • P2 实现重排序
  • P2 实现引用来源展示
  • P2 实现知识库问答接口
  • P2 实现仅基于已审核资料回答
  • P2 实现无法回答兜底提示

3.8 内容审核与发布

  • P2 设计内容审核状态
  • P2 实现编辑提交审核
  • P2 实现专家史实校验
  • P2 实现内容审核通过
  • P2 实现内容审核驳回
  • P2 实现内容修改意见
  • P2 实现内容发布
  • P2 实现内容撤回
  • P2 实现内容版本记录
  • P2 实现内容与文物关联
  • P2 实现内容与标签关联

3.9 研学任务链

  • P3 设计研学任务数据模型
  • P3 设计任务类型枚举
  • P3 设计任务完成条件
  • P3 设计任务奖励规则
  • P3 实现任务模板创建
  • P3 实现任务链创建
  • P3 实现任务领取
  • P3 实现任务完成提交
  • P3 实现任务进度展示
  • P3 实现研学报告生成
  • P3 实现家长分享入口

3.10 3D 与数字资产展示

  • P2 确认 3D 模型格式规范
  • P2 确认模型大小限制
  • P2 确认模型压缩策略
  • P2 实现 GLB 模型上传
  • P2 实现模型资源绑定文物
  • P2 实现 Web 端模型查看器
  • P2 实现模型旋转缩放
  • P2 实现模型热点说明
  • P3 实现小程序 3D 展示适配
  • P3 实现 AR 展示入口
  • P3 实现 VR 场景入口

阶段 4:运营、增长与数据回流

4.1 运营后台

  • P2 实现运营数据看板
  • P2 实现用户增长统计
  • P2 实现文物浏览排行
  • P2 实现机构访问排行
  • P2 实现搜索词统计
  • P2 实现分享数据统计
  • P2 实现收藏数据统计
  • P2 实现贡献用户统计
  • P2 实现举报纠错统计
  • P2 实现内容消费统计

4.2 用户行为埋点

  • P2 设计埋点事件规范
  • P2 实现页面浏览埋点
  • P2 实现地图点击埋点
  • P2 实现文物详情浏览埋点
  • P2 实现搜索埋点
  • P2 实现筛选埋点
  • P2 实现分享埋点
  • P2 实现收藏埋点
  • P2 实现纠错提交埋点
  • P2 实现海外线索提交埋点
  • P2 实现内容消费埋点

4.3 推荐与数据回流

  • P3 设计用户兴趣标签
  • P3 设计文物热度分
  • P3 设计标签权重更新规则
  • P3 实现热门文物推荐
  • P3 实现附近推荐
  • P3 实现同类文物推荐
  • P3 实现故事内容推荐
  • P3 实现用户行为反哺标签权重

4.4 活动与专题

  • P2 设计专题数据模型
  • P2 实现专题创建
  • P2 实现专题编辑
  • P2 实现专题发布
  • P2 实现专题下线
  • P2 实现首页专题入口
  • P2 实现专题详情页
  • P2 实现专题关联文物
  • P2 实现南迁北归专题
  • P3 实现节日活动专题
  • P3 实现机构联名专题

阶段 5:安全、合规与运维体系

5.1 安全体系

  • P0 实现 HTTPS 全站访问
  • P0 实现后台登录鉴权
  • P0 实现接口权限校验
  • P0 实现机构数据隔离
  • P0 实现敏感坐标权限控制
  • P0 实现文件上传安全校验
  • P0 实现关键操作审计
  • P1 实现接口限流
  • P1 实现登录失败保护
  • P1 实现敏感操作二次确认
  • P1 实现数据导出权限控制
  • P1 实现备份数据访问控制

5.2 隐私与合规

  • P0 完成用户协议
  • P0 完成隐私政策
  • P0 完成儿童信息保护说明
  • P0 完成用户上传内容规则
  • P0 完成地图合规审查
  • P0 完成文物图片授权审查
  • P0 完成机构数据授权审查
  • P1 完成 AI 生成内容免责声明
  • P1 完成海外文物表述规范
  • P1 完成用户举报处理规范

5.3 备份与恢复

  • P0 配置数据库定时备份
  • P0 配置对象存储备份策略
  • P0 配置环境变量备份策略
  • P0 编写数据库恢复流程
  • P0 演练数据库恢复
  • P1 配置跨区域备份
  • P1 配置备份告警
  • P1 配置备份完整性检查

5.4 监控与告警

  • P0 配置后端服务健康检查
  • P0 配置接口错误监控
  • P0 配置前端错误监控
  • P0 配置数据库监控
  • P0 配置 Redis 监控
  • P0 配置对象存储访问监控
  • P0 配置日志采集
  • P0 配置错误告警
  • P1 配置接口耗时告警
  • P1 配置地图接口异常告警
  • P1 配置 AI 调用异常告警

5.5 发布流程

  • P0 设计开发环境发布流程
  • P0 设计测试环境发布流程
  • P0 设计生产环境发布流程
  • P0 设计回滚流程
  • P0 设计数据库变更流程
  • P0 设计 PC Web 发布流程
  • P0 设计上线公告流程
  • P0 设计上线后问题响应流程
  • P1 实现自动化部署
  • P1 实现灰度发布

阶段 6:验收清单

6.1 MVP 必须验收

  • P0 PC Web 地图站可正常打开
  • P0 PC Web 地图可正常加载
  • P0 PC Web 视觉效果通过设计评审
  • P0 PC Web 整体观感符合专业、权威、东方、现代、可探索基调
  • P0 PC Web 首屏具备清晰视觉焦点和地图探索吸引力
  • P0 PC Web 地图点位 hover、选中和聚合展开状态可用
  • P0 PC Web 详情抽屉动效自然且不影响性能
  • P0 PC Web 文物卡片同时具备专业信息和趣味信息
  • P0 PC Web 数据来源、可信度、位置精度展示清晰
  • P0 用户可查看附近文物
  • P0 用户可查看机构文物列表
  • P0 用户可查看文物详情
  • P0 用户可按关键词搜索文物
  • P0 用户可按门类筛选文物
  • P0 后台管理员可登录
  • P0 机构用户可登录
  • P0 机构用户只能管理本机构数据
  • P0 管理员可管理所有机构数据
  • P0 后台可新增文物
  • P0 后台可编辑文物
  • P0 后台可维护位置
  • P0 后台可维护标签
  • P0 后台可上传图片
  • P0 后台可发布文物
  • P0 后台可撤回文物
  • P0 地图可展示不少于 1000 件文物
  • P0 文物详情字段完整率达到约定目标
  • P0 标签覆盖率达到 100%
  • P0 关键操作均有审计日志
  • P0 敏感坐标不对普通用户暴露
  • P0 核心接口响应时间符合要求
  • P0 生产环境已配置备份
  • P0 上线前回归测试通过

6.2 全球版必须验收

  • P1 用户可提交海外文物线索
  • P1 用户可上传证据材料
  • P1 用户可查看审核进度
  • P1 系统可执行 AI 初筛
  • P1 专家可审核线索
  • P1 审核通过后可进入地图展示
  • P1 审核通过后可展示发现者署名
  • P1 用户可获得贡献值
  • P1 地图可切换全图、在家、离家视图
  • P1 用户可提交纠错
  • P1 管理员可处理纠错

6.3 内容生态版必须验收

  • P2 标签规则可配置
  • P2 标签组合可匹配内容模板
  • P2 编辑可创建故事内容
  • P2 AI 可生成故事初稿
  • P2 AI 生成内容必须进入人工审核
  • P2 专家可校验故事史实
  • P2 内容发布后可展示在文物详情页
  • P2 3D 模型可上传并展示
  • P2 内容消费数据可统计

7. 当前建议优先执行顺序

7.1 第一优先级

  • P0 确认第一批合作机构和种子文物范围
  • P0 确认地图服务商和地图合规方案
  • P0 完成技术架构文档
  • P0 完成数据模型文档
  • P0 初始化代码仓库和工程结构
  • P0 建立 PostgreSQL + PostGIS 数据库
  • P0 实现文物、机构、位置、标签核心数据模型
  • P0 实现后台文物管理
  • P0 实现 PC Web 地图和文物详情
  • P0 导入 500-1000 件种子文物

7.2 第二优先级

  • P1 实现批量导入
  • P1 实现搜索增强
  • P1 实现用户登录和收藏
  • P1 实现纠错反馈
  • P1 实现海外线索提交
  • P1 实现 AI 初筛
  • P1 实现专家审核后台

7.3 第三优先级

  • P2 实现内容模板库
  • P2 实现标签规则引擎
  • P2 实现 RAG 知识库
  • P2 实现 AI 故事初稿
  • P2 实现 3D 模型展示
  • P2 实现南迁路线专题

8. 待拆解到排期的问题

  • P0 每个阶段的具体开始时间和结束时间
  • P0 每个模块的负责人
  • P0 每个任务的预计工期
  • P0 每个任务的依赖关系
  • P0 每个任务的验收人
  • P0 每个任务的风险等级
  • P0 第一批上线范围是否收缩
  • P0 第一批机构数据是否可按时提供
  • P0 地图精确到展厅/展柜是否允许公开
  • P0 海外文物功能是否需要单独合规评审