selfrelease
2b42da4421
- rsync 源码并排除 .env/node_modules/构建产物，避免覆盖生产配置 - 构建前 source .env，确保 NEXT_PUBLIC_*/VITE_API_URL/ADMIN_BASE 正确注入 - 支持 --migrate/--seed/--api/--web/--admin/--restart/--no-sync - pm2 startOrReload + 健康检查；支持 SSH 密钥或 DEPLOY_PASS
中华文明全图鉴——文物全图系统
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 大屏地图体验
- 专业美观：东方审美 + 现代地图产品质感
- 趣味可探索：文物故事钩子 + 点位动效 + 路线叙事
- 可信优先：数据来源、审核状态、位置精度均可追溯