OpenDDD.NET 1.0.0-alpha.17

.NET Core 3.1 This package targets .NET Core 3.1. The package is compatible with this framework or higher.
This is a prerelease version of OpenDDD.NET.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package OpenDDD.NET --version 1.0.0-alpha.17                

                    
                

            
NuGet\Install-Package OpenDDD.NET -Version 1.0.0-alpha.17
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="OpenDDD.NET" Version="1.0.0-alpha.17" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add OpenDDD.NET --version 1.0.0-alpha.17                

                    
                

            
#r "nuget: OpenDDD.NET, 1.0.0-alpha.17"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install OpenDDD.NET as a Cake Addin
#addin nuget:?package=OpenDDD.NET&version=1.0.0-alpha.17&prerelease

// Install OpenDDD.NET as a Cake Tool
#tool nuget:?package=OpenDDD.NET&version=1.0.0-alpha.17&prerelease

OpenDDD.NET

License NuGet

OpenDDD.NET is an open-source framework for domain-driven design (DDD) development using C# and .NET Core. It provides a set of powerful tools and abstractions to help developers build scalable, maintainable, and testable applications following the principles of DDD.

Key Features

  • Aggregates: Define domain aggregates with clear boundaries and encapsulate domain logic within them.
  • Entities and Value Objects: Create entities and value objects to represent domain concepts and ensure strong type safety.
  • Repositories: Define repositories to abstract away data access and enable persistence of domain objects.
  • Domain Events: Implement domain events to facilitate communication between domain objects and decouple them from each other.
  • Application Services: Use application services to coordinate the execution of domain logic and manage transactions.
  • Dependency Injection: Leverage the built-in dependency injection support in .NET Core for easy integration with your application.
  • Testability: OpenDDD.NET promotes testability by providing interfaces and abstractions that allow for easy mocking and unit testing.
  • Hexagonal Architecture: OpenDDD.NET is based on the hexagonal architecture, promoting a clear separation between the core domain and external dependencies.
  • Expand and Contract: The framework follows the expand and contract design pattern, making it easy to add new features without modifying existing code.
  • Dotenv: OpenDDD.NET supports the dotenv pattern for managing configuration and environment-specific settings.

Supported .NET Versions

  • .NET Core 3.1
  • .NET 5

Getting Started

To get started with OpenDDD.NET, follow these simple steps:

  1. Install the NuGet package: Use the NuGet package manager or the .NET CLI to add the OpenDDD.NET package to your project.
dotnet add package OpenDDD.NET
  1. Install the project template: If you want to quickly scaffold new projects using OpenDDD.NET, you can install the OpenDDD.NET project template NuGet package.
dotnet new install OpenDDD.NET-Templates
  1. Create a new project: Use the OpenDDD.NET project template to create a new project with the necessary files, folder structure, and initial configuration already set up.
dotnet new openddd-net -n "MyContext"
  1. Define your domain model: Create domain aggregates, entities, value objects, and repositories according to your domain requirements.
  2. Implement domain logic: Encapsulate your domain logic within aggregates and entities, utilizing domain events when necessary.
  3. Use application services: Create application services to orchestrate the execution of domain logic and manage transactions.
  4. Wire up dependencies: Use the built-in dependency injection support in .NET Core to wire up your domain objects and application services.
  5. Start building your application: Utilize the power of OpenDDD.NET to build scalable and maintainable applications following the principles of DDD.

For detailed documentation and code examples, please refer to the user guide of this repository.

Example Code

You can find example code and usage scenarios in the PowerIAM project, which is an open-source identity and access management system built using OpenDDD.NET.

Release History

  • v1.0.0-alpha.1 (2022-10-02): Initial alpha release.
  • v1.0.0-alpha.2 (2022-10-09): Make the hexagonal architecture pattern more represented in the namespaces.
  • v1.0.0-alpha.3 (2022-11-20): Refactor JwtToken and add IdToken.

For a complete list of releases and their changelogs, please visit the Releases page.

Contributing

We welcome contributions from the community. To contribute to OpenDDD.NET, please follow these steps:

  1. Fork the repository and clone it to your local machine.
  2. Create a new branch for your feature or bug fix.
  3. Implement your changes and ensure that the existing tests pass.
  4. Write new tests to cover your changes and make sure they pass as well.
  5. Commit your changes and push them to your fork.
  6. Submit a pull request with a clear description of your changes and the problem they solve.

Please make sure to review our Contributing Guidelines before submitting a pull request.

License

OpenDDD.NET is licensed under the GPLv3 License. Feel free to use it in your own projects.

Acknowledgements

OpenDDD.NET is inspired by the principles and ideas of Domain-Driven Design (DDD) and the fantastic work done by the DDD community. We would like to thank all the contributors and supporters who have helped make this project possible.

Get in Touch

If you have any questions, suggestions, or feedback, please don't hesitate to reach out to us. You can find more information and ways to contact us on our website.

Let's build better software together with OpenDDD.NET!

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0-alpha.3 94 10/3/2023
2.0.0-alpha.2 82 10/3/2023
2.0.0-alpha.1 80 10/1/2023
1.0.0-alpha.17 91 6/27/2023
1.0.0-alpha.16 92 5/7/2023
1.0.0-alpha.15 100 5/1/2023
1.0.0-alpha.14 92 4/30/2023
1.0.0-alpha.13 93 4/28/2023
1.0.0-alpha.12 98 4/28/2023