Skip to content
This repository has been archived by the owner on Aug 14, 2024. It is now read-only.

Concept Point of Sale (POS) system - Blazor UI and micro services

License

Notifications You must be signed in to change notification settings

marinasundstrom/PointOfSale

Repository files navigation

PointOfSale

A Point of Sale app - demonstrating a distributed system supported by a well-crafted UI.

It is a proof of concept. Check the Disclaimer below.

Videos

Background

This is an attempt at learning micro-services and asyncronous messaging that started as simply a "Point of Sale" app.

Due to its nature, learn as you go, this is not the most complete sample.

The Purpose

To learn and share knowledge on how to design and implement a complex project based on [micro] services. And to have fun, at the same time. :)

Feel free to take inspiration from this work of art!

Development approach

It started when crafting a UI and adding the basic functionality. Thinking about the domain, what a User would expect from an app such as this - a general Behavior-centric approach to development.

First there was the Product Catalog, and then came the Cart system. Later the Customers service was added. Then the ability to create Receipts.

Project structure

The distributed app consists of code in .NET 6, using ASP.NET Core, and Blazor for UI.

As a development orchestrator, Tye is used. It has some Docker image dependencies that are also being managed by Tye.

SQL Server, Nginx, RabbitMQ, and Redis, are all running in Docker. Check tye.yaml.

The main services are: Carts, Catalog, Customers, Billing. The supporting project is Marketing which house the Discounts. The rest are in a basic state, with some not interacting with the main app.

Disclaimer

This is an educational effort that was created for fun when trying to understand the domain and how to implement it. It has never been made with any intention to be set into production.

It SHOULD NOT be used in production.

How to run

First, make sure that .NET 6 SDK and the Tye global tools are installed. You also need Docker.

Then, in the solution root directory, run:

tye run

This will start all the services and Docker containers.

Dashboard:

http://localhost:8000

Point of Sales UI:

https://localhost:8080/

You have to configure the certificates for SSL to work with Nginx. Check cert.md.

About

Concept Point of Sale (POS) system - Blazor UI and micro services

Topics

Resources

License

Stars

Watchers

Forks

Languages