matthewrenze / clean-architecture-demo Goto Github PK

A sample app for my online course "Clean Architecture: Patterns, Practices, and Principles" in .NET Framework 4.8

License: BSD 3-Clause "New" or "Revised" License

C# 92.02% CSS 0.39% Gherkin 2.14% HTML 5.28% ASP.NET 0.17%

clean-architecture-demo's Introduction

Clean Architecture Demo

A sample application for Clean Architecture: Patterns, Practices, and Principles using Microsoft .NET Framework 4.8.

This sample application is intended to be a learning tool for clean architecture practices. It incorporates several of these practices in a way that is simple and easy to understand.

If you'd like to learn more about this style of software architecture, please check out my online course Clean Architecture: Patterns, Practices, and Principles.

Branches

There are three branches in this project to demonstrate various practices:

master - contains the simplest implementation used to demonstrate the practices taught in the course at the expense of a bit of coupling with the IDbSet interface from Entity Framework
dbset-adaptor - uses a database adapter to completely decouple the application from the persistence layer -- a cleaner but slightly more complex approach
repo-and-uow - uses the repository and unit of work patterns to completely decouple the application from the persistance layer -- an even cleaner but also more complex approach

Technologies

This demo application uses the following technologies:

.NET Framework 4.8
C# .NET 7.3
ASP.NET MVC 5.2
Entity Framework 6.4
Visual Studio 2022
SQL Server 2019
StructureMap 4.7
NUnit 3.13
Moq 4.18
SpecFlow 3.9

Other Versions

For other versions of this sample application, please see the following:

clean-architecture-demo's People

Contributors

Stargazers

Watchers

Forkers

boriphuth barissonmez ijianhuang mjzone mainul098 lilasquared cshall72 houssemzaier nithinankam moffassal ksks88 ranshers tazmir kennyup jakeryu cangosta sopi allanegidio simonjmartin lennycastaneda joaomajesus laivietanh1986 mahmmad-khamar-shaikh harshaddave14 vasilut abradley91 agholipour southerncoder marioffdsw afnpires jocurativo eggbeard khoatdb anwar-ul-haq zhimaqiao51 jsntcy mh884 evertonqueiroz akhileshpgit renatoapcosta jpcuevas charithsoori displace99 kegeerts snaplucas tormina2r atk0dev ajile-in markokacprzak anhdungitus ajaysaupure blessochampion hathanhhung ryanfiorini markiec13 heyjohnford farfaniriss damianhintz pikamuchu nrifath2009 moanouti andriichernyshov vmdao arsri1981 daniellessio liucy1898 marclongoria alameerashraf wilapark cooray tadasvirsilas kaelragrite ion-dumneanu divpaul2016 jwest80 nmtri1987 rajeeshckr flyabrway ahmed-elmasry iqan oneofbestman jotab okproject princearora28 luqizhen carlovsky666 andyvauliln sunsreng nethol onixus74 marcelloclv amarish-kumar ahedabu sangkyunyoon andressyj24 erlonfs forkedrepo mkindika tejada7 bkrumme

clean-architecture-demo's Issues

Update to .NET Core

Cannot run the test case successfully (VS2022, .NET framework 4.8)

Hi, could you updated the project to .NET 4.8 or newer framework? I face some issue when I try to run this project when training from Pluralsight lesson.

Or are there some suggestions to run this project?

Found issues:

I cannot install .net framework 4.5 sdk in my win10 anymore (microsoft has removed the offical download link).
Seems the package ObjectFactory is out of date. I cannot run the specification project for testing.
EF6 schema and data initalization failed.

Expect result:

Run test case successfully.
EF6 schema and data initalization sucessfully.

Thanks.

Snapshot of Run test case failed:

How to create the database used in the demo

When running the demo app and going to for example the 'Customers' page. I get the following error: 'A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: Named Pipes Provider, error: 40 - Could not open a connection to SQL Server)'

Security

Hi Mathew. I have a Issue, what is best way to do a Security Implementation(user, login, Authorization, etc) in this Architecture? I had tried to implement OWIN inside, but is Hard, because on all, requires access to Database context from presentation layer, and others issues. How do you recomended implements a security middleware or other?

Use webapi on Service layer

Hi Matthew,

I watched your course, and I studied your project. I liked it very much. I would like used in real life, but there is something rare on the service layer : Where can I create a HttpGet or POST service in this layer?
I'd tried this on the Get method:
[HttpGet]
public IEnumerable Get()
{
}
on EmployeesController.cs(CleanArchitecture.Service.Employees), this route must be : http://localhost:49581/api/employees/Get/1, I think so, but It doesn't work, in this kind of project how is the route template in the URI for API services ?

same case for http://localhost:49581/api/Sales/Get/1

Thanks,

Edgar V

Throw a calls-stack details Exceptions Msg when Calling Service (WebApi) project 'Sale By Id=5' endpoints which(SaleId=5) is not existed at Sales DB table

Hi @matthewrenze ,

Thanks for your wonderful PS course and code repo.
I am playing around urs code base and found a handle exception which were showing at swagger page, That Exception Msg was not properly handled in sale middleware-application layer code .
Testcase (Negative )
Calling API End-points -https://localhost:7001/api/sales/5
Above SaleId=5 was not present at Sales DB table and thrown a calls-stack exception msg at swagger page as response. It should be handle in code and return a friendly Msg as response. Attached Screenshot as below

Thanks again for code.

Regards,
Tutul

Thanks,

Paul

Typo in project name

There is a typo in the name of a project. "Persistance" should be changed to "Persistence"

https://github.com/matthewrenze/clean-architecture-demo/tree/master/Persistance

Database creation

I am trying to run this solution, but getting database errors. Should I have SQL Express or LocalDb installed? Do I need to create the database prior to running, or should it be created on build/run?