2d847e154f
中华文明全图鉴——文物全图系统(PC Web 地图 + NestJS API + 管理后台)。 含三大 IP(文物南迁北归 / 国宝海外回归 / 博物馆手艺人)、AI 文物对话、 文物地图与详情、以及 demo-video-kit 演示视频生成工具。
42 KiB
42 KiB
中华文明全图鉴——文物全图系统任务拆解
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.mdAPI 设计文档 - 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 确认用户协议初稿
阶段 1:MVP 国内文物地图
目标:完成国内重点文物地图、文物档案、机构后台、基础标签、基础审核和 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 海外文物功能是否需要单独合规评审