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

25 KiB

中华文明全图鉴——文物全图系统 PRD

1. 文档信息

项目 内容
产品名称 中华文明全图鉴
产品简称 文物全图
文档类型 PRD 产品需求文档
文档版本 v1.0
适用阶段 0-12 个月产品规划,重点覆盖 MVP 至全球版
目标端 PC Web 地图站、机构/专家/编辑后台;微信小程序作为后续移动端补充

2. 产品定位

2.1 一句话定位

做一张“活着的”中华文明全图,让每一件文物无论在家还是离家,都拥有完整位置、可信档案、结构化标签、故事角色和可衍生内容。

2.2 核心价值

  • 解决“在哪里”:建立全球文物精确或模糊位置数据库,国内文物由机构直供,海外文物由用户众包发现并经审核确认。
  • 解决“是谁”:为每件重点文物建立身份档案、流转历史、标签体系、故事档案和角色卡。
  • 解决“能做什么”:通过标签体系驱动故事、有声内容、研学任务、视频脚本、VR/AR、文创等衍生内容生产。

2.3 产品原则

  • 可信优先:数据来源、审核过程、修改记录均可追溯。
  • 地图优先:以地理位置和流转轨迹作为核心入口。
  • PC 优先:第一阶段优先建设 PC Web 大屏地图体验,保证全球地图、路线、聚合点和文物档案有足够展示空间。
  • 专业美观:PC 端视觉必须体现文博项目的权威感、秩序感和高级感,避免普通后台化、工具化或粗糙地图页。
  • 趣味可探索:在不损害专业性的前提下,通过文物故事钩子、点位动效、探索反馈、角色化短句和路线叙事增强浏览乐趣。
  • 标签驱动:所有内容衍生均依赖结构化标签,不依赖纯人工临时创作。
  • AI 辅助,不替代审核:AI 用于标签推荐、查重、内容初稿和来源辅助判断,最终结论必须人工确认。
  • 敏感信息保护:私人收藏、非公开坐标、机构内部信息需分级展示。

3. 背景与目标

3.1 项目背景

当前文物信息分散在博物馆官网、展览页面、学术论文、拍卖图录、新闻报道、民间记录和海外机构数据库中。普通公众很难直观看到中国文物在全球的分布,文博机构也缺少一个可统一展示、更新、审核和内容衍生的平台。

“中华文明全图鉴”希望构建一个以文物为核心、以地图为入口、以标签为引擎、以可信审核为基础的数据与内容平台。

3.2 阶段目标

阶段 时间 目标 核心产出
第一阶段 0-3 个月 建立国内重点文物可信数据基底 PC Web 地图站 MVP、机构后台、1000 件种子文物、在家视图
第二阶段 3-6 个月 建立海外流失文物发现与审核机制 离家视图、全图对比、用户标记、三级审核、发现者体系
第三阶段 6-12 个月 建立标签驱动内容衍生能力 标签引擎、内容模板库、AI 辅助生成、研学/有声/3D 内容入口

4. 用户画像

用户类型 核心需求 使用场景
普通公众 查看文物分布、了解国宝故事 打开 PC Web 地图站浏览全国或全球文物分布,查看文物档案和故事
学生/家长 研学学习、任务打卡 完成“文物守护人”任务链,生成研学报告
海外华人/留学生 发现海外中国文物、建立情感连接 在海外博物馆标记中国文物位置并获得发现者署名
文博从业者 数据查询、资料维护、展出信息更新 管理机构文物、展厅位置、展出状态和数字资产
专家审核者 审核海外标记、校验史实 对用户提交的位置、来源、证据进行复核
内容编辑 维护故事、角色卡、标签和内容模板 基于标签生成故事初稿并完成编辑审核
内容创作者 获取文物素材和故事线索 按标签筛选文物,获取可授权素材和脚本方向

5. 产品范围

5.1 MVP 范围

MVP 聚焦“PC Web 国内文物地图 + 文物档案 + 后台录入 + 基础标签”。

必须包含:

  • 文物地图浏览
  • PC 大屏地图浏览
  • PC Web 专业视觉设计系统
  • 地图探索趣味交互
  • 附近文物查看
  • 文物详情页
  • 国内机构后台录入
  • 文物主数据管理
  • 位置数据管理
  • 基础标签管理
  • 展出状态管理
  • 数据来源记录
  • 基础搜索与筛选
  • 管理员后台审核与发布

