chore: 初始化仓库

中华文明全图鉴——文物全图系统(PC Web 地图 + NestJS API + 管理后台)。
含三大 IP(文物南迁北归 / 国宝海外回归 / 博物馆手艺人)、AI 文物对话、
文物地图与详情、以及 demo-video-kit 演示视频生成工具。
This commit is contained in:
selfrelease
2026-06-13 20:55:44 +08:00
commit 2d847e154f
161 changed files with 22629 additions and 0 deletions
+88
View File
@@ -0,0 +1,88 @@
# 中华文明全图鉴——文物全图系统
PC Web 优先的文物全球位置地图平台。
## 项目结构
```
wenwumap/
apps/
web/ # PC Web 地图站(Next.js + React + TypeScript
admin/ # 管理后台(React + Vite + Ant Design
api/ # 后端 APINestJS + TypeScript
packages/
shared/ # 共享类型与枚举
db/ # 数据库 migration 与 seedPostgreSQL + PostGIS
infra/ # Docker Compose 本地基础设施
scripts/ # 工程校验脚本
docs/ # 设计、接口、测试文档(规划中)
```
## 快速开始
### 前置依赖
- Node.js >= 20
- pnpm >= 9
- Docker & Docker Compose(用于本地 PostgreSQL/PostGIS、Redis、MinIO
### 启动本地基础设施
```bash
cd infra
docker compose up -d
```
### 安装依赖
```bash
pnpm install
```
### 复制环境变量
```bash
cp .env.example .env
# 根据实际情况修改 .env
```
### 执行数据库 migration
```bash
pnpm --filter @wenwumap/db migrate
```
### 启动开发服务
```bash
# 后端 API
pnpm dev:api
# PC Web 地图站
pnpm dev:web
# 管理后台
pnpm dev:admin
```
### 结构校验
```bash
pnpm check-structure
```
## 文档
- [产品需求文档](./1-prd.md)
- [任务拆解](./2-task.md)
- [技术架构](./3-architecture.md)
- [数据模型](./4-data-model.md)
- [API 设计](./5-api.md)
- [阶段进度与测试记录](./11-progress-log.md)
## 设计原则
- **PC 优先**:第一阶段优先建设 PC Web 大屏地图体验
- **专业美观**:东方审美 + 现代地图产品质感
- **趣味可探索**:文物故事钩子 + 点位动效 + 路线叙事
- **可信优先**:数据来源、审核状态、位置精度均可追溯