Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Here's why:

ASP.NET Core MVC with controllers and views. Razor Pages is a new alternative in ASP.NET Core, a page-based programming model that makes building web UI easier and more productive.

• Easier to follow.
• Covers more features.
• Preferred approach for new app development.

With a layered architecture, applications can enforce restrictions on which layers can communicate with other layers. This architecture helps to achieve encapsulation. When a layer is changed or replaced, only those layers that work with it should be impacted. By limiting which layers depend on which other layers, the impact of changes can be mitigated so that a single change doesn't impact the entire application.

You will find answers to the following questions

• How do we develop a project with N-Layer Architecture?
• How to use the Code First Approach with Entity Framework Core 5.0?
• How do We Configure a Detailed Database with the Fluent API?
• How do we apply a Generic Repository Design Pattern
• How to implement a Unit of Work Design Pattern?
• What can we do with Asynchronous Programming.
• How do we implement Object-Oriented Programming in our project
• How do we make Front-End Validations with Data Annotations
• How do we implement Dependency Injection on Layered Architecture.
• Is it necessary to write Extension Methods
• What is the Result Structure
• How do we use DTO (Data Transfer Object)
• Use of the AutoMapper Library
• How to Perform the Use of the AutoMapper Library
• How to apply Paging, Sorting, Filtering to a our project.
• How do we perform Image & File Upload Operations.
• How do we set up the Authentication & Authorization mechanization.
• How do we write javascript-based software such as Ajax, Jquery.
• How do I integrate Toaster, DataTables, Trumbowyg, Select2.

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section.

• Microsoft SQL Server
• MVC
• AJAX
• Jquerry
• Bootstrap

Technologies and Methods

• Developing a Project With N Layered Architecture
• Entity Framework Core 5.0 Code First
• Database Configurations With Fluent API
• Generic Repository Pattern
• Unit of Work Pattern
• Async Programming
• OOP
• Dependency Injection In N Layered Architecture
• Extension Methods
• Custom Result Structure
• DTO (Data Transfer Object)
• AutoMapper AutoMapper Library
• MD5 Password Hashing
• SHA512 Password Hashing
• Paging, Sorting, Filtering
• LINQ
• File & Image Upload
• User Management System with Identity
• Ajax, Jquerry, Jquerry UI
• Sweet Alert2, Toastr, DataTables, Trumbowyg, Select2
• Bootstrap 4.5

(back to top)

Getting Started

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

• dotnet Blogesque.Data.csproj

   <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="5.0.14" />
   <PackageReference Include="Microsoft.EntityFrameworkCore" Version="5.0.14" />
   <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.14">
   <PrivateAssets>all</PrivateAssets>
   <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
   </PackageReference>
   <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.14" />
   <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.14">
   <PrivateAssets>all</PrivateAssets>
   <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
   </PackageReference>

• dotnet Villagenix.Client.csproj

  <PackageReference Include="Blazored.LocalStorage" Version="3.0.0" />
  <PackageReference Include="Microsoft.AspNetCore.Components.Authorization" Version="5.0.14" />
  <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="5.0.0" />
  <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="5.0.0" />
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
  <PackageReference Include="System.Net.Http.Json" Version="5.0.0" />

• dotnet Blogesque.Entities.csproj

  <PackageReference Include="Microsoft.Extensions.Identity.Stores" Version="5.0.14" />

• dotnet Blogesque.Mvc.csproj

  <PackageReference Include="AutoMapper" Version="11.0.1" />
  <PackageReference Include="AutoMapper.Extensions.Microsoft.DependencyInjection" Version="11.0.0" />
  <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation" Version="5.0.14" />
  <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.14">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  </PackageReference>
  <PackageReference Include="NLog" Version="4.7.13" />
  <PackageReference Include="NLog.Web.AspNetCore" Version="4.14.0" />
  <PackageReference Include="NToastNotify" Version="7.0.0" />
  <PackageReference Include="System.Data.SqlClient" Version="4.8.3" />

• dotnet Blogesque.Services.csproj

  <PackageReference Include="AutoMapper" Version="11.0.1" />
  <PackageReference Include="AutoMapper.Extensions.Microsoft.DependencyInjection" Version="11.0.0" />
  <PackageReference Include="Microsoft.AspNetCore.Identity" Version="2.2.0" />

• dotnet Blogesque.Shared.csproj

  <PackageReference Include="LinqKit.Microsoft.EntityFrameworkCore" Version="5.1.0" />
  <PackageReference Include="Microsoft.AspNetCore.Mvc.Core" Version="2.2.5" />
  <PackageReference Include="Microsoft.AspNetCore.Mvc.ViewFeatures" Version="2.2.0" />
  <PackageReference Include="Microsoft.EntityFrameworkCore" Version="5.0.14" />
  <PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="5.0.0" />

Installation

1. Clone the repo

   https://github.com/BerkayKulak/Blogesque.git

2. Update Nuget packages

   dotnet tool update <PACKAGE_ID> -g|--global

3. Add Migration

   dotnet ef migrations add InitialCreate

4. Update Database

   dotnet ef database update

(back to top)

Usage

# Go into the Blogesque.Mvc
$ cd \Blogesque\Blogesque.Mvc

# Run the app
$ dotnet run
$ dotnet run --project ./projects/proj1/proj1.csproj

(back to top)

Bug / Feature Request

If you find a bug (the website couldn't handle the query and / or gave undesired results), kindly open an issue here by including your search query and the expected result.

If you'd like to request a new function, feel free to do so by opening an issue here. Please include sample queries and their corresponding results.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Berkay Kulak - (https://www.linkedin.com/in/berkay-kulak-3442311b1/) - kulakberkay15@gmail.com

Project Link: (https://github.com/BerkayKulak/Blogesque)

(back to top)