first commiit

2025-02-08 10:15:06 +08:00
parent 6815bd083b
commit 262bf41379
242 changed files with 19959 additions and 1 deletions
--- a/src/api/auth/index.ts
+++ b/src/api/auth/index.ts
@@ -0,0 +1,84 @@
+import request from "@/utils/request";
+
+const AUTH_BASE_URL = "/api/v1/auth";
+
+const AuthAPI = {
+  /** 登录接口*/
+  login(data: LoginFormData) {
+    const formData = new FormData();
+    formData.append("username", data.username);
+    formData.append("password", data.password);
+    formData.append("captchaKey", data.captchaKey);
+    formData.append("captchaCode", data.captchaCode);
+    return request<any, LoginResult>({
+      url: `${AUTH_BASE_URL}/login`,
+      method: "post",
+      data: formData,
+      headers: {
+        "Content-Type": "multipart/form-data",
+      },
+    });
+  },
+
+  /** 刷新 token 接口*/
+  refreshToken(refreshToken: string) {
+    return request<any, LoginResult>({
+      url: `${AUTH_BASE_URL}/refresh-token`,
+      method: "post",
+      params: { refreshToken: refreshToken },
+      headers: {
+        Authorization: "no-auth",
+      },
+    });
+  },
+
+  /** 注销登录接口 */
+  logout() {
+    return request({
+      url: `${AUTH_BASE_URL}/logout`,
+      method: "delete",
+    });
+  },
+
+  /** 获取验证码接口*/
+  getCaptcha() {
+    return request<any, CaptchaInfo>({
+      url: `${AUTH_BASE_URL}/captcha`,
+      method: "get",
+    });
+  },
+};
+
+export default AuthAPI;
+
+/** 登录表单数据 */
+export interface LoginFormData {
+  /** 用户名 */
+  username: string;
+  /** 密码 */
+  password: string;
+  /** 验证码缓存key */
+  captchaKey: string;
+  /** 验证码 */
+  captchaCode: string;
+}
+
+/** 登录响应 */
+export interface LoginResult {
+  /** 访问令牌 */
+  accessToken: string;
+  /** 刷新令牌 */
+  refreshToken: string;
+  /** 令牌类型 */
+  tokenType: string;
+  /** 过期时间(秒) */
+  expiresIn: number;
+}
+
+/** 验证码信息 */
+export interface CaptchaInfo {
+  /** 验证码缓存key */
+  captchaKey: string;
+  /** 验证码图片Base64字符串 */
+  captchaBase64: string;
+}
--- a/src/api/codegen/index.ts
+++ b/src/api/codegen/index.ts
@@ -0,0 +1,191 @@
+import request from "@/utils/request";
+
+const GENERATOR_BASE_URL = "/api/v1/codegen";
+
+const GeneratorAPI = {
+  /** 获取数据表分页列表 */
+  getTablePage(params: TablePageQuery) {
+    return request<any, PageResult<TablePageVO[]>>({
+      url: `${GENERATOR_BASE_URL}/table/page`,
+      method: "get",
+      params: params,
+    });
+  },
+
+  /** 获取代码生成配置 */
+  getGenConfig(tableName: string) {
+    return request<any, GenConfigForm>({
+      url: `${GENERATOR_BASE_URL}/${tableName}/config`,
+      method: "get",
+    });
+  },
+
+  /** 获取代码生成配置 */
+  saveGenConfig(tableName: string, data: GenConfigForm) {
+    return request({
+      url: `${GENERATOR_BASE_URL}/${tableName}/config`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /** 获取代码生成预览数据 */
+  getPreviewData(tableName: string) {
+    return request<any, GeneratorPreviewVO[]>({
+      url: `${GENERATOR_BASE_URL}/${tableName}/preview`,
+      method: "get",
+    });
+  },
+
+  /** 重置代码生成配置 */
+  resetGenConfig(tableName: string) {
+    return request({
+      url: `${GENERATOR_BASE_URL}/${tableName}/config`,
+      method: "delete",
+    });
+  },
+
+  /**
+   * 下载 ZIP 文件
+   * @param url
+   * @param fileName
+   */
+  download(tableName: string) {
+    return request({
+      url: `${GENERATOR_BASE_URL}/${tableName}/download`,
+      method: "get",
+      responseType: "blob",
+    }).then((response) => {
+      const fileName = decodeURI(
+        response.headers["content-disposition"].split(";")[1].split("=")[1]
+      );
+
+      const blob = new Blob([response.data], { type: "application/zip" });
+      const a = document.createElement("a");
+      const url = window.URL.createObjectURL(blob);
+      a.href = url;
+      a.download = fileName;
+      a.click();
+      window.URL.revokeObjectURL(url);
+    });
+  },
+};
+
+export default GeneratorAPI;
+
+/** 代码生成预览对象 */
+export interface GeneratorPreviewVO {
+  /** 文件生成路径 */
+  path: string;
+  /** 文件名称 */
+  fileName: string;
+  /** 文件内容 */
+  content: string;
+}
+
+/**  数据表分页查询参数 */
+export interface TablePageQuery extends PageQuery {
+  /** 关键字(表名) */
+  keywords?: string;
+}
+
+/** 数据表分页对象 */
+export interface TablePageVO {
+  /** 表名称 */
+  tableName: string;
+
+  /** 表描述 */
+  tableComment: string;
+
+  /** 存储引擎 */
+  engine: string;
+
+  /** 字符集排序规则 */
+  tableCollation: string;
+
+  /** 创建时间 */
+  createTime: string;
+}
+
+/** 代码生成配置表单 */
+export interface GenConfigForm {
+  /** 主键 */
+  id?: number;
+
+  /** 表名 */
+  tableName?: string;
+
+  /** 业务名 */
+  businessName?: string;
+
+  /** 模块名 */
+  moduleName?: string;
+
+  /** 包名 */
+  packageName?: string;
+
+  /** 实体名 */
+  entityName?: string;
+
+  /** 作者 */
+  author?: string;
+
+  /** 上级菜单 */
+  parentMenuId?: number;
+
+  /** 后端应用名 */
+  backendAppName?: string;
+  /** 前端应用名 */
+  frontendAppName?: string;
+
+  /** 字段配置列表 */
+  fieldConfigs?: FieldConfig[];
+}
+
+/** 字段配置 */
+export interface FieldConfig {
+  /** 主键 */
+  id?: number;
+
+  /** 列名 */
+  columnName?: string;
+
+  /** 列类型 */
+  columnType?: string;
+
+  /** 字段名 */
+  fieldName?: string;
+
+  /** 字段类型 */
+  fieldType?: string;
+
+  /** 字段描述 */
+  fieldComment?: string;
+
+  /** 是否在列表显示 */
+  isShowInList?: number;
+
+  /** 是否在表单显示 */
+  isShowInForm?: number;
+
+  /** 是否在查询条件显示 */
+  isShowInQuery?: number;
+
+  /** 是否必填 */
+  isRequired?: number;
+
+  /** 表单类型 */
+  formType?: number;
+
+  /** 查询类型 */
+  queryType?: number;
+
+  /** 字段长度 */
+  maxLength?: number;
+
+  /** 字段排序 */
+  fieldSort?: number;
+
+  /** 字典类型 */
+  dictType?: string;
+}
--- a/src/api/coup/index.js
+++ b/src/api/coup/index.js
@@ -0,0 +1,205 @@
+// 代客下单
+import request from "@/utils/request-php";
+import { getToken } from '@/utils/auth'
+function getLoginName() {
+    const obj = localStorage.getItem("userInfo") || '';
+    const { username } = obj ? JSON.parse(obj) : {};
+    return username
+}
+// 抖音团购核销准备
+export function $douyin_fulfilmentcertificateprepare(data) {
+    return request({
+        url: 'douyin/fulfilmentcertificateprepare',
+        method: "post",
+        data: {
+            ...data
+        }
+    });
+}
+// 抖音团购核销
+export function $douyin_certificateprepare(data) {
+    return request({
+        url: 'douyin/certificateprepare',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+// 抖音团购核销撤销
+export function $douyin_fulfilmentcertificatecancel(data) {
+    return request({
+        url: 'douyin/fulfilmentcertificatecancel',
+        method: "post",
+        data: {
+            ...data
+        }
+    });
+}
+// 抖音团购核销记录
+export function $douyin_orderlist(data) {
+    return request({
+        url: 'douyin/orderlist',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+
+// 抖音门店列表
+export function $douyin_storelist(data) {
+    return request({
+        url: 'douyin/storelist',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+// 抖音绑定门店
+export function $douyin_bindstore(data) {
+    return request({
+        url: 'douyin/bindstore',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+// 抖音订单查询
+
+export function $douyin_orderquery(data) {
+    return request({
+        url: 'douyin/orderquery',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+//会员签入
+export function $douyin_checkIn(data) {
+    return request({
+        url: 'douyin/checkIn',
+        method: "post",
+        data: {
+            clientType: 'ADMIN',
+            token: getToken(),
+            loginName: getLoginName(),
+
+            ...data
+        }
+    });
+}
+
+//美团
+
+// 美团获取uisdk 绑定 链接
+
+export function $meituan_getuisdkurl(data) {
+    return request({
+        url: 'meituan/getuisdkurl',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+// 美团获取uisdk 解绑 链接
+
+export function $meituan_getuisdkuniurl(data) {
+    return request({
+        url: 'meituan/getuisdkuniurl',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+// 美团团购核销准备
+
+export function $meituan_fulfilmentcertificateprepare(data) {
+    return request({
+        url: 'meituan/fulfilmentcertificateprepare',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+// 美团执行核销
+
+export function $meituan_certificateprepare(data) {
+    return request({
+        url: 'meituan/certificateprepare',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+// 美团团购核销记录
+
+
+export function $meituan_orderlist(data) {
+    return request({
+        url: 'meituan/orderlist',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+// 美团团购撤销
+
+
+export function $meituan_fulfilmentcertificatecancel(data) {
+    return request({
+        url: 'meituan/fulfilmentcertificatecancel',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+// 美团查询绑定状态
+export function $meituan_searchstorestatus(data) {
+    return request({
+        url: 'meituan/searchstorestatus',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
+// 登出
+export function $logout(data) {
+    return request({
+        url: 'user/logout',
+        method: "post",
+        data: {
+
+            ...data
+        }
+    });
+}
+
--- a/src/api/file/index.ts
+++ b/src/api/file/index.ts
@@ -0,0 +1,81 @@
+import request from "@/utils/request";
+
+const FileAPI = {
+  /**
+   * 上传文件
+   *
+   * @param formData
+   */
+  upload(formData: FormData) {
+    return request<any, FileInfo>({
+      url: "/api/v1/files",
+      method: "post",
+      data: formData,
+      headers: {
+        "Content-Type": "multipart/form-data",
+      },
+    });
+  },
+
+  /**
+   * 上传文件
+   */
+  uploadFile(file: File) {
+    const formData = new FormData();
+    formData.append("file", file);
+    return request<any, FileInfo>({
+      url: "/api/v1/files",
+      method: "post",
+      data: formData,
+      headers: {
+        "Content-Type": "multipart/form-data",
+      },
+    });
+  },
+
+  /**
+   * 删除文件
+   *
+   * @param filePath 文件完整路径
+   */
+  delete(filePath?: string) {
+    return request({
+      url: "/api/v1/files",
+      method: "delete",
+      params: { filePath: filePath },
+    });
+  },
+
+  /**
+   * 下载文件
+   * @param url
+   * @param fileName
+   */
+  download(url: string, fileName?: string) {
+    return request({
+      url: url,
+      method: "get",
+      responseType: "blob",
+    }).then((res) => {
+      const blob = new Blob([res.data]);
+      const a = document.createElement("a");
+      const url = window.URL.createObjectURL(blob);
+      a.href = url;
+      a.download = fileName || "下载文件";
+      a.click();
+      window.URL.revokeObjectURL(url);
+    });
+  },
+};
+
+export default FileAPI;
+
+/**
+ * 文件API类型声明
+ */
+export interface FileInfo {
+  /** 文件名 */
+  name: string;
+  /** 文件路径 */
+  url: string;
+}
--- a/src/api/login.js
+++ b/src/api/login.js
@@ -0,0 +1,58 @@
+import request from "@/utils/request";
+
+export function login(data) {
+  return request({
+    url: "auth/login",
+    method: "post",
+    data,
+  });
+}
+
+export function getInfo() {
+  return request({
+    url: "auth/info",
+    method: "get",
+  });
+}
+
+export function changChildShop(data) {
+  return request({
+    url: "/api/tbShopInfo/changChildShop",
+    method: "post",
+    data,
+  });
+}
+
+export function getCodeImg(header) {
+  return request({
+    url: "auth/code",
+    method: "get",
+  });
+}
+export function getqueryChildShop(params) {
+  return request({
+    url: "api/tbShopInfo/queryChildShop",
+    method: "get",
+    params,
+  });
+}
+
+export function logout() {
+  return request({
+    url: "auth/logout",
+    method: "delete",
+  });
+}
+
+/**
+ * 个人中心 修改密码
+ * @param {*} data
+ * @returns
+ */
+export function updatePass(data) {
+  return request({
+    url: "/api/users/updatePass",
+    method: "post",
+    data,
+  });
+}
--- a/src/api/system/config.ts
+++ b/src/api/system/config.ts
@@ -0,0 +1,104 @@
+import request from "@/utils/request";
+
+const CONFIG_BASE_URL = "/api/v1/config";
+
+const ConfigAPI = {
+  /** 获取系统配置分页数据 */
+  getPage(queryParams?: ConfigPageQuery) {
+    return request<any, PageResult<ConfigPageVO[]>>({
+      url: `${CONFIG_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+  /**
+   * 获取系统配置表单数据
+   *
+   * @param id ConfigID
+   * @returns Config表单数据
+   */
+  getFormData(id: number) {
+    return request<any, ConfigForm>({
+      url: `${CONFIG_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /** 添加系统配置*/
+  add(data: ConfigForm) {
+    return request({
+      url: `${CONFIG_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 更新系统配置
+   *
+   * @param id ConfigID
+   * @param data Config表单数据
+   */
+  update(id: number, data: ConfigForm) {
+    return request({
+      url: `${CONFIG_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 删除系统配置
+   *
+   * @param ids 系统配置ID
+   */
+  deleteById(id: number) {
+    return request({
+      url: `${CONFIG_BASE_URL}/${id}`,
+      method: "delete",
+    });
+  },
+
+  refreshCache() {
+    return request({
+      url: `${CONFIG_BASE_URL}/refresh`,
+      method: "PUT",
+    });
+  },
+};
+
+export default ConfigAPI;
+
+/** $系统配置分页查询参数 */
+export interface ConfigPageQuery extends PageQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+}
+
+/** 系统配置表单对象 */
+export interface ConfigForm {
+  /** 主键 */
+  id?: number;
+  /** 配置名称 */
+  configName?: string;
+  /** 配置键 */
+  configKey?: string;
+  /** 配置值 */
+  configValue?: string;
+  /** 描述、备注 */
+  remark?: string;
+}
+
+/** 系统配置分页对象 */
+export interface ConfigPageVO {
+  /** 主键 */
+  id?: number;
+  /** 配置名称 */
+  configName?: string;
+  /** 配置键 */
+  configKey?: string;
+  /** 配置值 */
+  configValue?: string;
+  /** 描述、备注 */
+  remark?: string;
+}
--- a/src/api/system/dept.ts
+++ b/src/api/system/dept.ts
@@ -0,0 +1,130 @@
+import request from "@/utils/request";
+
+const DEPT_BASE_URL = "/api/v1/dept";
+
+const DeptAPI = {
+  /**
+   * 获取部门列表
+   *
+   * @param queryParams 查询参数（可选）
+   * @returns 部门树形表格数据
+   */
+  getList(queryParams?: DeptQuery) {
+    return request<any, DeptVO[]>({
+      url: `${DEPT_BASE_URL}`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /** 获取部门下拉列表 */
+  getOptions() {
+    return request<any, OptionType[]>({
+      url: `${DEPT_BASE_URL}/options`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 获取部门表单数据
+   *
+   * @param id 部门ID
+   * @returns 部门表单数据
+   */
+  getFormData(id: number) {
+    return request<any, DeptForm>({
+      url: `${DEPT_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 新增部门
+   *
+   * @param data 部门表单数据
+   * @returns 请求结果
+   */
+  add(data: DeptForm) {
+    return request({
+      url: `${DEPT_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改部门
+   *
+   * @param id 部门ID
+   * @param data 部门表单数据
+   * @returns 请求结果
+   */
+  update(id: string, data: DeptForm) {
+    return request({
+      url: `${DEPT_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 删除部门
+   *
+   * @param ids 部门ID，多个以英文逗号(,)分隔
+   * @returns 请求结果
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${DEPT_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+};
+
+export default DeptAPI;
+
+/** 部门查询参数 */
+export interface DeptQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+  /** 状态 */
+  status?: number;
+}
+
+/** 部门类型 */
+export interface DeptVO {
+  /** 子部门 */
+  children?: DeptVO[];
+  /** 创建时间 */
+  createTime?: Date;
+  /** 部门ID */
+  id?: number;
+  /** 部门名称 */
+  name?: string;
+  /** 部门编号 */
+  code?: string;
+  /** 父部门ID */
+  parentId?: number;
+  /** 排序 */
+  sort?: number;
+  /** 状态(1:启用；0:禁用) */
+  status?: number;
+  /** 修改时间 */
+  updateTime?: Date;
+}
+
+/** 部门表单类型 */
+export interface DeptForm {
+  /** 部门ID(新增不填) */
+  id?: string;
+  /** 部门名称 */
+  name?: string;
+  /** 部门编号 */
+  code?: string;
+  /** 父部门ID */
+  parentId: string;
+  /** 排序 */
+  sort?: number;
+  /** 状态(1:启用；0：禁用) */
+  status?: number;
+}
--- a/src/api/system/dict-data.ts
+++ b/src/api/system/dict-data.ts
@@ -0,0 +1,162 @@
+import request from "@/utils/request";
+
+const DICT_DATA_BASE_URL = "/api/v1/dict-data";
+
+const DictDataAPI = {
+  /**
+   * 获取字典分页列表
+   *
+   * @param queryParams 查询参数
+   * @returns 字典分页结果
+   */
+  getPage(queryParams: DictDataPageQuery) {
+    return request<any, PageResult<DictDataPageVO[]>>({
+      url: `${DICT_DATA_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取字典数据表单
+   *
+   * @param id 字典ID
+   * @returns 字典数据表单
+   */
+  getFormData(id: number) {
+    return request<any, ResponseData<DictDataForm>>({
+      url: `${DICT_DATA_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 新增字典数据
+   *
+   * @param data 字典数据
+   */
+  add(data: DictDataForm) {
+    return request({
+      url: `${DICT_DATA_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改字典数据
+   *
+   * @param id 字典ID
+   * @param data 字典数据
+   */
+  update(id: number, data: DictDataForm) {
+    return request({
+      url: `${DICT_DATA_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 删除字典
+   *
+   * @param ids 字典ID，多个以英文逗号(,)分隔
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${DICT_DATA_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+
+  /**
+   * 获取字典的数据项
+   *
+   * @param dictCode 字典编码
+   * @returns 字典数据项
+   */
+  getOptions(dictCode: string) {
+    return request<any, OptionType[]>({
+      url: `${DICT_DATA_BASE_URL}/${dictCode}/options`,
+      method: "get",
+    });
+  },
+};
+
+export default DictDataAPI;
+
+/**
+ * 字典查询参数
+ */
+export interface DictDataPageQuery extends PageQuery {
+  /** 关键字(字典数据值/标签) */
+  keywords?: string;
+
+  /** 字典编码 */
+  dictCode?: string;
+}
+
+/**
+ * 字典分页对象
+ */
+export interface DictDataPageVO {
+  /**
+   * 字典ID
+   */
+  id: number;
+  /**
+   * 字典编码
+   */
+  dictCode: string;
+  /**
+   * 字典数据值
+   */
+  value: string;
+  /**
+   * 字典数据标签
+   */
+  label: string;
+  /**
+   * 状态（1:启用，0:禁用)
+   */
+  status: number;
+  /**
+   * 字典排序
+   */
+  sort?: number;
+}
+
+/**
+ * 字典
+ */
+export interface DictDataForm {
+  /**
+   * 字典ID
+   */
+  id?: number;
+  /**
+   * 字典编码
+   */
+  dictCode?: string;
+  /**
+   * 字典数据值
+   */
+  value?: string;
+  /**
+   * 字典数据标签
+   */
+  label?: string;
+  /**
+   * 状态（1:启用，0:禁用)
+   */
+  status?: number;
+  /**
+   * 字典排序
+   */
+  sort?: number;
+
+  /**
+   * 标签类型
+   */
+  tagType?: "success" | "warning" | "info" | "primary" | "danger" | undefined;
+}
--- a/src/api/system/dict.ts
+++ b/src/api/system/dict.ts
@@ -0,0 +1,180 @@
+import request from "@/utils/request";
+
+const DICT_BASE_URL = "/api/v1/dict";
+
+const DictAPI = {
+  /**
+   * 获取字典分页列表
+   *
+   * @param queryParams 查询参数
+   * @returns 字典分页结果
+   */
+  getPage(queryParams: DictPageQuery) {
+    return request<any, PageResult<DictPageVO[]>>({
+      url: `${DICT_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取字典表单数据
+   *
+   * @param id 字典ID
+   * @returns 字典表单数据
+   */
+  getFormData(id: number) {
+    return request<any, ResponseData<DictForm>>({
+      url: `${DICT_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 新增字典
+   *
+   * @param data 字典表单数据
+   */
+  add(data: DictForm) {
+    return request({
+      url: `${DICT_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改字典
+   *
+   * @param id 字典ID
+   * @param data 字典表单数据
+   */
+  update(id: number, data: DictForm) {
+    return request({
+      url: `${DICT_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 删除字典
+   *
+   * @param ids 字典ID，多个以英文逗号(,)分隔
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${DICT_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+
+  /**
+   * 获取字典列表
+   *
+   * @returns 字典列表
+   */
+  getList() {
+    return request<any, DictVO[]>({
+      url: `${DICT_BASE_URL}/list`,
+      method: "get",
+    });
+  },
+};
+
+export default DictAPI;
+
+/**
+ * 字典查询参数
+ */
+export interface DictPageQuery extends PageQuery {
+  /**
+   * 关键字(字典名称/编码)
+   */
+  keywords?: string;
+
+  /**
+   * 字典状态（1:启用，0:禁用）
+   */
+  status?: number;
+}
+
+/**
+ * 字典分页对象
+ */
+export interface DictPageVO {
+  /**
+   * 字典ID
+   */
+  id: number;
+  /**
+   * 字典名称
+   */
+  name: string;
+  /**
+   * 字典编码
+   */
+  dictCode: string;
+  /**
+   * 字典状态（1:启用，0:禁用）
+   */
+  status: number;
+}
+
+/**
+ * 字典
+ */
+export interface DictForm {
+  /**
+   * 字典ID
+   */
+  id?: number;
+  /**
+   * 字典名称
+   */
+  name?: string;
+  /**
+   * 字典编码
+   */
+  dictCode?: string;
+  /**
+   * 字典状态（1-启用，0-禁用）
+   */
+  status?: number;
+  /**
+   * 备注
+   */
+  remark?: string;
+}
+
+/**
+ * 字典数据项分页VO
+ *
+ * @description 字典数据分页对象
+ */
+export interface DictVO {
+  /** 字典名称 */
+  name: string;
+
+  /** 字典编码 */
+  dictCode: string;
+
+  /** 字典数据集合 */
+  dictDataList: DictData[];
+}
+
+/**
+ * 字典数据
+ *
+ * @description 字典数据
+ */
+export interface DictData {
+  /** 字典数据值 */
+  value: string;
+
+  /** 字典数据标签 */
+  label: string;
+
+  /** 标签类型 */
+  tagType: string;
+}
--- a/src/api/system/log.ts
+++ b/src/api/system/log.ts
@@ -0,0 +1,121 @@
+import request from "@/utils/request";
+
+const LOG_BASE_URL = "/api/v1/logs";
+
+const LogAPI = {
+  /**
+   * 获取日志分页列表
+   *
+   * @param queryParams 查询参数
+   */
+  getPage(queryParams: LogPageQuery) {
+    return request<any, PageResult<LogPageVO[]>>({
+      url: `${LOG_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取访问趋势
+   *
+   * @param queryParams
+   * @returns
+   */
+  getVisitTrend(queryParams: VisitTrendQuery) {
+    return request<any, VisitTrendVO>({
+      url: `${LOG_BASE_URL}/visit-trend`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取访问统计
+   *
+   * @param queryParams
+   * @returns
+   */
+  getVisitStats() {
+    return request<any, VisitStatsVO>({
+      url: `${LOG_BASE_URL}/visit-stats`,
+      method: "get",
+    });
+  },
+};
+
+export default LogAPI;
+
+/**
+ * 日志分页查询对象
+ */
+export interface LogPageQuery extends PageQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+  /** 操作时间 */
+  createTime?: [string, string];
+}
+
+/**
+ * 系统日志分页VO
+ */
+export interface LogPageVO {
+  /** 主键 */
+  id: number;
+  /** 日志模块 */
+  module: string;
+  /** 日志内容 */
+  content: string;
+  /** 请求路径 */
+  requestUri: string;
+  /** 请求方法 */
+  method: string;
+  /** IP 地址 */
+  ip: string;
+  /** 地区 */
+  region: string;
+  /** 浏览器 */
+  browser: string;
+  /** 终端系统 */
+  os: string;
+  /** 执行时间(毫秒) */
+  executionTime: number;
+  /** 操作人 */
+  operator: string;
+}
+
+/**  访问趋势视图对象 */
+export interface VisitTrendVO {
+  /** 日期列表 */
+  dates: string[];
+  /** 浏览量(PV) */
+  pvList: number[];
+  /** 访客数(UV) */
+  uvList: number[];
+  /** IP数 */
+  ipList: number[];
+}
+
+/** 访问趋势查询参数 */
+export interface VisitTrendQuery {
+  /** 开始日期 */
+  startDate: string;
+  /** 结束日期 */
+  endDate: string;
+}
+
+/**  访问统计 */
+export interface VisitStatsVO {
+  /** 今日访客数(UV) */
+  todayUvCount: number;
+  /** 总访客数 */
+  totalUvCount: number;
+  /** 访客数同比增长率（相对于昨天同一时间段的增长率） */
+  uvGrowthRate: number;
+  /** 今日浏览量(PV) */
+  todayPvCount: number;
+  /** 总浏览量 */
+  totalPvCount: number;
+  /** 同比增长率（相对于昨天同一时间段的增长率） */
+  pvGrowthRate: number;
+}
--- a/src/api/system/menu.ts
+++ b/src/api/system/menu.ts
@@ -0,0 +1,209 @@
+import request from "@/utils/request";
+// 菜单基础URL
+const MENU_BASE_URL = "/api/v1/menus";
+
+const MenuAPI = {
+  /**
+   * 获取当前用户的路由列表
+   * <p/>
+   * 无需传入角色，后端解析token获取角色自行判断是否拥有路由的权限
+   *
+   * @returns 路由列表
+   */
+  getRoutes() {
+    return request<any, RouteVO[]>({
+      url: `${MENU_BASE_URL}/routes`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 获取菜单树形列表
+   *
+   * @param queryParams 查询参数
+   * @returns 菜单树形列表
+   */
+  getList(queryParams: MenuQuery) {
+    return request<any, MenuVO[]>({
+      url: `${MENU_BASE_URL}`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取菜单下拉数据源
+   *
+   * @returns 菜单下拉数据源
+   */
+  getOptions(onlyParent?: boolean) {
+    return request<any, OptionType[]>({
+      url: `${MENU_BASE_URL}/options`,
+      method: "get",
+      params: { onlyParent: onlyParent },
+    });
+  },
+
+  /**
+   * 获取菜单表单数据
+   *
+   * @param id 菜单ID
+   */
+  getFormData(id: string) {
+    return request<any, MenuForm>({
+      url: `${MENU_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 添加菜单
+   *
+   * @param data 菜单表单数据
+   * @returns 请求结果
+   */
+  add(data: MenuForm) {
+    return request({
+      url: `${MENU_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改菜单
+   *
+   * @param id 菜单ID
+   * @param data 菜单表单数据
+   * @returns 请求结果
+   */
+  update(id: string, data: MenuForm) {
+    return request({
+      url: `${MENU_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 删除菜单
+   *
+   * @param id 菜单ID
+   * @returns 请求结果
+   */
+  deleteById(id: number) {
+    return request({
+      url: `${MENU_BASE_URL}/${id}`,
+      method: "delete",
+    });
+  },
+};
+
+export default MenuAPI;
+
+import type { MenuTypeEnum } from "@/enums/MenuTypeEnum";
+
+/** 菜单查询参数 */
+export interface MenuQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+}
+
+/** 菜单视图对象 */
+export interface MenuVO {
+  /** 子菜单 */
+  children?: MenuVO[];
+  /** 组件路径 */
+  component?: string;
+  /** ICON */
+  icon?: string;
+  /** 菜单ID */
+  id?: string;
+  /** 菜单名称 */
+  name?: string;
+  /** 父菜单ID */
+  parentId?: string;
+  /** 按钮权限标识 */
+  perm?: string;
+  /** 跳转路径 */
+  redirect?: string;
+  /** 路由名称 */
+  routeName?: string;
+  /** 路由相对路径 */
+  routePath?: string;
+  /** 菜单排序(数字越小排名越靠前) */
+  sort?: number;
+  /** 菜单 */
+  type?: MenuTypeEnum;
+  /** 菜单是否可见(1:显示;0:隐藏) */
+  visible?: number;
+}
+
+/** 菜单表单对象 */
+export interface MenuForm {
+  /** 菜单ID */
+  id?: string;
+  /** 父菜单ID */
+  parentId?: string;
+  /** 菜单名称 */
+  name?: string;
+  /** 菜单是否可见(1-是 0-否) */
+  visible: number;
+  /** ICON */
+  icon?: string;
+  /** 排序 */
+  sort?: number;
+  /** 路由名称 */
+  routeName?: string;
+  /** 路由路径 */
+  routePath?: string;
+  /** 组件路径 */
+  component?: string;
+  /** 跳转路由路径 */
+  redirect?: string;
+  /** 菜单 */
+  type?: MenuTypeEnum;
+  /** 权限标识 */
+  perm?: string;
+  /** 【菜单】是否开启页面缓存 */
+  keepAlive?: number;
+  /** 【目录】只有一个子路由是否始终显示 */
+  alwaysShow?: number;
+  /** 参数 */
+  params?: KeyValue[];
+}
+
+interface KeyValue {
+  key: string;
+  value: string;
+}
+
+/** RouteVO，路由对象 */
+export interface RouteVO {
+  /** 子路由列表 */
+  children: RouteVO[];
+  /** 组件路径 */
+  component?: string;
+  /** 路由属性 */
+  meta?: Meta;
+  /** 路由名称 */
+  name?: string;
+  /** 路由路径 */
+  path?: string;
+  /** 跳转链接 */
+  redirect?: string;
+}
+
+/** Meta，路由属性 */
+export interface Meta {
+  /** 【目录】只有一个子路由是否始终显示 */
+  alwaysShow?: boolean;
+  /** 是否隐藏(true-是 false-否) */
+  hidden?: boolean;
+  /** ICON */
+  icon?: string;
+  /** 【菜单】是否开启页面缓存 */
+  keepAlive?: boolean;
+  /** 路由title */
+  title?: string;
+}
--- a/src/api/system/notice.ts
+++ b/src/api/system/notice.ts
@@ -0,0 +1,199 @@
+import request from "@/utils/request";
+
+const NOTICE_BASE_URL = "/api/v1/notices";
+
+const NoticeAPI = {
+  /** 获取通知公告分页数据 */
+  getPage(queryParams?: NoticePageQuery) {
+    return request<any, PageResult<NoticePageVO[]>>({
+      url: `${NOTICE_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取通知公告表单数据
+   *
+   * @param id NoticeID
+   * @returns Notice表单数据
+   */
+  getFormData(id: number) {
+    return request<any, NoticeForm>({
+      url: `${NOTICE_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 添加通知公告
+   *
+   * @param data Notice表单数据
+   * @returns
+   */
+  add(data: NoticeForm) {
+    return request({
+      url: `${NOTICE_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 更新通知公告
+   *
+   * @param id NoticeID
+   * @param data Notice表单数据
+   */
+  update(id: number, data: NoticeForm) {
+    return request({
+      url: `${NOTICE_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 批量删除通知公告，多个以英文逗号(,)分割
+   *
+   * @param ids 通知公告ID字符串，多个以英文逗号(,)分割
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${NOTICE_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+
+  /**
+   * 发布通知
+   *
+   * @param id 被发布的通知公告id
+   * @returns
+   */
+  publish(id: number) {
+    return request({
+      url: `${NOTICE_BASE_URL}/${id}/publish`,
+      method: "put",
+    });
+  },
+
+  /**
+   * 撤回通知
+   *
+   * @param id 撤回的通知id
+   * @returns
+   */
+  revoke(id: number) {
+    return request({
+      url: `${NOTICE_BASE_URL}/${id}/revoke`,
+      method: "put",
+    });
+  },
+  /**
+   * 查看通知
+   *
+   * @param id
+   */
+  getDetail(id: string) {
+    return request<any, NoticeDetailVO>({
+      url: `${NOTICE_BASE_URL}/${id}/detail`,
+      method: "get",
+    });
+  },
+
+  /* 全部已读 */
+  readAll() {
+    return request({
+      url: `${NOTICE_BASE_URL}/read-all`,
+      method: "put",
+    });
+  },
+
+  /** 获取我的通知分页列表 */
+  getMyNoticePage(queryParams?: NoticePageQuery) {
+    return request<any, PageResult<NoticePageVO[]>>({
+      url: `${NOTICE_BASE_URL}/my-page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+};
+
+export default NoticeAPI;
+
+/** 通知公告分页查询参数 */
+export interface NoticePageQuery extends PageQuery {
+  /** 标题 */
+  title?: string;
+  /** 发布状态(0：未发布，1：已发布，-1：已撤回) */
+  publishStatus?: number;
+
+  isRead?: number;
+}
+
+/** 通知公告表单对象 */
+export interface NoticeForm {
+  id?: number;
+  /** 通知标题 */
+  title?: string;
+  /** 通知内容 */
+  content?: string;
+  /** 通知类型 */
+  type?: number;
+  /** 优先级(L：低，M：中，H：高) */
+  level?: string;
+  /** 目标类型(1-全体 2-指定) */
+  targetType?: number;
+  /** 目标ID合集，以,分割 */
+  targetUserIds?: string;
+}
+
+/** 通知公告分页对象 */
+export interface NoticePageVO {
+  id: string;
+  /** 通知标题 */
+  title?: string;
+  /** 通知内容 */
+  content?: string;
+  /** 通知类型 */
+  type?: number;
+  /** 发布人 */
+  publisherId?: bigint;
+  /** 优先级(0-低 1-中 2-高) */
+  priority?: number;
+  /** 目标类型(0-全体 1-指定) */
+  targetType?: number;
+  /** 发布状态(0-未发布 1已发布 2已撤回) */
+  publishStatus?: number;
+  /** 发布时间 */
+  publishTime?: Date;
+  /** 撤回时间 */
+  revokeTime?: Date;
+}
+
+export interface NoticeDetailVO {
+  /** 通知ID */
+  id?: string;
+
+  /** 通知标题 */
+  title?: string;
+
+  /** 通知内容 */
+  content?: string;
+
+  /** 通知类型 */
+  type?: number;
+
+  /** 发布人 */
+  publisherName?: string;
+
+  /** 优先级(L-低 M-中 H-高) */
+  level?: string;
+
+  /** 发布时间 */
+  publishTime?: Date;
+
+  /** 发布状态 */
+  publishStatus?: number;
+}
--- a/src/api/system/role.ts
+++ b/src/api/system/role.ts
@@ -0,0 +1,138 @@
+import request from "@/utils/request";
+
+const ROLE_BASE_URL = "/api/v1/roles";
+
+const RoleAPI = {
+  /** 获取角色分页数据 */
+  getPage(queryParams?: RolePageQuery) {
+    return request<any, PageResult<RolePageVO[]>>({
+      url: `${ROLE_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /** 获取角色下拉数据源 */
+  getOptions() {
+    return request<any, OptionType[]>({
+      url: `${ROLE_BASE_URL}/options`,
+      method: "get",
+    });
+  },
+  /**
+   * 获取角色的菜单ID集合
+   *
+   * @param roleId 角色ID
+   * @returns 角色的菜单ID集合
+   */
+  getRoleMenuIds(roleId: number) {
+    return request<any, number[]>({
+      url: `${ROLE_BASE_URL}/${roleId}/menuIds`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 分配菜单权限
+   *
+   * @param roleId 角色ID
+   * @param data 菜单ID集合
+   */
+  updateRoleMenus(roleId: number, data: number[]) {
+    return request({
+      url: `${ROLE_BASE_URL}/${roleId}/menus`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 获取角色表单数据
+   *
+   * @param id 角色ID
+   * @returns 角色表单数据
+   */
+  getFormData(id: number) {
+    return request<any, RoleForm>({
+      url: `${ROLE_BASE_URL}/${id}/form`,
+      method: "get",
+    });
+  },
+
+  /** 添加角色 */
+  add(data: RoleForm) {
+    return request({
+      url: `${ROLE_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 更新角色
+   *
+   * @param id 角色ID
+   * @param data 角色表单数据
+   */
+  update(id: number, data: RoleForm) {
+    return request({
+      url: `${ROLE_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 批量删除角色，多个以英文逗号(,)分割
+   *
+   * @param ids 角色ID字符串，多个以英文逗号(,)分割
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${ROLE_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+};
+
+export default RoleAPI;
+
+/** 角色分页查询参数 */
+export interface RolePageQuery extends PageQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+}
+
+/** 角色分页对象 */
+export interface RolePageVO {
+  /** 角色编码 */
+  code?: string;
+  /** 角色ID */
+  id?: number;
+  /** 角色名称 */
+  name?: string;
+  /** 排序 */
+  sort?: number;
+  /** 角色状态 */
+  status?: number;
+  /** 创建时间 */
+  createTime?: Date;
+  /** 修改时间 */
+  updateTime?: Date;
+}
+
+/** 角色表单对象 */
+export interface RoleForm {
+  /** 角色ID */
+  id?: number;
+  /** 角色编码 */
+  code?: string;
+  /** 数据权限 */
+  dataScope?: number;
+  /** 角色名称 */
+  name?: string;
+  /** 排序 */
+  sort?: number;
+  /** 角色状态(1-正常；0-停用) */
+  status?: number;
+}
--- a/src/api/system/user.ts
+++ b/src/api/system/user.ts
@@ -0,0 +1,384 @@
+import request from "@/utils/request";
+
+const USER_BASE_URL = "/api/v1/users";
+
+const UserAPI = {
+  /**
+   * 获取当前登录用户信息
+   *
+   * @returns 登录用户昵称、头像信息，包括角色和权限
+   */
+  getInfo() {
+    return request<any, UserInfo>({
+      url: `${USER_BASE_URL}/me`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 获取用户分页列表
+   *
+   * @param queryParams 查询参数
+   */
+  getPage(queryParams: UserPageQuery) {
+    return request<any, PageResult<UserPageVO[]>>({
+      url: `${USER_BASE_URL}/page`,
+      method: "get",
+      params: queryParams,
+    });
+  },
+
+  /**
+   * 获取用户表单详情
+   *
+   * @param userId 用户ID
+   * @returns 用户表单详情
+   */
+  getFormData(userId: number) {
+    return request<any, UserForm>({
+      url: `${USER_BASE_URL}/${userId}/form`,
+      method: "get",
+    });
+  },
+
+  /**
+   * 添加用户
+   *
+   * @param data 用户表单数据
+   */
+  add(data: UserForm) {
+    return request({
+      url: `${USER_BASE_URL}`,
+      method: "post",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改用户
+   *
+   * @param id 用户ID
+   * @param data 用户表单数据
+   */
+  update(id: number, data: UserForm) {
+    return request({
+      url: `${USER_BASE_URL}/${id}`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   * 修改用户密码
+   *
+   * @param id 用户ID
+   * @param password 新密码
+   */
+  resetPassword(id: number, password: string) {
+    return request({
+      url: `${USER_BASE_URL}/${id}/password/reset`,
+      method: "put",
+      params: { password: password },
+    });
+  },
+
+  /**
+   * 批量删除用户，多个以英文逗号(,)分割
+   *
+   * @param ids 用户ID字符串，多个以英文逗号(,)分割
+   */
+  deleteByIds(ids: string) {
+    return request({
+      url: `${USER_BASE_URL}/${ids}`,
+      method: "delete",
+    });
+  },
+
+  /** 下载用户导入模板 */
+  downloadTemplate() {
+    return request({
+      url: `${USER_BASE_URL}/template`,
+      method: "get",
+      responseType: "blob",
+    });
+  },
+
+  /**
+   * 导出用户
+   *
+   * @param queryParams 查询参数
+   */
+  export(queryParams: UserPageQuery) {
+    return request({
+      url: `${USER_BASE_URL}/export`,
+      method: "get",
+      params: queryParams,
+      responseType: "blob",
+    });
+  },
+
+  /**
+   * 导入用户
+   *
+   * @param deptId 部门ID
+   * @param file 导入文件
+   */
+  import(deptId: number, file: File) {
+    const formData = new FormData();
+    formData.append("file", file);
+    return request<any, ExcelResult>({
+      url: `${USER_BASE_URL}/import`,
+      method: "post",
+      params: { deptId: deptId },
+      data: formData,
+      headers: {
+        "Content-Type": "multipart/form-data",
+      },
+    });
+  },
+
+  /** 获取个人中心用户信息 */
+  getProfile() {
+    return request<any, UserProfileVO>({
+      url: `${USER_BASE_URL}/profile`,
+      method: "get",
+    });
+  },
+
+  /** 修改个人中心用户信息 */
+  updateProfile(data: UserProfileForm) {
+    return request({
+      url: `${USER_BASE_URL}/profile`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /** 修改个人中心用户密码 */
+  changePassword(data: PasswordChangeForm) {
+    return request({
+      url: `${USER_BASE_URL}/password`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /** 发送短信验证码（绑定或更换手机号）*/
+  sendMobileCode(mobile: string) {
+    return request({
+      url: `${USER_BASE_URL}/mobile/code`,
+      method: "post",
+      params: { mobile: mobile },
+    });
+  },
+
+  /** 绑定或更换手机号 */
+  bindOrChangeMobile(data: MobileUpdateForm) {
+    return request({
+      url: `${USER_BASE_URL}/mobile`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /** 发送邮箱验证码（绑定或更换邮箱）*/
+  sendEmailCode(email: string) {
+    return request({
+      url: `${USER_BASE_URL}/email/code`,
+      method: "post",
+      params: { email: email },
+    });
+  },
+
+  /** 绑定或更换邮箱 */
+  bindOrChangeEmail(data: EmailUpdateForm) {
+    return request({
+      url: `${USER_BASE_URL}/email`,
+      method: "put",
+      data: data,
+    });
+  },
+
+  /**
+   *  获取用户下拉列表
+   */
+  getOptions() {
+    return request<any, OptionType[]>({
+      url: `${USER_BASE_URL}/options`,
+      method: "get",
+    });
+  },
+};
+
+export default UserAPI;
+
+/** 登录用户信息 */
+export interface UserInfo {
+  /** 用户ID */
+  userId?: number;
+
+  /** 用户名 */
+  username?: string;
+
+  /** 昵称 */
+  nickname?: string;
+
+  /** 头像URL */
+  avatar?: string;
+
+  /** 角色 */
+  roles: string[];
+
+  /** 权限 */
+  perms: string[];
+}
+
+/**
+ * 用户分页查询对象
+ */
+export interface UserPageQuery extends PageQuery {
+  /** 搜索关键字 */
+  keywords?: string;
+
+  /** 用户状态 */
+  status?: number;
+
+  /** 部门ID */
+  deptId?: number;
+
+  /** 开始时间 */
+  createTime?: [string, string];
+}
+
+/** 用户分页对象 */
+export interface UserPageVO {
+  /** 用户ID */
+  id: number;
+  /** 用户头像URL */
+  avatar?: string;
+  /** 创建时间 */
+  createTime?: Date;
+  /** 部门名称 */
+  deptName?: string;
+  /** 用户邮箱 */
+  email?: string;
+  /** 性别 */
+  gender?: number;
+  /** 手机号 */
+  mobile?: string;
+  /** 用户昵称 */
+  nickname?: string;
+  /** 角色名称，多个使用英文逗号(,)分割 */
+  roleNames?: string;
+  /** 用户状态(1:启用;0:禁用) */
+  status?: number;
+  /** 用户名 */
+  username?: string;
+}
+
+/** 用户表单类型 */
+export interface UserForm {
+  /** 用户头像 */
+  avatar?: string;
+  /** 部门ID */
+  deptId?: number;
+  /** 邮箱 */
+  email?: string;
+  /** 性别 */
+  gender?: number;
+  /** 用户ID */
+  id?: number;
+  /** 手机号 */
+  mobile?: string;
+  /** 昵称 */
+  nickname?: string;
+  /** 角色ID集合 */
+  roleIds?: number[];
+  /** 用户状态(1:正常;0:禁用) */
+  status?: number;
+  /** 用户名 */
+  username?: string;
+}
+
+/** 个人中心用户信息 */
+export interface UserProfileVO {
+  /** 用户ID */
+  id?: number;
+
+  /** 用户名 */
+  username?: string;
+
+  /** 昵称 */
+  nickname?: string;
+
+  /** 头像URL */
+  avatar?: string;
+
+  /** 性别 */
+  gender?: number;
+
+  /** 手机号 */
+  mobile?: string;
+
+  /** 邮箱 */
+  email?: string;
+
+  /** 部门名称 */
+  deptName?: string;
+
+  /** 角色名称，多个使用英文逗号(,)分割 */
+  roleNames?: string;
+
+  /** 创建时间 */
+  createTime?: Date;
+}
+
+/** 个人中心用户信息表单 */
+export interface UserProfileForm {
+  /** 用户ID */
+  id?: number;
+
+  /** 用户名 */
+  username?: string;
+
+  /** 昵称 */
+  nickname?: string;
+
+  /** 头像URL */
+  avatar?: string;
+
+  /** 性别 */
+  gender?: number;
+
+  /** 手机号 */
+  mobile?: string;
+
+  /** 邮箱 */
+  email?: string;
+}
+
+/** 修改密码表单 */
+export interface PasswordChangeForm {
+  /** 原密码 */
+  oldPassword?: string;
+  /** 新密码 */
+  newPassword?: string;
+  /** 确认新密码 */
+  confirmPassword?: string;
+}
+
+/** 修改手机表单 */
+export interface MobileUpdateForm {
+  /** 手机号 */
+  mobile?: string;
+  /** 验证码 */
+  code?: string;
+}
+
+/** 修改邮箱表单 */
+export interface EmailUpdateForm {
+  /** 邮箱 */
+  email?: string;
+  /** 验证码 */
+  code?: string;
+}