Running Examples

Running samples for RCommon

Requirements

• Visual Studio 2022 Community Edition+

• SQL Express 2019+

• Requires EF Tools to be installed to dotnet CLI https://docs.microsoft.com/en-us/ef/core/cli/dotnet - include updates.

Suggested Reading & Courseware

There is a lot to do with RCommon. It can be used simply as a library of extensions/helpers to assist you with day-to-day programming, or you can build substantially complicated solutions from it. Our samples will focus on some of the heavier lifting done when building loosely coupled, future proofed applications.

Our "Clean Architecture with CQRS" sample was built from an existing educational solution which also happens to have a Udemy course available for it. We don't have anything to do with the courseware but we like it. This is a good place to start as it will provide a straight forward approach to building a loosely coupled application using patterns like CQRS, Mediator, Unit of Work, Repository Pattern, and more. RCommon extends this sample by demonstrating how easy, and efficient it is to use our persistence libraries along with our data services to implement unit of work.

Start Up Instructions

1. Download or clone the source code from GitHub

2. Right click on the HR.LeaveManagement.API project

3. Choose "Open in Terminal" from menu

4. Refer to Developer Powershell

5. Run commands below:

   • dotnet ef database update --context LeaveManagementDbContext

   • dotnet ef database update --context LeaveManagementIdentityDbContext

6. Right click solution and choose "Set Startup Projects" from menu.

7. Choose "HR.LeaveManagement.MVC" and "HR.LeaveManagement.API" from menu options.

8. Build and Start Solution

Login

At this point you should have a solution that compiles, and runs and you'll be presented with two browser windows:

1. The Swagger API for the HR Leave Management System

2. The User Interface for the HR Leave Management System

Login for HR Leave Management System

3. Choose the "Login" link at the top right

4. Login with "[e-mail]" and Password: "P@ssword1" for administrative functionality and "[e-mail]"/"P@ssword1" for a basic user functionality

5. From here, you can feel free to explore the application.