2024-07-18 15:55:44 +08:00
|
|
|
|
# SnowAdmin
|
2024-06-26 17:41:28 +08:00
|
|
|
|
|
|
|
|
|
|
### 介绍 📖
|
|
|
|
|
|
|
2024-07-18 15:55:44 +08:00
|
|
|
|
SnowAdmin 一款基于 Vue3、TypeScript、Vite5、Pinia、Arco-Design 开源的后台管理框架，符合直觉的使用模式，使用目前最新技术栈开发。项目提供了一些常用组件，在一定程度上提高您的开发效率。另外本项目还封装了一些常用组件、Hooks、动态路由等功能。
|
2024-06-26 17:41:28 +08:00
|
|
|
|
|
|
|
|
|
|
### 在线预览 👀
|
|
|
|
|
|
|
|
|
|
|
|
- 链接：建设中
|
|
|
|
|
|
|
|
|
|
|
|
### 代码仓库 ⭐
|
|
|
|
|
|
|
|
|
|
|
|
- Gitee：https://gitee.com/wang_fan_w/dc-admin
|
|
|
|
|
|
|
|
|
|
|
|
### 项目文档 📚
|
|
|
|
|
|
|
|
|
|
|
|
- 项目更新日志：建设中
|
|
|
|
|
|
|
|
|
|
|
|
- 项目文档地址：建设中
|
|
|
|
|
|
|
|
|
|
|
|
### 项目功能 🔨
|
|
|
|
|
|
|
|
|
|
|
|
- 使用 Vue3 + TypeScript 开发，单文件组件**＜script setup＞**
|
|
|
|
|
|
- 采用 Vite5 作为项目开发
|
|
|
|
|
|
- 使用 Pinia 替代 Vuex，轻量、简单、易用，集成 Pinia 持久化插件
|
|
|
|
|
|
- 使用 TypeScript 对 Axios 整个二次封装（请求拦截、取消、常用请求封装…）
|
|
|
|
|
|
- 支持 Arco-Design 组件大小切换、多主题布局、暗黑模式、i18n 国际化
|
|
|
|
|
|
- 使用 VueRouter 配置动态路由权限拦截、路由懒加载，支持页面按钮权限控制
|
|
|
|
|
|
- 使用 KeepAlive 对页面进行缓存，支持多级嵌套路由缓存
|
|
|
|
|
|
- 使用 Prettier 统一格式化代码，集成 ESLint、Stylelint 代码校验规范
|
|
|
|
|
|
- 使用 husky、lint-staged、commitlint等插件，规范提交信息
|
|
|
|
|
|
|
|
|
|
|
|
### 安装使用步骤 📔
|
|
|
|
|
|
|
|
|
|
|
|
- **Clone：**
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
|
# Gitee
|
|
|
|
|
|
git clone https://gitee.com/wang_fan_w/dc-admin.git
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- **Install：**
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
|
pnpm install
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- **Run：**
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
|
pnpm dev
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- **Build：**
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
|
# 开发环境
|
|
|
|
|
|
pnpm run dev
|
|
|
|
|
|
|
|
|
|
|
|
# 测试环境
|
|
|
|
|
|
pnpm run preview
|
|
|
|
|
|
|
|
|
|
|
|
# 生产环境
|
|
|
|
|
|
pnpm run build
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- **Lint：**
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
|
# eslint 检测代码
|
|
|
|
|
|
pnpm lint:eslint
|
|
|
|
|
|
|
|
|
|
|
|
# prettier 格式化代码
|
|
|
|
|
|
pnpm lint:prettier
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 项目截图 📷
|
|
|
|
|
|
|
|
|
|
|
|
- 登录页：
|
|
|
|
|
|
|
|
|
|
|
|
- 首页：
|
|
|
|
|
|
|
|
|
|
|
|
- 表格页：
|
|
|
|
|
|
|
|
|
|
|
|
- 用户中心：
|
|
|
|
|
|
|
|
|
|
|
|
- 系统配置页：
|
|
|
|
|
|
|
|
|
|
|
|
### 文件资源目录 📚
|
|
|
|
|
|
|
|
|
|
|
|
```text
|
2024-07-18 15:55:44 +08:00
|
|
|
|
SnowAdmin
|
2024-06-26 17:41:28 +08:00
|
|
|
|
├─ .husky # husky 配置文件
|
|
|
|
|
|
├─ .vscode # VSCode 推荐配置
|
|
|
|
|
|
├─ public # 静态资源文件（该文件夹不会被打包）
|
|
|
|
|
|
├─ src
|
|
|
|
|
|
│ ├─ api # API 接口管理
|
|
|
|
|
|
│ ├─ assets # 静态资源文件
|
|
|
|
|
|
│ ├─ components # 全局组件
|
|
|
|
|
|
│ ├─ config # 全局配置项
|
|
|
|
|
|
│ ├─ directives # 全局指令文件
|
|
|
|
|
|
│ ├─ hooks # 常用 Hooks 封装
|
|
|
|
|
|
│ ├─ lang # 语言国际化 i18n
|
|
|
|
|
|
│ ├─ layout # 框架布局模块
|
|
|
|
|
|
│ ├─ router # 路由管理
|
|
|
|
|
|
│ ├─ store # pinia store
|
|
|
|
|
|
│ ├─ style # 全局样式文件
|
|
|
|
|
|
│ ├─ typings # 全局 ts 声明
|
|
|
|
|
|
│ ├─ utils # 常用工具库
|
|
|
|
|
|
│ ├─ views # 项目所有页面
|
|
|
|
|
|
│ ├─ App.vue # 项目主组件
|
|
|
|
|
|
│ ├─ main.ts # 项目入口文件
|
|
|
|
|
|
│ └─ vite-env.d.ts # 指定 ts 识别 vue
|
|
|
|
|
|
├─ .env # vite 常用配置
|
|
|
|
|
|
├─ .env.development # 开发环境配置
|
|
|
|
|
|
├─ .env.production # 生产环境配置
|
|
|
|
|
|
├─ .env.test # 测试环境配置
|
|
|
|
|
|
├─ .eslintignore # 忽略 Eslint 校验
|
|
|
|
|
|
├─ .eslintrc.cjs # Eslint 校验配置文件
|
|
|
|
|
|
├─ .gitignore # 忽略 git 提交
|
|
|
|
|
|
├─ .prettierignore # 忽略 Prettier 格式化
|
|
|
|
|
|
├─ .prettierrc.cjs # Prettier 格式化配置
|
|
|
|
|
|
├─ commitlint.config.cjs # git 提交规范配置
|
|
|
|
|
|
├─ index.html # 入口 html
|
|
|
|
|
|
├─ package-lock.json # 依赖包包版本锁
|
|
|
|
|
|
├─ package.json # 依赖包管理
|
|
|
|
|
|
├─ README.md # README 介绍
|
|
|
|
|
|
├─ tsconfig.json # typescript 全局配置
|
|
|
|
|
|
└─ vite.config.ts # vite 全局配置文件
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 浏览器支持 🌎
|
|
|
|
|
|
|
|
|
|
|
|
- 本地开发推荐使用 Chrome 最新版浏览器 [Download](https://www.google.com/intl/zh-CN/chrome/)。
|
|
|
|
|
|
- 生产环境支持现代浏览器，不再支持 IE 浏览器，更多浏览器可以查看 [Can I Use Es Module](https://caniuse.com/?search=ESModule)。
|
|
|
|
|
|
|
|
|
|
|
|
|  |  |  |  |  |
|
|
|
|
|
|
| :---------------------------------------------: | :-----------------------------------------------: | :--------------------------------------------------: | :-------------------------------------------------: | :-------------------------------------------------: |
|
|
|
|
|
|
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
|
|
|
|
|
|
|
|
|
|
|
|
### 项目后台接口 🧩
|
|
|
|
|
|
|
2024-06-28 19:01:54 +08:00
|
|
|
|
建设中
|
