https://github.com/leonsteinhaeuser/demo-shop
A simple Go based demo microservice application.
https://github.com/leonsteinhaeuser/demo-shop
Last synced: 4 months ago
JSON representation
A simple Go based demo microservice application.
- Host: GitHub
- URL: https://github.com/leonsteinhaeuser/demo-shop
- Owner: leonsteinhaeuser
- License: apache-2.0
- Created: 2025-07-20T19:28:55.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-02-15T16:37:06.000Z (4 months ago)
- Last Synced: 2026-02-15T23:37:14.585Z (4 months ago)
- Language: Go
- Size: 372 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# demo-shop
A simple Go based demo microservice application.
## What is this?
This demo microservice application is designed to showcase the capabilities of a microservices architecture using Go. It demonstrates how to build cloud native applications with a focus on scalability, resilience, and maintainability. A key aspect of this application is to demonstrate how to integrate tracing and monitoring. Each microservice is designed to be independently deployable and scalable. The application is built around the following services:
| Service Name | Description |
|--------------|-------------|
| User Service | Manages user accounts |
| Item Service | Handles product catalog and inventory |
| Cart Service | Manages shopping cart functionality |
| Cart Presentation Service | Renders the cart details as single JSON object (references to items are resolved) |
| Checkout Service | Manages the checkout process |
| Gateway Service | Acts as an authentication and authorization proxy for the microservices |
| Frontend Service | Provides the user interface for the application |
### Flow Diagram
```mermaid
graph TD;
A[Frontend] --> B[Gateway];
B --> C[User Service];
B --> D[Item Service];
B --> E[Cart Service];
B --> F[Cart Presentation];
B --> G[Checkout Service];
F --> D;
F --> E;
G --> D;
G --> E;
```
## Local Development
### Requirements
- Podman >= 5.5.1
- Go >= 1.24
### How to start
To simplify the process of startup for all microservices, a `Makefile` is provided. You can use the following commands to start the application:
| Command | Description |
|---------------|---------------------------------|
| `make run` | Start all services in the foreground |
| `make rund` | Start all services in detached mode |
| `make down` | Stop all services |
| `make test` | Execute unit tests with coverage |
| `make test-short` | Execute unit tests in short mode |
| `make lint` | Run code linters |
| `make clean` | Format code with gofmt |
| `make install-tools` | Install development tools |
| `make help` | Print help information |