feat: 完善环境标识配置

.env.develop

@@ -0,0 +1,14 @@
+# develop 分支测试环境构建配置
+VITE_APP_ENV = "develop"
+VITE_APP_ENV_LABEL = "测试环境"
+
+VITE_PUBLIC_PATH = /
+
+VITE_ROUTER_HISTORY = "hash"
+
+VITE_CDN = false
+
+VITE_COMPRESSION = "none"
+
+# 本地调试 develop mode 时的后端代理目标；线上测试环境由 Nginx 将 /api 代理到测试后端。
+VITE_API_PROXY_TARGET = "http://localhost:3501"

.env.development

@@ -1,6 +1,9 @@
 # 平台本地运行端口号
 VITE_PORT = 8848
 
+VITE_APP_ENV = "local"
+VITE_APP_ENV_LABEL = "本地环境"
+
 # 开发环境读取配置文件路径
 VITE_PUBLIC_PATH = /
 

.env.production

@@ -1,4 +1,7 @@
 # 线上环境平台打包路径
+VITE_APP_ENV = "production"
+VITE_APP_ENV_LABEL = "生产环境"
+
 VITE_PUBLIC_PATH = /
 
 # 线上环境路由历史模式（Hash模式传"hash"、HTML5模式传"h5"、Hash模式带base参数传"hash,base参数"、HTML5模式带base参数传"h5,base参数"）
@@ -10,4 +13,4 @@ VITE_CDN = false
 # 是否启用gzip压缩或brotli压缩（分两种情况，删除原始文件和不删除原始文件）
 # 压缩时不删除原始文件的配置：gzip、brotli、both（同时开启 gzip 与 brotli 压缩）、none（不开启压缩，默认）
 # 压缩时删除原始文件的配置：gzip-clear、brotli-clear、both-clear（同时开启 gzip 与 brotli 压缩）、none（不开启压缩，默认）
-VITE_COMPRESSION = "none"
+VITE_COMPRESSION = "none"

.env.staging

@@ -1,7 +1,10 @@
-# 预发布也需要生产环境的行为
+# 预发布当前按 develop/测试环境标识
 # https://cn.vitejs.dev/guide/env-and-mode.html#modes
 # NODE_ENV = development
 
+VITE_APP_ENV = "develop"
+VITE_APP_ENV_LABEL = "测试环境"
+
 VITE_PUBLIC_PATH = /
 
 # 预发布环境路由历史模式（Hash模式传"hash"、HTML5模式传"h5"、Hash模式带base参数传"hash,base参数"、HTML5模式带base参数传"h5,base参数"）

.env.test

@@ -0,0 +1,17 @@
+# 测试环境构建配置
+VITE_APP_ENV = "develop"
+VITE_APP_ENV_LABEL = "测试环境"
+
+VITE_PUBLIC_PATH = /
+
+# 测试环境路由历史模式
+VITE_ROUTER_HISTORY = "hash"
+
+# 测试环境不使用 CDN，避免外部依赖影响验收
+VITE_CDN = false
+
+# 测试环境默认不生成压缩产物
+VITE_COMPRESSION = "none"
+
+# 本地调试 test mode 时的后端代理目标；线上测试环境由 Nginx 将 /api 代理到测试后端。
+VITE_API_PROXY_TARGET = "http://localhost:3501"

README.md

@@ -86,13 +86,16 @@ http://localhost:8848/
 | `pnpm dev`            | 启动 Vite 开发服务，默认端口来自 `.env.development` 的 `VITE_PORT=8848` | 本地开发             |
 | `pnpm serve`          | `pnpm dev` 的别名                                                       | 兼容习惯命令         |
 | `pnpm build`          | 清理 `dist` 后执行生产构建，内存上限设为 8192MB                         | 发布前打包           |
+| `pnpm build:develop`  | 使用 `develop` mode 构建测试环境静态产物                                | 测试环境构建         |
+| `pnpm build:test`     | `pnpm build:develop` 的兼容命令                                         | 旧测试构建入口       |
+| `pnpm build:prod`     | `pnpm build` 的生产构建别名                                             | 生产环境构建         |
 | `pnpm build:staging`  | 使用 `staging` mode 构建                                                | 预发布环境验证       |
 | `pnpm report`         | 构建并打开 Rollup 可视化分析报告                                        | 分析包体积           |
 | `pnpm preview`        | 预览已有 `dist` 构建产物                                                | 构建后本地验收       |
 | `pnpm preview:build`  | 先构建再预览                                                            | 一步完成打包验收     |
 | `pnpm typecheck`      | 执行 `tsc --noEmit` 和 `vue-tsc --noEmit --skipLibCheck`                | 类型检查             |
 | `pnpm lint`           | 依次执行 ESLint、Prettier、Stylelint 自动修复                           | 提交前整理代码       |
-| `pnpm lint:eslint`    | 对 `src`、`build` 下 JS/TS/Vue 做 ESLint 修复                            | 脚本或逻辑代码调整后 |
+| `pnpm lint:eslint`    | 对 `src`、`build` 下 JS/TS/Vue 做 ESLint 修复                           | 脚本或逻辑代码调整后 |
 | `pnpm lint:prettier`  | 格式化 `src` 下常见源码与文档格式                                       | 样式统一             |
 | `pnpm lint:stylelint` | 修复 HTML/Vue/CSS/SCSS 样式规则                                         | 样式文件调整后       |
 | `pnpm svgo`           | 递归压缩 SVG                                                            | SVG 资源变更后       |
@@ -116,9 +119,10 @@ http://localhost:8848/
 
 ## 后端对接
 
