progcoder-shop-microservices

(★ 123)

Microservices E-commerce on .NET, ASP.NET Core, Docker, RabbitMQ, MassTransit, gRPC, YARP, PostgreSQL, MySQL, MongoDB, Redis, Elasticsearch, EF Core, Marten, CQRS, MediatR, Clean Architecture, Keycloak, OpenTelemetry, Prometheus, Grafana, React

File Explorer

Download Latest Version (.zip)

Showing a partial file list — download the zip above to see everything.

- - bug_report.md
  - feature_request.md
- - _ci.yml
  - bild-and-deploy.yml
  - build-react-apps.yml
  - build-services.yml
- CODE_OF_CONDUCT.md
- FUNDING.yml
- pull_request_template.md
- SECURITY.md
- - clean_architecture.png
  - github_actions_flows.png
  - grafana_logs.png
  - grafana_monitoring.png
  - microservices_architecture.png
  - ProGCoder.ComCopyright.png
  - vertical_slice_architecture.png
- - ProG Coder Shop Micrservices.postman_collection.json
- - config.yml
  - web.yml
- - watermark_settings.sh
- - grafana.ini
- - loki-config.yml
- - ngrok.exe
  - ngrok.yml
  - README.md
- - otel-collector-config.yaml
- - 01-create-multiple-dbs.sh
- - alert.rules
  - prometheus.yml
  - web.yml
- - promtail-config.yml
- - rabbitmq_enabled_plugins
- - add_datasources.sh
- - tempo.yaml
- add-migration.sh
- run-migration.sh
- Directory.Build.props
- Directory.Packages.props
.coderabbit.yaml
.dockerignore
.env.sample
.gitignore
CONTRIBUTING.md
docker-compose.infrastructure.yml
docker-compose.yml
DONATE.md
LICENSE
Makefile
progcoder-shop-microservices.sln
README.md

# Installation Guide

1. Get the code

git clone https://github.com/huynxtb/progcoder-shop-microservices

Downloads the entire project code from GitHub to your computer.

cd progcoder-shop-microservices

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

├── docker-compose.infrastructure.yml # Infrastructure services

Runs the command against the services defined in the compose file.

├── docker-compose.yml # Application services

Runs the command against the services defined in the compose file.

docker ps

Type this command into your terminal and run it.

docker ps -a

Type this command into your terminal and run it.

docker exec -it [container-name] bash

Type this command into your terminal and run it.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

3. .NET

Medium

Prerequisites

Git Needed to download the project code from GitHub.
.NET SDK The SDK required for the dotnet command.

dotnet restore

Downloads the packages the project depends on.

dotnet run

Builds the project and runs it immediately.

✅ After dotnet run, check the message or address shown in the terminal.

4. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

cd src/Apps/App.Admin

This project's files live in a subfolder, so move into it first.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

5. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make env