The JimCo Retailers demonstration application is a group of four related web applications. It consists of the following parts:
- A back end API written in C# using ASP.Net Core.
- A Retail web site aimed at online shoppers written using React
- An Employee Portal web site aimed at internal employees written using React
- A Vendor Portal web site aimed at Vendors who distribute products to the store written using React
All four 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 three front end web sites. 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 Retail site is written in TypeScript using React functions / hooks, React version 18 and React Router version 6.3. It is responsive down to 375 pixels. It does not currently use any authorization or authentication (though this may change).
Repository here
The Employee Portal is written in TypeScript using React functions / hooks, React version 18 and React Router version 6.3. It is designed specifically for in-store use on tablets or desktop computers and is therefore designed for a minimum screen size of 1024 x 768 pixels. Auth0 is used for authorization, and the internal database is used for role-based authentication.
Repository here
The vendor portal is written in TypeScript using React functions / hooks, React version 18 and React Router version 6.3. It is designed specifically for desktop computers and therefore is designed for a minimum screen resolution of 1024 x 768 pixels. Auth0 is used for Authentication, and the internal database is used for role-based authorization.
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
- @auth0/auth0-react, used to interact with Auth0
- uuid, used to generate uuids