Go (golang) based SAAS approach to quick start your project backend
- TDD (Test Driven Design) approach
- SAAS approach API (with tenant)
- Clean Infrastructure (inspired by go-clean-arch)
- API Versioning (using echo)
- Database Migration (golang-migrate)
- JWT Authentication method (jwt-go)
- Casbin Authorization (casbin)
- Popular ORM (xorm)
- Application Configuration (viper)
- Logging library (zap)
- Support multilanguages (go-i18n)
- and much more...
# clone repository
git clone https://github.com/sieryuu/goseed.git
# setup your database connection in ./appsettings.json
# if you are not using postgreSql, please change the dialect in ./main.go
# create a database if you havn't created one
# on this example, database name is goseed
# migrate database
migrate -database postgres://postgres:postgres@localhost:5432/goseed?sslmode=disable -path db/migrations up
# 1/u init_table (42.9171ms)
# run the application
go run .
# unit testing
go test ./...cURL
# I am using Windows command prompt for testing
# ping
curl localhost:8888/ping
# login
curl --header "Content-Type: application/json" --request POST --data "{ \"Username\": \"admin\", \"Password\": \"123qwe\"}" localhost:8888/me/login
#output: {"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNTgzMDM5MzQ4fQ.k5RH0bLJaxpfyRdbDXR1-qRWFt-gnhU3YlZV9R_Bcms"}
# using token to request something
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNTgzMDM5MzQ4fQ.k5RH0bLJaxpfyRdbDXR1-qRWFt-gnhU3YlZV9R_Bcms" localhost:8888/v1/domain1/articlesAny advice, contribution, suggestion are welcome 😊