5.2 第二阶段范围

  • 海外文物标记
  • 用户发现者体系
  • AI 初筛
  • 专家复核
  • 社区公示
  • 离家视图
  • 全图对比视图
  • 南迁路线专题
  • 用户举报纠错
  • 贡献值与称号体系

5.3 第三阶段范围

  • 标签规则引擎
  • 内容模板库
  • 故事初稿生成
  • 有声故事入口
  • 研学任务链
  • 3D 文物模型展示
  • 内容审核与发布
  • 创作者素材检索
  • 用户行为数据回流

5.4 暂不纳入 MVP 的范围

  • 区块链数字藏品
  • 实时数字人对话
  • AI 视频自动生成
  • 大型 VR 沉浸式体验
  • 复杂推荐系统
  • 微信小程序完整端
  • 独立原生 App
  • 商业交易闭环

6. 核心用户旅程

6.1 普通用户查看附近文物

  1. 用户打开 PC Web 地图站。
  2. 系统默认展示全国或全球文物地图,用户可选择授权定位查看附近文物。
  3. 地图展示博物馆、文物聚合点、分布热力和筛选图层。
  4. 用户点击机构或文物点位。
  5. 系统展示文物列表或文物详情。
  6. 用户查看故事、位置、展出状态、标签和参观信息。
  7. 用户收藏、分享或进入研学任务。

6.2 机构用户录入文物

  1. 机构用户登录后台。
  2. 创建或导入文物数据。
  3. 录入基础属性、展出状态、坐标、展厅/展柜信息。
  4. 绑定高清图、3D 模型或其他数字资产。
  5. 系统进行格式校验和坐标合理性校验。
  6. 数据进入待发布状态。
  7. 机构确认后上线。
  8. 后续可更新、撤回或修正。

6.3 用户发现海外文物

  1. 用户在海外博物馆发现疑似中国文物。
  2. 用户提交名称、位置、照片、来源说明和坐标。
  3. 系统进行 AI 查重、来源可信度评分和反常识检测。
  4. 通过初筛后进入专家复核。
  5. 专家审核通过后进入社区公示。
  6. 公示期无重大异议后正式上线。
  7. 文物详情页展示发现者署名和可信度等级。
  8. 用户获得贡献值和称号进度。

6.4 编辑生成文物故事

  1. 编辑进入文物详情后台。
  2. 查看文物基础数据、标签、流转历史和来源资料。
  3. 调用 AI 辅助生成故事初稿。
  4. 编辑基于来源资料修订内容。
  5. 文物专家进行史实校验。
  6. 内容审核通过后发布到文物详情页。

7. 功能需求

7.1 文物地图

7.1.1 功能说明

地图是用户浏览文物的主入口,支持全球视角、国内视角、海外视角、南迁路线视角。

7.1.2 功能需求

编号 需求 优先级
MAP-001 支持地图缩放、拖拽、定位 P0
MAP-002 支持按照当前位置展示附近文物和机构 P0
MAP-003 支持点位聚合,避免地图密集时卡顿 P0
MAP-004 支持不同文物状态使用不同图例 P0
MAP-005 支持“全图 / 在家 / 离家 / 南迁路线”视图切换 P1
MAP-006 支持点击机构点位后展示该机构文物列表 P0
MAP-007 支持点击文物点位后展示文物详情卡片 P0
MAP-008 支持模糊区域渲染,不暴露敏感精确坐标 P0
MAP-009 PC Web 支持左侧筛选栏、右侧详情抽屉和地图主画布联动 P0
MAP-010 PC Web 支持顶部数据统计栏,展示国内、海外、在展、库藏等核心数字 P0
MAP-011 PC Web 支持图层控制,包括机构点、文物点、热力层、路线层和模糊区域层 P1
MAP-012 PC Web 支持大屏分辨率适配,重点适配 1440px、1920px 及以上宽度 P0
MAP-013 PC Web 视觉风格需兼具专业文博感和现代地图产品质感 P0
MAP-014 PC Web 支持点位 hover、选中、聚合展开、详情抽屉切换等轻量动效 P0
MAP-015 PC Web 支持文物故事钩子展示,例如一句话人设、代表台词、流转亮点 P1
MAP-016 PC Web 支持探索反馈,例如新发现标记、路线节点高亮、筛选结果数量变化反馈 P1
MAP-017 支持南迁路线动画展示 P2
MAP-018 支持室内平面图或展厅定位 P2

