A fully-featured REST API developed in Golang for an ebook store.

Check out the TODO.md if you want to have some fun 😇

• Features
• Tech/Libraries
• High-level Documentation
  • System Context Diagram
  • Backend Container Diagram
  • Design Principles / Techniques
• Local Development
  • How to Run Locally
  • How to Lint Project
  • How to Use Husky Git pre-commit hook
  • How Generate Seed Data
  • How to Regenerate Mocks
  • How to Regenerate REST API Documentation
  • How to Regenerate Dependency Initialization

• Authentication (Sign up, Login and Reset Password)
• Multiple Roles (Customer and Administrator)
• Book Catalog Management
• Order Management
• Pagination
• Order Creation
• File Storage/Retrieval
• Payment Management

• Golang
• Gin
• PostgreSQL
• GORM
• JWT
• Bcrypt
• Wire
• Viper
• Zap
• Stripe
• Amazon S3
• Amazon SES
• Swagger
• Localstack
• Testify
• golangci-lint

This is a high-level technical documentation about how this application is structured. The diagrams follow the C4 model

• SOLID Principles
• Hexagonal Architecture
• Domain Driver Design
• Package by Feature
• Test-Driven-Development

1. Execute docker containers

make docker-up

2. Execute REST HTTP Server

make start_server

3. Open http://localhost:8080/docs in your browser

1. Install golangci-lint

go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

2. Execute lint target

make lint

Pre-commit hooks are very useful to prevent commits with bad code.

1. Install Husky

go install github.com/go-courier/husky/cmd/husky@latest

2. Init Husky

husky init

1. Execute docker containers

make docker-up

2. Clean database and generate seed data

make generate_seed_data

1. Install Mockery

go install github.com/vektra/mockery/v2@latest

2. Generate Mocks

make generate-mocks

1. Install Swaggo

go install github.com/swaggo/swag/cmd/[email protected]

2. Generate Docs

make api-docs

1. Install wire

go install github.com/google/wire/cmd/wire@latest

2. Execute wire

make wire