goseed🌱

Go (golang) based SAAS approach to quick start your project backend

Why goseed?

• 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...

Run the application

# 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/articles

Finally

Any advice, contribution, suggestion are welcome 😊