Sample implementation of the Clean Architecture Principles with .NET Core. Use cases as central organizing structure, decoupled from frameworks and technology details. Built by small components that are developed and tested in isolation.

We support two versions:

• .NET 6 - .NET 6.
• .NET 5 - .NET 5.
• .NET Core 3.1 - .NET Core 3.1.

Hit the WATCH button to get the latest Clean Architecture updates.

Manga is a Virtual Wallet Solution in which the customer register an account then manage the balance by Deposit, Withdraw and Transfer operations.

We also support the React client:

To startup the whole solution, execute the following command:

Windows:

PS cd .docker && ./setup.ps1

MacOS:

$ cd .docker && ./setup.sh

Then the following containers should be running on docker ps:

Browse to https://wallet.local:8081 then click on Log In. If asked trust the self-signed certificate.

Learn how to design modular applications.

Explore the .NET Core features.

Learning how to design modular applications will help you become a better engineer. Designing modular applications is the holy grail of software architecture, it is hard to find engineers experienced on designing applications which allows adding new features in a steady speed.

.NET Core brings a sweet development environment, an extensible and cross-platform framework. We will explore the benefits of it in the infrastructure layer and we will reduce its importance in the application and domain layers. The same rule is applied for modern C# language syntax.

This is continually updated, open source project.

Contributions are welcome!

Learn from the community.

Feel free to submit pull requests to help:

• Fix errors.
• Refactoring.
• Build the Front End.
• Submit issues and bugs.

The Discussão em Português is pinned for the large community of brazillian developers.

• Motivation
  • Learn how to design modular applications
  • Explore the .NET Core features
  • Learn from the open source community
• Contributing

• Register Flow of Control
• Get Customer Details Flow of Control

• Hexagonal Architecture Style
  • Ports
  • Adapters
  • The Left Side
  • The Right Side
• Onion Architecture Style
• Clean Architecture Style

• Controller
• ViewModel
• Presenter
  • Standard Output
  • Error Output
  • Alternative Output
• Unit of Work
• First-Class Collections
• Factory

• Value Object
• Entity
• Aggregate Root
• Repository
• Use Case

• Domain
• Application
• Infrastructure
• User Interface

• Single Responsibility Principle
• Open-Closed Principle
• Liskov Substitution Principle
• Interface Segregation Principle
• Dependency Inversion Principle

• Swagger and API Versioning
• Microsoft Extensions
• Feature Flags
• Logging
• Data Annotations
• Authentication
• Authorization

• Add Migration
• Update Database

• Running the Application Locally
• Running the Tests Locally
• Continuous Integration & Continuous Deployment

• SQL Server

Thanks goes to these wonderful people (emoji key):

Ivan Paulovich 🎨 ⚠️ 💻	Petr Sedláček ⚠️ 💻	Gus 🎨 ⚠️	arulconsultant ⚠️	Guilherme Silva 🎨 ⚠️ 💻
Ondřej Štorc 🎨 ⚠️	Marlon Miranda da Silva 🎨 ⚠️	NicoCG ⚠️	Filipe Augusto Lima de Souza 🎨 ⚠️ 💻	sshaw-sml ⚠️ 💻
Matheus Neder ⚠️	димитрий матиенко 🎨 ⚠️	morphlogic ⚠️ 💻	Felipe Lambert ⚠️ 💻	Philippe Matray 🎨 💻
Leandro Fagundes 💬	Bart van Ommen 🤔 💻	qpippop 🤔	Cesar Pereira 💻	Edvaldo Farias 💻
Sergio Broccardi 💻	cuno92 💻	Vinícius Mamoré 💻	dyavolick 💻	felipetofoli 🎨 💻
Charith De Silva 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Hit the FORK button and show Clean Architecture on your profile.