selfrelease
2d847e154f
中华文明全图鉴——文物全图系统（PC Web 地图 + NestJS API + 管理后台）。 含三大 IP（文物南迁北归 / 国宝海外回归 / 博物馆手艺人）、AI 文物对话、 文物地图与详情、以及 demo-video-kit 演示视频生成工具。
1.7 KiB
1.7 KiB
中华文明全图鉴——文物全图系统
PC Web 优先的文物全球位置地图平台。
项目结构
wenwumap/
apps/
web/ # PC Web 地图站（Next.js + React + TypeScript）
admin/ # 管理后台（React + Vite + Ant Design）
api/ # 后端 API（NestJS + TypeScript）
packages/
shared/ # 共享类型与枚举
db/ # 数据库 migration 与 seed（PostgreSQL + PostGIS）
infra/ # Docker Compose 本地基础设施
scripts/ # 工程校验脚本
docs/ # 设计、接口、测试文档（规划中）
快速开始
前置依赖
- Node.js >= 20
- pnpm >= 9
- Docker & Docker Compose（用于本地 PostgreSQL/PostGIS、Redis、MinIO）
启动本地基础设施
cd infra
docker compose up -d
安装依赖
pnpm install
复制环境变量
cp .env.example .env
# 根据实际情况修改 .env
执行数据库 migration
pnpm --filter @wenwumap/db migrate
启动开发服务
# 后端 API
pnpm dev:api
# PC Web 地图站
pnpm dev:web
# 管理后台
pnpm dev:admin
结构校验
pnpm check-structure
文档
设计原则
- PC 优先：第一阶段优先建设 PC Web 大屏地图体验
- 专业美观：东方审美 + 现代地图产品质感
- 趣味可探索：文物故事钩子 + 点位动效 + 路线叙事
- 可信优先：数据来源、审核状态、位置精度均可追溯