-开发环境通过 Vite 代理把 `/api` 转发到 `VITE_API_PROXY_TARGET`，默认值为 `http://localhost:3500`。相关配置位于：
+开发环境通过 Vite 代理把 `/api` 转发到 `VITE_API_PROXY_TARGET`，默认值为 `http://localhost:3500`。页面右上角环境标识按 `VITE_APP_ENV=local/develop/production` 显示“本地环境”“测试环境”“生产环境”。相关配置位于：
 
 - `.env.development`
+- `.env.develop`
 - `vite.config.ts`
 
 当前已对接接口：
@@ -176,11 +180,17 @@ http://localhost:8848/
 ## 配置说明
 
 - `.env`: 全局默认配置，目前包含端口和是否隐藏首页。
-- `.env.development`: 开发环境端口、路由模式、API 代理目标。
-- `.env.staging`: 预发布构建配置，可开启 CDN。
-- `.env.production`: 生产构建配置。
+- `.env.development`: 本地开发环境端口、路由模式、API 代理目标，`VITE_APP_ENV=local`，页面标识为“本地环境”。
+- `.env.develop`: develop/测试环境构建配置，`VITE_APP_ENV=develop`，页面标识为“测试环境”。
+- `.env.test`: 兼容旧测试 mode 的构建配置，语义同 develop；线上测试站点的 `/api` 应由 Nginx 代理到测试后端。
+- `.env.staging`: 预发布构建配置，当前按 develop/测试环境标识，可开启 CDN。
+- `.env.production`: 生产构建配置，`VITE_APP_ENV=production`，页面标识为“生产环境”。
 - `public/platform-config.json`: pure-admin 运行时平台配置，例如标题、布局、主题、标签页和菜单搜索历史。
 
+## 环境构建约定
+
+仓库只维护项目自身的构建脚本和环境变量文件，不维护流水线文件。测试、生产的触发规则和部署路径由外部 CI/CD 平台配置；测试、生产站点的 `/api` 必须分别代理到对应的 `access-manage`，避免环境串线。
+
 ## 协作与文档同步
 
 - 文件结构、入口文件、业务模块、脚本或关键配置发生变化时，必须同步更新本 README 的「目录说明」「重要脚本」或对应说明段落。

package.json

@@ -7,6 +7,9 @@
     "dev": "NODE_OPTIONS=--max-old-space-size=4096 vite",
     "serve": "pnpm dev",
     "build": "rimraf dist && NODE_OPTIONS=--max-old-space-size=8192 vite build",
+    "build:develop": "rimraf dist && vite build --mode develop",
+    "build:test": "pnpm build:develop",
+    "build:prod": "pnpm build",
     "build:staging": "rimraf dist && vite build --mode staging",
     "report": "rimraf dist && vite build",
     "preview": "vite preview",

pnpm-workspace.yaml

@@ -0,0 +1,24 @@
+allowedDeprecatedVersions:
+  are-we-there-yet: "*"
+  sourcemap-codec: "*"
+  lodash.isequal: "*"
+  domexception: "*"
+  w3c-hr-time: "*"
+  inflight: "*"
+  npmlog: "*"
+  rimraf: "*"
+  stable: "*"
+  gauge: "*"
+  abab: "*"
+  glob: "*"
+
+onlyBuiltDependencies:
+  - "@parcel/watcher"
+  - core-js
+  - es5-ext
+  - esbuild
+  - typeit
+  - vue-demi
+
+ignoredBuiltDependencies:
+  - "@tailwindcss/oxide"

src/App.vue

@@ -1,5 +1,8 @@
 <template>
   <el-config-provider :locale="currentLocale">
+    <div class="environment-badge" :aria-label="`当前环境：${appEnvLabel}`">
+      {{ appEnvLabel }}
+    </div>
     <router-view />
     <ReDialog />
   </el-config-provider>
@@ -17,6 +20,27 @@ export default defineComponent({
     [ElConfigProvider.name]: ElConfigProvider,
     ReDialog
   },
+  data() {
+    const appEnv =
+      import.meta.env.VITE_APP_ENV ||
+      (import.meta.env.MODE === "development"
+        ? "local"
+        : import.meta.env.MODE === "production"
+          ? "production"
+          : "develop");
+    const defaultLabelMap = {
+      local: "本地环境",
+      develop: "测试环境",
+      production: "生产环境"
+    } as const;
+
+    return {
+      appEnvLabel:
+        import.meta.env.VITE_APP_ENV_LABEL ||
+        defaultLabelMap[appEnv as keyof typeof defaultLabelMap] ||
+        "本地环境"
+    };
+  },
   computed: {
     currentLocale() {
       return zhCn;
@@ -24,3 +48,28 @@ export default defineComponent({
   }
 });
 </script>
+
+<style scoped>
+.environment-badge {
+  position: fixed;
+  top: 72px;
+  right: 16px;
+  z-index: 1000;
+  padding: 8px 10px;
+  font-size: 12px;
+  font-weight: 750;
+  line-height: 1;
+  color: #fff;
+  letter-spacing: 0;
+  background: rgb(20 20 24 / 86%);
+  border-radius: 999px;
+  box-shadow: 0 10px 24px rgb(0 0 0 / 16%);
+}
+
+@media (width <= 768px) {
+  .environment-badge {
+    top: 16px;
+    right: 16px;
+  }
+}
+</style>

types/global.d.ts

@@ -70,6 +70,8 @@ declare global {
     VITE_CDN: boolean;
     VITE_HIDE_HOME: string;
     VITE_COMPRESSION: ViteCompression;
+    VITE_APP_ENV?: "local" | "develop" | "production";
+    VITE_APP_ENV_LABEL?: string;
     VITE_API_PROXY_TARGET?: string;
   }