Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CanerPatir/aspnet-core-clean-arch
It is a clean architecture project template which is based on hexagonal-architecture principles built with .Net core.
https://github.com/CanerPatir/aspnet-core-clean-arch
clean-architecture clean-code ddd-architecture ddd-sample dotnet-core hexagonal-architecture microservice mongodb onion-architecture port-and-adapters tdd
Last synced: 1 day ago
JSON representation
It is a clean architecture project template which is based on hexagonal-architecture principles built with .Net core.
- Host: GitHub
- URL: https://github.com/CanerPatir/aspnet-core-clean-arch
- Owner: CanerPatir
- License: apache-2.0
- Created: 2019-05-01T16:18:02.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T01:15:23.000Z (over 1 year ago)
- Last Synced: 2024-05-29T02:35:17.217Z (6 months ago)
- Topics: clean-architecture, clean-code, ddd-architecture, ddd-sample, dotnet-core, hexagonal-architecture, microservice, mongodb, onion-architecture, port-and-adapters, tdd
- Language: C#
- Homepage:
- Size: 211 KB
- Stars: 162
- Watchers: 7
- Forks: 34
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Experimental Product Domain Based On Hexagonal Architecture Principles
This project is a sample application built using .NET Core. The main goal of this project is implementing and better understanding DDD and hexagonal architecture principles.
# Also known as
* Ports and Adapters
* Clean Architecture
* Onion Architecture
# Hexagonal architecture
With hexagonal architecture
* Domain layer contains enterprise wide logic and types and does not depend anything except these
* Application layer contains business logic and types
* Infrastructure layer (including persistence, messaging, logging, presentation) contains all external concerns
* Presentation and Infrastructure layers depend only on Application
* Infrastructure dependencies can be replaced
with minimal effort. For instance, we can switch data store without touching business code.
## Getting Started
Use these instructions to get the project up and running.
### Prerequisites
You will need the following tools:
* [Visual Studio Code or 2019](https://www.visualstudio.com/downloads/) or [JetBrains Rider](https://www.jetbrains.com/rider/download)
* [.NET Core SDK 3.0](https://www.microsoft.com/net/download/dotnet-core/3.0)
### Setup
Follow these steps to get your development environment set up:
1. Clone the repository
2. At the root directory, restore dependencies
```
dotnet restore
```
3. Build the solution
```
dotnet build
```
5. Run tests
```
dotnet test
```
## Technologies
* .NET Core 3.0
* ASP.NET Core 3.0
## License
This project is licensed under the MIT License - see the [LICENSE.md](https://github.com/CanerPatir/aspnet-core-clean-arch/blob/master/LICENSE) file for details.
## References
* https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/
* https://blog.ploeh.dk/2013/12/03/layers-onions-ports-adapters-its-all-the-same/