HexaShop is a simple Golang application built to learn and implement hexagonal architecture. It includes APIs for managing users and products, demonstrating the core principles of domain-driven design and separation of concerns.
- User management API (CRUD operations)
- Product management API (CRUD operations)
- Demonstrates hexagonal Architecture (ports & adapters pattern)
This project uses the hexagonal architecture (also known as Ports and Adapters), which aims to create a more modular, loosely-coupled code structure. The business logic (core domain) is separated from the infrastructure (database, HTTP layer), making it easier to test and extend.
- Must have installed
go 1.21.1or latest. - Must have installed task command
-
Run the following command to execute the application
task run
./
├── cmd/
│ └── app/
│ └── main.go
├── conf/
│ └── conf.go
├── internal/
│ ├── adapter/
│ │ ├── http/
│ │ │ ├── api/
│ │ │ │ ├── product.go
│ │ │ │ └── user.go
│ │ │ ├── rq/
│ │ │ │ ├── product.go
│ │ │ │ └── user.go
│ │ │ └── router.go
│ │ └── storage/
│ │ ├── postgres/
│ │ │ ├── migration/
│ │ │ │ ├── 000001_init.down.sql
│ │ │ │ └── 000001_init.up.sql
│ │ │ ├── repo/
│ │ │ │ ├── product.go
│ │ │ │ └── user.go
│ │ │ ├── schema/
│ │ │ │ └── schema.sql
│ │ │ ├── db.go
│ │ │ └── migration.go
│ │ └── redis/
│ ├── core/
│ │ ├── domain/
│ │ │ ├── product.go
│ │ │ └── user.go
│ │ └── service/
│ │ ├── product.go
│ │ └── user.go
│ └── port/
│ ├── product.go
│ └── user.go
├── .env.sample
├── .gitignore
├── README.md
├── Taskfile.yml
├── go.mod
└── go.sum