https://github.com/charly3pins/eShop

E-Commerce project using Hexagonal Architecture (Ports-and-adapters) as a proof-of-concept applying DDD in Go
https://github.com/charly3pins/eShop

ddd e-commerce go golang hexagonal-architecture microservices ports-and-adapters

Last synced: 29 days ago
JSON representation

E-Commerce project using Hexagonal Architecture (Ports-and-adapters) as a proof-of-concept applying DDD in Go

• Host: GitHub
• URL: https://github.com/charly3pins/eShop
• Owner: charly3pins
• Created: 2021-02-03T08:59:26.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-02-07T17:08:15.000Z (almost 4 years ago)
• Last Synced: 2024-08-03T23:30:00.002Z (4 months ago)
• Topics: ddd, e-commerce, go, golang, hexagonal-architecture, microservices, ports-and-adapters
• Language: Go
• Homepage:
• Size: 10.7 KB
• Stars: 38
• Watchers: 3
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-golang-repositories - eShop - Commerce project using Hexagonal Architecture (Ports-and-adapters) as a proof-of-concept applying DDD in Go (Repositories)

README

        
# 🛒🌐 eShop

The aim of this project is to be a proof-of-concept using `Hexagonal Architecture` (Ports-and-adapters) applying `DDD` in `Go` 🔥

The code will be reviewed over time to time while I will introduce new concepts about the Hexagonal Architecture or DDD and new features  to it; so for sure will be refactored several times.

## 👩‍💻 Project

The idea of this project is to support an E-Commerce called `eShop` (super original 🙄). It has to provide a user management system and an order and product catalogue.

The language chosen for this has been `Go` and the database `PostgreSQL`. For the simplicity of the case I've added a `docker-compose` to create the db automatically and a `Makefile` with a few commands described above ✨

## 📐 Architecture

As mentioned before, the project it's using the Hexagonal Architecture and the layers are 📁

- application - it contains the `application services` (the use cases).

- domain - it defines the core of our applications; it contains the `entities`, the `factories` and the `repositories interfaces`.

- infrastructure - it contains the implementation of the `repositories` defined in the domain and the `api` definition (router and handlers).

- cmd - the multiple commands offered by the project.

## 📝 Commands

Use `docker-compose up` to start the database.

Use `make run` to start the server.

Use `make migrations` to run the migrations.

### Sign In User

Endpoint: /users

Request: POST

```

curl -X POST http://localhost:8080/users -d '{"email":"[email protected]", "name":"charly3pins"}'

```

### Add products to Order

Endpoint: /orders

Request: POST

Creating an Order (empty `order_id`)

```

curl -X POST http://localhost:8080/orders -d '{"user_id":"48c20124-824a-4cf6-a377-d2efdc789bf3", "products":[{"name":"DDD book", "unit_price": 35, "currency": "EUR", "quantity": 1}, {"name":"post-it", "unit_price": 2, "currency": "EUR", "quantity": 3}, {"name":"pen", "unit_price": 1, "currency": "EUR", "quantity": 5}]}'

```

Adding a new product to an existing Order (with `order_id`)

```

curl -X POST http://localhost:8080/orders -d '{"user_id":"48c20124-824a-4cf6-a377-d2efdc789bf3", "order_id": "47fafa06-a73a-4733-966b-60914d1dd8ff", "products":[{"name":"IDDD book", "unit_price": 55, "currency": "EUR", "quantity": 1}]}'

```

Updating an existing product to an existing Order (with `order_id` and `product_id`)

```

curl -X POST http://localhost:8080/orders -d '{"user_id":"48c20124-824a-4cf6-a377-d2efdc789bf3", "order_id": "47fafa06-a73a-4733-966b-60914d1dd8ff", "products":[{"product_id":"c92ca476-adcd-4843-a5a3-8c442c2f7d4e", "name":"post-it", "unit_price": 2, "currency": "EUR", "quantity": 10}]}'

```

## 🤝 Contributing

As with all my projects you are more than welcome to contribute. You can open an issue, a pull request or just send me a message and we can chat about the topic you want 🚀