Home

Awesome

<div align="center"> <h1 align="center">XiRang</h1>

Auth Go Version Gin Version Gorm Version GitHub Issues GitHub Pull Requests GitHub Pull Requests HitCount GitHub license

<p> 🐉 简单好用,不缠不绕,直接上手的go-web框架 </p> <img src="https://cdn.jsdelivr.net/gh/eryajf/tu@main/img/image_20240420_214408.gif" width="800" height="3"> </div><br> <p align="center"> <a href="" rel="noopener"> <img src="https://cdn.jsdelivr.net/gh/eryajf/tu/img/image_20220826_101156.png" alt="Project logo"></a> </p>

xirang,亦即息壤,大概在我读小学时,父亲从外地回来,并带回来几本读物,其中一本是迅哥儿小时候最爱读的《山海经》,也是在那时,我第一次认识这个词语。

维基百科对其解释是:息壤是中国古代传说中的一种神物,所谓“息壤”就是自己可以自动生长的土壤。用“息壤”修筑的堤坝,洪水长一米,堤坝也自动长一米。

我将项目命名为xirang,亦是希望在自己不间断地学习积累之中,项目也能够越发成长,并有其丰富的力量。

🥸 项目介绍

xirang 是一个非常简单的 gin+gorm 框架的基础架构,你只需要修改简单的代码,即可开始上手编写你的接口。

只需要根据情况修改配置config.yml,然后配置里边的数据库配置信息,即可开始开发。

数据表会自动创建,也可以通过 docs 下的 sql 自行创建。

👨‍💻 项目地址

分类GitHubGitee
后端https://github.com/eryajf/xirang.githttps://gitee.com/eryajf-world/xirang.git
前端https://github.com/eryajf/xirang-ui.githttps://gitee.com/eryajf-world/xirang-ui.git

📖 目录结构

xirang
├── config----------------配置文件读取
├── controller------------控制层
├── logic-----------------逻辑层
├── middleware------------中间件
├── model-----------------对象定义
├── public----------------一些公共组件与工具
├── routers---------------路由
├── service---------------服务层
├── test------------------一些测试
├── config.yml------------配置文件
└── main.go---------------程序入口

👀 功能概览

登录页首页
用户管理分组管理
角色管理菜单管理
接口管理操作日志

🚀 快速开始

xirang 项目的基础依赖项只有 MySQL,本地准备好这两个服务之后,就可以启动项目,进行调试。

拉取代码

# 后端代码
$ git clone https://github.com/eryajf/xirang.git

# 前端代码
$ git clone https://github.com/eryajf/xirang-ui.git

更改配置

# 修改后端配置
$ cd xirang
# 文件路径 config.yml, 根据自己本地的情况,调整数据库等配置信息。
$ vim config.yml

启动服务

# 启动后端
$ cd xirang
$ go mod tidy
$ make run

# 启动前端
$ cd xirang-ui
$ git config --global url."https://".insteadOf git://
$ npm install --registry=http://registry.npmmirror.com
$ yarn dev

本地访问:http://localhost:8090,用户名/密码:admin/123456