Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heromicro/omgind
https://github.com/heromicro/omgind
casbin di ent gin go swagger ulid wire
Last synced: 1 day ago
JSON representation
- Host: GitHub
- URL: https://github.com/heromicro/omgind
- Owner: heromicro
- License: mit
- Created: 2023-02-08T04:34:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-19T03:19:35.000Z (22 days ago)
- Last Synced: 2024-12-19T04:25:30.272Z (21 days ago)
- Topics: casbin, di, ent, gin, go, swagger, ulid, wire
- Language: Go
- Homepage:
- Size: 5.41 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
omgind
站在gin-admin的肩膀上, 根据个人喜好魔改的后台工程模板
#### one more gin admin => omgind
基于 GIN + entgo + CASBIN + WIRE 实现的RBAC权限管理脚手架，目的是提供一套轻量的中后台开发框架，方便、快速的完成业务需求的开发。
[![ReportCard][reportcard-image]][reportcard-url] [![GoDoc][godoc-image]][godoc-url] [![License][license-image]][license-url]
## 特性
- 遵循 `RESTful API` 设计规范 & 基于接口的编程规范
- 基于 `GIN` 框架，提供了丰富的中间件支持（JWTAuth、CORS、RequestLogger、RequestRateLimiter、TraceID、CasbinEnforce、Recover、GZIP）
- 基于 `Casbin` 的 RBAC 访问控制模型 -- **权限控制可以细粒度到按钮 & 接口**
- 基于 `entgo` 的数据库 ORM
- 基于 `WIRE` 的依赖注入 -- 依赖注入本身的作用是解决了各个模块间层级依赖繁琐的初始化过程
- 基于 `Logrus & Context` 实现了日志输出，通过结合 Context 实现了统一的 TraceID/UserID 等关键字段的输出(同时支持日志钩子写入到`Gorm`/`entgo`)
- 基于 `JWT` 的用户认证 -- 基于 JWT 的黑名单验证机制
- 基于 `Swaggo` 自动生成 `Swagger` 文档 -- 独立于接口的 mock 实现
- 基于 `net/http/httptest` 标准包实现了 API 的单元测试
- 基于 `go mod` 的依赖管理(国内源可使用：[https://goproxy.cn/](https://goproxy.cn/))
## 依赖工具
```
go get -u github.com/cosmtrek/air
go get -u github.com/google/wire/cmd/wire
go get -u github.com/swaggo/swag/cmd/swag
```
- [air](https://github.com/cosmtrek/air) -- Live reload for Go apps
- [wire](https://github.com/google/wire) -- Compile-time Dependency Injection for Go
- [swag](https://github.com/swaggo/swag) -- Automatically generate RESTful API documentation with Swagger 2.0 for Go.
## 依赖框架
- [Gin](https://gin-gonic.com/) -- The fastest full-featured web framework for Go.
- [entgo](https://entgo.io) -- Simple, yet powerful ORM for modeling and querying data.
- [Casbin](https://casbin.org/) -- An authorization library that supports access control models like ACL, RBAC, ABAC in Golang
- [Wire](https://github.com/google/wire) -- Compile-time Dependency Injection for Go
## 快速开始
```bash
$ git clone https://github.com/heromicro/omgind
$ cd omgind
# 使用AIR工具运行
$ air
# OR 基于Makefile运行
$ make start
# OR 使用go命令运行
$ go run cmd/omgind/main.go web -c ./configs/config.toml -m ./configs/rbac_model.conf --menu ./configs/menu.yaml
```
> 启动成功之后，可在浏览器中输入地址进行访问：[http://127.0.0.1:10088/swagger/index.html](http://127.0.0.1:10088/swagger/index.html)
## 生成`swagger`文档
```bash
# 基于Makefile
make swagger
# OR 使用swag命令
swag init -d ./cmd/${APP}/,internal/ --output ./internal/app/swagger
```
## 重新生成依赖注入文件
```bash
# 基于Makefile
make wire
# OR 使用wire命令
wire gen ./internal/app
```
## [omgind-cli](https://github.com/heromicro/omgind-cli) 工具使用
### 创建项目
```bash
omgind-cli new -d test-omgind -p test-omgind -m
```
### 快速生成业务模块
#### 创建模板 task.yaml
```bash
name: Task
comment: 任务管理
mixin: "sort, time, active, memo"
fields:
- name: Code
type: string
comment: 任务编号
required: true
max: 16. # 配置最大字符数
min: 0 # 配置最少字符数
index: unique # true, false unique
- name: Name
type: string
comment: 任务名称
required: true
max: 16
min: 0
index: false
- name: Person
type: int32
comment: 任务人数
required: true
max: 32 # 配置最大值
min: 5 # 配置最小值
- name: Memo
type: string
comment: 任务备注
required: false
```
#### format swag comment
```
swag fmt
```
#### 执行生成命令并运行
```bash
cd test-omgind
omgind-cli g -d . -p test-omgind -f ./task.yaml
# 生成 swagger
make swagger
# 生成依赖项
make wire
# 运行服务
make start
```
## 前端工程
- 基于[Ant Design React](https://ant.design/index-cn)版本的实现：[omgind-react](https://github.com/heromicro/omgind-react)
## Questions
### OSX 下基于 `sqlite3` 运行出现：`'stdlib.h' file not found`
```bash
export CGO_ENABLED=1; export CC=gcc; go get -v -x github.com/mattn/go-sqlite3
```
## MIT License
Copyright (c) 2021 heromicro/omgind
[reportcard-url]: https://goreportcard.com/
[reportcard-image]: https://goreportcard.com
[godoc-url]: https://pkg.go.dev/github.com/
[godoc-image]: https://godoc.org/github.com/
[license-url]: http://opensource.org/licenses/MIT
[license-image]: https://img.shields.io/npm/l/express.svg