ruoyi-plus-soybean/README.md
2021-11-10 20:48:55 +08:00

6.8 KiB
Raw Blame History

SoybeanAdmin Logo

Soybean Admin


简介

Soybean Admin 是一个基于 Vue3、Vite、Naive UI、TypeScript 的免费中后台模版,它使用了最新的前端技术栈,内置丰富的插件,有着极高的代码规范,

开箱即用的中后台前端解决方案,也可用于学习参考。

特性

  • 最新技术栈:使用 Vue3/vite2 等前端前沿技术开发, 使用高效率的npm包管理器pnpm
  • TypeScript: 应用程序级 JavaScript 的语言
  • 主题:丰富可配置的主题
  • 代码规范:丰富的规范插件及极高的代码规范
  • 路由配置:简易的路由配置

预览

目录规范

soybean-admin
├── build                      //vite构建相关配置和插件
   ├── define                 //定义的全局常量通过vite构建时注入
   ├── env                    //.env环境文件内容加载插件
   └── plugins                //构建插件
       ├── html.ts            //html插件(注入变量,压缩代码等)
       ├── iconify.ts         //iconify图标插件
       ├── visualizer.ts      //构建的依赖大小占比分析插件
       ├── vue.ts             //vue相关vite插件
       └── windicss.ts        //css框架插件
├── doc                        //项目相关说明文档
├── public                     //公共目录
   ├── resource               //资源文件夹(打包后会保留到dist根目录)
   └── favicon.ico            //网站标签图标
├── src
   ├── assets                 //静态资源
   ├── components             //全局组件
      ├── business           //业务相关组件
      ├── common             //公共组件
      └── custom             //自定义组件
   ├── context                //全局上下文(通过provide和inject实现)
      ├── app                //从app.vue注入的上下文
      └── part               //局部组件注入的上下文
   ├── enum                   //TS枚举
      ├── animate.ts         //动画枚举
      ├── business.ts        //业务相关枚举
      ├── common.ts          //通用枚举
      ├── route.ts           //路由相关枚举
      ├── storage.ts         //存储相关枚举
      └── theme.ts           //系统主题配置相关枚举
   ├── hooks                  //组合式的钩子函数hooks
      ├── business           //业务相关hooks
      └── common             //通用hooks
   ├── interface              //TS类型接口
      ├── business.ts        //业务相关类型接口
      ├── common.ts          //通用类型接口
      └── theme.ts           //系统主题配置相关类型接口
   ├── layouts                //布局组件
      ├── BasicLayout        //基本布局(包含全局头部、侧边栏、底部等公共部分)
      ├── BlankLayout        //空白布局组件(单个页面)
      └── RouterViewLayout   //路由组件(用于多级路由之间的桥接)
   ├── plugins                //插件
      └── dark-mode.ts       //windicss暗黑模式插件
   ├── router                 //vue路由
      ├── modules            //路由页面(按模块划分)
      ├── permission         //路由权限(路由守卫)
      ├── routes         		 //声明的路由
      └── setup              //路由挂载函数
   ├── service                //网络请求
      ├── api                //接口api
      ├── middleware         //请求结果的处理中间件
      └── request            //封装的请求函数
   ├── settings               //项目静态配置
      ├── constant           //常量配置
      └── theme.ts           //项目主题初始配置
   ├── store                  //状态管理
      └── modules            //状态管理划分的模块
   ├── styles                 //样式
      ├── css                //css
      └── scss               //scss
   ├── typings                //TS类型声明文件(*.d.ts)
   ├── utils                  //全局工具函数
      ├── auth               //用户鉴权
      ├── common             //通用工具函数
      ├── package            //npm依赖
      ├── router             //路由
      ├── request            //请求工具函数
      └── storage            //存储
   ├── views                  //页面
      ├── about
      ├── component
      ├── dashboard
      ├── document
      ├── multi-menu
      └── system             //系统内置页面:登录、异常页等
   ├── App.vue                //vue文件入口
   ├── AppProvider.vue        //配置naive UI的vue文件(国际化,loadingBar、message等组件)
   └── main.ts                //项目入口ts文件
├── .cz-config.js              //git cz提交配置
├── .editorconfig              //统一编辑器配置
├── .env                       //环境文件
├── .env.development           //环境文件(开发模式)
├── .env.production            //环境文件(生产模式)
├── .env.staging               //环境文件(自定义staging模式)
├── .eslintignore              //忽略eslint检查的配置文件
├── .eslintrc.js               //eslint配置文件
├── .gitignore                 //忽略git提交的配置文件
├── .husky                     //git commit提交钩子提交前检查代码格式和提交commit内容的格式
├── .prettierrc.js             //prettier代码格式插件配置
├── commitlint.config.js       //commitlint提交规范插件配置
├── index.html
├── package.json               //npm依赖描述文件
├── pnpm-lock.yaml             //npm包管理器pnpm依赖锁定文件
├── README.md                  //项目介绍文档
├── tsconfig.json              //TS配置
├── vite.config.ts             //vite配置
└── windi.config.ts            //windicss框架配置