7.1.3 PC 端视觉与趣味性要求

方向 要求
专业性 信息层级清晰,数据来源、审核状态、位置精度和文物级别必须可识别
美观性 采用克制的东方色彩、细腻地图底色、文博纹样点缀和现代卡片布局
趣味性 通过悬浮提示、点位动效、故事短句、角色化文案和路线叙事引导探索
克制性 趣味表达不得卡通化、游戏化过度,不得削弱文物信息的严肃性和可信度
性能 动效必须轻量,不影响地图缩放、拖拽、聚合和详情加载性能

7.1.4 地图图例

图例 含义
实心蓝点 国内在展
实心蓝点 + 房子 国内库藏
空心蓝圈 国内外借或巡展中
实心红点 海外精确坐标
半透明橙圈 海外模糊区域
灰色问号 位置未知
金色箭头 回归中
绿色星标 近期新标记或新展出
紫色光环 南迁北归相关文物

7.2 文物详情页

7.2.1 功能说明

文物详情页是单件文物的完整档案页,包含身份、位置、故事、标签、来源、数字资产和相关内容。

7.2.2 功能需求

编号 需求 优先级
ART-001 展示文物名称、年代、门类、级别、材质、尺寸 P0
ART-002 展示当前状态:在家、离家、在途、未知 P0
ART-003 展示当前位置、机构、展厅或模糊区域 P0
ART-004 展示位置可信度和数据来源 P0
ART-005 展示完整流转时间轴 P1
ART-006 展示故事章节:缘起、流转、精彩故事、现状 P1
ART-007 展示特殊章节:离家、南迁北归、归途 P2
ART-008 展示角色卡,包括人格、语气、口头禅、禁忌话题 P2
ART-009 展示文物标签 P0
ART-010 展示高清图片、音频、视频、3D 模型等数字资产 P1
ART-011 支持收藏、分享、纠错 P1

7.3 标签体系

7.3.1 功能说明

标签是文物筛选、内容衍生、故事模板匹配和推荐的核心基础。

7.3.2 标签类型

类型 示例
基础属性标签 门类、年代、级别、材质、功能、尺寸规模
流转经历标签 流失状态、回归状态、南迁北归、修复经历、外借经历、巡展经历、数字化经历、争议事件、名人关联、入藏方式
情感属性标签 情绪主调、适合年龄、体验时长、互动类型

7.3.3 功能需求

编号 需求 优先级
TAG-001 支持创建、编辑、禁用标签 P0
TAG-002 支持标签分类管理 P0
TAG-003 支持单选、多选、布尔、文本等标签类型 P0
TAG-004 支持文物绑定多个标签 P0
TAG-005 支持按标签筛选文物 P0
TAG-006 支持标签来源记录:机构、编辑、AI、专家 P1
TAG-007 支持 AI 推荐标签,人工确认后生效 P1
TAG-008 支持标签组合触发内容模板 P2
TAG-009 支持标签新增申请和季度评审 P2

7.4 机构后台

7.4.1 功能说明

机构后台用于国内博物馆或文博机构维护自有文物数据。

7.4.2 功能需求

编号 需求 优先级
ORG-001 支持机构账号登录 P0
ORG-002 支持机构信息维护 P0
ORG-003 支持文物新增、编辑、批量导入 P0
ORG-004 支持位置、展厅、展柜和展出状态维护 P0
ORG-005 支持图片、音频、视频、3D 模型上传 P1
ORG-006 支持数据格式校验 P0
ORG-007 支持坐标合理性校验 P0
ORG-008 支持数据撤回、修正和更新 P1
ORG-009 支持机构数据更新提醒 P2
ORG-010 支持机构数据接口接入 P1

7.5 海外发现与用户标记

7.5.1 功能说明

海外发现系统允许用户提交海外中国文物线索,经审核后成为平台可信数据。

