feat: 重构服务支持双模式并接入 MongoDB 数据库

- 新增 MongoDB 存储层实现英雄、预设和版本数据的持久化
- 新增 push-meta 和 migrate-to-mongo 脚本支持数据同步迁移
- 支持开发版和线上设计版双模式运行
- 新增版本闸门机制，线上设计版落后时进入只读模式
- 优化前端 API 配置适配不同部署环境
- 新增线上设计版静态资源托管和路由回退

put/server/.env.example

@@ -0,0 +1,22 @@
+# ---- 运行模式 ----
+# local  = 项目开发版（本地，全功能：写 heroSet.ts / 导出 CSV / push-meta）
+# remote = 线上设计版（VPS 部署，仅英雄/预设编辑，版本落后时只读）
+MODE=local
+
+# ---- MongoDB（两边都要配置，连同一个库）----
+# 本地 MongoDB 示例：mongodb://127.0.0.1:27017
+# 带账号密码示例：  mongodb://user:password@your-vps-ip:27017
+# Atlas 示例：       mongodb+srv://user:password@cluster0.xxxx.mongodb.net
+MONGO_URL=mongodb://user:password@your-vps-ip:27017
+MONGO_DB=heroconfig
+
+# ---- 服务端口 ----
+PORT=3001
+
+# ---- 数据结构版本 ----
+# 英雄/底座结构有破坏性变更时 +1，并执行 npm run push-meta 推送到库中
+# 线上设计版低于库中版本时将进入只读，需更新部署
+SCHEMA_VERSION=1
+
+# ---- 前端（web/.env，仅静态部署时需要；server 托管 dist 时不用配）----
+# VITE_API_BASE=http://your-vps-ip:3001