XiRang

🐉 简单好用，不缠不绕，直接上手的go-web框架

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

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

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

🥸 项目介绍

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

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

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

👨‍💻 项目地址

📖 目录结构

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