7.5.2 功能需求

编号 需求 优先级
UGC-001 支持用户提交海外文物标记 P1
UGC-002 支持提交文物名称、机构、坐标、照片、来源链接和说明 P1
UGC-003 支持精确坐标和模糊区域提交 P1
UGC-004 支持提交后查看审核进度 P1
UGC-005 支持系统自动查重 P1
UGC-006 支持来源可信度评分 P1
UGC-007 支持用户补充证据 P2
UGC-008 支持用户举报错误信息 P1
UGC-009 支持审核通过后发现者署名 P1
UGC-010 支持匿名展示或实名展示 P1

7.6 审核系统

7.6.1 审核模式

国内文物:机构自审 + 系统备案。
海外文物:用户标记 → AI 初筛 → 专家复核 → 社区公示 → 上线。

7.6.2 功能需求

编号 需求 优先级
AUD-001 支持审核任务池 P0
AUD-002 支持按门类、地域、机构分配审核任务 P1
AUD-003 支持 AI 初筛结果展示 P1
AUD-004 支持专家通过、驳回、要求补充资料 P1
AUD-005 支持双专家审核和仲裁机制 P2
AUD-006 支持 7 天社区公示 P2
AUD-007 支持审核日志完整记录 P0
AUD-008 支持审核证据附件管理 P1
AUD-009 支持用户举报后重新进入复核 P1
AUD-010 支持审核状态对用户可见 P1

7.7 发现者贡献体系

7.7.1 功能说明

对用户提交并审核通过的位置线索给予署名、贡献值和称号激励。

7.7.2 贡献规则

行为 分值
提交精确坐标且来源为 A 级 +50
提交模糊区域且来源为 B 级 +20
修正已有错误坐标 +30
补充关键证据材料 +10
被专家认定为无效或恶意提交 0 或扣分

7.7.3 称号体系

称号 条件
见习侦探 注册并完成首次提交
文物巡护员 贡献值 ≥ 100
国宝守夜人 贡献值 ≥ 500
文明守望者 贡献值 ≥ 1000

7.8 故事与角色卡

7.8.1 故事结构

每件重点文物应包含以下故事章节:

章节 内容 字数建议
缘起 何时、何地、何人、为何而创 300 字
流转 历代收藏、迁移、事件 400 字
精彩故事 传奇、争议、人物、当代事件 500 字
现状 现在在哪里、是否展出、如何参观 200 字

特殊文物可增加:

  • 离家章节
  • 南迁北归章节
  • 归途章节

7.8.2 角色卡字段

字段 说明
identity 文物身份设定
personality 性格关键词
voice_tone 声音和表达风格
catchphrase 代表性台词
taboo_topics 不应主动展开的话题
emotional_anchor 情感锚点
related_tags 关联标签
content_templates 可触发内容模板

7.9 内容衍生引擎

7.9.1 功能说明

基于标签组合匹配内容模板,生成故事、音频、研学、视频脚本、VR 体验等内容初稿。

7.9.2 功能需求

编号 需求 优先级
CNT-001 支持内容模板库管理 P2
CNT-002 支持标签组合匹配模板 P2
CNT-003 支持 AI 生成故事或脚本初稿 P2
CNT-004 支持编辑审核和专家校验 P2
CNT-005 支持发布至内容池 P2
CNT-006 支持内容与文物、标签关联 P2
CNT-007 支持有声故事、研学任务、3D 展示等内容类型 P3
CNT-008 支持用户消费数据回流 P3

7.10 AI 辅助能力

7.10.1 MVP AI 能力

  • 文物描述文本结构化提取
  • 标签推荐
  • 用户提交内容查重
  • 坐标异常检测
  • 来源可信度初评

7.10.2 中后期 AI 能力

  • RAG 文物知识库问答
  • 故事初稿生成
  • 角色卡初稿生成
  • 研学任务生成
  • 有声故事脚本生成
  • 文物图像相似度检索

7.10.3 AI 使用约束

  • AI 输出不得直接作为最终公开内容。
  • AI 生成内容必须展示引用来源。
  • 涉及文物归属、流失、追索、争议的信息必须人工审核。
  • AI 问答必须基于已审核知识库,不允许自由编造。

