selfrelease
2d847e154f
中华文明全图鉴——文物全图系统（PC Web 地图 + NestJS API + 管理后台）。 含三大 IP（文物南迁北归 / 国宝海外回归 / 博物馆手艺人）、AI 文物对话、 文物地图与详情、以及 demo-video-kit 演示视频生成工具。
89 lines
1.7 KiB
Markdown
89 lines
1.7 KiB
Markdown
# 中华文明全图鉴——文物全图系统
|
||
|
||
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）
|
||
|
||
### 启动本地基础设施
|
||
|
||
```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 大屏地图体验
|
||
- **专业美观**：东方审美 + 现代地图产品质感
|
||
- **趣味可探索**：文物故事钩子 + 点位动效 + 路线叙事
|
||
- **可信优先**：数据来源、审核状态、位置精度均可追溯
|