ASP Dotnet Core Clean Architecture

The purpose of this template is to provide a robust and streamlined methodology for enterprise application development. By capitalizing on the strengths of Clean Architecture and ASP.NET Core, it ensures a maintainable, scalable, and efficient development process. This approach not only simplifies the complexity of enterprise systems but also enhances their performance and longevity.

Check out the Project Page to learn more about this Open Source Project.

Getting Started

Download the Extension

Download this Extension and install it on your machine. Make sure Visual Studio 2022 is installed on your machine with the latest SDK.

Follow these Steps to get started.

You Solution Template is Ready!

Next, open the appsettings.json file in WebAPI to modify the ConnectionStrings if necessary.

Finally, build and run the Application.

Default Roles & Credentials

As soon you build and run your application, default users and roles get added to the database.

Default Roles are as follows.

• Admin

Here are the credentials for the default users.

• UserName - Admin / Password - Sam@12345

You can use these default credentials to generate valid JWTokens at the ../api/v1/Account/Authenticate endpoint.

Purpose of this Project

Does it really make sense to Setup your ASP.NET Core Solution everytime you start a new WebApi Project ? Aren't we wasting quite a lot of time in doing this over and over gain?

This is the exact Problem that I intend to solve with this Full-Fledged ASP.NET Core 9 WebApi Solution Template, that also follows various principles of Clean Architecture.

The primary goal is to create a Full-Fledged implementation, that is well documented along with the steps taken to build this Solution from Scratch. This Solution Template will also be available within Visual Studio 2022 (by installing the required Nuget Package / Extension).

Demonstrate Clean Monolith Architecture in ASP.NET Core 9

• This is not a Proof of Concept
• Implementation that is ready for Production
• Integrate the most essential libraries and packages

Frequently Asked Questions (FAQ)

To see the frequently asked questions and find answers related to using and developing the project, please refer to the FAQ file. This file includes common questions you might encounter while working with the project and provides links to the relevant documentation.

Read the FAQ

Give a Star ⭐️

If you found this Implementation helpful or used it in your Projects, do give it a star. Thanks!

Technologies

• ASP.NET Core 9 WebApi
• REST Standards

Features

• Clean Architecture
• CQRS with MediatR Library
• Entity Framework Core - Code First
• Repository Pattern - Generic
• Serilog
• Swagger UI
• Response Wrappers
• Healthchecks
• Pagination
• Microsoft Identity with JWT Authentication
• Role based Authorization
• Identity Seeding
• Database Seeding
• Custom Exception Handling Middlewares
• API Versioning
• Localization ( fa - en )
• Fluent Validation
• Complete User Management Module ( Register - Authenticate - Change UserName - Change Password )
• User Auditing
• TestProjects ( FunctionalTests - UnitTests - IntegrationTests )

Prerequisites

• Visual Studio 2022 Community and above
• .NET Core 9 SDK and above
• Basic Understanding of Architectures and Clean Code Principles

Share it!

I have personally not come across a clean implementation on a WebAPI, which is the reason that I started building this up. There are quite a lot of improvements and fixes along the way from the day I started out. Thanks to the community for the support and suggestions. Please share this Repository within your developer community, if you think that this would a difference! Thanks.

About the Author

Saman Azadi

• Twitter - Saman Azadi
• Linkedin - Saman Azadi
• Github - Saman Azadi