开发配置

1. 安装 Node.js

Node.js 版本要求：^20.19.0 || >=22.12.0（来源：package.json -> engines.node）
安装后可执行 node -v 校验版本

2. 进入 Admin 主工程目录

进入目录：Vort-Admin/（不要进入 __Tigshop-*__ 子工程目录）。

3. 安装依赖

在 Vort-Admin/ 根目录打开终端执行：

npm install --registry=https://registry.npmmirror.com

说明：

本工程根目录包含 package-lock.json，建议团队统一使用 npm 安装依赖，避免 lock 文件冲突

4. 配置开发环境变量

Vite 会按运行模式自动加载环境变量文件：

npm run dev：加载 .env.development（同时也会加载 .env，如存在）
npm run build：加载 .env.production（同时也会加载 .env，如存在）

仓库默认忽略 .env.development（见 Vort-Admin/.gitignore），请在 Vort-Admin/ 根目录手动创建。

4.1 创建 `.env.development`

新建文件 .env.development，并按实际环境修改（可直接复制模板后再改值）：

# ===================== 接口请求 =====================
# axios 会按以下规则拼接请求地址：
# baseURL = VITE_BASE_URL + VITE_REQUEST_URL_PREFIX
VITE_BASE_URL=http://localhost:8080
VITE_REQUEST_URL_PREFIX=/api

# ===================== 部署子目录（可选） =====================
# 为空表示部署在根路径。
# 如部署在子目录 /admin 下，则填写：/admin（不要以 / 结尾）
# 注意：该值同时影响“路由 base”与“静态资源 base”。
VITE_BASE_DIR=

# ===================== 登录页默认填充（可选） =====================
# 平台后台登录（/login）
VITE_DEFAULT_USER_NAME=
VITE_DEFAULT_USER_PASSWORD=
# 商家端登录（当访问路径包含 merchantLogin 时）
VITE_DEFAULT_STORE_NAME=
VITE_DEFAULT_STORE_PASSWORD=

# ===================== Demo 模式（可选） =====================
# 1：演示模式（部分操作会被限制，如 IM 配置保存、手机号完整展示等）
# 0：非演示模式
VITE_IS_DEMO=0

# ===================== 版本/形态开关（可选） =====================
# 代码中会按 == 1 判定开关（1 开启，0 关闭）
VITE_IS_MERCHANT=0
VITE_IS_PRO=0
VITE_IS_OVERSEAS=0
VITE_IS_B2B=0
VITE_IS_S2B2C=0
VITE_IS_STORE=0

# ===================== MQTT（可选） =====================
# 不配置时：
# - 开发环境默认：ws(s)://{hostname}:8083/mqtt
# - 生产环境默认：ws(s)://{host}/mqtt
VITE_MQTT_URL=