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

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 大屏地图体验
- **专业美观**：东方审美 + 现代地图产品质感
- **趣味可探索**：文物故事钩子 + 点位动效 + 路线叙事
- **可信优先**：数据来源、审核状态、位置精度均可追溯