8. 数据需求

8.1 核心实体

实体 说明
artifacts 文物主数据
artifact_locations 文物位置数据
institutions 文博机构数据
users 用户数据
tags 标签定义
artifact_tags 文物标签关系
audit_tasks 审核任务
audit_logs 审核日志
source_evidences 来源证据
artifact_stories 文物故事
artifact_personas 文物角色卡
content_templates 内容模板
content_assets 内容资产
contribution_records 用户贡献记录

8.2 文物主表字段

字段 类型 说明
id UUID 文物唯一 ID
unified_map_id String 全图唯一编码
name String 文物名称
category Enum 门类
dynasty String 年代
level Enum 文物级别
material String 材质
dimensions String 尺寸
current_status Enum 在家、离家、在途、未知
home_institution_id UUID 原属或现属国内机构
created_at Timestamp 创建时间
updated_at Timestamp 更新时间

8.3 位置表字段

字段 类型 说明
id UUID 位置记录 ID
artifact_id UUID 文物 ID
location_type Enum domestic、overseas、unknown、in_transit
institution_id UUID 关联机构
coordinates GeoJSON GPS 坐标或模糊区域
precision Enum 展厅、建筑、城市、国家、区域
floor_plan_ref String 展厅平面图编号
display_status Enum 在展、库藏、外借、修复中、巡展中
source_type Enum 机构直供、用户报告、专家验证
discoverer_user_id UUID 发现者
verified_at Timestamp 审核通过时间
valid_until Timestamp 位置有效期
created_at Timestamp 创建时间

9. 权限角色

角色 权限
游客 浏览公开地图、文物详情、故事内容
注册用户 收藏、分享、提交海外线索、纠错、查看贡献
机构用户 管理本机构文物、位置、展出状态和数字资产
内容编辑 管理故事、角色卡、标签、内容模板
专家 审核海外线索、校验故事史实、处理争议
运营 管理用户、活动、贡献体系、社区公示
系统管理员 全局配置、权限管理、数据审计、发布控制

10. 非功能需求

10.1 性能需求

指标 要求
地图首页首屏加载 ≤ 3 秒
地图缩放和拖拽响应 ≤ 300ms
文物详情页加载 ≤ 2 秒
搜索响应 ≤ 1 秒
后台列表查询 ≤ 2 秒
常规审核操作提交 ≤ 1 秒

10.2 数据安全

  • 私人收藏地址默认模糊展示。
  • 精确坐标仅专家后台或授权角色可见。
  • 机构数据需支持撤回和更新。
  • 用户发现者信息默认匿名,可选择公开昵称或实名。
  • 所有关键数据修改必须记录审计日志。
  • 故事、位置、标签、审核结论需保留历史版本。

10.3 可用性

  • 核心地图服务可用性不低于 99.5%。
  • 后台数据操作需有草稿、保存、撤回、恢复机制。
  • AI 服务不可用时,不影响基础地图和文物详情浏览。

10.4 合规要求

  • 地图展示需符合国内地图服务与地理信息展示要求。
  • 用户上传图片、资料和文字需进行内容安全审核。
  • 涉及海外流失、追索、归属争议的信息需以事实记录为主,避免平台主动发起政治性倡议。
  • 数字资产使用需明确授权来源和可展示范围。

11. 验收标准

11.1 MVP 验收标准

模块 验收标准
文物数据 支持录入不少于 1000 件种子文物
机构数据 支持不少于 5 家机构数据管理
地图展示 可在 PC Web 地图站展示机构和文物点位,支持大屏缩放、聚合、筛选和详情联动
文物详情 可查看基础属性、当前位置、标签、图片和简介
后台管理 机构用户可新增、编辑、提交文物数据
标签管理 管理员可维护基础标签并绑定文物
审核备案 管理员可查看机构提交记录和操作日志
搜索筛选 用户可按名称、年代、门类、机构进行筛选
权限控制 游客、注册用户、机构用户、管理员权限隔离

11.2 第二阶段验收标准

模块 验收标准
海外标记 用户可提交海外文物线索
AI 初筛 系统可返回查重和可信度初评结果
专家审核 专家可通过、驳回或要求补充材料
社区公示 审核通过内容可进入公示期
发现者体系 审核通过后展示发现者署名并发放贡献值
地图视图 支持全图、在家、离家视图切换

