The Beans demonstration application is a game which emulates a commodities market. Players can buy, sell and trade various colored beans amongst themselves or to / from the Exchange. It consists of the following parts:
- A back end API written in C# using ASP.Net Core.
- The web front end, written using React and TypeScript.
- An Azure function (serverless application) that runs once a day to adjust the bean prices.
Both web sites are hosted on Microsoft Azure. The code repositories are hosted on GitHub (see below for links to the individual repositories, or click here to see them all), and CI/CD is handled by Microsoft Azure DevOps.
Repository here
The API is the back end for the front end web site. It is written in C# version 10 using ASP.Net Core / .Net Core version 6. It is architected in a multi-layer approach as shown below:
| Layer Name | Function | Type |
|---|---|---|
| Data Access | The repository layer that handles access to the database | Class Library |
| Services | The business logic layer that sits between the API and Data Access Layers | Class Library |
| API | The web-facing API using minimal endpoints | Web API |
| Models | The DTO models shared between the API and Services Layers | Class Library |
| Common | Common classes, Attributes, Enumerations, extension methods, etc | Class Library |
In addition to the above, the API uses Dapper to access a Microsoft SQL / Azure SQL database.
Repository here
The front end web site is written in TypeScript using React functional components and hooks, React version 18 and React Router version 6.3. It is responsive down to 375 pixels. Auth0 is used to authenticate users.
Repository here
The Background function is used to automate the adjustment of bean prices on a daily basis (currently set to run at 3AM). It is written in C# version 10 using .NET 6.
For the API:
- AspNetCoreRateLimit Used to rate limit requests
- Hashids.net Used to obfuscate Ids sent to end users
- Dapper Used to access the database
- Json.NET a JSON library for .Net
For the Web Sites, the following NPM packages:
- react, react-dom, react-router-dom, react-icons
- @mui/material, used for alerts
- Syncfusion used for Charts, Grids and Notifications badges
- @auth0/auth0-react, used to interact with Auth0
- uuid, used to generate uuids
For the Background Function:
- Serilog used for logging to Azure blob storage