签入版本

2026-10-27 16:15:53 +08:00
parent 06a855c0f4
commit de8edd1b3c
129 changed files with 141 additions and 141 deletions
@@ -1,6 +1,6 @@
 # API 层开发

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端 API 层位于 `src/api/` 目录，封装所有与后端的 HTTP 请求。底层基于 Axios 封装了 `VAxios` 类（位于 `src/utils/http/axios/`），提供请求拦截、响应解包、错误处理、重复请求取消等能力。
@@ -1,6 +1,6 @@
 # 前端构建

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端使用 Vite 构建，支持开发服务器和生产构建。`vite.config.ts` 通过环境变量和插件系统管理构建配置，生产环境推荐使用 Nginx 部署。
@@ -1,6 +1,6 @@
 # 公共组件库

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 项目提供丰富的公共组件，位于 `ui/src/components/` 目录，基于 Ant Design Vue 二次封装，覆盖表格、表单、弹窗、上传、富文本编辑等常见场景。组件通过 `src/plugins/` 中的 `setupCustomComponents` 全局注册，任何页面直接使用，无需单独 import。
@@ -1,6 +1,6 @@
 # BasicForm 表单

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 `BasicForm` 位于 `src/components/Form/src/BasicForm.vue`，基于 Ant Design Vue 的 `a-form` 二次封装，通过 schemas 配置化定义表单字段，支持查询表单和业务表单两种模式。
@@ -1,6 +1,6 @@
 # Hooks 组合式函数

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 项目封装了一系列组合式函数（Hooks），位于 `src/hooks/` 和 `src/utils/` 目录，提供权限检查、异步 loading、防重复提交、实时时钟、项目配置等可复用逻辑。
@@ -1,6 +1,6 @@
 # 国际化

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 当前项目仅支持中文界面，Ant Design Vue 默认支持中文，所有界面文本直接硬编码在组件中。如需扩展多语言支持，可基于 vue-i18n 实现。
@@ -1,6 +1,6 @@
 # Modal 弹窗

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 项目提供 `BasicModal` 组件（`src/components/Modal/src/basicModal.vue`）和原生 `a-modal` 两种弹窗用法。编辑弹窗通过 `defineAsyncComponent` 懒加载，减少首屏渲染负担。
@@ -1,6 +1,6 @@
 # 权限指令 v-perm

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 `v-perm` 和 `v-perms` 是项目自定义的 Vue 指令，用于按钮级别的权限控制，无权限时自动从 DOM 中移除元素。底层通过 `usePermission` Hook 检查用户权限列表。
@@ -1,6 +1,6 @@
 # 路由与菜单

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端路由基于 Vue Router 4 实现动态路由生成，菜单数据从后端获取，通过 `generator-routers.ts` 递归生成路由表，路由守卫控制登录状态和权限。
@@ -1,6 +1,6 @@
 # 前端环境与结构

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端基于 Vue3 + Ant Design Vue 构建，使用 pnpm 作为包管理工具，Vite 作为构建工具，TypeScript 作为开发语言。
@@ -1,6 +1,6 @@
 # Store 状态管理

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端使用 Pinia 进行状态管理，核心模块包括 `user`（用户信息与权限）、`asyncRoute`（动态路由与菜单）、`projectSetting`（项目配置）、`designSetting`（主题设计）等。
@@ -1,6 +1,6 @@
 # 样式与主题

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端样式方案采用 Tailwind CSS + SCSS + Ant Design Vue 主题覆盖，支持深色模式切换。全局 SCSS 变量通过 Vite 的 `additionalData` 注入。
@@ -1,6 +1,6 @@
 # BasicTable 表格

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 `BasicTable` 位于 `src/components/Table/src/Table.vue`，基于 Ant Design Vue 的 `a-table` 二次封装，提供列定义、数据请求、分页、操作列、多选、全屏、密度调整、列设置等能力。
@@ -1,6 +1,6 @@
 # 工具函数

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 前端工具函数位于 `src/utils/` 目录，提供认证管理、本地存储、日期格式化、树结构操作、文件下载等通用能力。
@@ -1,6 +1,6 @@
 # 页面视图开发

-<!-- Copyright (c) 2021-2026 小蚂蚁云团队 版权所有 -->
+

 :::tip 说明
 页面视图位于 `src/views/` 目录，每个业务模块遵循 `index.vue`（列表页）+ `edit.vue`（编辑弹窗）+ `detail.vue`（详情弹窗）的标准模式，辅以 `columns.ts`（列定义）和 `querySchemas.ts`（搜索表单）配置文件。