docs(projects): 文档更新

This commit is contained in:
Soybean
2021-11-10 20:44:43 +08:00
parent 6a543422ff
commit 448d28db2e
15 changed files with 563 additions and 132 deletions

View File

@ -12,18 +12,21 @@
## 简介
Soybean Admin 是一个基于 Vue3、Vite、Naive UI、TypeScript 的中后台解决方案,它使用了最新的前端技术栈,并提炼了典型的业务模型,页面,包括二次封装组件、动态菜单、权限校验、粒子化权限控制等功能,它可以帮助你快速搭建企业级中后台项目,相信不管是从新技术使用还是其他方面,都能帮助到你。
Soybean Admin 是一个基于 Vue3、Vite、Naive UI、TypeScript 的免费中后台模版,它使用了最新的前端技术栈,内置丰富的插件,有着极高的代码规范,
开箱即用的中后台前端解决方案,也可用于学习参考。
## 特性
- **最新技术栈**:使用 Vue3/vite2 等前端前沿技术开发, 使用高效率的npm包管理器pnpm
- **TypeScript**: 应用程序级 JavaScript 的语言
- **主题**:可配置的主题
- **代码规范**:丰富的规范插件及极高规范的代码组织
- **主题**丰富可配置的主题
- **代码规范**:丰富的规范插件及极高的代码规范
- **路由配置**:简易的路由配置
## 预览
- [soybean-admin](https://soybean.pro/) - 站点
- [soybean-admin](https://soybean.pro/)
## 目录规范
@ -41,8 +44,8 @@ soybean-admin
└── windicss.ts //css框架插件
├── doc //项目相关说明文档
├── public //公共目录
├── resource //资源文件夹(不会被打包)
└── favicon.ico
├── resource //资源文件夹(打包后会保留到dist根目录)
└── favicon.ico //网站标签图标
├── src
├── assets //静态资源
├── components //全局组件
@ -57,7 +60,7 @@ soybean-admin
├── business.ts //业务相关枚举
├── common.ts //通用枚举
├── route.ts //路由相关枚举
├── storage.ts //存储相关枚举
├── storage.ts //存储相关枚举
└── theme.ts //系统主题配置相关枚举
├── hooks //组合式的钩子函数hooks
├── business //业务相关hooks
@ -67,41 +70,43 @@ soybean-admin
├── common.ts //通用类型接口
└── theme.ts //系统主题配置相关类型接口
├── layouts //布局组件
├── BasicLayout //基本布局组件(包含全局头部、侧边栏、底部等)
── BlankLayout //空白布局组件
├── BasicLayout //基本布局(包含全局头部、侧边栏、底部等公共部分)
── BlankLayout //空白布局组件(单个页面)
└── RouterViewLayout //路由组件(用于多级路由之间的桥接)
├── plugins //插件
└── dark-mode.ts //windicss暗黑模式插件
├── router //vue路由
├── cache.ts //缓存的路由
├── components.ts //缓存的路由对应的组件
├── helpers.ts //工具函数
── menus.ts //菜单
├── permission.ts //路由守卫相关函数
└── routes.ts //声明的路由
├── modules //路由页面(按模块划分)
├── permission //路由权限(路由守卫)
├── routes //声明的路由
── setup //路由挂载函数
├── service //网络请求
├── api //请求接口
├── api //接口api
├── middleware //请求结果的处理中间件
── request //封装的请求函数
└── utils //请求相关工具函数
├── settings //项目初始配置
── request //封装的请求函数
├── settings //项目静态配置
├── constant //常量配置
└── theme.ts //项目主题初始配置
├── store //状态管理
└── modules //状态管理划分的模块
├── styles //样式
├── css //css
└── scss //scss
├── typings //TS类型声明文件(*.d.ts)
├── utils //全局工具函数
├── auth
├── common
├── package
├── router
── storage
├── auth //用户鉴权
├── common //通用工具函数
├── package //npm依赖
├── router //路由
── request //请求工具函数
└── storage //存储
├── views //页面
├── about
├── component
├── dashboard
├── document
├── multi-menu
└── system
└── system //系统内置页面:登录、异常页等
├── App.vue //vue文件入口
├── AppProvider.vue //配置naive UI的vue文件(国际化,loadingBar、message等组件)
└── main.ts //项目入口ts文件
@ -118,7 +123,7 @@ soybean-admin
├── .prettierrc.js //prettier代码格式插件配置
├── commitlint.config.js //commitlint提交规范插件配置
├── index.html
├── package.json
├── package.json //npm依赖描述文件
├── pnpm-lock.yaml //npm包管理器pnpm依赖锁定文件
├── README.md //项目介绍文档
├── tsconfig.json //TS配置