# soma-server

**Repository Path**: eryajf/soma-server

## Basic Information

- **Project Name**: soma-server
- **Description**: go + vue3 管理后台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-06-10
- **Last Updated**: 2024-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目简介

soma-server基于当前流行技术组合的前后端系统：

Gin + Gorm + Casbin + Jwt + Mysql + Vue 的前后端分离后台管理系统，权限控制采用RBAC，支持动态路由。

## 项目源码

|     |   后端源码  |   前端源码  |
|---  |--- | --- |
|  gitee   | <https://gitee.com/isekiro/soma-server>  |  <https://gitee.com/isekiro/soma-ui> |

## 已经实现后台系统功能

- 用户管理：提供用户的相关配置
- 接口鉴权：JWT 双 Token 刷新
- 角色管理：对权限与菜单进行分配，可根据部门设置角色的数据权限
- 菜单管理：已实现菜单动态路由，后端可配置化
- 日志管理：用户操日志记录

## go后端配置、启动、部署

```bash
1、安装go>=1.20

2、开启mod： go env -w GO111MODULE=on

3、配置代理：go env -w GOPROXY=https://goproxy.cn,direct 这个让下载依赖速度更快

4。下载项目：git clone https://gitee.com/isikero/soma-server.git

5、go mod tidy 安装所需依赖

6、导入sql/soma.sql,修改config.yml 里的配置

7、go install github.com/swaggo/swag/cmd/swag@latest 

8、生成swagger文档：swag init

7、本地运行直接 go run main.go 即可

8、线上部署： go build  打包然后上传服务器命令： nohup ./soma-server & ，容器化自行修改。

9、配置nginx 反向代理即可
```

## 前端配置、启动、部署

```bash
1、npm install -g pnpm

2、vite.config.ts proxy代码块内配置api地址

3、pnpm install 安装依赖

4、pnpm dev 启动即可

5、线上部署：pnpm build 然后上传./dist/下编译后的文件到web服务器即可

```

## 功能说明

效果图：

登录页
| ![输入图片说明](https://foruda.gitee.com/images/1699862230057464556/d1bd2089_11522834.png) |
|--|
1、左侧菜单
| ![输入图片说明](https://foruda.gitee.com/images/1699862305797687930/8c4dc44a_11522834.png) |
|--|
2、用户管理
| ![输入图片说明](https://foruda.gitee.com/images/1699862294638594483/354d492c_11522834.png) |
|--|
3、角色管理
| ![输入图片说明](https://foruda.gitee.com/images/1699862253670321583/bac2de55_11522834.png) |
|--|
4、角色管理
| ![输入图片说明](https://foruda.gitee.com/images/1699862265520442894/7823f7e2_11522834.png)|
|--|
5、菜单管理
| ![输入图片说明](https://foruda.gitee.com/images/1699862205114849813/6e5c1fc9_11522834.png)|
|--|
6、接口管理
| ![输入图片说明](https://foruda.gitee.com/images/1699862274421639287/aff606ba_11522834.png)  |
|--|

7、操作日志
| ![输入图片说明](https://foruda.gitee.com/images/1699862220775351438/b6095b4a_11522834.png) |
|--|
8、主题菜单
| ![输入图片说明](https://foruda.gitee.com/images/1699862285468769725/a4f01f49_11522834.png) |
|--|

## 技术选型

后端使用技术

- Gin
- Jwt
- Mysql
- Gorm
- Casbin
- Viper
- Zap

前端使用技术

- Vue3
- Element Plus
- Vite
- Typescript

## 特别鸣谢

- gorm:<https://gorm.io/>
- casbin:<https://casbin.org/>
- vue:<https://github.com/vuejs/vue>
- element:<https://github.com/ElemeFE/element>
- pure-admin:<https://github.com/pure-admin/vue-pure-admin>