RCommon
HomeGitHub
  • Introduction
  • Common Scenarios
  • Getting Started
    • Running Examples
    • Roadmap
    • Releases
      • 1.0.1.75
      • 1.0.2.0
      • 2.0.0
      • 2.1.0
  • Topics
    • Fundamentals
      • Configuration
      • Logging
      • GUID Generation
      • Time and Date
      • Emailing
        • SMTP Email
        • SendGrid Email API
      • Data Transfer Objects
        • Pagination
      • Security
        • Current User
        • Claims
      • Events
        • Transactional Events
        • Synchronous Events
        • Asynchronous Events
        • Producers
        • Subscribers
      • Validation
        • Fluent Validation
      • Caching
        • Dynamically Compiled Expressions
        • Persistence Caching
        • Caching Services
        • Redis & Valkey
        • Memory Cache
      • Serialization
        • JSON.NET
        • System.Text.Json
    • Patterns
      • Specification
      • Mediator
        • MediatR
          • Validator Behavior
          • Unit of Work Behavior
          • Logging Behavior
      • CQRS
        • Commands
        • Queries
      • Persistence
        • Repository
          • Entity Framework Core
          • Dapper
          • Linq2Db
        • Transactions
          • Unit of Work
      • Event Bus
        • In Memory
        • MediatR
        • Wolverine
      • Message Bus
        • MassTransit
        • Wolverine
    • Architecture
      • Overview
      • Microservices
      • Clean Architecture
      • Event Driven Architecture
  • Examples
    • Clean Architecture
    • CQRS
    • Mediator: MediatR
    • Event Handling: In Memory
    • Event Handling: MediatR
    • Event Handling: MassTransit
    • Event Handling: Wolverine
    • Validation: Fluent Validation
Powered by GitBook
On this page
  • Requirements
  • Suggested Reading & Courseware
  • Start Up Instructions
  • Login
  1. Getting Started

Running Examples

Running samples for RCommon

PreviousCommon ScenariosNextRoadmap

Last updated 1 year ago

Requirements

  • Visual Studio 2022 Community Edition+

  • SQL Express 2019+

  • Requires EF Tools to be installed to dotnet CLI - 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 which also happens to have a 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 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

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

4. Login with "admin@localhost.com" and Password: "P@ssword1" for administrative functionality and "user@localhost.com"/"P@ssword1" for a basic user functionality

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

https://docs.microsoft.com/en-us/ef/core/cli/dotnet
existing educational solution
Udemy course
the source code
Login for HR Leave Management System