最新

杨鑫
1 parent 23ee3b2a
Showing 937 changed files with 82377 additions and 846 deletions
5-26代码优化.md
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.browserslistrc
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.changeset/README.md
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.changeset/config.json
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.commitlintrc.js
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.dockerignore
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.editorconfig
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.gitattributes
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.gitconfig
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.gitignore
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.gitpod.yml
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.node-version
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.npmrc
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.prettierignore
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.prettierrc.mjs
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/.stylelintignore
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/CHANGELOG.md
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/LICENSE
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/README.md
泰额版/Food Labeling Management Code/Yi.Vben5.Vue3/apps/backend-mock/.env
+# 5-26 代码优化
+
+本文档说明 **2026-05-26** 对美国版接口的变更。
+
+1. **`/api/app/product-category`**：新增/编辑 **`categoryCode` 取消必填**（见 [product-category-categoryCode](#product-category-categorycode-可选)）。
+2. **`/api/app/label-template`**：新增/编辑/列表/详情支持 **Region、Location 多选数组**；列表 Query 增加 **Region/Location 筛选**（见 [label-template-regionlocation](#label-template-regionlocation-多选)）。
+3. **`/api/app/rbac-role`**：修复 **`accessPermissions` JSON 数组**（如 `manage_labels`）无法绑定菜单（见 [rbac-role-accesspermissions](#rbac-role-accesspermissions-修复)）。
+4. **`/api/app/auth-scope`**：管理员（及按数据范围受限账号）登录后 **Company → Region → Location** 级联选店（见 [auth-scope-登录选店](#auth-scope-登录后-company--region--location-级联选店)）。
+5. **`/api/app/us-app-auth`**：App 管理员 Token 专用 **Company / Region / 门店筛选** 接口（见 [us-app-auth-管理员选店](#us-app-auth-app-管理员级联选店)）。
+
+**应用服务**：`ProductCategoryAppService`、`LabelTemplateAppService`、`RbacRoleAppService`  
+**命名约定**（与 5-17 / 5-18 一致）：UI **Region** = API **`regionIds` / `groupIds` / `groupId`**（`fl_group.Id`）；UI **Location** = **`locationIds` / `locationId`**（`location.Id`）。
+
+---
+
+## product-category categoryCode 可选
+
+**影响接口**
+
+| 方法 | 路径 |
+|------|------|
+| POST | `/api/app/product-category` |
+| PUT | `/api/app/product-category/{id}` |
+
+### 变更说明
+
+| 项 | 变更前 | 变更后 |
+|----|--------|--------|
+| **categoryCode** | 必填；空则报「类别编码和名称不能为空」 | **可选**；可不传、传 `null` 或 `""` |
+| **categoryName** | 必填 | 仍必填 |
+| **落库** | — | 未填编码时 `CategoryCode` 存 **空字符串** |
+| **唯一性** | 编码或名称重复即报错 | 有编码：编码 **或** 名称重复报错；**无编码**：仅校验 **名称** 不重复 |
+
+### 入参（节选）
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| categoryCode | string | **否** | 类别编码 |
+| categoryName | string | **是** | 类别名称 |
+| regionIds / groupIds / locationIds | string[] | 否 | Region·Location 范围（规则见 `5-17接口优化.md`） |
+
+### 请求示例（无编码）
+
+```http
+POST /api/app/product-category
+Content-Type: application/json
+Authorization: Bearer {token}
+```
+
+```json
+{
+  "categoryName": "Beverages",
+  "buttonAppearance": "TEXT",
+  "state": true,
+  "availabilityType": "ALL",
+  "orderNum": 0
+}
+```
+
+### 联调注意
+
+| 现象 | 处理 |
+|------|------|
+| 仍报「类别编码和名称不能为空」 | 确认已部署含本变更的后端；仅需保证 **categoryName** 非空 |
+| 无编码时名称重复 | 正常：仅按 **categoryName** 判重 |
+
+> Region/Location 多选、列表 `region`/`location` 展示等完整说明见 `5-17接口优化.md` → product-category 章节。
+
+---
+
+## label-template Region·Location 多选
+
+**应用服务**：`LabelTemplateAppService`  
+**存储表**：`fl_label_template_location`（模板 ↔ 门店，**无新表**）  
+**主表字段**：`fl_label_template.AppliedLocationType` = `ALL` / `SPECIFIED`
+
+### 变更说明
+
+| 项 | 变更前 | 变更后 |
+|----|--------|--------|
+| **新增/编辑 Body** | 仅 `appliedLocation` + `appliedLocationIds` | 增加 **`regionIds`**、**`groupIds`**、**`locationIds`**（与 `appliedLocationIds` 合并） |
+| **列表 Query** | 仅 `locationId` | 增加 **`groupId`**（Region）；`locationId` 优先于 `groupId`（与 product-category 一致） |
+| **列表出参** | 仅 `locationText`（单条展示） | 增加 **`region`**、**`location`** 展示 + **`regionIds`**、**`locationIds`** 数组 |
+| **详情出参** | `appliedLocationIds` | 同上，并保留 **`appliedLocationIds`**（与 `locationIds` 一致，兼容编辑器） |
+| **范围解析** | 仅显式门店 Id | Region 展开为门店后与门店 Id **取并集** 落库 |
+
+### 影响接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/app/label-template?SkipCount=1&MaxResultCount=10` | 列表支持 `groupId`/`locationId` 筛选；`items[]` 增加 `region`、`location`、`regionIds`、`locationIds` |
+| GET | `/api/app/label-template/{id}` | 详情增加上述字段 |
+| POST | `/api/app/label-template` | Body 支持 Region/Location 多选 |
+| PUT | `/api/app/label-template/{id}` | 同新增 |
+
+路径参数 **`id`** 仍为模板编码 **`TemplateCode`**（与编辑器 JSON 的 `id` 一致）。
+
+### 新增/编辑入参（Body：`LabelTemplateCreateInputVo`）
+
+| 字段 | JSON 名 | 类型 | 必填 | 说明 |
+|------|---------|------|------|------|
+| TemplateCode | `id` | string | 是 | 模板编码 |
+| TemplateName | `name` | string | 是 | 模板名称 |
+| AppliedLocationType | `appliedLocation` | string | 否 | `ALL` / `SPECIFIED`，默认 `ALL` |
+| RegionIds | `regionIds` | string[] | 否 | Region 多选（`fl_group.Id`） |
+| GroupIds | `groupIds` | string[] | 否 | 与 `regionIds` 等价，合并去重 |
+| LocationIds | `locationIds` | string[] | 否 | 门店多选（`location.Id`） |
+| AppliedLocationIds | `appliedLocationIds` | string[] | 否 | 兼容旧字段，与 `locationIds` 合并 |
+| Elements | `elements` | array | 否 | 模板组件，全量重建 |
+| TemplateProductDefaults | `templateProductDefaults` | array | 否 | 仅 **编辑** 时显式传入才重建 |
+
+**自动规则**
+
+| 入参 | 行为 |
+|------|------|
+| `regionIds` / `groupIds` / `locationIds` / `appliedLocationIds` 任一有有效 Id | `appliedLocation` 按 **`SPECIFIED`** 处理 |
+| 仅传空数组 `[]` 且 `appliedLocation` 为 `ALL` | 不绑定门店（全部门店） |
+| `appliedLocation: "SPECIFIED"` 且合并后无有效门店 | 报错：`指定适用区域或门店时，至少需要匹配到一个有效门店` |
+| `appliedLocation` 非法值 | 报错：`适用门店范围不合法（ALL/SPECIFIED）` |
+
+**合并规则**：每个 `regionIds` 展开为该 Region 下全部门店，再与 `locationIds`、`appliedLocationIds` **取并集** → 写入 `fl_label_template_location`。
+
+### 请求示例（Region + 门店多选）
+
+```http
+POST /api/app/label-template
+Content-Type: application/json
+Authorization: Bearer {token}
+```
+
+```json
+{
+  "id": "TPL_TEST_001",
+  "name": "Price Tag 4x6",
+  "labelType": "PRICE",
+  "unit": "inch",
+  "width": 4,
+  "height": 6,
+  "appliedLocation": "SPECIFIED",
+  "regionIds": [
+    "fl_group_id_east",
+    "fl_group_id_west"
+  ],
+  "locationIds": [
+    "11111111-1111-1111-1111-111111111111"
+  ],
+  "showRuler": true,
+  "showGrid": true,
+  "state": true,
+  "elements": []
+}
+```
+
+### 请求示例（全部门店，兼容旧版）
+
+```json
+{
+  "id": "TPL_ALL",
+  "name": "Global Template",
+  "labelType": "PRICE",
+  "unit": "inch",
+  "width": 4,
+  "height": 6,
+  "appliedLocation": "ALL",
+  "appliedLocationIds": [],
+  "elements": []
+}
+```
+
+### 列表（`GET /api/app/label-template`）
+
+**Query 参数**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| SkipCount / MaxResultCount | int | 分页（项目约定 SkipCount 从 1 起） |
+| keyword | string | 模板名称/编码模糊 |
+| **groupId** | string | **按 Region 筛选**（`fl_group.Id`）：命中 `appliedLocation=ALL` 的模板，或在 `fl_label_template_location` 中绑定了该 Region 下任一门门店的模板 |
+| **locationId** | string | **按门店筛选**（`location.Id`）；**优先于 groupId** |
+| labelType | string | 如 `PRICE` |
+| state | bool | 启用状态 |
+| sorting | string | 排序（可选） |
+
+**筛选规则**（与 product-category / label-type 相同，内部 `LocationScopeBindingHelper.ResolveScopedLocationIdsAsync`）
+
+| 入参 | 行为 |
+|------|------|
+| 均未传 `groupId`、`locationId` | 不过滤适用范围 |
+| 仅 `groupId` | 解析该 Region 下全部门店 Id，再筛模板 |
+| 仅 `locationId` | 按该门店 Id 筛模板 |
+| 同时传 | **以 `locationId` 为准**（忽略 `groupId`） |
+| Region/门店无效或解析结果为空 | 仅返回 **`appliedLocation=ALL`** 的模板 |
+
+命中条件（满足其一即可出现在列表）：
+
+- `fl_label_template.AppliedLocationType = 'ALL'`
+- `SPECIFIED` 且 `fl_label_template_location` 中存在 `LocationId ∈` 解析得到的门店集合
+
+**请求示例**
+
+```http
+GET /api/app/label-template?SkipCount=1&MaxResultCount=10&groupId=fl_group_id_east HTTP/1.1
+Authorization: Bearer {token}
+```
+
+```http
+GET /api/app/label-template?SkipCount=1&MaxResultCount=10&locationId=11111111-1111-1111-1111-111111111111 HTTP/1.1
+Authorization: Bearer {token}
+```
+
+**命名对照**：UI **Region** → Query **`groupId`**；UI **Location** → Query **`locationId`**。
+
+### 列表出参
+
+**`items[]` 新增/对齐字段**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| region | string | 适用 Region 展示文案 |
+| location | string | 适用门店展示文案 |
+| regionIds | string[] | Region Id 多选；`ALL` 时为 `[]` |
+| locationIds | string[] | 门店 Id 多选；`ALL` 时为 `[]` |
+| locationText | string | **兼容字段**，与 `location` 相同 |
+
+其它字段不变：`id`（= TemplateCode）、`templateName`、`contentsCount`、`sizeText`、`versionNo`、`lastEdited` 等。
+
+**列表响应示例片段**
+
+```json
+{
+  "pageIndex": 1,
+  "pageSize": 10,
+  "totalCount": 2,
+  "items": [
+    {
+      "id": "TPL_ALL",
+      "templateCode": "TPL_ALL",
+      "templateName": "Global Template",
+      "labelType": "PRICE",
+      "region": "All Regions",
+      "location": "All Locations",
+      "locationText": "All Locations",
+      "regionIds": [],
+      "locationIds": [],
+      "contentsCount": 5,
+      "sizeText": "4x6inch",
+      "versionNo": 1,
+      "lastEdited": "2026-05-26T10:00:00"
+    },
+    {
+      "id": "TPL_TEST_001",
+      "templateName": "Price Tag 4x6",
+      "region": "East Region, West Region",
+      "location": "UNCC store, Central Park Store",
+      "locationText": "UNCC store, Central Park Store",
+      "regionIds": ["fl_group_id_east", "fl_group_id_west"],
+      "locationIds": [
+        "11111111-1111-1111-1111-111111111111",
+        "22222222-2222-2222-2222-222222222222"
+      ],
+      "contentsCount": 3,
+      "sizeText": "4x6inch",
+      "versionNo": 2,
+      "lastEdited": "2026-05-26T11:30:00"
+    }
+  ]
+}
+```
+
+### 详情出参（`GET /api/app/label-template/{id}`）
+
+在原有 `elements`、`templateProductDefaults`、`appliedLocationType` 等基础上增加：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| region | string | 展示文案 |
+| location | string | 展示文案 |
+| regionIds | string[] | Region Id 多选 |
+| groupIds | string[] | 与 `regionIds` 相同（兼容） |
+| locationIds | string[] | 门店 Id 多选 |
+| appliedLocationIds | string[] | 与 `locationIds` 一致（编辑器回显） |
+
+### 展示规则
+
+| appliedLocation | region | location | regionIds / locationIds |
+|-----------------|--------|----------|-------------------------|
+| **ALL** | `All Regions` | `All Locations` | 空数组 `[]` |
+| **SPECIFIED** | 绑定门店 `location.GroupName` 去重后 `, ` 拼接 | 门店名（优先 `LocationName`，否则 `LocationCode`）拼接 | 由绑定门店反推 / 直接为绑定 Id |
+| **SPECIFIED** 无绑定 | `无` | `无` | `[]` |
+
+`regionIds` 由 `locationIds` 反查 `fl_group` 得到（与 product-category、label-type 一致）。
+
+### 编辑说明
+
+- `PUT` Body 字段与 `POST` 相同；传 `regionIds` / `locationIds` 会 **全量替换** 模板适用门店（先删 `fl_label_template_location` 再插入）。
+- `elements` 仍为全量重建；`templateProductDefaults` 仅当 Body **显式包含** 该字段时才重建，避免普通保存误清空。
+- 编辑成功 **`versionNo` +1**。
+
+### 联调注意
+
+| 现象 | 处理 |
+|------|------|
+| 列表无 `regionIds` | 确认已部署含本变更的后端 |
+| 传 `groupId` 列表仍很多 | 正常：`appliedLocation=ALL` 的模板始终可见 |
+| 传 `groupId` 列表为空 | 检查 Region 是否存在、其下是否有门店；无效 Region 时仅剩 ALL 模板 |
+| 传了 Region 仍显示 All Locations | 检查 Region Id 是否有效、是否能在库中展开到门店 |
+| 仅 `appliedLocationIds` 不传 `locationIds` | 仍支持，与 `locationIds` 合并 |
+| 前端编辑器仍传 `appliedLocation: "ALL"` | 管理端若需多选，须在 Body 增加 `regionIds` / `locationIds`（见 `labelTemplateService.ts`） |
+| 指定范围但 0 门店 | 后端报错，需至少 1 个有效门店 |
+
+### 与 product-category / label-type 的关系
+
+逻辑与 **`5-17接口优化.md`** 中 product-category、label-type 的 Region·Location 绑定一致，差异仅为：
+
+| 模块 | 范围字段名 | 关联表 |
+|------|------------|--------|
+| product-category | `availabilityType` | `fl_product_category_location` |
+| label-type | `availabilityType` | `fl_label_type_location` |
+| **label-template** | **`appliedLocation`** | **`fl_label_template_location`** |
+
+---
+
+## rbac-role accessPermissions 修复
+
+**应用服务**：`RbacRoleAppService`  
+**影响接口**：`POST` / `PUT /api/app/rbac-role/{id}`、`GET` 列表/详情回显
+
+### 问题与根因
+
+| 现象 | 根因 |
+|------|------|
+| 保存报 `accessPermissions 未匹配到任何菜单` | 前端提交 **JSON 数组字符串**（如 `["manage_labels",...]`），旧逻辑按逗号拆分，解析结果带 `["` 引号，无法匹配 |
+| 传 `manage_labels` 等仍无菜单 | 表单权限码为 **UI 编码**（`manage_labels`），菜单侧为 **`menu.labels`**（由 `Menu.Router` 推导）；二者未做映射 |
+| 详情 `accessPermissionCodes` 为空 | 新增/编辑未写入 **`Role.AccessPermissionCodes`**（JSON 列），仅依赖 `RoleMenu` 反查 |
+
+### 变更说明
+
+| 项 | 变更后 |
+|----|--------|
+| **入参解析** | `accessPermissions` 支持 **JSON 数组字符串**、逗号分隔、以及 Body 字段 **`accessPermissionCodes`** 数组 |
+| **菜单绑定** | UI 权限码经 **`RoleAccessPermissionMenuMapping`** 映射到 `Menu.Router`，再写入 **`RoleMenu`** |
+| **落库** | 同时将勾选的 UI 编码写入 **`Role.AccessPermissionCodes`**（JSON 数组），供 GET 回显 |
+| **PermissionCode 为空** | 仍可按 **`Router`** 推导 `menu.xxx`（建议执行 `menu_backfill_permission_code.sql`） |
+
+### UI 权限码 → 菜单 Router 映射（当前库）
+
+| accessPermissions（UI） | 绑定菜单 Router |
+|-------------------------|-----------------|
+| `manage_labels` | `/labeling`、`/labels`、`/label-categories`、`/label-types`、`/label-templates` |
+| `manage_people` | `/account-management` |
+| `edit_settings` | `/menu-management`、`/multiple-options` |
+| `view_reports` | `/reports` |
+| `manage_products` | （当前 `Menu` 表无 Products 路由，勾选不绑定菜单，**不单独报错**） |
+| `approve_batches` | （当前无对应菜单路由，同上） |
+
+> 至少 **1 个** 权限码能匹配到菜单即保存成功；若 **全部** 均无法匹配（例如只勾 `manage_products` 且库中无对应菜单），仍返回业务错误。
+
+### 请求示例（与前端一致）
+
+```http
+PUT /api/app/rbac-role/3a1f077b-3665-63f2-5fea-0fd7e7044b88
+Content-Type: application/json
+Authorization: Bearer {token}
+```
+
+```json
+{
+  "roleName": "Partner Admin",
+  "roleCode": "admin",
+  "remark": "Admin",
+  "dataScope": 0,
+  "state": true,
+  "orderNum": 999,
+  "accessPermissions": "[\"manage_labels\",\"edit_settings\",\"view_reports\",\"manage_people\",\"manage_products\",\"approve_batches\"]"
+}
+```
+
+也可使用逗号分隔（旧格式）：
+
+```json
+{
+  "accessPermissions": "manage_labels, view_reports, manage_people"
+}
+```
+
+或同时传数组字段（与 `accessPermissions` 合并去重）：
+
+```json
+{
+  "accessPermissionCodes": ["manage_labels", "view_reports"]
+}
+```
+
+### 入参优先级（与 5-18 一致）
+
+| menuIds | accessPermissions / accessPermissionCodes | 行为 |
+|---------|-------------------------------------------|------|
+| 非空数组 | 任意 | **以 menuIds 为准** |
+| 不传 | 非空 | 按 UI 权限码映射菜单并覆盖 `RoleMenu` |
+| 不传 | `""` 或空数组 | 清空 `RoleMenu` 与 `AccessPermissionCodes` |
+| `[]` | 不传 | 清空绑定 |
+
+### 响应回显
+
+| 字段 | 说明 |
+|------|------|
+| `accessPermissionCodes` | 来自 **`Role.AccessPermissionCodes`**，如 `["manage_labels","view_reports"]` |
+| `accessPermissions` | 已绑定菜单的 **`menu.xxx`** 汇总（逗号拼接，只读展示） |
+| `menuIds` | 已绑定菜单 Guid 列表（`RoleMenu`） |
+
+### 数据库准备（推荐）
+
+```bash
+美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/scripts/menu_backfill_permission_code.sql
+```
+
+### 联调注意
+
+| 现象 | 处理 |
+|------|------|
+| 仍报未匹配到菜单 | 确认已部署本修复；检查 `Menu` 是否存在上表 Router |
+| 只勾 Products/Batches 报错 | 当前库无对应菜单属预期；请同时勾选 Labels/Reports 等 |
+| 同时传 `menuIds: []` | **menuIds 优先**，会清空绑定并忽略 accessPermissions |
+
+> 更完整的 RBAC 说明见 **`5-18接口优化.md`** → rbac-role 章节。
+
+---
+
+## auth-scope 登录后 Company · Region · Location 级联选店
+
+**应用服务**：`AuthScopeAppService`  
+**适用场景**：Web `POST /api/app/account/login` 或 App `POST /api/app/us-app-auth/login` 取得 Token 后，**管理员**无 `userlocation` 绑定时需先选工作门店；亦支持非管理员在数据范围内级联选择（须已绑定该门店）。
+
+**命名约定**（与 5-17 一致）：UI **Company** = **`partnerId`**（`fl_partner.Id`）；UI **Region** = **`groupId`**（`fl_group.Id`）；UI **Location** = **`locationId`**（`location.Id`，Guid 字符串）。
+
+### 接口一览
+
+| 步骤 | 方法 | 路径 | 说明 |
+|------|------|------|------|
+| 1 | GET | `/api/app/auth-scope/companies` | 可选公司列表 |
+| 2 | GET | `/api/app/auth-scope/regions?partnerId={partnerId}` | 指定公司下 Region |
+| 3 | GET | `/api/app/auth-scope/locations?partnerId={partnerId}&groupId={groupId}` | 指定公司+Region 下门店 |
+| 4 | POST | `/api/app/auth-scope/select-location` | 确认当前工作门店 |
+| — | GET | `/api/app/auth-scope/current-scope` | 查询已选工作门店（未选返回 `null`） |
+
+**鉴权**：均需 `Authorization: Bearer {token}`。
+
+### 数据范围
+
+| 角色 | Company | Region | Location |
+|------|---------|--------|----------|
+| **管理员**（`admin` / 用户名 `admin` / 权限 `*:*:*`） | 全部未删除公司 | 该公司下全部 Region | 该 Region 下全部门店（`location.Partner` + `location.GroupName` 与 `fl_group` 一致） |
+| **非管理员** | `userlocation` 绑定门店所属公司 | 绑定门店对应 Region | 上述 Region 内且符合 `LocationRegionScopeHelper` 的门店；**选店时**须已绑定该 `locationId` |
+
+### 1）公司列表
+
+```http
+GET /api/app/auth-scope/companies HTTP/1.1
+Authorization: Bearer {token}
+```
+
+**响应**：`AuthScopeCompanyOptionDto[]`
+
+```json
+[
+  { "id": "fl_partner_id_1", "partnerName": "Acme Foods", "state": true }
+]
+```
+
+### 2）Region 列表
+
+```http
+GET /api/app/auth-scope/regions?partnerId=fl_partner_id_1 HTTP/1.1
+Authorization: Bearer {token}
+```
+
+**响应**：`AuthScopeRegionOptionDto[]`
+
+```json
+[
+  { "id": "fl_group_id_east", "groupName": "East Region", "partnerId": "fl_partner_id_1", "state": true }
+]
+```
+
+### 3）门店列表
+
+```http
+GET /api/app/auth-scope/locations?partnerId=fl_partner_id_1&groupId=fl_group_id_east HTTP/1.1
+Authorization: Bearer {token}
+```
+
+**响应**：`AuthScopeLocationOptionDto[]`（含 `fullAddress`、`groupName` 等）
+
+### 4）确认选店（与现有 App 逻辑对齐）
+
+```http
+POST /api/app/auth-scope/select-location HTTP/1.1
+Authorization: Bearer {token}
+Content-Type: application/json
+```
+
+```json
+{
+  "partnerId": "fl_partner_id_1",
+  "groupId": "fl_group_id_east",
+  "locationId": "a2696b9e-2277-11f1-b4c6-00163e0c7c4f"
+}
+```
+
+**响应**：`AuthScopeSelectLocationOutputDto`
+
+| 字段 | 说明 |
+|------|------|
+| partnerId / partnerName | 所选公司 |
+| groupId / groupName | 所选 Region |
+| location | 与 **`UsAppBoundLocationDto`** 相同（`id`、`locationCode`、`locationName`、`fullAddress`、`state`） |
+
+**选店后的服务端行为**（无需改前端即可对接 App）：
+
+| 能力 | 行为 |
+|------|------|
+| **工作范围缓存** | 写入分布式缓存（24h）；退出 `POST /api/app/auth-session/logout` 时清除 |
+| **`GET /api/app/us-app-auth/my-locations`** | 管理员在缓存选店后，列表 **合并** 该门店（与 `userlocation` 并集） |
+| **`GET .../location-detail/{locationId}`** | 管理员可不依赖 `userlocation` 访问已选门店（`UsAppPrintLogScopeHelper.EnsureUserCanAccessLocationAsync`） |
+| **App 打印/报表** | 仍传 `locationId`；权限规则不变（见 `5-18接口优化.md`） |
+
+### 5）当前工作范围
+
+```http
+GET /api/app/auth-scope/current-scope HTTP/1.1
+Authorization: Bearer {token}
+```
+
+未选店时响应体为 **`null`**（HTTP 200）。
+
+### 联调注意
+
+| 现象 | 处理 |
+|------|------|
+| `regions` 为空 | 公司下无 `fl_group` 或当前账号无 Region 数据范围 |
+| `locations` 为空 | 门店 `Partner` / `GroupName` 未与 `fl_partner`、`fl_group` 对齐 |
+| 选店报「门店与所选公司/区域不匹配」 | 检查 `location.Partner`、`location.GroupName` |
+| 非管理员选店报未绑定 | 须在 **Team Member** 中为该账号绑定该门店 |
+| 选店后 `my-locations` 仍为空 | 确认已调 `select-location` 且 Token 为管理员身份 |
+
+> Web 管理端报表等模块仍可按 Query 传 `partnerId` / `groupId` / `locationId` 收窄；本组接口主要解决 **登录后选工作门店** 与 **App 门店列表** 一致性问题。
+
+---
+
+## us-app-auth App 管理员级联选店
+
+**应用服务**：`UsAppAuthAppService`  
+**适用场景**：App 使用 **`POST /api/app/us-app-auth/login`** 登录后，持 **管理员** 身份（`admin` 角色 / 用户名 `admin` / 权限 `*:*:*`）且 JWT 含 **`client_kind=us-app`**，按 Company → Region 筛选门店。
+
+**与 `auth-scope` 关系**：查询逻辑共用 `AuthScopeQueryHelper`；App 侧路径统一在 **`us-app-auth`** 下，并 **强制 App Token + 管理员**，避免误用 Web Token。
+
+### 接口一览
+
+| 步骤 | 方法 | 路径 | 说明 |
+|------|------|------|------|
+| 0 | POST | `/api/app/us-app-auth/login` | 获取 App Token（须管理员账号） |
+| 1 | GET | `/api/app/us-app-auth/admin-scope-companies` | 公司列表 → 取 `id` 作 `partnerId` |
+| 2 | GET | `/api/app/us-app-auth/admin-scope-regions?partnerId={partnerId}` | Region 列表 → 取 `id` 作 `groupId` |
+| 3 | GET | `/api/app/us-app-auth/admin-scope-locations?partnerId={partnerId}&groupId={groupId}` | **按公司与 Region Id 筛选门店** |
+| 4 | POST | `/api/app/us-app-auth/select-admin-scope-location` | 确认工作门店 |
+| — | GET | `/api/app/us-app-auth/my-locations` | 选店后刷新绑定门店（含缓存门店） |
+
+**鉴权**：步骤 1–4 须 Header `Authorization: Bearer {App登录返回的token}`。
+
+### 前置条件
+
+| 项 | 要求 |
+|----|------|
+| Token 来源 | 必须来自 **`/api/app/us-app-auth/login`**（非 Web `/api/app/account/login`） |
+| JWT 声明 | `client_kind` = `us-app` |
+| 角色 | 平台管理员（`ReportsRoleHelper.IsAdminRole`） |
+| 违反时 | `请使用 App 登录令牌调用该接口` 或 `仅管理员可使用公司/区域/门店筛选接口` |
+
+### 1）公司列表
+
+```http
+GET /api/app/us-app-auth/admin-scope-companies HTTP/1.1
+Authorization: Bearer {app_token}
+```
+
+**响应**：`AuthScopeCompanyOptionDto[]`（与 auth-scope 相同）
+
+```json
+[
+  { "id": "fl_partner_id_1", "partnerName": "Acme Foods", "state": true }
+]
+```
+
+### 2）Region 列表
+
+```http
+GET /api/app/us-app-auth/admin-scope-regions?partnerId=fl_partner_id_1 HTTP/1.1
+Authorization: Bearer {app_token}
+```
+
+**响应**：`AuthScopeRegionOptionDto[]`
+
+```json
+[
+  { "id": "fl_group_id_east", "groupName": "East Region", "partnerId": "fl_partner_id_1", "state": true }
+]
+```
+
+### 3）门店列表（按 partnerId + groupId 筛选）
+
+```http
+GET /api/app/us-app-auth/admin-scope-locations?partnerId=fl_partner_id_1&groupId=fl_group_id_east HTTP/1.1
+Authorization: Bearer {app_token}
+```
+
+**Query**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| partnerId | 是 | 公司 Id（`fl_partner.Id`） |
+| groupId | 是 | Region Id（`fl_group.Id`） |
+
+**响应**：`AuthScopeLocationOptionDto[]`
+
+```json
+[
+  {
+    "id": "a2696b9e-2277-11f1-b4c6-00163e0c7c4f",
+    "locationCode": "LOC-1",
+    "locationName": "Downtown Kitchen",
+    "fullAddress": "123 Main St, New York, NY 10001",
+    "state": true,
+    "partnerId": "fl_partner_id_1",
+    "groupId": "fl_group_id_east",
+    "groupName": "East Region"
+  }
+]
+```
+
+筛选规则：`location.Partner` 匹配该公司（Id 或名称），且 `location.GroupName` 与所选 `fl_group.GroupName` 一致。
+
+### 4）确认选店
+
+```http
+POST /api/app/us-app-auth/select-admin-scope-location HTTP/1.1
+Authorization: Bearer {app_token}
+Content-Type: application/json
+```
+
+```json
+{
+  "partnerId": "fl_partner_id_1",
+  "groupId": "fl_group_id_east",
+  "locationId": "a2696b9e-2277-11f1-b4c6-00163e0c7c4f"
+}
+```
+
+**响应**：`AuthScopeSelectLocationOutputDto`（含 `location` 节点，结构同 `UsAppBoundLocationDto`）
+
+### 推荐调用顺序（App）
+
+```text
+POST /api/app/us-app-auth/login
+  → GET  admin-scope-companies
+  → GET  admin-scope-regions?partnerId=...
+  → GET  admin-scope-locations?partnerId=...&groupId=...
+  → POST select-admin-scope-location
+  → GET  my-locations
+  → 后续业务接口传 locationId（打印、报表等，规则不变）
+```
+
+### 联调注意
+
+| 现象 | 处理 |
+|------|------|
+| 报「请使用 App 登录令牌」 | 勿用 Web `account/login` 的 Token；须重新 App 登录 |
+| 报「仅管理员可使用」 | 换管理员账号或绑定 `admin` 角色 |
+| `locations` 为空 | 核对门店 `Partner`、`GroupName` 与 `fl_partner`、`fl_group` |
+| 与 auth-scope 重复 | App 端 **优先** 使用本节前缀；Web 端用 `auth-scope` |
+
+---
+
+## 变更记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-05-26 | us-app-auth：App 管理员 `admin-scope-companies/regions/locations`、`select-admin-scope-location` |
+| 2026-05-26 | auth-scope：登录后 Company/Region/Location 级联选店；选店缓存；`my-locations` / 门店详情与管理员选店对齐 |
+| 2026-05-26 | product-category：`categoryCode` 新增/编辑改为可选 |
+| 2026-05-26 | label-template：新增/编辑/列表/详情支持 `regionIds`、`locationIds` 及 `region`、`location` 展示 |
+| 2026-05-26 | label-template 列表 Query 增加 `groupId`（Region）、`locationId`（门店）筛选 |
+| 2026-05-26 | rbac-role：支持 accessPermissions JSON 数组 + UI 权限码映射 Menu；落库 AccessPermissionCodes |
+> 1%
+last 2 versions
+not dead
+not ie 11
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works with multi-package repos, or single-package repos to help you version and publish your code. You can find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in [our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "vbenjs/vue-vben-admin" }
+  ],
+  "commit": false,
+  "fixed": [["@vben-core/*", "@vben/*"]],
+  "snapshot": {
+    "prereleaseTemplate": "{tag}-{datetime}"
+  },
+  "privatePackages": { "version": true, "tag": true },
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}
+export { default } from '@vben/commitlint-config';
+node_modules
+.git
+.gitignore
+*.md
+dist
+.turbo
+dist.zip
+root = true
+
+[*]
+charset=utf-8
+end_of_line=lf
+insert_final_newline=true
+indent_style=space
+indent_size=2
+max_line_length = 100
+trim_trailing_whitespace = true
+quote_type = single
+
+[*.{yml,yaml,json}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+# https://docs.github.com/cn/get-started/getting-started-with-git/configuring-git-to-handle-line-endings
+
+# Automatically normalize line endings (to LF) for all text-based files.
+* text=auto eol=lf
+
+# Declare files that will always have CRLF line endings on checkout.
+*.{cmd,[cC][mM][dD]} text eol=crlf
+*.{bat,[bB][aA][tT]} text eol=crlf
+
+# Denote all files that are truly binary and should not be modified.
+*.{ico,png,jpg,jpeg,gif,webp,svg,woff,woff2} binary
 \ No newline at end of file
+[core]
+    ignorecase = false
+node_modules
+.DS_Store
+dist
+dist-ssr
+dist.zip
+dist.tar
+dist.war
+.nitro
+.output
+*-dist.zip
+*-dist.tar
+*-dist.war
+coverage
+*.local
+**/.vitepress/cache
+.cache
+.turbo
+.temp
+dev-dist
+.stylelintcache
+yarn.lock
+package-lock.json
+pnpm-lock.yaml
+.VSCodeCounter
+**/backend-mock/data
+
+# local env files
+.env.local
+.env.*.local
+.eslintcache
+
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+vite.config.mts.*
+vite.config.mjs.*
+vite.config.js.*
+vite.config.ts.*
+
+# Editor directories and files
+.idea
+# .vscode
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+# 排除自动生成的类型文件
+apps/web-antd/types/components.d.ts
+.history
+ports:
+  - port: 5555
+    onOpen: open-preview
+tasks:
+  - init: npm i -g corepack && pnpm install
+    command: pnpm run dev:play
+22.1.0
+registry = "https://registry.npmmirror.com"
+public-hoist-pattern[]=lefthook
+public-hoist-pattern[]=eslint
+public-hoist-pattern[]=prettier
+public-hoist-pattern[]=prettier-plugin-tailwindcss
+public-hoist-pattern[]=stylelint
+public-hoist-pattern[]=*postcss*
+public-hoist-pattern[]=@commitlint/*
+public-hoist-pattern[]=czg
+
+strict-peer-dependencies=false
+auto-install-peers=true
+dedupe-peer-dependents=true
+dist
+dev-dist
+.local
+.output.js
+node_modules
+.nvmrc
+coverage
+CODEOWNERS
+.nitro
+.output
+
+
+**/*.svg
+**/*.sh
+
+public
+.npmrc
+*-lock.yaml
+export { default } from '@vben/prettier-config';
+dist
+public
+__tests__
+coverage
+# 1.4.1
+
+**FEATURES**
+
+- Tinymce添加在antd原生表单/useVbenForm下的校验样式
+- useVbenForm 增加 Cascader(级联选择器) 组件
+
+**BUG FIX**
+
+- 菜单管理 路由地址的必填项不生效
+- withDefaultPlaceholder中placeholder 在keepalive & 语言切换 & tab切换 显示不变的问题
+
+**REFACTOR**
+
+- 字典接口抛出异常(为什么会抛出异常?)无限调用接口 兼容处理
+- 代码生成 字典下拉加载 改为每次进入编辑页面都加载
+- ~~个人中心 账号绑定 样式/逻辑重构~~(回滚了 既要又要的问题)
+- ~~个人中心 下拉卡片 昵称超长省略显示~~(回滚了 既要又要的问题)
+
+# 1.4.0
+
+**FEATURES**
+
+- 菜单管理(通用方法) 保存表格滚动/展开状态并执行回调 用于树表在执行 新增/编辑/删除等操作后 依然在当前位置(体验优化)
+-
+- 菜单管理 级联删除 删除菜单和children
+
+**REFACTOR**
+
+- 除个人中心外所有本地路由改为从后端返回(需要执行更新sql)
+- 流程图预览改为logicflow预览而非图片 ...然后后端又更新了 又改成iframe了
+- 菜单管理 新增角色校验(与后端权限保持一致) 只有superadmin可进行增删改
+
+# 1.3.6
+
+**BUG FIX**
+
+- oss配置switch切换 导致报错`存储类型找不到`
+- 文件上传无法正确清除(innerList)
+
+# 1.3.5
+
+**BUG FIX**
+
+- 某些带Vxe表格弹窗 关闭后没有正常清理表格数据的问题
+
+# 1.3.4
+
+**BUG FIX**
+
+- 文件上传多次触发导致数据不一致 https://gitee.com/dapppp/ruoyi-plus-vben5/issues/IC3BK6
+
+**PREFORMANCE**
+
+- 浏览器返回按钮/手势操作时 弹窗不会被关闭(keepAlive导致)
+
+# 1.3.3
+
+**BUG FIX**
+
+- 工作流list展示在开启缩放会有误差导致触底逻辑不会触发
+
+**OTHER**
+
+- 代码生成预览对模板的提示...（下载都懒得点一下吗）
+
+# 1.3.2
+
+**REFACTOR**
+
+- 所有表格操作列宽度调整为'auto', 这样会根据子元素宽度适配(比如没有分配权限的情况)
+- 菜单图标更新了一部分 sql同步更新
+
+**OTHER**
+
+- 暂时锁死vite依赖 i18n会报错
+
+# 1.3.1
+
+**REFACTOR**
+
+- 所有Modal/Drawer表单关闭前会进行表单数据对比来弹出提示框
+- 字典项颜色选择从`原生input type=color`改为`vue3-colorpicker`组件
+- 全局Header: ClientID 更改大小写 [spring的问题导致](https://gitee.com/dapppp/ruoyi-plus-vben5/issues/IC0BDS)
+
+**BUG FIX**
+
+- getVxePopupContainer逻辑调整 解决表格固定高度展开不全的问题
+
+**FEATURES**
+
+- 字典渲染支持loading(length为0情况)
+
+**OTHERS**
+
+- useForm的组件改为异步导入(官方更新) bootstrap.js体积从2M降到600K 首屏加载速度提升
+
+# 1.3.0
+
+注意: 如果你使用老版本的`文件上传`/`图片上传` 可暂时使用
+
+- `component: 'ImageUploadOld'`
+- `component: 'FileUploadOld'`
+
+代替 **建议替换为新版本**
+
+大致变动:
+
+- `accept string[] -> string`
+- `resultField 已经移除 统一使用ossId`
+- `maxNumber -> maxCount`
+
+具体参数查看: `apps/web-antd/src/components/upload/src/props.d.ts`
+
+不再推荐使用useDescription, 这个版本会标记为@deprecated, 下个次版本将会移除
+
+框架所有使用useDescription组件的会替换为原生(TODO)
+
+**REFACTOR**
+
+- **文件上传/图片上传重构(破坏性更新 不兼容之前的api)**
+- **文件上传/图片上传不再支持url用法 强制使用ossId**
+- TableSwitch组件重构
+- 管理员租户切换不再返回首页 直接刷新当前页(除特殊页面外会回到首页)
+- 租户切换Select增加loading
+- ~~modalLoading/drawerLoading改为调用内部的lock/unlock方法~~ 有待商榷暂时按老版本逻辑不变
+- 登录验证码 增加loading
+- DictEnum使用const代替enum
+- TinyMCE组件重构 移除冗余代码/功能 增加loading
+
+**ALPHA功能**
+
+- 弹窗表单数据更改关闭时的提示框(可能最终不会加入) 测试页面: 参数管理
+
+**BUG FIX**
+
+- 重新登录 字典会unknown的情况[详细分析](https://gitee.com/dapppp/ruoyi-plus-vben5/issues/IBY27D)
+- 测试菜单 请假申请 选中删除 需要根据状态判断
+- 修复文件/图片在Safari中无法上传 file-type库与Safari不兼容导致
+- 头像裁剪 图片加载失败一直处于loading无法上传
+- 头像裁剪 私有桶会拼接timestamp参数导致sign计算异常无法上传 感谢cropperjs作者 https://github.com/fengyuanchen/cropperjs/issues/1230
+- 租户选择下拉框会跟随body滚动(将下拉框样式的默认absolute改为fixed)
+
+**OTHER**
+
+- 字典管理 字典类型 表格选中行增加bold效果
+- 全局圆角修改 与antd保持一致
+- vditor(Markdown)升级3.10.9
+- 老版本的文件/图片上传将于下个版本移除
+- useDescription将于下个版本移除
+- getVxePopupContainer与新版Vxe不兼容 先返回body(会导致滚动不跟随)后续版本再优化
+
+# 1.2.3
+
+**BUG FIX**
+
+- `withDefaultPlaceholder`中将`placeholder`修改为computed, 解决后续使用`updateSchema`无法正常更新显示placeholder(响应式问题)
+
+- 流程定义 修改accept类型 解决无法拖拽上传
+
+**FEATURES**
+
+- 增加`环境变量`打包配置demo -> build:antd:test
+- 角色管理 勾选权限组件添加对错误用法的校验提示
+
+**REFACTOR**
+
+- OAuth内部逻辑重构 增加新的默认OAuth登录方式
+- 重构部分setup组件为setup语法糖形式
+
+# 1.2.2
+
+**FEATURES**
+
+- 代码生成支持路径方式生成
+- 代码生成 支持选择表单生成类型(需要模板支持)
+- 工作流 支持按钮权限
+
+# 1.2.1
+
+# BUG FIXES
+
+- 客户端管理 错误的status disabled
+- modal/drawer升级后zIndex(2000)会遮挡Tinymce的下拉框zIndex(1300)
+
+# 1.2.0
+
+**REFACTOR**
+
+- 菜单选择组件重构为Table形式
+- 字典相关功能重构 采用一个Map储存字典(之前为两个Map)
+- 代码生成配置页面重构 去除步骤条
+
+**Features**
+
+- 对接后端工作流
+- ~~通用的vxe-table排序事件(排序逻辑改为在排序事件中处理而非在api处理)~~
+- getDict/getDictOptions 提取公共逻辑 减少冗余代码
+- 字典新增对Number类型的支持 -> `getDictOptions('', true);`即可获取number类型的value
+- 文件上传 增加上传进度条 下方上传提示
+- 图片上传 增加上传进度条 下方上传提示
+- oss下载进度提示
+
+**BUG FIXES**
+
+- 字典项为空时getDict方法无限调用接口(无奈兼容 不给字典item本来就是错误用法)
+- 表格排序翻页会丢失排序参数
+- 下载文件时(responseType === 'blob')需要判断下载失败(返回json而非二进制)的情况
+- requestClient缺失i18n内容
+
+**OTHERS**
+
+- 用户管理 新增只获取一次(mounted)默认密码而非每次打开modal都获取
+- `apps/web-antd/src/utils/dict.ts` `getDict`方法将于下个版本删除 使用`getDictOptions`替代
+- VxeTable升级V4.10.0
+- 移除`@deprecated` `apps/web-antd/src/adapter/vxe-table.ts`的`tableCheckboxEvent`方法
+- 移除`由于更新方案弃用的` `apps/web-antd/src/adapter/vxe-table.ts`的`vxeSortEvent`方法
+- 移除apps下的ele和naive目录
+
+# 1.1.3
+
+**REFACTOR**
+
+- 重构: 判断vxe-table的复选框是否选中
+
+**Bug Fixes**
+
+- 节点树在编辑 & 空数组(不勾选)情况 勾选节点会造成watch延迟触发 导致会带上父节点id造成id重复
+- 节点树在节点独立情况下的控制台warning: Invalid prop: type check failed for prop "value". Expected Array, got Object
+
+**Others**
+
+- 角色管理 优化Drawer布局
+- unplugin-vue-components插件(默认未开启) 需要排除Button组件 全局已经默认导入了
+
+**BUG FIXES**
+
+- 操作日志详情 在description组件中json预览样式异常
+- 微服务版本 区间查询和中文搜索条件一起使用 无法正确查询
+
+# 1.1.2
+
+**Features**
+
+- Options转Enum工具函数
+
+**OTHERS**
+
+- 菜单管理 改为虚拟滚动
+- 移除requestClient的一些冗余参数
+- 主动退出登录(右上角个人选项)不需要带跳转地址
+
+**BUG FIXES**
+
+- 语言 漏加Content-Language请求头
+- 用户管理/岗位管理 左边部门树错误emit导致会调用两次列表api
+
+# 1.1.1
+
+**REFACTOR**
+
+- 使用VxeTable重构OAuth账号绑定列表(替代antdv的Table)
+- commonDownloadExcel方法 支持处理区间选择器字段导出excel
+
+**BUG FIXES**
+
+- 修复在Modal/Drawer中使用VxeTable时, 第二次打开表单参数依旧为第一次提交的参数
+
+**OTHERS**
+
+- 废弃downloadExcel方法 统一使用commonDownloadExcel方法
+
+# 1.1.0
+
+**FEATURES**
+
+- 支持离线图标功能(全局可在内网环境中使用)
+
+**BUG FIXES**
+
+- 在VxeTable固定列时, getPopupContainer会导致宽度不够, 弹出层样式异常 解决办法(将弹窗元素挂载到VXe滚动容器上)
+
+**OTHERS**
+
+- 代码生成 - 字段信息修改 改为minWidth 防止在高分辨率屏幕出现空白
+
+# 1.0.0
+
+**FEATURES**
+
+- 用户管理 新增从参数取默认密码
+- 全局表格加上id 方便进行缓存列排序的操作
+- 支持菜单名称i18n
+- 登录页 验证码登录
+- Markdown编辑/预览组件(基于vditor)
+- VxeTable搜索表单 enter提交
+
+**BUG FIXES**
+
+- 登录页面 关闭租户后下拉框没有正常隐藏
+- 字典管理 关闭租户不应显示`同步租户字典`按钮
+- 登录日志 漏掉了登录日志日期查询
+- 登出相关逻辑在并发(非await)情况下重复执行的问题
+- VxeTable在开启/关闭查询表单时 需要使用不同的padding
+- VxeTable表格刷新 默认为reload 修改为在当前页刷新(query)
+- 岗位管理 部门参数错误
+- 角色管理 菜单分配 节点独立下的回显及提交问题
+- 租户管理 套餐管理 回显时候`已选中节点`数量为0
+- 用户管理 更新用户时打开drawer需要加载该部门下的岗位信息
+
+**OTHERS**
+
+- 登录页 租户选择框浮层固定高度[256px] 超过高度自动滚动
+- 表单的Label默认方向改为`top` 支持\n换行
+- 所有表格的搜索加上allowClear属性 支持清除
+- vxe表格loading 只加载表格 不加载上面的表单
+
+# 1.0.0-beta (2024-10-8)
+
+**FEATURES**
+
+- 基础功能已经开发完毕
+- 工作流相关模块等待后端重构后开发
+MIT License
+
+Copyright (c) 2026 dubai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+## **简介**
+
+[![license](https://img.shields.io/github/license/anncwb/vue-vben-admin.svg)](LICENSE)
+
+基于 [ruoyi-plus-vben & vben5 & ant-design-vue  ](https://gitee.com/dapppp/ruoyi-plus-vben.git) 的 Yi 框架前端项目
+
+完全兼容意框架[Yi.Admin](https://gitee.com/ccnetcore/Yi) rbac模块
+
+| 组件/框架      | 版本   |
+| :------------- | :----- |
+| vben           | 5.5.6  |
+| ant-design-vue | 4.2.6  |
+| vue            | 3.5.13 |
+
+
+
+## 提示
+
+该仓库使用vben5开发，采用分包目录结构, 具体开发路径为: `根目录/apps/web-antd`
+
+**后端需要开启”furion格式的规范化api“**：路径在Yi.Abp.Net8/src/Yi.Abp.Web/YiAbpWebModule.cs
+
+
+
+
+## 文档
+
+[ruoyi-vben 框架文档](https://dapdap.top/)
+
+[VbenAdmin V5 文档地址](https://doc.vben.pro/)
+
+
+## 安装使用
+
+前置准备环境(只能用pnpm)
+
+```json
+"packageManager": "pnpm",
+"engines": {
+  "node": ">=20.15.0",
+  "pnpm": "latest"
+},
+```
+
+安装依赖
+
+```bash
+cd yiabp-mini
+
+pnpm install
+```
+
+运行
+
+```bash
+pnpm dev:antd
+```
+
+打包
+
+```bash
+pnpm build:antd
+```
+
+## 这是一个特性 而不是一个bug!
+
+1. 菜单管理可分配 但只有`admin`/`superadmin`角色能访问 其他角色访问会到403页面
+2. 租户相关菜单可分配 但只有`superadmin`角色能访问 其他角色访问会到403页面
+3. 分配的租户管理员无法修改自己的角色的菜单(即管理员角色的菜单) 防止自己把自己权限弄没了
+
+## Git 贡献提交规范
+
+参考 [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) 规范 ([Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))
+
+- `feat` 增加新功能
+- `fix` 修复问题/BUG
+- `style` 代码风格相关无影响运行结果的
+- `perf` 优化/性能提升
+- `refactor` 重构
+- `revert` 撤销修改
+- `test` 测试相关
+- `docs` 文档/注释
+- `chore` 依赖更新/脚手架配置修改等
+- `workflow` 工作流改进
+- `ci` 持续集成
+- `types` 类型定义文件更改
+- `wip` 开发中
+
+## 浏览器支持
+
+最低适配应该为`Chrome 88+`以上浏览器 详见 [css - where](https://developer.mozilla.org/en-US/docs/Web/CSS/:where#browser_compatibility)
+
+本地开发推荐使用`Chrome` 最新版本浏览器
+
+支持现代浏览器，不支持 IE
+
+| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
+| :-: | :-: | :-: | :-: | :-: |
+| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
+PORT=5320
+ACCESS_TOKEN_SECRET=access_token_secret
+REFRESH_TOKEN_SECRET=refresh_token_secret
+# @vben/backend-mock
+
+## Description
+
+Vben Admin 数据 mock 服务，没有对接任何的数据库，所有数据都是模拟的，用于前端开发时提供数据支持。线上环境不再提供 mock 集成，可自行部署服务或者对接真实数据，由于 `mock.js` 等工具有一些限制，比如上传文件不行、无法模拟复杂的逻辑等，所以这里使用了真实的后端服务来实现。唯一麻烦的是本地需要同时启动后端服务和前端服务，但是这样可以更好的模拟真实环境。该服务不需要手动启动，已经集成在 vite 插件内，随应用一起启用。
+
+## Running the app
+
+```bash
+# development
+$ pnpm run start
+
+# production mode
+$ pnpm run build
+```
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse } from '~/utils/response';
+
+export default eventHandler((event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  const codes =
+    MOCK_CODES.find((item) => item.username === userinfo.username)?.codes ?? [];
+
+  return useResponseSuccess(codes);
+});
+import {
+  clearRefreshTokenCookie,
+  setRefreshTokenCookie,
+} from '~/utils/cookie-utils';
+import { generateAccessToken, generateRefreshToken } from '~/utils/jwt-utils';
+import { forbiddenResponse } from '~/utils/response';
+
+export default defineEventHandler(async (event) => {
+  const { password, username } = await readBody(event);
+  if (!password || !username) {
+    setResponseStatus(event, 400);
+    return useResponseError(
+      'BadRequestException',
+      'Username and password are required',
+    );
+  }
+
+  const findUser = MOCK_USERS.find(
+    (item) => item.username === username && item.password === password,
+  );
+
+  if (!findUser) {
+    clearRefreshTokenCookie(event);
+    return forbiddenResponse(event, 'Username or password is incorrect.');
+  }
+
+  const accessToken = generateAccessToken(findUser);
+  const refreshToken = generateRefreshToken(findUser);
+
+  setRefreshTokenCookie(event, refreshToken);
+
+  return useResponseSuccess({
+    ...findUser,
+    accessToken,
+  });
+});
+import {
+  clearRefreshTokenCookie,
+  getRefreshTokenFromCookie,
+} from '~/utils/cookie-utils';
+
+export default defineEventHandler(async (event) => {
+  const refreshToken = getRefreshTokenFromCookie(event);
+  if (!refreshToken) {
+    return useResponseSuccess('');
+  }
+
+  clearRefreshTokenCookie(event);
+
+  return useResponseSuccess('');
+});
+import {
+  clearRefreshTokenCookie,
+  getRefreshTokenFromCookie,
+  setRefreshTokenCookie,
+} from '~/utils/cookie-utils';
+import { verifyRefreshToken } from '~/utils/jwt-utils';
+import { forbiddenResponse } from '~/utils/response';
+
+export default defineEventHandler(async (event) => {
+  const refreshToken = getRefreshTokenFromCookie(event);
+  if (!refreshToken) {
+    return forbiddenResponse(event);
+  }
+
+  clearRefreshTokenCookie(event);
+
+  const userinfo = verifyRefreshToken(refreshToken);
+  if (!userinfo) {
+    return forbiddenResponse(event);
+  }
+
+  const findUser = MOCK_USERS.find(
+    (item) => item.username === userinfo.username,
+  );
+  if (!findUser) {
+    return forbiddenResponse(event);
+  }
+  const accessToken = generateAccessToken(findUser);
+
+  setRefreshTokenCookie(event, refreshToken);
+
+  return accessToken;
+});
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  const data = `
+  {
+    "code": 0,
+    "message": "success",
+    "data": [
+              {
+                "id": 123456789012345678901234567890123456789012345678901234567890,
+                "name": "John Doe",
+                "age": 30,
+                "email": "john-doe@demo.com"
+                },
+                {
+                "id": 987654321098765432109876543210987654321098765432109876543210,
+                "name": "Jane Smith",
+                "age": 25,
+                "email": "jane@demo.com"
+                }
+            ]
+  }
+  `;
+  setHeader(event, 'Content-Type', 'application/json');
+  return data;
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse } from '~/utils/response';
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  const menus =
+    MOCK_MENUS.find((item) => item.username === userinfo.username)?.menus ?? [];
+  return useResponseSuccess(menus);
+});
+export default eventHandler((event) => {
+  const { status } = getQuery(event);
+  setResponseStatus(event, Number(status));
+  return useResponseError(`${status}`);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import {
+  sleep,
+  unAuthorizedResponse,
+  useResponseSuccess,
+} from '~/utils/response';
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  await sleep(600);
+  return useResponseSuccess(null);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import {
+  sleep,
+  unAuthorizedResponse,
+  useResponseSuccess,
+} from '~/utils/response';
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  await sleep(1000);
+  return useResponseSuccess(null);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import {
+  sleep,
+  unAuthorizedResponse,
+  useResponseSuccess,
+} from '~/utils/response';
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  await sleep(2000);
+  return useResponseSuccess(null);
+});
+import { faker } from '@faker-js/faker';
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse, useResponseSuccess } from '~/utils/response';
+
+const formatterCN = new Intl.DateTimeFormat('zh-CN', {
+  timeZone: 'Asia/Shanghai',
+  year: 'numeric',
+  month: '2-digit',
+  day: '2-digit',
+  hour: '2-digit',
+  minute: '2-digit',
+  second: '2-digit',
+});
+
+function generateMockDataList(count: number) {
+  const dataList = [];
+
+  for (let i = 0; i < count; i++) {
+    const dataItem: Record<string, any> = {
+      id: faker.string.uuid(),
+      pid: 0,
+      name: faker.commerce.department(),
+      status: faker.helpers.arrayElement([0, 1]),
+      creationTime: formatterCN.format(
+        faker.date.between({ from: '2021-01-01', to: '2022-12-31' }),
+      ),
+      remark: faker.lorem.sentence(),
+    };
+    if (faker.datatype.boolean()) {
+      dataItem.children = Array.from(
+        { length: faker.number.int({ min: 1, max: 5 }) },
+        () => ({
+          id: faker.string.uuid(),
+          pid: dataItem.id,
+          name: faker.commerce.department(),
+          status: faker.helpers.arrayElement([0, 1]),
+          creationTime: formatterCN.format(
+            faker.date.between({ from: '2023-01-01', to: '2023-12-31' }),
+          ),
+          remark: faker.lorem.sentence(),
+        }),
+      );
+    }
+    dataList.push(dataItem);
+  }
+
+  return dataList;
+}
+
+const mockData = generateMockDataList(10);
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  const listData = structuredClone(mockData);
+
+  return useResponseSuccess(listData);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { MOCK_MENU_LIST } from '~/utils/mock-data';
+import { unAuthorizedResponse, useResponseSuccess } from '~/utils/response';
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  return useResponseSuccess(MOCK_MENU_LIST);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { MOCK_MENU_LIST } from '~/utils/mock-data';
+import { unAuthorizedResponse } from '~/utils/response';
+
+const namesMap: Record<string, any> = {};
+
+function getNames(menus: any[]) {
+  menus.forEach((menu) => {
+    namesMap[menu.name] = String(menu.id);
+    if (menu.children) {
+      getNames(menu.children);
+    }
+  });
+}
+getNames(MOCK_MENU_LIST);
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  const { id, name } = getQuery(event);
+
+  return (name as string) in namesMap &&
+    (!id || namesMap[name as string] !== String(id))
+    ? useResponseSuccess(true)
+    : useResponseSuccess(false);
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { MOCK_MENU_LIST } from '~/utils/mock-data';
+import { unAuthorizedResponse } from '~/utils/response';
+
+const pathMap: Record<string, any> = { '/': 0 };
+
+function getPaths(menus: any[]) {
+  menus.forEach((menu) => {
+    pathMap[menu.path] = String(menu.id);
+    if (menu.children) {
+      getPaths(menu.children);
+    }
+  });
+}
+getPaths(MOCK_MENU_LIST);
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  const { id, path } = getQuery(event);
+
+  return (path as string) in pathMap &&
+    (!id || pathMap[path as string] !== String(id))
+    ? useResponseSuccess(true)
+    : useResponseSuccess(false);
+});
+import { faker } from '@faker-js/faker';
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { getMenuIds, MOCK_MENU_LIST } from '~/utils/mock-data';
+import { unAuthorizedResponse, usePageResponseSuccess } from '~/utils/response';
+
+const formatterCN = new Intl.DateTimeFormat('zh-CN', {
+  timeZone: 'Asia/Shanghai',
+  year: 'numeric',
+  month: '2-digit',
+  day: '2-digit',
+  hour: '2-digit',
+  minute: '2-digit',
+  second: '2-digit',
+});
+
+const menuIds = getMenuIds(MOCK_MENU_LIST);
+
+function generateMockDataList(count: number) {
+  const dataList = [];
+
+  for (let i = 0; i < count; i++) {
+    const dataItem: Record<string, any> = {
+      id: faker.string.uuid(),
+      name: faker.commerce.product(),
+      status: faker.helpers.arrayElement([0, 1]),
+      creationTime: formatterCN.format(
+        faker.date.between({ from: '2022-01-01', to: '2025-01-01' }),
+      ),
+      permissions: faker.helpers.arrayElements(menuIds),
+      remark: faker.lorem.sentence(),
+    };
+
+    dataList.push(dataItem);
+  }
+
+  return dataList;
+}
+
+const mockData = generateMockDataList(100);
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  const {
+    page = 1,
+    MaxResultCount = 20,
+    name,
+    id,
+    remark,
+    startTime,
+    endTime,
+    status,
+  } = getQuery(event);
+  let listData = structuredClone(mockData);
+  if (name) {
+    listData = listData.filter((item) =>
+      item.name.toLowerCase().includes(String(name).toLowerCase()),
+    );
+  }
+  if (id) {
+    listData = listData.filter((item) =>
+      item.id.toLowerCase().includes(String(id).toLowerCase()),
+    );
+  }
+  if (remark) {
+    listData = listData.filter((item) =>
+      item.remark?.toLowerCase()?.includes(String(remark).toLowerCase()),
+    );
+  }
+  if (startTime) {
+    listData = listData.filter((item) => item.creationTime >= startTime);
+  }
+  if (endTime) {
+    listData = listData.filter((item) => item.creationTime <= endTime);
+  }
+  if (['0', '1'].includes(status as string)) {
+    listData = listData.filter((item) => item.status === Number(status));
+  }
+  return usePageResponseSuccess(page as string, MaxResultCount as string, listData);
+});
+import { faker } from '@faker-js/faker';
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse, usePageResponseSuccess } from '~/utils/response';
+
+function generateMockDataList(count: number) {
+  const dataList = [];
+
+  for (let i = 0; i < count; i++) {
+    const dataItem = {
+      id: faker.string.uuid(),
+      imageUrl: faker.image.avatar(),
+      imageUrl2: faker.image.avatar(),
+      open: faker.datatype.boolean(),
+      status: faker.helpers.arrayElement(['success', 'error', 'warning']),
+      productName: faker.commerce.productName(),
+      price: faker.commerce.price(),
+      currency: faker.finance.currencyCode(),
+      quantity: faker.number.int({ min: 1, max: 100 }),
+      available: faker.datatype.boolean(),
+      category: faker.commerce.department(),
+      releaseDate: faker.date.past(),
+      rating: faker.number.float({ min: 1, max: 5 }),
+      description: faker.commerce.productDescription(),
+      weight: faker.number.float({ min: 0.1, max: 10 }),
+      color: faker.color.human(),
+      inProduction: faker.datatype.boolean(),
+      tags: Array.from({ length: 3 }, () => faker.commerce.productAdjective()),
+    };
+
+    dataList.push(dataItem);
+  }
+
+  return dataList;
+}
+
+const mockData = generateMockDataList(100);
+
+export default eventHandler(async (event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+
+  await sleep(600);
+
+  const { page, MaxResultCount, sortBy, sortOrder } = getQuery(event);
+  const listData = structuredClone(mockData);
+  if (sortBy && Reflect.has(listData[0], sortBy as string)) {
+    listData.sort((a, b) => {
+      if (sortOrder === 'asc') {
+        if (sortBy === 'price') {
+          return (
+            Number.parseFloat(a[sortBy as string]) -
+            Number.parseFloat(b[sortBy as string])
+          );
+        } else {
+          return a[sortBy as string] > b[sortBy as string] ? 1 : -1;
+        }
+      } else {
+        if (sortBy === 'price') {
+          return (
+            Number.parseFloat(b[sortBy as string]) -
+            Number.parseFloat(a[sortBy as string])
+          );
+        } else {
+          return a[sortBy as string] < b[sortBy as string] ? 1 : -1;
+        }
+      }
+    });
+  }
+
+  return usePageResponseSuccess(page as string, MaxResultCount as string, listData);
+});
+export default defineEventHandler(() => 'Test get handler');
+export default defineEventHandler(() => 'Test post handler');
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse } from '~/utils/response';
+
+export default eventHandler((event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  return useResponseSuccess({
+    url: 'https://unpkg.com/@vbenjs/static-source@0.1.7/source/logo-v1.webp',
+  });
+  // return useResponseError("test")
+});
+import { verifyAccessToken } from '~/utils/jwt-utils';
+import { unAuthorizedResponse } from '~/utils/response';
+
+export default eventHandler((event) => {
+  const userinfo = verifyAccessToken(event);
+  if (!userinfo) {
+    return unAuthorizedResponse(event);
+  }
+  return useResponseSuccess(userinfo);
+});
+import type { NitroErrorHandler } from 'nitropack';
+
+const errorHandler: NitroErrorHandler = function (error, event) {
+  event.node.res.end(`[Error Handler] ${error.stack}`);
+};
+
+export default errorHandler;
+import { forbiddenResponse, sleep } from '~/utils/response';
+
+export default defineEventHandler(async (event) => {
+  event.node.res.setHeader(
+    'Access-Control-Allow-Origin',
+    event.headers.get('Origin') ?? '*',
+  );
+  if (event.method === 'OPTIONS') {
+    event.node.res.statusCode = 204;
+    event.node.res.statusMessage = 'No Content.';
+    return 'OK';
+  } else if (
+    ['DELETE', 'PATCH', 'POST', 'PUT'].includes(event.method) &&
+    event.path.startsWith('/api/')
+  ) {
+    await sleep(Math.floor(Math.random() * 2000));
+    return forbiddenResponse(event, '演示环境，禁止修改');
+  }
+});
+import errorHandler from './error';
+
+process.env.COMPATIBILITY_DATE = new Date().toISOString();
+export default defineNitroConfig({
+  devErrorHandler: errorHandler,
+  errorHandler: '~/error',
+  routeRules: {
+    '/api/**': {
+      cors: true,
+      headers: {
+        'Access-Control-Allow-Credentials': 'true',
+        'Access-Control-Allow-Headers':
+          'Accept, Authorization, Content-Length, Content-Type, If-Match, If-Modified-Since, If-None-Match, If-Unmodified-Since, X-CSRF-TOKEN, X-Requested-With',
+        'Access-Control-Allow-Methods': 'GET,HEAD,PUT,PATCH,POST,DELETE',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Expose-Headers': '*',
+      },
+    },
+  },
+});
+{
+  "name": "@vben/backend-mock",
+  "version": "0.0.1",
+  "description": "",
+  "private": true,
+  "license": "MIT",
+  "author": "",
+  "scripts": {
+    "build": "nitro build",
+    "start": "nitro dev"
+  },
+  "dependencies": {
+    "@faker-js/faker": "catalog:",
+    "jsonwebtoken": "catalog:",
+    "nitropack": "catalog:"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "catalog:",
+    "h3": "catalog:"
+  }
+}
+export default defineEventHandler(() => {
+  return `
+<h1>Hello Vben Admin</h1>
+<h2>Mock service is starting</h2>
+<ul>
+<li><a href="/api/user">/api/user/info</a></li>
+<li><a href="/api/menu">/api/menu/all</a></li>
+<li><a href="/api/auth/codes">/api/auth/codes</a></li>
+<li><a href="/api/auth/login">/api/auth/login</a></li>
+<li><a href="/api/upload">/api/upload</a></li>
+</ul>
+`;
+});
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}
+{
+  "extends": "./.nitro/types/tsconfig.json"
+}
+import type { EventHandlerRequest, H3Event } from 'h3';
+
+export function clearRefreshTokenCookie(event: H3Event<EventHandlerRequest>) {
+  deleteCookie(event, 'jwt', {
+    httpOnly: true,
+    sameSite: 'none',
+    secure: true,
+  });
+}
+
+export function setRefreshTokenCookie(
+  event: H3Event<EventHandlerRequest>,
+  refreshToken: string,
+) {
+  setCookie(event, 'jwt', refreshToken, {
+    httpOnly: true,
+    maxAge: 24 * 60 * 60, // unit: seconds
+    sameSite: 'none',
+    secure: true,
+  });
+}
+
+export function getRefreshTokenFromCookie(event: H3Event<EventHandlerRequest>) {
+  const refreshToken = getCookie(event, 'jwt');
+  return refreshToken;
+}
+import type { EventHandlerRequest, H3Event } from 'h3';
+
+import jwt from 'jsonwebtoken';
+
+import { UserInfo } from './mock-data';
+
+// TODO: Replace with your own secret key
+const ACCESS_TOKEN_SECRET = 'access_token_secret';
+const REFRESH_TOKEN_SECRET = 'refresh_token_secret';
+
+export interface UserPayload extends UserInfo {
+  iat: number;
+  exp: number;
+}
+
+export function generateAccessToken(user: UserInfo) {
+  return jwt.sign(user, ACCESS_TOKEN_SECRET, { expiresIn: '7d' });
+}
+
+export function generateRefreshToken(user: UserInfo) {
+  return jwt.sign(user, REFRESH_TOKEN_SECRET, {
+    expiresIn: '30d',
+  });
+}
+
+export function verifyAccessToken(
+  event: H3Event<EventHandlerRequest>,
+): null | Omit<UserInfo, 'password'> {
+  const authHeader = getHeader(event, 'Authorization');
+  if (!authHeader?.startsWith('Bearer')) {
+    return null;
+  }
+
+  const token = authHeader.split(' ')[1];
+  try {
+    const decoded = jwt.verify(token, ACCESS_TOKEN_SECRET) as UserPayload;
+
+    const username = decoded.username;
+    const user = MOCK_USERS.find((item) => item.username === username);
+    const { password: _pwd, ...userinfo } = user;
+    return userinfo;
+  } catch {
+    return null;
+  }
+}
+
+export function verifyRefreshToken(
+  token: string,
+): null | Omit<UserInfo, 'password'> {
+  try {
+    const decoded = jwt.verify(token, REFRESH_TOKEN_SECRET) as UserPayload;
+    const username = decoded.username;
+    const user = MOCK_USERS.find((item) => item.username === username);
+    const { password: _pwd, ...userinfo } = user;
+    return userinfo;
+  } catch {
+    return null;
+  }
+}
+export interface UserInfo {
+  id: number;
+  password: string;
+  realName: string;
+  roles: string[];
+  username: string;
+  homePath?: string;
+}
+
+export const MOCK_USERS: UserInfo[] = [
+  {
+    id: 0,
+    password: '123456',
+    realName: 'Vben',
+    roles: ['super'],
+    username: 'vben',
+  },
+  {
+    id: 1,
+    password: '123456',
+    realName: 'Admin',
+    roles: ['admin'],
+    username: 'admin',
+    homePath: '/workspace',
+  },
+  {
+    id: 2,
+    password: '123456',
+    realName: 'Jack',
+    roles: ['user'],
+    username: 'jack',
+    homePath: '/analytics',
+  },
+];
+
+export const MOCK_CODES = [
+  // super
+  {
+    codes: ['AC_100100', 'AC_100110', 'AC_100120', 'AC_100010'],
+    username: 'vben',
+  },
+  {
+    // admin
+    codes: ['AC_100010', 'AC_100020', 'AC_100030'],
+    username: 'admin',
+  },
+  {
+    // user
+    codes: ['AC_1000001', 'AC_1000002'],
+    username: 'jack',
+  },
+];
+
+const dashboardMenus = [
+  {
+    meta: {
+      order: -1,
+      title: 'page.dashboard.title',
+    },
+    name: 'Dashboard',
+    path: '/dashboard',
+    redirect: '/analytics',
+    children: [
+      {
+        name: 'Analytics',
+        path: '/analytics',
+        component: '/dashboard/analytics/index',
+        meta: {
+          affixTab: true,
+          title: 'page.dashboard.analytics',
+        },
+      },
+      {
+        name: 'Workspace',
+        path: '/workspace',
+        component: '/dashboard/workspace/index',
+        meta: {
+          title: 'page.dashboard.workspace',
+        },
+      },
+    ],
+  },
+];
+
+const createDemosMenus = (role: 'admin' | 'super' | 'user') => {
+  const roleWithMenus = {
+    admin: {
+      component: '/demos/access/admin-visible',
+      meta: {
+        icon: 'mdi:button-cursor',
+        title: 'demos.access.adminVisible',
+      },
+      name: 'AccessAdminVisibleDemo',
+      path: '/demos/access/admin-visible',
+    },
+    super: {
+      component: '/demos/access/super-visible',
+      meta: {
+        icon: 'mdi:button-cursor',
+        title: 'demos.access.superVisible',
+      },
+      name: 'AccessSuperVisibleDemo',
+      path: '/demos/access/super-visible',
+    },
+    user: {
+      component: '/demos/access/user-visible',
+      meta: {
+        icon: 'mdi:button-cursor',
+        title: 'demos.access.userVisible',
+      },
+      name: 'AccessUserVisibleDemo',
+      path: '/demos/access/user-visible',
+    },
+  };
+
+  return [
+    {
+      meta: {
+        icon: 'ic:baseline-view-in-ar',
+        keepAlive: true,
+        order: 1000,
+        title: 'demos.title',
+      },
+      name: 'Demos',
+      path: '/demos',
+      redirect: '/demos/access',
+      children: [
+        {
+          name: 'AccessDemos',
+          path: '/demosaccess',
+          meta: {
+            icon: 'mdi:cloud-key-outline',
+            title: 'demos.access.backendPermissions',
+          },
+          redirect: '/demos/access/page-control',
+          children: [
+            {
+              name: 'AccessPageControlDemo',
+              path: '/demos/access/page-control',
+              component: '/demos/access/index',
+              meta: {
+                icon: 'mdi:page-previous-outline',
+                title: 'demos.access.pageAccess',
+              },
+            },
+            {
+              name: 'AccessButtonControlDemo',
+              path: '/demos/access/button-control',
+              component: '/demos/access/button-control',
+              meta: {
+                icon: 'mdi:button-cursor',
+                title: 'demos.access.buttonControl',
+              },
+            },
+            {
+              name: 'AccessMenuVisible403Demo',
+              path: '/demos/access/menu-visible-403',
+              component: '/demos/access/menu-visible-403',
+              meta: {
+                authority: ['no-body'],
+                icon: 'mdi:button-cursor',
+                menuVisibleWithForbidden: true,
+                title: 'demos.access.menuVisible403',
+              },
+            },
+            roleWithMenus[role],
+          ],
+        },
+      ],
+    },
+  ];
+};
+
+export const MOCK_MENUS = [
+  {
+    menus: [...dashboardMenus, ...createDemosMenus('super')],
+    username: 'vben',
+  },
+  {
+    menus: [...dashboardMenus, ...createDemosMenus('admin')],
+    username: 'admin',
+  },
+  {
+    menus: [...dashboardMenus, ...createDemosMenus('user')],
+    username: 'jack',
+  },
+];
+
+export const MOCK_MENU_LIST = [
+  {
+    id: 1,
+    name: 'Workspace',
+    status: 1,
+    type: 'menu',
+    icon: 'mdi:dashboard',
+    path: '/workspace',
+    component: '/dashboard/workspace/index',
+    meta: {
+      icon: 'carbon:workspace',
+      title: 'page.dashboard.workspace',
+      affixTab: true,
+      order: 0,
+    },
+  },
+  {
+    id: 2,
+    meta: {
+      icon: 'carbon:settings',
+      order: 9997,
+      title: 'system.title',
+      badge: 'new',
+      badgeType: 'normal',
+      badgeVariants: 'primary',
+    },
+    status: 1,
+    type: 'catalog',
+    name: 'System',
+    path: '/system',
+    children: [
+      {
+        id: 201,
+        pid: 2,
+        path: '/system/menu',
+        name: 'SystemMenu',
+        authCode: 'System:Menu:List',
+        status: 1,
+        type: 'menu',
+        meta: {
+          icon: 'carbon:menu',
+          title: 'system.menu.title',
+        },
+        component: '/system/menu/list',
+        children: [
+          {
+            id: 20_101,
+            pid: 201,
+            name: 'SystemMenuCreate',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Menu:Create',
+            meta: { title: 'common.create' },
+          },
+          {
+            id: 20_102,
+            pid: 201,
+            name: 'SystemMenuEdit',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Menu:Edit',
+            meta: { title: 'common.edit' },
+          },
+          {
+            id: 20_103,
+            pid: 201,
+            name: 'SystemMenuDelete',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Menu:Delete',
+            meta: { title: 'common.delete' },
+          },
+        ],
+      },
+      {
+        id: 202,
+        pid: 2,
+        path: '/system/dept',
+        name: 'SystemDept',
+        status: 1,
+        type: 'menu',
+        authCode: 'System:Dept:List',
+        meta: {
+          icon: 'carbon:container-services',
+          title: 'system.dept.title',
+        },
+        component: '/system/dept/list',
+        children: [
+          {
+            id: 20_401,
+            pid: 201,
+            name: 'SystemDeptCreate',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Dept:Create',
+            meta: { title: 'common.create' },
+          },
+          {
+            id: 20_402,
+            pid: 201,
+            name: 'SystemDeptEdit',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Dept:Edit',
+            meta: { title: 'common.edit' },
+          },
+          {
+            id: 20_403,
+            pid: 201,
+            name: 'SystemDeptDelete',
+            status: 1,
+            type: 'button',
+            authCode: 'System:Dept:Delete',
+            meta: { title: 'common.delete' },
+          },
+        ],
+      },
+    ],
+  },
+  {
+    id: 9,
+    meta: {
+      badgeType: 'dot',
+      order: 9998,
+      title: 'demos.vben.title',
+      icon: 'carbon:data-center',
+    },
+    name: 'Project',
+    path: '/vben-admin',
+    type: 'catalog',
+    status: 1,
+    children: [
+      {
+        id: 901,
+        pid: 9,
+        name: 'VbenDocument',
+        path: '/vben-admin/document',
+        component: 'IFrameView',
+        type: 'embedded',
+        status: 1,
+        meta: {
+          icon: 'carbon:book',
+          iframeSrc: 'https://doc.vben.pro',
+          title: 'demos.vben.document',
+        },
+      },
+      {
+        id: 902,
+        pid: 9,
+        name: 'VbenGithub',
+        path: '/vben-admin/github',
+        component: 'IFrameView',
+        type: 'link',
+        status: 1,
+        meta: {
+          icon: 'carbon:logo-github',
+          link: 'https://github.com/vbenjs/vue-vben-admin',
+          title: 'Github',
+        },
+      },
+      {
+        id: 903,
+        pid: 9,
+        name: 'VbenAntdv',
+        path: '/vben-admin/antdv',
+        component: 'IFrameView',
+        type: 'link',
+        status: 0,
+        meta: {
+          icon: 'carbon:hexagon-vertical-solid',
+          badgeType: 'dot',
+          link: 'https://ant.vben.pro',
+          title: 'demos.vben.antdv',
+        },
+      },
+    ],
+  },
+  {
+    id: 10,
+    component: '_core/about/index',
+    type: 'menu',
+    status: 1,
+    meta: {
+      icon: 'lucide:copyright',
+      order: 9999,
+      title: 'demos.vben.about',
+    },
+    name: 'About',
+    path: '/about',
+  },
+];
+
+export function getMenuIds(menus: any[]) {
+  const ids: number[] = [];
+  menus.forEach((item) => {
+    ids.push(item.id);
+    if (item.children && item.children.length > 0) {
+      ids.push(...getMenuIds(item.children));
+    }
+  });
+  return ids;
+}
+import type { EventHandlerRequest, H3Event } from 'h3';
+
+export function useResponseSuccess<T = any>(data: T) {
+  return {
+    code: 0,
+    data,
+    error: null,
+    message: 'ok',
+  };
+}
+
+export function usePageResponseSuccess<T = any>(
+  page: number | string,
+  MaxResultCount: number | string,
+  list: T[],
+  { message = 'ok' } = {},
+) {
+  const pageData = pagination(
+    Number.parseInt(`${page}`),
+    Number.parseInt(`${MaxResultCount}`),
+    list,
+  );
+
+  return {
+    ...useResponseSuccess({
+      items: pageData,
+      total: list.length,
+    }),
+    message,
+  };
+}
+
+export function useResponseError(message: string, error: any = null) {
+  return {
+    code: -1,
+    data: null,
+    error,
+    message,
+  };
+}
+
+export function forbiddenResponse(
+  event: H3Event<EventHandlerRequest>,
+  message = 'Forbidden Exception',
+) {
+  setResponseStatus(event, 403);
+  return useResponseError(message, message);
+}
+
+export function unAuthorizedResponse(event: H3Event<EventHandlerRequest>) {
+  setResponseStatus(event, 401);
+  return useResponseError('Unauthorized Exception', 'Unauthorized Exception');
+}
+
+export function sleep(ms: number) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export function pagination<T = any>(
+  pageNo: number,
+  MaxResultCount: number,
+  array: T[],
+): T[] {
+  const offset = (pageNo - 1) * Number(MaxResultCount);
+  return offset + Number(MaxResultCount) >= array.length
+    ? array.slice(offset)
+    : array.slice(offset, offset + Number(MaxResultCount));
+}
+# 应用标题
+VITE_APP_TITLE=Yi Admin
+
+# 应用命名空间，用于缓存、store等功能的前缀，确保隔离
+VITE_APP_NAMESPACE=vben-web-antd
+
+# 对store进行加密的密钥，在将store持久化到localStorage时会使用该密钥进行加密
+VITE_APP_STORE_SECURE_KEY=please-replace-me-with-your-own-key
+# public path
+VITE_BASE=/
+
+# Basic interface address SPA
+VITE_GLOB_API_URL=/api/app
+
+VITE_VISUALIZER=true
+# 端口号
+VITE_PORT=17001
+
+VITE_BASE=/
+# 是否开启 Nitro Mock服务，true 为开启，false 为关闭
+VITE_NITRO_MOCK=false
+# 是否打开 devtools，true 为打开，false 为关闭
+VITE_DEVTOOLS=false
+# 是否注入全局loading
+VITE_INJECT_APP_LOADING=true
+
+# 后台请求路径 具体在vite.config.mts配置代理
+VITE_GLOB_API_URL="/dev-api"
+VITE_APP_URL="http://flus-test.3ffoodsafety.com/api/app"
+
+# 全局加密开关(即开启了加解密功能才会生效 不是全部接口加密 需要和后端对应)
+VITE_GLOB_ENABLE_ENCRYPT=false
+# RSA公钥 请求加密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PUBLIC_KEY=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAKoR8mX0rGKLqzcWmOzbfj64K8ZIgOdHnzkXSOVOZbFu/TJhZ7rFAN+eaGkl3C4buccQd/EjEsj9ir7ijT7h96MCAwEAAQ==
+# RSA私钥 响应解密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PRIVATE_KEY=MIIBVAIBADANBgkqhkiG9w0BAQEFAASCAT4wggE6AgEAAkEAmc3CuPiGL/LcIIm7zryCEIbl1SPzBkr75E2VMtxegyZ1lYRD+7TZGAPkvIsBcaMs6Nsy0L78n2qh+lIZMpLH8wIDAQABAkEAk82Mhz0tlv6IVCyIcw/s3f0E+WLmtPFyR9/WtV3Y5aaejUkU60JpX4m5xNR2VaqOLTZAYjW8Wy0aXr3zYIhhQQIhAMfqR9oFdYw1J9SsNc+CrhugAvKTi0+BF6VoL6psWhvbAiEAxPPNTmrkmrXwdm/pQQu3UOQmc2vCZ5tiKpW10CgJi8kCIFGkL6utxw93Ncj4exE/gPLvKcT+1Emnoox+O9kRXss5AiAMtYLJDaLEzPrAWcZeeSgSIzbL+ecokmFKSDDcRske6QIgSMkHedwND1olF8vlKsJUGK3BcdtM8w4Xq7BpSBwsloE=
+# 客户端id
+VITE_GLOB_APP_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
+
+VITE_GLOB_DEMO_MODE=false
+VITE_BASE=/
+
+# 是否开启压缩，可以设置为 none, brotli, gzip
+VITE_COMPRESS=gzip
+
+# 是否开启 PWA
+VITE_PWA=false
+
+# vue-router 的模式
+VITE_ROUTER_HISTORY=history
+
+# 是否注入全局loading
+VITE_INJECT_APP_LOADING=true
+
+# 打包后是否生成dist.zip
+VITE_ARCHIVER=true
+
+# 后端接口地址（ABP 动态 API：/api/app）
+VITE_GLOB_API_URL=http://flus-test.3ffoodsafety.com/api/app
+
+# 全局加密开关(即开启了加解密功能才会生效 不是全部接口加密 需要和后端对应)
+VITE_GLOB_ENABLE_ENCRYPT=false
+# RSA公钥 请求加密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PUBLIC_KEY=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAKoR8mX0rGKLqzcWmOzbfj64K8ZIgOdHnzkXSOVOZbFu/TJhZ7rFAN+eaGkl3C4buccQd/EjEsj9ir7ijT7h96MCAwEAAQ==
+# RSA私钥 响应解密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PRIVATE_KEY=MIIBVAIBADANBgkqhkiG9w0BAQEFAASCAT4wggE6AgEAAkEAmc3CuPiGL/LcIIm7zryCEIbl1SPzBkr75E2VMtxegyZ1lYRD+7TZGAPkvIsBcaMs6Nsy0L78n2qh+lIZMpLH8wIDAQABAkEAk82Mhz0tlv6IVCyIcw/s3f0E+WLmtPFyR9/WtV3Y5aaejUkU60JpX4m5xNR2VaqOLTZAYjW8Wy0aXr3zYIhhQQIhAMfqR9oFdYw1J9SsNc+CrhugAvKTi0+BF6VoL6psWhvbAiEAxPPNTmrkmrXwdm/pQQu3UOQmc2vCZ5tiKpW10CgJi8kCIFGkL6utxw93Ncj4exE/gPLvKcT+1Emnoox+O9kRXss5AiAMtYLJDaLEzPrAWcZeeSgSIzbL+ecokmFKSDDcRske6QIgSMkHedwND1olF8vlKsJUGK3BcdtM8w4Xq7BpSBwsloE=
+# 客户端id
+VITE_GLOB_APP_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
+
+# 开启SSE
+VITE_GLOB_SSE_ENABLE=false
+
+VITE_GLOB_DEMO_MODE=true
+
+# 该文件是为了给一个增加环境变量打包的例子
+# 对应在根目录package.json -> build:antd:test 命令
+
+VITE_BASE=/
+
+# 是否开启压缩，可以设置为 none, brotli, gzip
+VITE_COMPRESS=gzip
+
+# 是否开启 PWA
+VITE_PWA=false
+
+# vue-router 的模式
+VITE_ROUTER_HISTORY=history
+
+# 是否注入全局loading
+VITE_INJECT_APP_LOADING=true
+
+# 打包后是否生成dist.zip
+VITE_ARCHIVER=true
+
+# 后端接口地址
+VITE_GLOB_API_URL=/test-api
+
+# 全局加密开关(即开启了加解密功能才会生效 不是全部接口加密 需要和后端对应)
+VITE_GLOB_ENABLE_ENCRYPT=true
+# RSA公钥 请求加密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PUBLIC_KEY=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAKoR8mX0rGKLqzcWmOzbfj64K8ZIgOdHnzkXSOVOZbFu/TJhZ7rFAN+eaGkl3C4buccQd/EjEsj9ir7ijT7h96MCAwEAAQ==
+# RSA私钥 响应解密使用 注意这两个是两对RSA公私钥 请求加密-后端解密是一对 响应解密-后端加密是一对
+VITE_GLOB_RSA_PRIVATE_KEY=MIIBVAIBADANBgkqhkiG9w0BAQEFAASCAT4wggE6AgEAAkEAmc3CuPiGL/LcIIm7zryCEIbl1SPzBkr75E2VMtxegyZ1lYRD+7TZGAPkvIsBcaMs6Nsy0L78n2qh+lIZMpLH8wIDAQABAkEAk82Mhz0tlv6IVCyIcw/s3f0E+WLmtPFyR9/WtV3Y5aaejUkU60JpX4m5xNR2VaqOLTZAYjW8Wy0aXr3zYIhhQQIhAMfqR9oFdYw1J9SsNc+CrhugAvKTi0+BF6VoL6psWhvbAiEAxPPNTmrkmrXwdm/pQQu3UOQmc2vCZ5tiKpW10CgJi8kCIFGkL6utxw93Ncj4exE/gPLvKcT+1Emnoox+O9kRXss5AiAMtYLJDaLEzPrAWcZeeSgSIzbL+ecokmFKSDDcRske6QIgSMkHedwND1olF8vlKsJUGK3BcdtM8w4Xq7BpSBwsloE=
+# 客户端id
+VITE_GLOB_APP_CLIENT_ID=e5cd7e4891bf95d1d19206ce24a7b32e
+
+# 开启SSE
+VITE_GLOB_SSE_ENABLE=true
+
+<!doctype html>
+<html lang="zh">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+    <meta name="renderer" content="webkit" />
+    <meta name="description" content="A Modern Back-end Management System" />
+    <meta name="keywords" content="Vben Admin Vue3 Vite" />
+    <meta name="author" content="Vben" />
+    <meta
+      name="viewport"
+      content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=0"
+    />
+    <!-- 由 vite 注入 VITE_APP_TITLE 变量，在 .env 文件内配置 -->
+    <title><%= VITE_APP_TITLE %></title>
+    <link rel="icon" href="/favicon.ico" />
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+{
+  "name": "@vben/web-antd",
+  "version": "1.4.1",
+  "homepage": "https://vben.pro",
+  "bugs": "https://github.com/vbenjs/vue-vben-admin/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vbenjs/vue-vben-admin.git",
+    "directory": "apps/web-antd"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "vben",
+    "email": "ann.vben@gmail.com",
+    "url": "https://github.com/anncwb"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "pnpm vite build",
+    "build:analyze": "pnpm vite build --mode analyze",
+    "dev": "pnpm vite --mode development",
+    "preview": "vite preview",
+    "typecheck": "vue-tsc --noEmit --skipLibCheck"
+  },
+  "imports": {
+    "#/*": "./src/*"
+  },
+  "dependencies": {
+    "@ant-design/icons-vue": "^7.0.1",
+    "@tinymce/tinymce-vue": "^6.0.1",
+    "@vben/access": "workspace:*",
+    "@vben/common-ui": "workspace:*",
+    "@vben/constants": "workspace:*",
+    "@vben/hooks": "workspace:*",
+    "@vben/icons": "workspace:*",
+    "@vben/layouts": "workspace:*",
+    "@vben/locales": "workspace:*",
+    "@vben/plugins": "workspace:*",
+    "@vben/preferences": "workspace:*",
+    "@vben/request": "workspace:*",
+    "@vben/stores": "workspace:*",
+    "@vben/styles": "workspace:*",
+    "@vben/types": "workspace:*",
+    "@vben/utils": "workspace:*",
+    "@vueuse/core": "catalog:",
+    "ant-design-vue": "catalog:",
+    "cropperjs": "^1.6.2",
+    "crypto-js": "^4.2.0",
+    "dayjs": "catalog:",
+    "echarts": "^5.5.1",
+    "jsbarcode": "^3.12.3",
+    "jsencrypt": "^3.3.2",
+    "lodash-es": "^4.17.21",
+    "pinia": "catalog:",
+    "qrcode": "catalog:",
+    "tinymce": "^7.3.0",
+    "unplugin-vue-components": "^0.27.3",
+    "vue": "catalog:",
+    "vue-router": "catalog:",
+    "vue3-colorpicker": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.2.2",
+    "@types/lodash-es": "^4.17.12"
+  }
+}
+export { default } from '@vben/tailwind-config/postcss';
+/**
+ * 通用组件共同的使用的基础组件，原先放在 adapter/form 内部，限制了使用范围，这里提取出来，方便其他地方使用
+ * 可用于 vben-form、vben-modal、vben-drawer 等组件使用,
+ */
+
+import type { Component } from 'vue';
+
+import type { BaseFormComponentType } from '@vben/common-ui';
+import type { Recordable } from '@vben/types';
+
+import {
+  computed,
+  defineAsyncComponent,
+  defineComponent,
+  getCurrentInstance,
+  h,
+  ref,
+} from 'vue';
+
+import { ApiComponent, globalShareState, IconPicker } from '@vben/common-ui';
+import { $t } from '@vben/locales';
+
+import { notification } from 'ant-design-vue';
+
+import { FileUploadOld, ImageUploadOld } from '#/components/upload-old';
+
+const RichTextarea = defineAsyncComponent(() =>
+  import('#/components/tinymce/index').then((res) => res.Tinymce),
+);
+
+const FileUpload = defineAsyncComponent(() =>
+  import('#/components/upload').then((res) => res.FileUpload),
+);
+
+const ImageUpload = defineAsyncComponent(() =>
+  import('#/components/upload').then((res) => res.ImageUpload),
+);
+
+const AutoComplete = defineAsyncComponent(
+  () => import('ant-design-vue/es/auto-complete'),
+);
+const Button = defineAsyncComponent(() => import('ant-design-vue/es/button'));
+const Cascader = defineAsyncComponent(
+  () => import('ant-design-vue/es/cascader'),
+);
+const Checkbox = defineAsyncComponent(
+  () => import('ant-design-vue/es/checkbox'),
+);
+const CheckboxGroup = defineAsyncComponent(() =>
+  import('ant-design-vue/es/checkbox').then((res) => res.CheckboxGroup),
+);
+const DatePicker = defineAsyncComponent(
+  () => import('ant-design-vue/es/date-picker'),
+);
+const Divider = defineAsyncComponent(() => import('ant-design-vue/es/divider'));
+const Input = defineAsyncComponent(() => import('ant-design-vue/es/input'));
+const InputNumber = defineAsyncComponent(
+  () => import('ant-design-vue/es/input-number'),
+);
+const InputPassword = defineAsyncComponent(() =>
+  import('ant-design-vue/es/input').then((res) => res.InputPassword),
+);
+const Mentions = defineAsyncComponent(
+  () => import('ant-design-vue/es/mentions'),
+);
+const Radio = defineAsyncComponent(() => import('ant-design-vue/es/radio'));
+const RadioGroup = defineAsyncComponent(() =>
+  import('ant-design-vue/es/radio').then((res) => res.RadioGroup),
+);
+const RangePicker = defineAsyncComponent(() =>
+  import('ant-design-vue/es/date-picker').then((res) => res.RangePicker),
+);
+const Rate = defineAsyncComponent(() => import('ant-design-vue/es/rate'));
+const Select = defineAsyncComponent(() => import('ant-design-vue/es/select'));
+const Space = defineAsyncComponent(() => import('ant-design-vue/es/space'));
+const Switch = defineAsyncComponent(() => import('ant-design-vue/es/switch'));
+const Textarea = defineAsyncComponent(() =>
+  import('ant-design-vue/es/input').then((res) => res.Textarea),
+);
+const TimePicker = defineAsyncComponent(
+  () => import('ant-design-vue/es/time-picker'),
+);
+const TreeSelect = defineAsyncComponent(
+  () => import('ant-design-vue/es/tree-select'),
+);
+const Upload = defineAsyncComponent(() => import('ant-design-vue/es/upload'));
+
+const withDefaultPlaceholder = <T extends Component>(
+  component: T,
+  type: 'input' | 'select',
+  componentProps: Recordable<any> = {},
+) => {
+  return defineComponent({
+    name: component.name,
+    inheritAttrs: false,
+    setup: (props: any, { attrs, expose, slots }) => {
+      // 改为placeholder 解决在keepalive & 语言切换 & tab切换 显示不变的问题
+      const computedPlaceholder = computed(
+        () =>
+          props?.placeholder ||
+          attrs?.placeholder ||
+          $t(`ui.placeholder.${type}`),
+      );
+
+      // 透传组件暴露的方法
+      const innerRef = ref();
+      const publicApi: Recordable<any> = {};
+      expose(publicApi);
+      const instance = getCurrentInstance();
+      instance?.proxy?.$nextTick(() => {
+        for (const key in innerRef.value) {
+          if (typeof innerRef.value[key] === 'function') {
+            publicApi[key] = innerRef.value[key];
+          }
+        }
+      });
+      return () =>
+        h(
+          component,
+          {
+            ...componentProps,
+            placeholder: computedPlaceholder.value,
+            ...props,
+            ...attrs,
+            ref: innerRef,
+          },
+          slots,
+        );
+    },
+  });
+};
+
+// 这里需要自行根据业务组件库进行适配，需要用到的组件都需要在这里类型说明
+export type ComponentType =
+  | 'ApiSelect'
+  | 'ApiTreeSelect'
+  | 'AutoComplete'
+  | 'Cascader'
+  | 'Checkbox'
+  | 'CheckboxGroup'
+  | 'DatePicker'
+  | 'DefaultButton'
+  | 'Divider'
+  | 'FileUpload'
+  | 'FileUploadOld'
+  | 'IconPicker'
+  | 'ImageUpload'
+  | 'ImageUploadOld'
+  | 'Input'
+  | 'InputNumber'
+  | 'InputPassword'
+  | 'Mentions'
+  | 'PrimaryButton'
+  | 'Radio'
+  | 'RadioGroup'
+  | 'RangePicker'
+  | 'Rate'
+  | 'RichTextarea'
+  | 'Select'
+  | 'Space'
+  | 'Switch'
+  | 'Textarea'
+  | 'TimePicker'
+  | 'TreeSelect'
+  | 'Upload'
+  | BaseFormComponentType;
+
+async function initComponentAdapter() {
+  const components: Partial<Record<ComponentType, Component>> = {
+    // 如果你的组件体积比较大，可以使用异步加载
+    // Button: () =>
+    // import('xxx').then((res) => res.Button),
+    ApiSelect: withDefaultPlaceholder(
+      {
+        ...ApiComponent,
+        name: 'ApiSelect',
+      },
+      'select',
+      {
+        component: Select,
+        loadingSlot: 'suffixIcon',
+        visibleEvent: 'onDropdownVisibleChange',
+        modelPropName: 'value',
+      },
+    ),
+    ApiTreeSelect: withDefaultPlaceholder(
+      {
+        ...ApiComponent,
+        name: 'ApiTreeSelect',
+      },
+      'select',
+      {
+        component: TreeSelect,
+        fieldNames: { label: 'label', value: 'value', children: 'children' },
+        loadingSlot: 'suffixIcon',
+        modelPropName: 'value',
+        optionsPropName: 'treeData',
+        visibleEvent: 'onVisibleChange',
+      },
+    ),
+    AutoComplete,
+    Cascader: withDefaultPlaceholder(Cascader, 'select'),
+    Checkbox,
+    CheckboxGroup,
+    DatePicker,
+    // 自定义默认按钮
+    DefaultButton: (props, { attrs, slots }) => {
+      return h(Button, { ...props, attrs, type: 'default' }, slots);
+    },
+    Divider,
+    IconPicker: withDefaultPlaceholder(IconPicker, 'select', {
+      iconSlot: 'addonAfter',
+      inputComponent: Input,
+      modelValueProp: 'value',
+    }),
+    Input: withDefaultPlaceholder(Input, 'input'),
+    InputNumber: withDefaultPlaceholder(InputNumber, 'input'),
+    InputPassword: withDefaultPlaceholder(InputPassword, 'input'),
+    Mentions: withDefaultPlaceholder(Mentions, 'input'),
+    // 自定义主要按钮
+    PrimaryButton: (props, { attrs, slots }) => {
+      return h(Button, { ...props, attrs, type: 'primary' }, slots);
+    },
+    Radio,
+    RadioGroup,
+    RangePicker,
+    Rate,
+    Select: withDefaultPlaceholder(Select, 'select'),
+    Space,
+    Switch,
+    Textarea: withDefaultPlaceholder(Textarea, 'input'),
+    TimePicker,
+    TreeSelect: withDefaultPlaceholder(TreeSelect, 'select'),
+    Upload,
+    ImageUpload,
+    FileUpload,
+    RichTextarea,
+    ImageUploadOld,
+    FileUploadOld,
+  };
+
+  // 将组件注册到全局共享状态中
+  globalShareState.setComponents(components);
+
+  // 定义全局共享状态中的消息提示
+  globalShareState.defineMessage({
+    // 复制成功消息提示
+    copyPreferencesSuccess: (title, content) => {
+      notification.success({
+        description: content,
+        message: title,
+        placement: 'bottomRight',
+      });
+    },
+  });
+}
+
+export { initComponentAdapter };
+import type {
+  VbenFormSchema as FormSchema,
+  VbenFormProps,
+} from '@vben/common-ui';
+
+import type { ComponentType } from './component';
+
+import { setupVbenForm, useVbenForm as useForm, z } from '@vben/common-ui';
+import { $t } from '@vben/locales';
+
+import { isArray } from 'lodash-es';
+
+async function initSetupVbenForm() {
+  setupVbenForm<ComponentType>({
+    config: {
+      // ant design vue组件库默认都是 v-model:value
+      baseModelPropName: 'value',
+
+      // 一些组件是 v-model:checked 或者 v-model:fileList
+      modelPropNameMap: {
+        Checkbox: 'checked',
+        Radio: 'checked',
+        RichTextarea: 'modelValue',
+        Switch: 'checked',
+        Upload: 'fileList',
+      },
+    },
+    defineRules: {
+      // 输入项目必填国际化适配
+      required: (value, _params, ctx) => {
+        if (value === undefined || value === null || value.length === 0) {
+          return $t('ui.formRules.required', [ctx.label]);
+        }
+        return true;
+      },
+      // 选择项目必填国际化适配
+      selectRequired: (value, _params, ctx) => {
+        if (
+          [false, null, undefined].includes(value) ||
+          (isArray(value) && value.length === 0)
+        ) {
+          return $t('ui.formRules.selectRequired', [ctx.label]);
+        }
+        return true;
+      },
+    },
+  });
+}
+
+const useVbenForm = useForm<ComponentType>;
+
+export { initSetupVbenForm, useVbenForm, z };
+
+export type VbenFormSchema = FormSchema<ComponentType>;
+export type { VbenFormProps };
+export type FormSchemaGetter = () => VbenFormSchema[];
+import type { VxeGridPropTypes } from '@vben/plugins/vxe-table';
+
+import { h } from 'vue';
+
+import { setupVbenVxeTable, useVbenVxeGrid } from '@vben/plugins/vxe-table';
+
+import { Button, Image } from 'ant-design-vue';
+
+import { useVbenForm } from './form';
+
+setupVbenVxeTable({
+  configVxeTable: (vxeUI) => {
+    vxeUI.setConfig({
+      grid: {
+        align: 'center',
+        border: false,
+        minHeight: 180,
+        formConfig: {
+          // 全局禁用vxe-table的表单配置，使用formOptions
+          enabled: false,
+        },
+        proxyConfig: {
+          autoLoad: true,
+          response: {
+            result: 'items',
+            total: 'totalCount',
+            list: 'items',
+          },
+          showActiveMsg: true,
+          showResponseMsg: false,
+        },
+        // 溢出展示形式
+        showOverflow: true,
+        pagerConfig: {
+          // 默认条数
+          pageSize: 10,
+          // 分页可选条数
+          pageSizes: [10, 20, 30, 40, 50],
+        },
+        rowConfig: {
+          // 鼠标移入行显示 hover 样式
+          isHover: true,
+          // 点击行高亮
+          isCurrent: false,
+        },
+        columnConfig: {
+          // 可拖拽列宽
+          resizable: true,
+        },
+        // 右上角工具栏
+        toolbarConfig: {
+          // 自定义列
+          custom: true,
+          customOptions: {
+            icon: 'vxe-icon-setting',
+          },
+          // 最大化
+          zoom: true,
+          // 刷新
+          refresh: true,
+          refreshOptions: {
+            // 默认为reload 修改为在当前页刷新
+            code: 'query',
+          },
+        },
+        // 圆角按钮
+        round: true,
+        // 表格尺寸
+        size: 'medium',
+        customConfig: {
+          // 表格右上角自定义列配置 是否保存到localStorage
+          // 必须存在id参数才能使用
+          storage: false,
+        },
+      },
+    });
+
+    // 表格配置项可以用 cellRender: { name: 'CellImage' },
+    vxeUI.renderer.add('CellImage', {
+      renderTableDefault(_renderOpts, params) {
+        const { column, row } = params;
+        return h(Image, { src: row[column.field] });
+      },
+    });
+
+    // 表格配置项可以用 cellRender: { name: 'CellLink' },
+    vxeUI.renderer.add('CellLink', {
+      renderTableDefault(renderOpts) {
+        const { props } = renderOpts;
+        return h(
+          Button,
+          { size: 'small', type: 'link' },
+          { default: () => props?.text },
+        );
+      },
+    });
+
+    // 这里可以自行扩展 vxe-table 的全局配置，比如自定义格式化
+    // vxeUI.formats.add
+  },
+  useVbenForm,
+});
+
+export { useVbenVxeGrid };
+
+export type * from '@vben/plugins/vxe-table';
+
+/**
+ * 判断vxe-table的复选框是否选中
+ * @param tableApi api
+ * @returns boolean
+ */
+export function vxeCheckboxChecked(
+  tableApi: ReturnType<typeof useVbenVxeGrid>[1],
+) {
+  return tableApi?.grid?.getCheckboxRecords?.()?.length > 0;
+}
+
+/**
+ * 通用的 排序参数添加到请求参数中
+ * @param params 请求参数
+ * @param sortList vxe-table的排序参数
+ */
+export function addSortParams(
+  params: Record<string, any>,
+  sortList: VxeGridPropTypes.ProxyAjaxQuerySortCheckedParams[],
+) {
+  // 这里是排序取消 length为0 就不添加参数了
+  if (sortList.length === 0) {
+    return;
+  }
+  // 支持单/多字段排序
+  const orderByColumn = sortList.map((item) => item.field).join(',');
+  const isAsc = sortList.map((item) => item.order).join(',');
+  params.orderByColumn = orderByColumn;
+  params.isAsc = isAsc;
+}
+export type ID = number | string;
+export type IDS = (number | string)[];
+
+export interface BaseEntity {
+  createBy?: string;
+  createDept?: string;
+  creationTime?: string;
+  updateBy?: string;
+  updateTime?: string;
+}
+
+/**
+ * 分页信息
+ * @param rows 结果集
+ * @param total 总数
+ */
+export interface PageResult<T = any> {
+  items: T[];
+  totalCount: number;
+}
+
+/**
+ * 分页查询参数
+ *
+ * 排序支持的用法如下:
+ * {isAsc:"asc",orderByColumn:"id"} order by id asc
+ * {isAsc:"asc",orderByColumn:"id,creationTime"} order by id asc,create_time asc
+ * {isAsc:"desc",orderByColumn:"id,creationTime"} order by id desc,create_time desc
+ * {isAsc:"asc,desc",orderByColumn:"id,creationTime"} order by id asc,create_time desc
+ *
+ * @param SkipCount 当前页
+ * @param MaxResultCount 每页大小
+ * @param orderByColumn 排序字段
+ * @param isAsc 是否升序
+ */
+export interface PageQuery {
+  isAsc?: string;
+  orderByColumn?: string;
+  SkipCount?: number;
+  MaxResultCount?: number;
+  [key: string]: any;
+}
+import type { GrantType } from '@vben/common-ui';
+import type { HttpResponse } from '@vben/request';
+
+import { h } from 'vue';
+
+import { useAppConfig } from '@vben/hooks';
+
+import { Modal } from 'ant-design-vue';
+
+import { requestClient } from '#/api/request';
+
+const { clientId, sseEnable } = useAppConfig(
+  import.meta.env,
+  import.meta.env.PROD,
+);
+
+export namespace AuthApi {
+  /**
+   * @description: 所有登录类型都需要用到的
+   * @param clientId 客户端ID 这里为必填项 但是在loginApi内部处理了 所以为可选
+   * @param grantType 授权/登录类型
+   * @param tenantId 租户id
+   */
+  export interface BaseLoginParams {
+    clientId?: string;
+    grantType: GrantType;
+    tenantId: string;
+  }
+
+  /**
+   * @description: oauth登录需要用到的参数
+   * @param socialCode 第三方参数
+   * @param socialState 第三方参数
+   * @param source 与后端的 justauth.type.xxx的回调地址的source对应
+   */
+  export interface OAuthLoginParams extends BaseLoginParams {
+    socialCode: string;
+    socialState: string;
+    source: string;
+  }
+
+  /**
+   * @description: 验证码登录需要用到的参数
+   * @param code 验证码 可选(未开启验证码情况)
+   * @param uuid 验证码ID 可选(未开启验证码情况)
+   * @param username 用户名
+   * @param password 密码
+   */
+  export interface SimpleLoginParams extends BaseLoginParams {
+    code?: string;
+    uuid?: string;
+    username: string;
+    password: string;
+  }
+
+  export type LoginParams = OAuthLoginParams | SimpleLoginParams;
+
+  // /** 登录接口参数 */
+  // export interface LoginParams {
+  //   code?: string;
+  //   grantType: string;
+  //   password: string;
+  //   tenantId: string;
+  //   username: string;
+  //   uuid?: string;
+  // }
+
+  /** 登录接口返回值 */
+  export interface LoginResult {
+    access_token: string;
+    client_id: string;
+    expire_in: number;
+  }
+
+  export interface RefreshTokenResult {
+    data: string;
+    status: number;
+  }
+}
+
+/**
+ * 登录
+ */
+export async function loginApi(data: AuthApi.LoginParams) {
+  return requestClient.post<AuthApi.LoginResult>(
+    '/account/login',
+    { ...data, clientId },
+    {
+      encrypt: true,
+    },
+  );
+}
+
+/**
+ * 用户登出
+ * @returns void
+ */
+export async function doLogout() {
+  const resp = await requestClient.post<HttpResponse<void>>(
+    'account/logout',
+    null,
+    {
+      isTransformResponse: false,
+    },
+  );
+  // 无奈之举 对错误用法的提示
+  if (resp.code === 401 && import.meta.env.DEV) {
+    Modal.destroyAll();
+    Modal.warn({
+      title: '后端配置出现错误',
+      centered: true,
+      content: h('div', { class: 'flex flex-col gap-2' }, [
+        `检测到你的logout接口返回了401, 导致前端一直进入循环逻辑???`,
+        ...Array.from({ length: 3 }, () =>
+          h(
+            'span',
+            { class: 'font-bold text-red-500 text-[18px]' },
+            '去检查你的后端配置!别盯着前端找问题了!这不是前端问题!',
+          ),
+        ),
+      ]),
+    });
+  }
+}
+
+/**
+ * 关闭sse连接
+ * @returns void
+ */
+export function seeConnectionClose() {
+  /**
+   * 未开启sse 不需要处理
+   */
+  if (!sseEnable) {
+    return;
+  }
+  return requestClient.get<void>('/resource/sse/close');
+}
+
+/**
+ * @param companyName 租户/公司名称
+ * @param domain 绑定域名(不带http(s)://) 可选
+ * @param tenantId 租户id
+ */
+export interface TenantOption {
+  companyName: string;
+  domain?: string;
+  tenantId: string;
+}
+
+/**
+ * @param tenantEnabled 是否启用租户
+ * @param voList 租户列表
+ */
+export interface TenantResp {
+  tenantEnabled: boolean;
+  voList: TenantOption[];
+}
+
+/**
+ * 获取租户列表 下拉框使用
+ */
+export function tenantList() {
+  return requestClient.get<TenantResp>('/tenant/select');
+}
+
+/**
+ * vben的 先不删除
+ * @returns string[]
+ */
+export async function getAccessCodesApi() {
+  return requestClient.get<string[]>('/auth/codes');
+}
+
+/**
+ * 绑定第三方账号
+ * @param source 绑定的来源
+ * @returns 跳转url
+ */
+export function authBinding(source: string, tenantId: string) {
+  return requestClient.get<string>(`/auth/binding/${source}`, {
+    params: {
+      domain: window.location.host,
+      tenantId,
+    },
+  });
+}
+
+/**
+ * 取消绑定
+ * @param id id
+ */
+export function authUnbinding(id: string) {
+  return requestClient.deleteWithMsg<void>(`/auth/unlock/${id}`);
+}
+
+/**
+ * oauth授权回调
+ * @param data oauth授权
+ * @returns void
+ */
+export function authCallback(data: AuthApi.OAuthLoginParams) {
+  return requestClient.post<void>('/auth/social/callback', data);
+}
+import { requestClient } from '#/api/request';
+
+/**
+ * 发送短信验证码
+ * @param phone 手机号
+ * @returns void
+ */
+export function sendSmsCode(phone: string) {
+  return requestClient.get<void>('/resource/sms/code', {
+    params: { phone },
+  });
+}
+
+/**
+ * 发送邮件验证码
+ * @param email 邮箱
+ * @returns void
+ */
+export function sendEmailCode(email: string) {
+  return requestClient.get<void>('/resource/email/code', {
+    params: { email },
+  });
+}
+
+/**
+ * @param img 图片验证码 需要和base64拼接
+ * @param isEnableCaptcha 是否开启
+ * @param uuid 验证码ID
+ */
+export interface CaptchaResponse {
+  isEnableCaptcha: boolean;
+  img: string;
+  uuid: string;
+}
+
+/**
+ * 图片验证码
+ * @returns resp
+ */
+export function captchaImage() {
+  return requestClient.get<CaptchaResponse>('/account/captcha-image');
+}
+export * from './auth';
+export * from './menu';
+export * from './upload';
+export * from './user';
+import { requestClient } from '#/api/request';
+
+/**
+ * @description: 菜单meta
+ * @param title 菜单名
+ * @param icon 菜单图标
+ * @param noCache 是否不缓存
+ * @param link 外链链接
+ */
+export interface MenuMeta {
+  icon: string;
+  link?: string;
+  noCache: boolean;
+  title: string;
+}
+
+/**
+ * @description: 菜单
+ * @param name 菜单名
+ * @param path 菜单路径
+ * @param hidden 是否隐藏
+ * @param component 组件名称 Layout
+ * @param alwaysShow 总是显示
+ * @param query 路由参数(json形式)
+ * @param meta 路由信息
+ * @param children 子路由信息
+ */
+export interface Menu {
+  alwaysShow?: boolean;
+  children: Menu[];
+  component: string;
+  hidden: boolean;
+  meta: MenuMeta;
+  name: string;
+  path: string;
+  query?: string;
+  redirect?: string;
+}
+
+/**
+ * 获取用户所有菜单
+ */
+export async function getAllMenusApi() {
+  return requestClient.get<Menu[]>('/account/Vue3Router/vben5');
+}
+import type { AxiosRequestConfig } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+/**
+ * Axios上传进度事件
+ */
+export type AxiosProgressEvent = AxiosRequestConfig['onUploadProgress'];
+
+/**
+ * 默认上传结果
+ */
+export interface UploadResult {
+  url: string;
+  fileName: string;
+  ossId: string;
+}
+
+/**
+ * 通过单文件上传接口
+ * @param file 上传的文件
+ * @param options 一些配置项
+ * @param options.onUploadProgress 上传进度事件
+ * @param options.signal 上传取消信号
+ * @param options.otherData 其他请求参数 后端拓展可能会用到
+ * @returns 上传结果
+ */
+export function uploadApi(
+  file: Blob | File,
+  options?: {
+    onUploadProgress?: AxiosProgressEvent;
+    otherData?: Record<string, any>;
+    signal?: AbortSignal;
+  },
+) {
+  const { onUploadProgress, signal, otherData = {} } = options ?? {};
+  return requestClient.upload<UploadResult>(
+    '/resource/oss/upload',
+    { file, ...otherData },
+    { onUploadProgress, signal, timeout: 60_000 },
+  );
+}
+
+/**
+ * 上传api type
+ */
+export type UploadApi = typeof uploadApi;
+import { requestClient } from '#/api/request';
+
+export interface Role {
+  dataScope: string;
+  flag: boolean;
+  roleId: number;
+  roleKey: string;
+  roleName: string;
+  roleSort: number;
+  status: string;
+  superAdmin: boolean;
+}
+
+export interface User {
+  avatar: string;
+  creationTime: string;
+  deptId: number;
+  deptName: string;
+  email: string;
+  loginDate: string;
+  loginIp: string;
+  nick: string;
+  phone: string;
+  remark: string;
+  roles: Role[];
+  sex: string;
+  status: string;
+  tenantId: string;
+  userId: number;
+  userName: string;
+  userType: string;
+}
+
+export interface UserInfoResp {
+  permissionCodes: string[];
+  roles: string[];
+  roleCodes: string[];
+  user: User;
+}
+
+/**
+ * 获取用户信息
+ * 存在返回null的情况(401) 不会抛出异常 需要手动抛异常
+ */
+export async function getUserInfoApi() {
+  return requestClient.get<null | UserInfoResp>('account');
+}
+export interface DashboardMetricCardDto {
+  key: string;
+  title: string;
+  value: number;
+  previousValue: number;
+  changeValue: number;
+  changeRate: number;
+}
+
+export interface DashboardWeeklyPointDto {
+  date: string;
+  value: number;
+}
+
+export interface DashboardCategorySliceDto {
+  categoryId: string;
+  categoryName: string;
+  count: number;
+  ratio: number;
+}
+
+export interface DashboardRecentLabelItemDto {
+  taskId: string;
+  labelCode: string;
+  displayName: string;
+  printedByUserId: string | null;
+  printedByName: string;
+  printedAt: string;
+  status: string;
+  labelTypeBadge: string;
+}
+
+export interface DashboardOverviewDto {
+  labelsPrintedToday: DashboardMetricCardDto;
+  activeTemplates: DashboardMetricCardDto;
+  activeUsers: DashboardMetricCardDto;
+  locations: DashboardMetricCardDto;
+  people: DashboardMetricCardDto;
+  products: DashboardMetricCardDto;
+  weeklyPrintVolume: DashboardWeeklyPointDto[];
+  byCategory: DashboardCategorySliceDto[];
+  byCategoryTotal: number;
+  recentLabels: DashboardRecentLabelItemDto[];
+  generatedAt?: string | null;
+}
+import type {
+  DashboardCategorySliceDto,
+  DashboardMetricCardDto,
+  DashboardOverviewDto,
+  DashboardRecentLabelItemDto,
+  DashboardWeeklyPointDto,
+} from './dashboard-types';
+
+import { requestClient } from '#/api/request';
+
+const PATH = '/dashboard/overview';
+
+function num(x: unknown, fallback = 0): number {
+  const n = typeof x === 'number' ? x : Number(x);
+  return Number.isFinite(n) ? n : fallback;
+}
+
+function str(o: Record<string, unknown>, camel: string, pascal: string, fallback = '') {
+  const v = o[camel] ?? o[pascal];
+  if (v === null || v === undefined) {
+    return fallback;
+  }
+  return String(v);
+}
+
+function normMetric(raw: unknown): DashboardMetricCardDto {
+  if (!raw || typeof raw !== 'object') {
+    return {
+      changeRate: 0,
+      changeValue: 0,
+      key: '',
+      previousValue: 0,
+      title: '',
+      value: 0,
+    };
+  }
+  const o = raw as Record<string, unknown>;
+  return {
+    changeRate: num(o.changeRate ?? o.ChangeRate, 0),
+    changeValue: num(o.changeValue ?? o.ChangeValue, 0),
+    key: String(o.key ?? o.Key ?? ''),
+    previousValue: num(o.previousValue ?? o.PreviousValue, 0),
+    title: String(o.title ?? o.Title ?? ''),
+    value: num(o.value ?? o.Value, 0),
+  };
+}
+
+function normWeeklyPoint(raw: unknown): DashboardWeeklyPointDto | null {
+  if (!raw || typeof raw !== 'object') {
+    return null;
+  }
+  const o = raw as Record<string, unknown>;
+  const date = String(o.date ?? o.Date ?? '');
+  if (!date) {
+    return null;
+  }
+  return { date, value: num(o.value ?? o.Value, 0) };
+}
+
+function normCategorySlice(raw: unknown): DashboardCategorySliceDto | null {
+  if (!raw || typeof raw !== 'object') {
+    return null;
+  }
+  const o = raw as Record<string, unknown>;
+  return {
+    categoryId: String(o.categoryId ?? o.CategoryId ?? ''),
+    categoryName: String(o.categoryName ?? o.CategoryName ?? ''),
+    count: num(o.count ?? o.Count, 0),
+    ratio: num(o.ratio ?? o.Ratio, 0),
+  };
+}
+
+function normRecentLabel(raw: unknown): DashboardRecentLabelItemDto | null {
+  if (!raw || typeof raw !== 'object') {
+    return null;
+  }
+  const o = raw as Record<string, unknown>;
+  const taskId = str(o, 'taskId', 'TaskId', '');
+  const labelCode = str(o, 'labelCode', 'LabelCode', '');
+  if (!taskId && !labelCode) {
+    return null;
+  }
+  const pbUid = o.printedByUserId ?? o.PrintedByUserId;
+  return {
+    displayName: str(o, 'displayName', 'DisplayName', '—') || '—',
+    labelCode: labelCode || '—',
+    labelTypeBadge: str(o, 'labelTypeBadge', 'LabelTypeBadge', '—') || '—',
+    printedAt: str(o, 'printedAt', 'PrintedAt', ''),
+    printedByName: str(o, 'printedByName', 'PrintedByName', '—') || '—',
+    printedByUserId:
+      pbUid === null || pbUid === undefined ? null : String(pbUid),
+    status: str(o, 'status', 'Status', 'active') || 'active',
+    taskId: taskId || labelCode,
+  };
+}
+
+function emptyMetric(key: string, title: string): DashboardMetricCardDto {
+  return {
+    changeRate: 0,
+    changeValue: 0,
+    key,
+    previousValue: 0,
+    title,
+    value: 0,
+  };
+}
+
+export function emptyDashboardOverview(): DashboardOverviewDto {
+  return {
+    activeTemplates: emptyMetric('activeTemplates', 'Active Templates'),
+    activeUsers: emptyMetric('activeUsers', 'Active Users'),
+    byCategory: [],
+    byCategoryTotal: 0,
+    generatedAt: null,
+    labelsPrintedToday: emptyMetric('labelsPrintedToday', 'Labels Printed Today'),
+    locations: emptyMetric('locations', 'Locations'),
+    people: emptyMetric('people', 'People'),
+    products: emptyMetric('products', 'Products'),
+    recentLabels: [],
+    weeklyPrintVolume: [],
+  };
+}
+
+function normalizeOverview(raw: unknown): DashboardOverviewDto {
+  if (!raw || typeof raw !== 'object') {
+    return emptyDashboardOverview();
+  }
+  const o = raw as Record<string, unknown>;
+
+  const weeklyRaw = (o.weeklyPrintVolume ?? o.WeeklyPrintVolume) as unknown;
+  const weeklyArr = Array.isArray(weeklyRaw) ? weeklyRaw : [];
+
+  const byCat = (o.byCategory ?? o.ByCategory) as unknown;
+  const legacyCat = (o.categoryDistribution ?? o.CategoryDistribution) as unknown;
+  const catArr =
+    Array.isArray(byCat) && byCat.length
+      ? byCat
+      : Array.isArray(legacyCat)
+        ? legacyCat
+        : [];
+
+  const totalRaw =
+    o.byCategoryTotal ??
+    o.ByCategoryTotal ??
+    o.categoryDistributionTotal ??
+    o.CategoryDistributionTotal;
+
+  const recentRaw = (o.recentLabels ?? o.RecentLabels) as unknown;
+  const recentArr = Array.isArray(recentRaw) ? recentRaw : [];
+
+  return {
+    activeTemplates: normMetric(o.activeTemplates ?? o.ActiveTemplates),
+    activeUsers: normMetric(o.activeUsers ?? o.ActiveUsers),
+    byCategory: catArr
+      .map(normCategorySlice)
+      .filter((x): x is DashboardCategorySliceDto => x !== null),
+    byCategoryTotal: num(totalRaw, 0),
+    generatedAt: (o.generatedAt ?? o.GeneratedAt ?? null) as string | null,
+    labelsPrintedToday: normMetric(o.labelsPrintedToday ?? o.LabelsPrintedToday),
+    locations: normMetric(o.locations ?? o.Locations),
+    people: normMetric(o.people ?? o.People),
+    products: normMetric(o.products ?? o.Products),
+    recentLabels: recentArr
+      .map(normRecentLabel)
+      .filter((x): x is DashboardRecentLabelItemDto => x !== null),
+    weeklyPrintVolume: weeklyArr
+      .map(normWeeklyPoint)
+      .filter((x): x is DashboardWeeklyPointDto => x !== null),
+  };
+}
+
+export function dashboardOverview() {
+  return requestClient
+    .get<unknown>(`${PATH}`, { errorMessageMode: 'message' })
+    .then((raw) => normalizeOverview(raw));
+}
 export * from './account-types';
+export * from './dashboard';
+export * from './dashboard-types';
 export {
   groupAdd,
   groupInfo,
@@ -65,6 +65,10 @@ export interface ProductCategoryDto {
   buttonStyleJson?: string | null;
   availabilityType?: 'ALL' | 'SPECIFIED' | string | null;
   locationIds?: string[] | null;
+  region?: string | null;
+  location?: string | null;
+  regionIds?: string[] | null;
+  groupIds?: string[] | null;
   state?: boolean | null;
   orderNum?: number | null;
   lastEdited?: string | null;
@@ -88,8 +92,30 @@ export interface ProductCategoryCreateInput {
   buttonStyleJson?: string | null;
   availabilityType?: 'ALL' | 'SPECIFIED' | string | null;
   locationIds?: string[] | null;
+  regionIds?: string[] | null;
+  groupIds?: string[] | null;
   state?: boolean;
   orderNum?: number | null;
 }
  
+export interface ProductBatchImportResultDto {
+  successCount: number;
+  failCount: number;
+  errors?: Array<{
+    rowNumber?: number;
+    productName?: string;
+    message?: string;
+  }>;
+}
+
+export interface ProductExportQuery {
+  Keyword?: string;
+  State?: boolean;
+  Sorting?: string;
+  PartnerId?: string;
+  GroupId?: string;
+  LocationId?: string;
+  CategoryId?: string;
+}
+
 export type ProductCategoryUpdateInput = ProductCategoryCreateInput;
 import type {
   FlPagedResult,
+  ProductBatchImportResultDto,
   ProductCreateInput,
   ProductDto,
+  ProductExportQuery,
   ProductGetListQuery,
   ProductUpdateInput,
 } from './product-types';
  
+import { ContentTypeEnum } from '#/api/helper';
 import { requestClient } from '#/api/request';
  
 const PATH = '/product';
@@ -37,3 +40,37 @@ export function productUpdate(id: string, data: ProductUpdateInput) {
 export function productRemove(id: string) {
   return requestClient.deleteWithMsg<void>(`${PATH}/${encodeURIComponent(id)}`);
 }
+
+export function productDownloadImportTemplate() {
+  return requestClient.post<Blob>(
+    `${PATH}/download-product-import-template`,
+    {},
+    {
+      isTransformResponse: false,
+      responseType: 'blob',
+      errorMessageMode: 'message',
+    },
+  );
+}
+
+export function productExportExcel(params?: ProductExportQuery) {
+  return requestClient.get<Blob>(`${PATH}/export-products-excel`, {
+    params,
+    isTransformResponse: false,
+    responseType: 'blob',
+    errorMessageMode: 'message',
+  });
+}
+
+export function productImportBatch(file: File) {
+  const formData = new FormData();
+  formData.append('file', file);
+  return requestClient.post<ProductBatchImportResultDto>(
+    `${PATH}/import-products-batch`,
+    formData,
+    {
+      headers: { 'Content-Type': ContentTypeEnum.FORM_DATA },
+      errorMessageMode: 'message',
+    },
+  );
+}
@@ -60,6 +60,20 @@ export interface LabelReportDataDto {
   mostUsedProducts: LabelReportTopProductDto[];
 }
  
+export interface ReportsTemplatePrintStatItemDto {
+  templateId?: string | null;
+  templateName?: string | null;
+  printedCount: number;
+}
+
+export interface ReportsTemplatePrintStatQuery extends FlPageQuery {
+  PartnerId?: string;
+  GroupId?: string;
+  LocationId?: string;
+  StartDate?: string;
+  EndDate?: string;
+}
+
 export interface LabelReportQuery {
   PartnerId?: string;
   GroupId?: string;
@@ -4,6 +4,8 @@ import type {
   LabelReportQuery,
   ReportsPrintLogItemDto,
   ReportsPrintLogQuery,
+  ReportsTemplatePrintStatItemDto,
+  ReportsTemplatePrintStatQuery,
 } from './reports-types';
  
 import { requestClient } from '#/api/request';
@@ -24,6 +26,15 @@ export function reportsLabelReport(params?: LabelReportQuery) {
   });
 }
  
+export function reportsTemplatePrintStatList(
+  params?: ReportsTemplatePrintStatQuery,
+) {
+  return requestClient.get<FlPagedResult<ReportsTemplatePrintStatItemDto>>(
+    `${PATH}/template-print-stat-list`,
+    { params, errorMessageMode: 'message' },
+  );
+}
+
 export function reportsExportPrintLogExcel(params?: ReportsPrintLogQuery) {
   return requestClient.post<Blob>(
     `${PATH}/export-print-log-excel`,
+import { requestClient } from './request';
+
+/**
+ * @description:  contentType
+ */
+export const ContentTypeEnum = {
+  // form-data  upload
+  FORM_DATA: 'multipart/form-data;charset=UTF-8',
+  // form-data qs
+  FORM_URLENCODED: 'application/x-www-form-urlencoded;charset=UTF-8',
+  // json
+  JSON: 'application/json;charset=UTF-8',
+} as const;
+
+/**
+ * 通用下载接口 封装一层
+ * @param url 请求地址
+ * @param data  请求参数
+ * @returns blob二进制
+ */
+export function commonExport(url: string, data: Record<string, any>) {
+  return requestClient.post<Blob>(url, data, {
+    data,
+    headers: { 'Content-Type': ContentTypeEnum.FORM_URLENCODED },
+    isTransformResponse: false,
+    responseType: 'blob',
+  });
+}
+export * from './core';
+import { requestClient } from '#/api/request';
+
+export interface CommandStats {
+  name: string;
+  value: string;
+}
+
+export interface RedisInfo {
+  [key: string]: string;
+}
+
+export interface CacheInfo {
+  commandStats: CommandStats[];
+  dbSize: number;
+  info: RedisInfo;
+}
+
+export interface CacheName {
+  cacheName: string;
+  remark: string;
+}
+
+export interface CacheValue {
+  cacheName: string;
+  cacheKey: string;
+  cacheValue: string;
+}
+
+/**
+ *
+ * @returns redis信息
+ */
+export function redisCacheInfo() {
+  return requestClient.get<CacheInfo>('/monitor/cache');
+}
+
+/**
+ * 查询缓存名称列表
+ * @returns 缓存名称列表
+ */
+export function listCacheName() {
+  return requestClient.get<CacheName[]>('/monitor-cache/name');
+}
+
+/**
+ * 查询缓存键名列表
+ * @param cacheName 缓存名称
+ * @returns 缓存键名列表
+ */
+export function listCacheKey(cacheName: string) {
+  return requestClient.get<string[]>(`/monitor-cache/key/${cacheName}`);
+}
+
+/**
+ * 查询缓存内容
+ * @param cacheName 缓存名称
+ * @param cacheKey 缓存键名
+ * @returns 缓存内容
+ */
+export function getCacheValue(cacheName: string, cacheKey: string) {
+  return requestClient.get<CacheValue>(
+    `/monitor-cache/value/${cacheName}/${cacheKey}`,
+  );
+}
+
+/**
+ * 清理指定名称缓存
+ * @param cacheName 缓存名称
+ */
+export function clearCacheName(cacheName: string) {
+  return requestClient.deleteWithMsg<void>(`/monitor-cache/key/${cacheName}`);
+}
+
+/**
+ * 清理指定键名缓存
+ * @param cacheName 缓存名称
+ * @param cacheKey 缓存键名
+ */
+export function clearCacheKey(cacheName: string, cacheKey: string) {
+  return requestClient.deleteWithMsg<void>(
+    `/monitor-cache/value/${cacheName}/${cacheKey}`,
+  );
+}
+
+/**
+ * 清理全部缓存
+ */
+export function clearCacheAll() {
+  return requestClient.deleteWithMsg<void>('/monitor-cache/clear');
+}
+import type { LoginLog } from './model';
+
+import type { IDS, PageQuery, PageResult } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  loginInfoClean = '/login-log/clean',
+  loginInfoExport = '/login-log/export',
+  root = '/login-log',
+  userUnlock = '/login-log/unlock',
+}
+
+/**
+ * 登录日志列表
+ * @param params 查询参数
+ * @returns list[]
+ */
+export function loginInfoList(params?: PageQuery) {
+  return requestClient.get<PageResult<LoginLog>>(Api.root, { params });
+}
+
+/**
+ * 导出登录日志
+ * @param data 表单参数
+ * @returns excel
+ */
+export function loginInfoExport(data: any) {
+  return commonExport(Api.loginInfoExport, data);
+}
+
+/**
+ * 移除登录日志
+ * @param infoIds 登录日志id数组
+ * @returns void
+ */
+export function loginInfoRemove(infoIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: infoIds.join(',') },
+  });
+}
+
+/**
+ * 账号解锁
+ * @param username 用户名(账号)
+ * @returns void
+ */
+export function userUnlock(username: string) {
+  return requestClient.get<void>(`${Api.userUnlock}/${username}`, {
+    successMessageMode: 'message',
+  });
+}
+
+/**
+ * 清空全部登录日志
+ * @returns void
+ */
+export function loginInfoClean() {
+  return requestClient.deleteWithMsg<void>(Api.loginInfoClean);
+}
+export interface LoginLog {
+  id: string;
+  loginUser: string;
+  loginLocation: string;
+  loginIp: string;
+  browser: string;
+  os: string;
+  logMsg: string;
+  creationTime: string;
+  creatorId: string | null;
+}
+import type { OnlineUser } from './model';
+
+import type { IDS, PageQuery, PageResult } from '#/api/common';
+
+import { requestClient } from '#/api/request';
+
+enum Api {
+  root = '/online',
+}
+
+/**
+ * 当前账号的在线设备 个人中心使用
+ * @returns OnlineUser[]
+ */
+export function onlineDeviceList() {
+  return requestClient.get<PageResult<OnlineUser>>(Api.root);
+}
+
+/**
+ * 这里的分页参数无效 返回的是全部的分页
+ * @param params 请求参数
+ * @returns 结果
+ */
+export function onlineList(params?: PageQuery) {
+  return requestClient.get<PageResult<OnlineUser>>(Api.root, { params });
+}
+
+/**
+ * 强制下线
+ * @param tokenId 连接Id
+ * @returns void
+ */
+export function forceLogout(tokenId: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: tokenId.join(',') },
+  });
+}
+
+/**
+ * 个人中心用的 跟上面的不同是用的Post
+ * @param tokenId 连接Id
+ * @returns void
+ */
+export function forceLogout2(tokenId: string) {
+  return requestClient.deleteWithMsg<void>(`${Api.root}/myself/${tokenId}`);
+}
+export interface OnlineUser {
+  connnectionId?: string;
+  userId?: string;
+  userName?: string;
+  loginTime: number;
+  ipaddr?: string;
+  loginLocation?: string;
+  os?: string;
+  browser?: string;
+}
+import type { OperationLog } from './model';
+
+import type { IDS, PageQuery, PageResult } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  operLogClean = '/operation-log/clean',
+  operLogExport = '/operation-log/export',
+  root = '/operation-log',
+}
+
+/**
+ * 操作日志分页
+ * @param params 查询参数
+ * @returns 分页结果
+ */
+export function operLogList(params?: PageQuery) {
+  return requestClient.get<PageResult<OperationLog>>(Api.root, {
+    params,
+  });
+}
+
+/**
+ * 删除操作日志
+ * @param operIds id/ids
+ */
+export function operLogRemove(operIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: operIds.join(',') },
+  });
+}
+
+/**
+ * 清空全部分页日志
+ */
+export function operLogClean() {
+  return requestClient.deleteWithMsg<void>(Api.operLogClean);
+}
+
+/**
+ * 导出操作日志
+ * @param data 查询参数
+ */
+export function operLogExport(data: Partial<OperationLog>) {
+  return commonExport(Api.operLogExport, data);
+}
+export interface OperationLog {
+  id: string;
+  title: string;
+  operType: string;
+  requestMethod: string;
+  operUser: string;
+  operIp: string;
+  operLocation: string;
+  method: string;
+  requestParam: string;
+  requestResult: string;
+  creationTime: string;
+  creatorId: string | null;
+}
+/**
+ * 该文件可自行根据业务逻辑进行调整
+ */
+
+import type { HttpResponse } from '@vben/request';
+
+import { useAppConfig } from '@vben/hooks';
+import { $t } from '@vben/locales';
+import { preferences } from '@vben/preferences';
+import {
+  authenticateResponseInterceptor,
+  errorMessageResponseInterceptor,
+  RequestClient,
+  stringify,
+} from '@vben/request';
+import { useAccessStore } from '@vben/stores';
+
+import { message, Modal } from 'ant-design-vue';
+
+import { useAuthStore } from '#/store';
+import { useThTenantStore } from '#/store/th-tenant';
+import {
+  decryptBase64,
+  decryptWithAes,
+  encryptBase64,
+  encryptWithAes,
+  generateAesKey,
+} from '#/utils/encryption/crypto';
+import * as encryptUtil from '#/utils/encryption/jsencrypt';
+
+const { apiURL, clientId, enableEncrypt, demoMode } = useAppConfig(
+  import.meta.env,
+  import.meta.env.PROD,
+);
+
+/**
+ * 是否已经处在登出过程中了 一个标志位
+ * 主要是防止一个页面会请求多个api 都401 会导致登出执行多次
+ */
+let isLogoutProcessing = false;
+
+/**
+ * 定义一个401专用异常 用于可能会用到的区分场景?
+ */
+export class UnauthorizedException extends Error {}
+
+/**
+ * 演示模式错误，用于标识演示环境禁止修改的错误
+ */
+export class DemoModeException extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'DemoModeException';
+    // 添加标记，用于错误拦截器识别
+    (this as any).__isDemoModeError = true;
+  }
+}
+
+function createRequestClient(baseURL: string) {
+  const client = new RequestClient({
+    // 后端地址
+    baseURL,
+    // 消息提示类型
+    errorMessageMode: 'message',
+    // 是否返回原生响应 比如：需要获取响应头时使用该属性
+    isReturnNativeResponse: false,
+    // 需要对返回数据进行处理
+    isTransformResponse: true,
+  });
+
+  /**
+   * 重新认证逻辑
+   */
+  async function doReAuthenticate() {
+    console.warn('Access token or refresh token is invalid or expired. ');
+    const accessStore = useAccessStore();
+    const authStore = useAuthStore();
+    accessStore.setAccessToken(null);
+    if (
+      preferences.app.loginExpiredMode === 'modal' &&
+      accessStore.isAccessChecked
+    ) {
+      accessStore.setLoginExpired(true);
+    } else {
+      await authStore.logout();
+    }
+  }
+
+  /**
+   * 刷新token逻辑
+   */
+  async function doRefreshToken() {
+    // 不需要
+    // 保留此方法只是为了合并方便
+    return '';
+  }
+
+  function formatToken(token: null | string) {
+    return token ? `Bearer ${token}` : null;
+  }
+
+  client.addRequestInterceptor({
+    fulfilled: (config) => {
+      // 演示模式：拦截所有修改操作
+      if (demoMode) {
+        const method = config.method?.toUpperCase() || '';
+        const isModifyMethod = ['DELETE', 'PATCH', 'POST', 'PUT'].includes(
+          method,
+        );
+        // 排除登录等认证接口，允许通过
+        const isAuthPath =
+          config.url?.includes('/auth/') ||
+          config.url?.includes('/login') ||
+          config.url?.includes('/logout');
+        if (isModifyMethod && !isAuthPath) {
+          // 显示错误提示
+          message.error('演示环境，禁止修改');
+          // 抛出演示模式错误，错误拦截器会识别并跳过处理
+          throw new DemoModeException('演示环境，禁止修改');
+        }
+      }
+
+      const accessStore = useAccessStore();
+      // 添加token
+      config.headers.Authorization = formatToken(accessStore.accessToken);
+      /** 泰额多租户：业务 API 携带 __tenant（JWT 亦含 TenantId，双保险） */
+      const thTenantStore = useThTenantStore();
+      if (thTenantStore.tenantId) {
+        config.headers.__tenant = thTenantStore.tenantId;
+      }
+      /**
+       * locale跟后台不一致 需要转换
+       */
+      const language = preferences.app.locale.replace('-', '_');
+      config.headers['Accept-Language'] = language;
+      config.headers['Content-Language'] = language;
+      /**
+       * 添加全局clientId
+       * 关于header的clientId被错误绑定到实体类
+       * https://gitee.com/dapppp/ruoyi-plus-vben5/issues/IC0BDS
+       */
+      config.headers.ClientID = clientId;
+      /**
+       * 格式化get/delete参数
+       * 如果包含自定义的paramsSerializer则不走此逻辑
+       */
+      if (
+        ['DELETE', 'GET'].includes(config.method?.toUpperCase() || '') &&
+        config.params &&
+        !config.paramsSerializer
+      ) {
+        /**
+         * 1. 格式化参数 微服务在传递区间时间选择(后端的params Map类型参数)需要格式化key 否则接收不到
+         * 2. 数组参数需要格式化 后端才能正常接收 会变成arr=1&arr=2&arr=3的格式来接收
+         */
+        config.paramsSerializer = (params) =>
+          stringify(params, { arrayFormat: 'repeat' });
+      }
+
+      const { encrypt } = config;
+      // 全局开启请求加密功能 && 该请求开启 && 是post/put请求
+      if (
+        enableEncrypt &&
+        encrypt &&
+        ['POST', 'PUT'].includes(config.method?.toUpperCase() || '')
+      ) {
+        const aesKey = generateAesKey();
+        config.headers['encrypt-key'] = encryptUtil.encrypt(
+          encryptBase64(aesKey),
+        );
+
+        config.data =
+          typeof config.data === 'object'
+            ? encryptWithAes(JSON.stringify(config.data), aesKey)
+            : encryptWithAes(config.data, aesKey);
+      }
+      return config;
+    },
+  });
+
+  // 通用的错误处理, 如果没有进入上面的错误处理逻辑，就会进入这里
+  // 主要处理http状态码不为200(如网络异常/离线)的情况 必须放在在下面的响应拦截器之前
+  const errorInterceptor = errorMessageResponseInterceptor(
+    (msg: string, error: any) => {
+      // 如果是演示模式错误，已经在请求拦截器中提示过了，这里不再提示
+      if (error?.__isDemoModeError || error?.name === 'DemoModeException') {
+        return;
+      }
+      message.error(msg);
+    },
+  );
+  client.addResponseInterceptor(errorInterceptor);
+
+  client.addResponseInterceptor<HttpResponse>({
+    fulfilled: async (response) => {
+      const encryptKey = (response.headers ?? {})['encrypt-key'];
+      if (encryptKey) {
+        /** RSA私钥解密 拿到解密秘钥的base64 */
+        const base64Str = encryptUtil.decrypt(encryptKey);
+        /** base64 解码 得到请求头的 AES 秘钥 */
+        const aesSecret = decryptBase64(base64Str.toString());
+        /** 使用aesKey解密 responseData */
+        const decryptData = decryptWithAes(
+          response.data as unknown as string,
+          aesSecret,
+        );
+        /** 赋值 需要转为对象 */
+        response.data = JSON.parse(decryptData);
+      }
+
+      const { isReturnNativeResponse, isTransformResponse } = response.config;
+      // 是否返回原生响应 比如：需要获取响应时使用该属性
+      if (isReturnNativeResponse) {
+        return response;
+      }
+      // 不进行任何处理，直接返回
+      // 用于页面代码可能需要直接获取code，data，message这些信息时开启
+      if (!isTransformResponse) {
+        /**
+         * 需要判断下载二进制的情况 正常是返回二进制 报错会返回json
+         * 当type为blob且content-type为application/json时 则判断已经下载出错
+         */
+        if (
+          response.config.responseType === 'blob' &&
+          response.headers['content-type']?.includes?.('application/json')
+        ) {
+          // 这时候的data为blob类型
+          const blob = response.data as unknown as Blob;
+          // 拿到字符串转json对象
+          response.data = JSON.parse(await blob.text());
+          // 然后按正常逻辑执行下面的代码(判断业务状态码)
+        } else {
+          // 其他情况 直接返回
+          return response.data;
+        }
+      }
+
+      const axiosResponseData = response.data;
+      if (!axiosResponseData) {
+        throw new Error($t('http.apiRequestFailed'));
+      }
+
+      console.log('axiosResponseData', axiosResponseData);
+      // 适配新的后端数据结构: { statusCode, data, succeeded, errors, extras, timestamp }
+      const { statusCode, data, succeeded, errors, extras, timestamp } =
+        axiosResponseData;
+
+      // 业务状态码为200且succeeded为true则请求成功
+      const hasSuccess = statusCode === 200 && succeeded === true;
+      if (hasSuccess) {
+        const successMsg = $t(`http.operationSuccess`);
+
+        if (response.config.successMessageMode === 'modal') {
+          Modal.success({
+            content: successMsg,
+            title: $t('http.successTip'),
+          });
+        } else if (response.config.successMessageMode === 'message') {
+          message.success(successMsg);
+        }
+
+        // 直接返回data字段
+        return data;
+      }
+
+      // 在此处根据自己项目的实际情况对不同的statusCode执行不同的操作
+      // 如果不希望中断当前请求，请return数据，否则直接抛出异常即可
+      let timeoutMsg = '';
+      switch (statusCode) {
+        case 401: {
+          // 已经在登出过程中 不再执行
+          if (isLogoutProcessing) {
+            throw new UnauthorizedException(timeoutMsg);
+          }
+          isLogoutProcessing = true;
+          const _msg = $t('http.loginTimeout');
+          const userStore = useAuthStore();
+          userStore.logout().finally(() => {
+            message.error(_msg);
+            isLogoutProcessing = false;
+          });
+          // 不再执行下面逻辑
+          throw new UnauthorizedException(_msg);
+        }
+        default: {
+          // 优先使用errors字段作为错误信息
+          if (errors && Array.isArray(errors) && errors.length > 0) {
+            timeoutMsg = errors.join(', ');
+          } else if (typeof errors === 'string') {
+            timeoutMsg = errors;
+          } else {
+            timeoutMsg = $t('http.apiRequestFailed');
+          }
+        }
+      }
+
+      // errorMessageMode='modal'的时候会显示modal错误弹窗，而不是消息提示，用于一些比较重要的错误
+      // errorMessageMode='none' 一般是调用时明确表示不希望自动弹出错误提示
+      if (response.config.errorMessageMode === 'modal') {
+        Modal.error({
+          content: timeoutMsg,
+          title: $t('http.errorTip'),
+        });
+      } else if (response.config.errorMessageMode === 'message') {
+        message.error(timeoutMsg);
+      }
+
+      throw new Error(timeoutMsg || $t('http.apiRequestFailed'));
+    },
+  });
+
+  // token过期的处理
+  client.addResponseInterceptor(
+    authenticateResponseInterceptor({
+      client,
+      doReAuthenticate,
+      doRefreshToken,
+      enableRefreshToken: preferences.app.enableRefreshToken,
+      formatToken,
+    }),
+  );
+
+  return client;
+}
+
+export const requestClient = createRequestClient(apiURL);
+
+export const baseRequestClient = new RequestClient({ baseURL: apiURL });
+import type { ServerInfo } from './model';
+
+import { requestClient } from '#/api/request';
+
+/**
+ * 获取服务器信息
+ * @returns 服务器信息
+ */
+export function getServerInfo() {
+  return requestClient.get<ServerInfo>('/monitor-server/info');
+}
+
+export interface CpuInfo {
+  coreTotal: number;
+  logicalProcessors: number;
+  cpuRate: number;
+}
+
+export interface MemoryInfo {
+  totalRAM: string;
+  usedRam: string;
+  freeRam: string;
+  ramRate: number;
+}
+
+export interface SystemInfo {
+  computerName: string;
+  osName: string;
+  serverIP: string;
+  osArch: string;
+}
+
+export interface AppInfo {
+  name: string;
+  version: string;
+  startTime: string;
+  runTime: string;
+  rootPath: string;
+  webRootPath: string;
+}
+
+export interface DiskInfo {
+  diskName: string;
+  typeName: string;
+  totalSize: string;
+  availableFreeSpace: string;
+  used: string;
+  availablePercent: number;
+}
+
+export interface ServerInfo {
+  cpu: CpuInfo;
+  memory: MemoryInfo;
+  sys: SystemInfo;
+  app: AppInfo;
+  disk: DiskInfo[];
+}
+
+import type { Client } from './model';
+
+import type { ID, IDS, PageQuery, PageResult } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  clientChangeStatus = '/client/changeStatus',
+  clientExport = '/client/export',
+  clientList = '/client/list',
+  root = '/client',
+}
+
+/**
+ * 查询客户端分页列表
+ * @param params 请求参数
+ * @returns 列表
+ */
+export function clientList(params?: PageQuery) {
+  return requestClient.get<PageResult<Client>>(Api.clientList, { params });
+}
+
+/**
+ * 导出客户端excel
+ * @param data 请求参数
+ */
+export function clientExport(data: Partial<Client>) {
+  return commonExport(Api.clientExport, data);
+}
+
+/**
+ * 客户端详情
+ * @param id id
+ * @returns 详情
+ */
+export function clientInfo(id: ID) {
+  return requestClient.get<Client>(`${Api.root}/${id}`);
+}
+
+/**
+ * 客户端新增
+ * @param data 参数
+ */
+export function clientAdd(data: Partial<Client>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 客户端修改
+ * @param data 参数
+ */
+export function clientUpdate(data: Partial<Client>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 客户端状态修改
+ * @param data 状态
+ */
+export function clientChangeStatus(data: any) {
+  const requestData = {
+    clientId: data.clientId,
+    status: data.status,
+  };
+  return requestClient.putWithMsg<void>(Api.clientChangeStatus, requestData);
+}
+
+/**
+ * 客户端删除
+ * @param ids id集合
+ */
+export function clientRemove(ids: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: ids.join(',') },
+  });
+}
+export interface Client {
+  id: number;
+  clientId: string;
+  clientKey: string;
+  clientSecret: string;
+  grantTypeList: string[];
+  grantType: string;
+  deviceType: string;
+  activeTimeout: number;
+  timeout: number;
+  status: string;
+}
+import type { SysConfig } from './model';
+
+import type { ID, IDS, PageQuery, PageResult } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  configExport = '/config/export',
+  configInfoByKey = '/config/config-key',
+  configList = '/config/list',
+  configRefreshCache = '/config/refreshCache',
+  root = '/config',
+}
+
+/**
+ * 系统参数分页列表
+ * @param params 请求参数
+ * @returns 列表
+ */
+export function configList(params?: PageQuery) {
+  return requestClient.get<PageResult<SysConfig>>(Api.root, { params });
+}
+
+export function configInfo(configId: ID) {
+  return requestClient.get<SysConfig>(`${Api.root}/${configId}`);
+}
+
+/**
+ * 导出
+ * @param data 参数
+ */
+export function configExport(data: Partial<SysConfig>) {
+  return commonExport(Api.configExport, data);
+}
+
+/**
+ * 刷新缓存
+ * @returns void
+ */
+export function configRefreshCache() {
+  return requestClient.deleteWithMsg<void>(Api.configRefreshCache);
+}
+
+/**
+ * 更新系统配置
+ * @param data 参数
+ */
+export function configUpdate(data: Partial<SysConfig>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 新增系统配置
+ * @param data 参数
+ */
+export function configAdd(data: Partial<SysConfig>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 删除配置
+ * @param configIds ids
+ */
+export function configRemove(configIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: configIds.join(',') },
+  });
+}
+
+/**
+ * 获取配置信息
+ * @param configKey configKey
+ * @returns value
+ */
+export function configInfoByKey(configKey: string) {
+  return requestClient.get<string>(`${Api.configInfoByKey}/${configKey}`);
+}
+export interface SysConfig {
+  id: string;
+  configName: string;
+  configKey: string;
+  configValue: string;
+  configType: string | null;
+  orderNum: number;
+  remark: string | null;
+  isDeleted: boolean;
+  creationTime: string;
+  creatorId: string | null;
+  lastModifierId: string | null;
+  lastModificationTime: string | null;
+}
+import type { Dept } from './model';
+
+import type { ID } from '#/api/common';
+
+import { requestClient } from '#/api/request';
+
+enum Api {
+  deptList = '/dept/list',
+  deptNodeInfo = '/dept/list/exclude',
+  root = '/dept',
+}
+
+/**
+ * 部门列表
+ * @returns list
+ */
+export function deptList(params?: { deptName?: string; status?: string }) {
+  return requestClient.get<Dept[]>(Api.deptList, { params });
+}
+
+/**
+ * 查询部门列表（排除节点）
+ * @param deptId 部门ID
+ * @returns void
+ */
+export function deptNodeList(deptId: ID) {
+  return requestClient.get<Dept[]>(`${Api.deptNodeInfo}/${deptId}`);
+}
+
+/**
+ * 部门详情
+ * @param deptId 部门id
+ * @returns 部门信息
+ */
+export function deptInfo(deptId: ID) {
+  return requestClient.get<Dept>(`${Api.root}/${deptId}`);
+}
+
+/**
+ * 部门新增
+ * @param data 参数
+ */
+export function deptAdd(data: Partial<Dept>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 部门更新
+ * @param data 参数
+ */
+export function deptUpdate(data: Partial<Dept>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 注意这里只允许单删除
+ * @param deptId ID
+ * @returns void
+ */
+export function deptRemove(deptId: ID) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: deptId },
+  });
+}
+export interface Dept {
+  creationTime: string;
+  creatorId?: string | null;
+  state: boolean;
+  deptName: string;
+  deptCode?: string;
+  leader?: string;
+  leaderName?: string;
+  parentId: string | null;
+  remark?: string;
+  orderNum: number;
+  id: string;
+  children?: Dept[];
+}
+export interface DictData {
+  id: string;
+  isDeleted: boolean;
+  orderNum: number;
+  state: boolean;
+  remark: string | null;
+  listClass: string | null;
+  cssClass: string | null;
+  dictType: string;
+  dictLabel: string | null;
+  dictValue: string;
+  isDefault: boolean;
+  creationTime: string;
+  creatorId: string | null;
+  lastModifierId: string | null;
+  lastModificationTime: string | null;
+}
+import type { DictData } from './dict-data-model';
+
+import type { ID, IDS, PageQuery } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  dictDataExport = '/dict/data/export',
+  dictDataInfo = '/dictionary/dic-type',
+  dictDataList = '/dict/data/list',
+  root = '/dictionary',
+}
+
+/**
+ * 主要是DictTag组件使用
+ * @param dictType 字典类型
+ * @returns 字典数据
+ */
+export function dictDataInfo(dictType: string) {
+  return requestClient.get<DictData[]>(`${Api.dictDataInfo}/${dictType}`);
+}
+
+/**
+ * 字典数据
+ * @param params 查询参数
+ * @returns 字典数据列表
+ */
+export function dictDataList(params?: PageQuery) {
+  return requestClient.get<DictData[]>(Api.root, { params });
+}
+
+/**
+ * 导出字典数据
+ * @param data 表单参数
+ * @returns blob
+ */
+export function dictDataExport(data: Partial<DictData>) {
+  return commonExport(Api.dictDataExport, data);
+}
+
+/**
+ * 删除
+ * @param dictIds 字典ID Array
+ * @returns void
+ */
+export function dictDataRemove(dictIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: dictIds.join(',') },
+  });
+}
+
+/**
+ * 新增
+ * @param data 表单参数
+ * @returns void
+ */
+export function dictDataAdd(data: Partial<DictData>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 修改
+ * @param data 表单参数
+ * @returns void
+ */
+export function dictDataUpdate(data: Partial<DictData>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 查询字典数据详细
+ * @param id 字典ID
+ * @returns 字典数据
+ */
+export function dictDetailInfo(id: ID) {
+  return requestClient.get<DictData>(`${Api.root}/${id}`);
+}
+export interface DictType {
+  id: string;
+  isDeleted: boolean;
+  orderNum: number;
+  state: boolean | null;
+  dictName: string;
+  dictType: string;
+  remark: string | null;
+  creationTime: string;
+  creatorId: string | null;
+  lastModifierId: string | null;
+  lastModificationTime: string | null;
+}
+import type { DictType } from './dict-type-model';
+
+import type { ID, IDS, PageQuery, PageResult } from '#/api/common';
+
+import { commonExport } from '#/api/helper';
+import { requestClient } from '#/api/request';
+
+enum Api {
+  dictOptionSelectList = '/dictionary-type/select-data-list',
+  dictTypeExport = '/dictionary-type/export',
+  dictTypeList = '/dictionary-type/list',
+  dictTypeRefreshCache = '/dictionary-type/refreshCache',
+  root = '/dictionary-type',
+}
+
+/**
+ * 获取字典类型列表
+ * @param params 请求参数
+ * @returns list
+ */
+export function dictTypeList(params?: PageQuery) {
+  return requestClient.get<PageResult<DictType>>(Api.root, { params });
+}
+
+/**
+ * 导出字典类型列表
+ * @param data 表单参数
+ * @returns blob
+ */
+export function dictTypeExport(data: Partial<DictType>) {
+  return commonExport(Api.dictTypeExport, data);
+}
+
+/**
+ * 删除字典类型
+ * @param dictIds 字典类型id数组
+ * @returns void
+ */
+export function dictTypeRemove(dictIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: dictIds.join(',') },
+  });
+}
+
+/**
+ * 刷新字典缓存
+ * @returns void
+ */
+export function refreshDictTypeCache() {
+  return requestClient.deleteWithMsg<void>(Api.dictTypeRefreshCache);
+}
+
+/**
+ * 新增
+ * @param data 表单参数
+ * @returns void
+ */
+export function dictTypeAdd(data: Partial<DictType>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 修改
+ * @param data 表单参数
+ * @returns void
+ */
+export function dictTypeUpdate(data: Partial<DictType>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 查询详情
+ * @param dictId 字典类型id
+ * @returns 信息
+ */
+export function dictTypeInfo(dictId: ID) {
+  return requestClient.get<DictType>(`${Api.root}/${dictId}`);
+}
+
+/**
+ * 这个在ele用到 v5用不上
+ * 下拉框  返回值和list一样
+ * @returns options
+ */
+export function dictOptionSelectList() {
+  return requestClient.get<DictType[]>(Api.dictOptionSelectList);
+}
+import type { Menu, MenuOption, MenuQuery, MenuResp } from './model';
+
+import type { ID, IDS } from '#/api/common';
+
+import { requestClient } from '#/api/request';
+
+enum Api {
+  menuList = '/menu/list',
+  menuTreeSelect = '/menu/tree',
+  root = '/menu',
+  tenantPackageMenuTreeselect = '/menu/tenantPackageMenuTreeselect',
+}
+
+/**
+ * 菜单列表
+ * @param params 参数
+ * @returns 列表
+ */
+export function menuList(params?: MenuQuery) {
+  return requestClient.get<Menu[]>(Api.menuList, { params });
+}
+
+/**
+ * 菜单详情
+ * @param menuId 菜单id
+ * @returns 菜单详情
+ */
+export function menuInfo(menuId: ID) {
+  return requestClient.get<Menu>(`${Api.root}/${menuId}`);
+}
+
+/**
+ * 菜单新增
+ * @param data 参数
+ */
+export function menuAdd(data: Partial<Menu>) {
+  return requestClient.postWithMsg<void>(Api.root, data);
+}
+
+/**
+ * 菜单更新
+ * @param data 参数
+ */
+export function menuUpdate(data: Partial<Menu>) {
+  return requestClient.putWithMsg<void>(`${Api.root}/${data.id}`, data);
+}
+
+/**
+ * 菜单删除
+ * @param menuIds ids
+ */
+export function menuRemove(menuIds: IDS) {
+  return requestClient.deleteWithMsg<void>(Api.root, {
+    params: { ids: menuIds.join(',') },
+  });
+}
+
+/**
+ * 下拉框使用  返回所有的菜单
+ * @returns []
+ */
+export function menuTreeSelect() {
+  return requestClient.get<MenuOption[]>(Api.menuTreeSelect);
+}
+
+/**
+ * 租户套餐使用
+ * @param packageId packageId
+ * @returns resp
+ */
+export function tenantPackageMenuTreeSelect(packageId: ID) {
+  return requestClient.get<MenuResp>(
+    `${Api.tenantPackageMenuTreeselect}/${packageId}`,
+  );
+}
+
+/**
+ * 批量删除菜单
+ * @param menuIds 菜单ids
+ * @returns void
+ */
+export function menuCascadeRemove(menuIds: IDS) {
+  return requestClient.deleteWithMsg<void>(`${Api.root}/cascade/${menuIds}`);
+}