# fs-admin

**Repository Path**: durcframework/fs-admin

## Basic Information

- **Project Name**: fs-admin
- **Description**: 一个纯净的后台管理系统，具备基本的RBAC权限校验功能，权限校验精确到按钮级别。前端使用Vue3、Vite5、Element-Plus、TypeScript、Pinia、Tailwindcss，后端采用Solon + Java17 + fastmybatis
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 3
- **Created**: 2025-01-26
- **Last Updated**: 2025-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# fs-admin

## 介绍

一个纯净的后台管理系统，具备基本的RBAC权限校验功能，权限校验精确到按钮级别。前端使用Vue3、Vite5、Element-Plus、TypeScript、Pinia、Tailwindcss，后端采用[Solon](https://gitee.com/opensolon/solon) + Java17 + [fastmybatis](https://gitee.com/durcframework/fastmybatis)

提供代码生成工具，自动生成前后端代码，实现完整的增删改查功能。

## 目录说明

- fs-admin-backend：后端代码，基于[Solon](https://solon.noear.org) + Java17 + [fastmybatis](https://torna.cn/fastmybatis/)
- fs-admin-frontend：前端代码，基于Vue3、Vite5、Element-Plus、TypeScript、Pinia、Tailwindcss
- fm-code-gen：代码生成工具

## 启动项目

克隆项目：`git clone https://gitee.com/durcframework/fs-admin.git`

使用IDEA打开项目，等待Maven依赖下载完成

### 启动后端

> 依赖：JDK17, MySQL5.7+

- 初始化数据库，导入[mysql.sql](./mysql.sql)
- 打开`fs-admin-backend/admin-boot/src/main/resources/app-dev.yml`文件，修改数据库用户名密码
- 运行`fs-admin-backend/admin-boot/src/main/java/com/gitee/fsadmin/AdminApp.java`

### 启动前端

> 依赖：nodejs，版本要求 >= 18.18.0

`cd fs-admin-frontend`，命令提示符跳转到前端根目录


- macOS用户在命令前面添加`sudo`

```shell
# 安装pnpm
npm install -g pnpm

# 安装依赖
pnpm install

# 启动
pnpm dev
```

浏览器访问：http://localhost:9125/

- 登录账号

超级管理员账号：admin 密码：123456


### 修改端口

服务端默认端口是8089 ，如果要修改，需要同时修改前后端端口配置

假设改成8090

打开`fs-admin-backend/admin-boot/src/main/resources/app-dev.yml`文件，添加配置：

```yaml
server:
  port: 8089
```

打开`fs-admin-frontend/.env.development`文件，修改VITE_BACKEND_URL配置

改成

```text
VITE_BACKEND_URL = http://127.0.0.1:8090
```

## 构建项目

执行根目录的`build.sh`，输出目录在`dist`

前后端已经打包在一起，只需启动后端服务即可，前端不需要部署。

## 预览图

- 用户管理

![1](./asset/1.png)

- 角色管理

![2](./asset/2.png)

- 菜单管理

![2](./asset/3.png)