https://github.com/jadhielv/itl

Sample Web API implementation with .NET Core and DDD using Clean Architecture.
https://github.com/jadhielv/itl

collaborate communityexchange ddd-architecture dotnetcore educative fluentvalidation github hacktoberfest mssql nunit student-vscode vuejs

Last synced: 5 days ago
JSON representation

Sample Web API implementation with .NET Core and DDD using Clean Architecture.

• Host: GitHub
• URL: https://github.com/jadhielv/itl
• Owner: Jadhielv
• License: mit
• Created: 2020-11-24T03:11:25.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2025-01-28T01:27:49.000Z (7 days ago)
• Last Synced: 2025-01-28T22:22:43.008Z (6 days ago)
• Topics: collaborate, communityexchange, ddd-architecture, dotnetcore, educative, fluentvalidation, github, hacktoberfest, mssql, nunit, student-vscode, vuejs
• Language: C#
• Homepage:
• Size: 6.18 MB
• Stars: 66
• Watchers: 7
• Forks: 13
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# ITL

Sample Web API implementation with .NET Core and DDD using Clean Architecture.

## Solution Design

The solution design focuses on a basic Domain Driven Design techniques and implementation, while keeping the things as simple as possible but can be extended as needed. Multiple assemblies are used for separation of concerns to keep logic isolated from the other components. **.NET 8 C#** is the default framework and language for this application.

### Assembly Layers

-   **ITL.Domain**  - This assembly contains common, entities and interfaces.

-   **ITL.Application**  - This assembly contains all services implementations.

-   **ITL.Infrastructure**  - This assembly contains the infrastructure of data persistence.

-   **ITL.API**  - This assembly is the web api host.

-   **ITL.Tests**  - This assembly contains unit test classes based on the [NUnit](https://github.com/nunit/nunit) testing framework.

## How to contribute

> :thought_balloon: If you are new in Open Source world feel free to check our [How to contribute guidelines](https://github.com/Jadhielv/ITL/blob/master/CONTRIBUTING.md)

## Validation

Data validation using [FluentValidation](https://github.com/JeremySkinner/FluentValidation)

## How to run application: 

[(Backend)](https://github.com/Jadhielv/ITL/tree/master/Backend)

1. Create empty database, name: **`KCTest`**.

2. Execute [migrations](https://github.com/Jadhielv/ITL/tree/master/Backend/src/ITL.Infrastructure/Migrations).

2. Set connection string (in [appsettings.json](https://github.com/Jadhielv/ITL/blob/master/Backend/src/ITL.API/appsettings.json) or by user secrets mechanism).

3. Run .. .

[(kctest-frontend)](https://github.com/Jadhielv/ITL/tree/master/kctest-frontend)

Follow the instructions in [README](https://github.com/Jadhielv/ITL/blob/master/kctest-frontend/README.md) file.

## ¡Give a Star!

If you like this project, learn something or you are using it in your applications, please give it a star. Thanks! .. .

## License

This project is open source and available under the -> [MIT License](LICENSE)