11.3 第三阶段验收标准

模块 验收标准
标签引擎 可根据标签组合匹配内容模板
内容模板 不少于 100 个模板可配置
AI 生成 可生成故事或脚本初稿
编辑审核 AI 内容必须经编辑和专家确认后发布
内容池 内容可关联到文物详情页
3D 展示 支持至少一种 3D 文物模型在线查看

12. 核心指标

维度 指标 6 个月目标 12 个月目标
数据覆盖 国内文物精确坐标 1,000 件 10,000 件
数据覆盖 海外文物位置标记 100 件 1,000 件
数据覆盖 接入机构数量 10 家 100 家
用户活跃 MAU 5 万 50 万
用户活跃 发现者注册数 200 人 5,000 人
用户活跃 用户标记提交数 500 条 10,000 条
内容衍生 标签覆盖文物比例 100% 100%
内容衍生 AI 短剧或脚本生成数 50 条 1,000 条
内容衍生 VR/3D 体验上线数 3 个 20 个
数据可信 审核通过率 60% 70%
数据可信 用户举报纠错率 < 5% < 3%
数据可信 机构数据更新频率 月度 实时

13. 风险与对策

风险 对策
私人收藏地址泄露 模糊区域渲染,精确坐标仅专家后台可见
假新闻或假拍卖线索 要求提交图录页码、拍卖日期、机构链接等证据
重复标记 AI 查重、坐标聚类、同机构同展厅自动合并
政治敏感 平台只记录事实状态,不主动发起追索倡议
故事编造 AI 仅生成初稿,公开前必须编辑和专家审核
机构数据更新滞后 提供 API 同步、更新提醒和数据 freshness 标记
标签体系膨胀 基础标签固定,扩展标签申请制和季度评审
地图性能下降 点位聚合、矢量瓦片、缓存和分级加载
AI 幻觉 RAG 引用来源、人工审核、不可直接发布

14. 技术实现建议

模块 推荐技术
PC Web 地图站 Next.js + React + TypeScript
微信小程序 Taro + React + TypeScript,后续移动端补充
管理后台 Ant Design Pro
地图引擎 MapLibre GL JS / 腾讯地图 / 高德地图
后端服务 NestJS + TypeScript
API REST + OpenAPI
主数据库 PostgreSQL + PostGIS
缓存 Redis
搜索 OpenSearch / Elasticsearch
向量检索 pgvector,后续可升级 Milvus
对象存储 OSS / COS / S3
队列 BullMQ + Redis
AI/RAG Embedding + Reranker + LLM + 已审核知识库
3D 展示 Three.js + glTF / GLB
部署 Docker + 云服务,后续 Kubernetes
监控 Sentry + Prometheus + Grafana

15. 版本规划

15.1 v1.0 国内版

目标:建立可信国内文物地图。

核心能力:

  • 机构后台
  • 文物主数据
  • 文物位置数据
  • 基础标签
  • PC Web 地图
  • 文物详情页
  • 在家视图

15.2 v2.0 全球版

目标:建立海外文物发现与审核机制。

核心能力:

  • 海外标记
  • AI 初筛
  • 专家审核
  • 社区公示
  • 发现者署名
  • 离家视图
  • 全图对比
  • 南迁路线专题

15.3 v3.0 内容生态版

目标:建立标签驱动内容衍生能力。

核心能力:

  • 内容模板库
  • 标签规则引擎
  • AI 故事初稿
  • 角色卡
  • 有声故事
  • 研学任务
  • 3D 文物展示
  • 创作者素材入口

16. 待确认问题

  • 第一批合作机构名单与数据授权方式。
  • 国内地图服务商选择与地图合规方案。
  • 文物数据是否需要支持批量导入标准模板。
  • 机构是否允许精确到展厅、展柜级别展示。
  • 海外文物线索的证据等级标准。
  • 专家审核组织方式、费用和 SLA。
  • AI 模型是否采用公有云 API、私有化部署或混合方案。
  • 数字资产版权和授权展示范围。
  • 是否需要多语言版本,尤其是英文。
  • 是否需要开放公共 API 或仅供合作机构使用。