refactor: ♻️ aPI 路径基础 URL 提取

src/api/dept/index.ts

@@ -1,38 +1,44 @@
 import request from "@/utils/request";
 import { DeptForm, DeptQuery, DeptVO } from "./model";
 
+const DEPT_BASE_URL = "/api/v1/dept";
+
 class DeptAPI {
   /**
-   * 部门树形表格
+   * 获取部门树形表格列表
    *
-   * @param queryParams
+   * @param queryParams 查询参数（可选）
+   * @returns 部门树形表格数据
    */
   static getList(queryParams?: DeptQuery) {
     return request<any, DeptVO[]>({
-      url: "/api/v1/dept",
+      url: `${DEPT_BASE_URL}`,
       method: "get",
       params: queryParams,
     });
   }
 
   /**
-   * 部门下拉列表
+   * 获取部门下拉列表选项
+   *
+   * @returns 部门下拉列表选项
    */
   static getOptions() {
     return request<any, OptionType[]>({
-      url: "/api/v1/dept/options",
+      url: `${DEPT_BASE_URL}/options`,
       method: "get",
     });
   }
 
   /**
-   * 获取部门详情
+   * 获取部门详情表单数据
    *
-   * @param id
+   * @param id 部门ID
+   * @returns 部门详情表单数据
    */
   static getFormData(id: number) {
     return request<any, DeptForm>({
-      url: "/api/v1/dept/" + id + "/form",
+      url: `${DEPT_BASE_URL}/${id}/form`,
       method: "get",
     });
   }
@@ -40,25 +46,27 @@ class DeptAPI {
   /**
    * 新增部门
    *
-   * @param data
+   * @param data 部门表单数据
+   * @returns 请求结果
    */
   static add(data: DeptForm) {
     return request({
-      url: "/api/v1/dept",
+      url: `${DEPT_BASE_URL}`,
       method: "post",
       data: data,
     });
   }
 
   /**
-   *  修改部门
+   * 修改部门
    *
-   * @param id
-   * @param data
+   * @param id 部门ID
+   * @param data 部门表单数据
+   * @returns 请求结果
    */
   static update(id: number, data: DeptForm) {
     return request({
-      url: "/api/v1/dept/" + id,
+      url: `${DEPT_BASE_URL}/${id}`,
       method: "put",
       data: data,
     });
@@ -67,11 +75,12 @@ class DeptAPI {
   /**
    * 删除部门
    *
-   * @param ids
+   * @param ids 部门ID，多个以英文逗号(,)分隔
+   * @returns 请求结果
    */
   static deleteByIds(ids: string) {
     return request({
-      url: "/api/v1/dept/" + ids,
+      url: `${DEPT_BASE_URL}/${ids}`,
       method: "delete",
     });
   }