go-clean-architecture-web-application-boilerplate

A web application boilerplate built with go and clean architecture. Most of this application built by standard libray.

Get Started

cp app/.env_example app/.env docker-compose build docker-compose up

After running docker, you need to execute sql files in app/database/sql.

Architecture

app
├── database
│   ├── migrations
│   │   └── schema.sql
│   └── seeds
│       └── faker.sql
├── domain
│   ├── post.go
│   └── user.go
├── infrastructure
│   ├── env.go
│   ├── logger.go
│   ├── router.go
│   └── sqlhandler.go
├── interfaces
│   ├── post_controller.go
│   ├── post_repository.go
│   ├── sqlhandler.go
│   ├── user_controller.go
│   └── user_repository.go
├── log
│   ├── access.log
│   └── error.log
├── main.go
└── usecases
    ├── logger.go
    ├── post_interactor.go
    ├── post_repository.go
    ├── user_interactor.go
    └── user_repository.go

8 directories, 22 files

API

Controller method naming rule

Repository method naming rule

cf. Spring Data JPA - Reference Documentation

Tests

I have no tests because of my laziness, but I will prepare tests in github - gobel-api which is a my more practical clean architecture application with golang.

References

• github - manuelkiessling/go-cleanarchitecture
• github - rymccue/golang-standard-lib-rest-api
• github - hirotakan/go-cleanarchitecture-sample
• Recruit Technologies - Go言語とDependency Injection
• Clean ArchitectureでAPI Serverを構築してみる
• github - ponzu-cms/ponzu
• クリーンアーキテクチャの書籍を読んだのでAPIサーバを実装してみた
• Go × Clean Architectureのサンプル実装
• Uncle Bob – Payroll Case Study (A full implementation)