isutare412 / hexago

System architecture PoC tuned for Go.

Hexago

System architecture PoC tuned for Go. The name Hexago was taken from Hexagonal Architecture.

Considerations

• Hexagonal Architecture
  • pkg/controller: Driving adapters
  • pkg/infrastructure: Driven adapters
  • pkg/core: Business logics
• Domain Driven Design
• Dependency Injection
• CQRS with Event Sourcing
• Go Standard Layout

Overview

Modules

Hexago Gateway

API gateway module for hexago service.

Hexago Payment

Payment module for hexago service.

Hexago Common

Includes common libraries of hexago modules.

Infrastructure

1. Run infrastructures using docker compose.

make infra
# 1) up
# 2) down
# 3) ps
# 4) logs
# 5) quit
# Please enter your choice: 1

2. Add local dns to each insfrastructure for local development. Optional for docker environment.

sudo tee -a /etc/hosts > /dev/null <<EOT
127.0.0.1 mongodb
127.0.0.1 kafka1
127.0.0.1 kafka2
EOT

3. Create kafka topics using kafka-ui.
   • donation-request

Test Drive

1. Prepare infrastructures above.

2. Build hexago modules.

make image-gateway
make image-payment

3. Run hexago modules.

make run-gateway
make run-payment

4. Test scenarios.

   • Swagger UI
   • Detailed scenarios

5. Stop hexago modules.

make stop-gateway
make stop-payment