CoolStore Web Application - 🎡 Modern Application on Dapr and Tye ⛵

CoolStore Website is a containerised microservices application consisting of services based on .NET Core running on Dapr. It demonstrates how to wire up small microservices into a larger application using microservice architectural principals.

Read documentation for more information.

The business domain is inspired from CoolStore project by JBoss Demo Central and Red Hat Demo Central.

Check out my medium, or my dev.to or say hi on Twitter!

Dapr Building Blocks

Name	Usecase	Apps Participants
Service-to-service invocation	- User clicks to the detail product - Populate product information for shopping cart items - Order gets detail information of buyer	productcatalogapp, inventoryapp, shoppingcartapp, identityapp
State management	Items in the shopping cart	shoppingcartapp
Publish and subscribe	User clicks checkout button, and the checkout process happens. It triggers the pub/sub flow in the system	shoppingcartapp, saleapp, identityapp
Resource bindings	Every 30 seconds and 1 minutes the validation process happens. It will change the status of order from Received to Process and Complete via Cron binding	productcatalogapp, inventoryapp
Observability	All apps in the application are injected by daprd so that it's tracked and observed by dapr	identityapp, webapigatewayapp, inventoryapp, productcatalogapp, shoppingcartapp, saleapp, web
Secrets	Bind with local secret file to hide password of redis	inventoryapp, productcatalogapp, shoppingcartapp, saleapp
Actors	N/A	N/A

Screenshots

Home page

Shopping Cart page

Order page

Try it

Make sure you have dapr and tye installed on your machine!

Only wanna see wth is it?

$ tye run

Go to http://localhost:8000, and you're able to access to several endpoints whenevever it's ready as below:

Web App: http://localhost:3000
Web Api Gateway: http://localhost:5000
Identity Server: http://localhost:5001

Wanna go deeply to see how can we built it!

Start core components

$ tye run tye.slim.yaml

Start dapr apps locally via dapr cli

$ dapr run --app-port 5001 --app-id identityapp dotnet run -- -p src\Services\Identity\IdentityService\IdentityService.csproj

$ dapr run --app-port 5002 --app-id inventoryapp dotnet run -- -p src\Services\Inventory\InventoryService.Api\InventoryService.Api.csproj

$ dapr run --app-port 5003 --app-id productcatalogapp dotnet run -- -p src\Services\ProductCatalog\ProductCatalogService.Api\ProductCatalogService.Api.csproj

$ dapr run --app-port 5004 --app-id shoppingcartapp dotnet run -- -p src\Services\ShoppingCart\ShoppingCartService.Api\ShoppingCartService.Api.csproj

Now, you can start to develop, debug or explore more about dapr with tye via Coolstore Apps.

Enable vm.max_map_count for ElasticSearch via run sysctl -w vm.max_map_count=262144

OS, SDK, library, tooling and prerequisites

Infrastructure

Windows 10 - The OS for developing and building this demo application.
WSL2 - Ubuntu OS - the subsystem that helps to run easily the bash shell on Windows OS
Docker for desktop (Kubernetes enabled) - The easiest tool to run Docker, Docker Swarm and Kubernetes on Mac and Windows
Kubernetes / AKS - The app is designed to run on Kubernetes (both locally on "Docker for Desktop" as well as on the cloud with AKS)
helm - Best package manager to find, share, and use software built for Kubernetes
dapr - An event-driven, portable runtime for building microservices on cloud and edge
tye - A developer tool that makes developing, testing, and deploying microservices and distributed applications easier

Back-end

.NET Core 5 - .NET Framework and .NET Core, including ASP.NET and ASP.NET Core
IdentityServer4 - Identity and Access Control solution for .NET Core
YARP - A toolkit for developing high-performance HTTP reverse proxy applications
FluentValidation - Popular .NET validation library for building strongly-typed validation rules
MediatR - Simple, unambitious mediator implementation in .NET
EF Core - Modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations
Scrutor - Assembly scanning and decoration extensions for Microsoft.Extensions.DependencyInjection
serilog - Simple .NET logging with fully-structured events
NEST - Elasticsearch.Net & NEST

Front-end

nodejs 10.x - JavaScript runtime built on Chrome's V8 JavaScript engine
typescript - A typed superset of JavaScript that compiles to plain JavaScript
create-react-app - A modern web app by running one command

µService development

Guidance for developing µService can be found at Clean Domain-Driven Design in 10 minutes

Open API

https://documenter.getpostman.com/view/4847807/SVmvUeZv?version=latest#9f5ed7e4-e855-46e5-a42d-64edb31bc1cb

CI/CD

Debug and Tracing Apps

Setup Kibana with TraceId, HandlerName, RequestPath, level and filter with HandlerName

Then, you can find the exception happend in code via Kibana dashboard with settings above. Grab the TraceId, then paste it to Zipkin dashboard, then you can see the tracing of this request as the following picture