{"id":13836583,"url":"https://github.com/ThembisileNGQ/Akkatecture","last_synced_at":"2025-07-10T15:33:11.539Z","repository":{"id":30800845,"uuid":"126046891","full_name":"ThembisileNGQ/Akkatecture","owner":"ThembisileNGQ","description":"a cqrs and event sourcing framework for dotnet core using akka.net","archived":false,"fork":false,"pushed_at":"2022-12-08T08:56:53.000Z","size":1819,"stargazers_count":526,"open_issues_count":16,"forks_count":54,"subscribers_count":35,"default_branch":"dev","last_synced_at":"2025-06-15T04:02:05.065Z","etag":null,"topics":["actors","actorsystem","akka","akkadotnet","clustering","cqrs","cqrs-pattern","csharp","ddd","domain-driven-design","dotnet-core","event-driven","event-sourcing","microservices","microsoft","netstandard"],"latest_commit_sha":null,"homepage":"https://akkatecture.net","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThembisileNGQ.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"lutando","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"custom":null}},"created_at":"2018-03-20T16:18:28.000Z","updated_at":"2025-03-26T08:47:58.000Z","dependencies_parsed_at":"2023-01-14T17:42:44.553Z","dependency_job_id":null,"html_url":"https://github.com/ThembisileNGQ/Akkatecture","commit_stats":null,"previous_names":["lutando/akkatecture"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/ThembisileNGQ/Akkatecture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThembisileNGQ%2FAkkatecture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThembisileNGQ%2FAkkatecture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThembisileNGQ%2FAkkatecture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThembisileNGQ%2FAkkatecture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThembisileNGQ","download_url":"https://codeload.github.com/ThembisileNGQ/Akkatecture/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThembisileNGQ%2FAkkatecture/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261178652,"owners_count":23120838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actors","actorsystem","akka","akkadotnet","clustering","cqrs","cqrs-pattern","csharp","ddd","domain-driven-design","dotnet-core","event-driven","event-sourcing","microservices","microsoft","netstandard"],"created_at":"2024-08-04T15:00:50.314Z","updated_at":"2025-07-10T15:33:10.693Z","avatar_url":"https://github.com/ThembisileNGQ.png","language":"C#","funding_links":["https://github.com/sponsors/lutando"],"categories":["Application Frameworks"],"sub_categories":["CQRS+ES"],"readme":"\n\u003ca href=\"https://akkatecture.net/\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Lutando/Akkatecture/master/logo.svg?sanitize=true\" width=\"100%\" height=\"200\"\u003e\u003c/a\u003e\n\n\n| nuget | master | dev | code coverage | chat | who are we? |\n|-------|:------:|:---:|:---:|:----:|-------------|\n| [![Nuget Package](https://img.shields.io/nuget/v/Akkatecture.svg?style=flat\u0026logo=nuget)](https://www.nuget.org/packages/Akkatecture/) | [![Build status](https://dev.azure.com/lutando/Akkatecture/_apis/build/status/Akkatecture%20Master%20CI%20CD?branchName=master)](https://dev.azure.com/lutando/Akkatecture/_build/latest?definitionId=2) | [![Build status](https://dev.azure.com/lutando/Akkatecture/_apis/build/status/Akkatecture%20Development%20CI%20CD?branchName=dev)](https://dev.azure.com/lutando/Akkatecture/_build/latest?definitionId=1) | [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=Lutando_Akkatecture\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=Lutando_Akkatecture) | [![Come Chat](https://img.shields.io/discord/440517592545755137.svg?logo=discord)](https://akkatecture.net/community) | [![we are reactive](https://img.shields.io/badge/we_are-reactive-blue.svg?style=flat)](https://www.reactivemanifesto.org/) |\n\n# Akkatecture\n\nAkkatecture is a cqrs and event sourcing framework for dotnet core, build ontop of akka.net. Fully optimised around using akka's highly scalable message passing and event stream pub sub mechanisms. Akkatecture targets `netstandard2.0`.\n\nGo ahead and take a look at [our documentation](http://akkatecture.net/docs/getting-started), go over [some concepts](http://akkatecture.net/docs/primitives), and read the [tips and tricks](http://akkatecture.net/docs/tips-and-tricks).\n\n\n### Features\n\n* **Distributed:** Each aggregate can operate concurrently in parallel inside of the actor system with isolated failure boundaries.\n* **Message based:** Making it highly scalable by being reactive from message passing, Akkatecture [does not ask, it tells](http://bartoszsypytkowski.com/dont-ask-tell-2/).\n* **Event sourced:** By design, aggregate roots derive their state by replaying persisted events.\n* **Highly scalable:** Work proceeds interactively and concurrently, overlapping in time, and may be done across nodes.\n* **Configurable:** Through akka.net's hocon configuration, you will be able to configure every aspect of your application.\n\n### Examples\n\nAkkatecture comes with a few prescribed examples on how one might use it:\n\n* **[Simple](https://github.com/Lutando/Akkatecture/tree/dev/examples/simple):** A simple console based example that shows the most simple example of how to create an aggregate and issue commands to it.\n\n* **[Walkthrough](https://github.com/Akkatecture/Walkthrough):** Tutorial style sample based on the walkthrough in the Akkatecture documentation. The walkthrough proposes domain that should be modelled based on some business requirements. The walkthrough goes step by step covering all the primitives and features covered in Akkatecture to give you an understanding of the framework. The beginning of the walkthrough can be found [here](https://akkatecture.net/docs/walkthrough-introduction).\n\n\n* **[Cluster](https://github.com/Lutando/Akkatecture/tree/dev/examples/cluster):** A more involved sample that shows you how to do distributed aggregates using clustering. Read the [readme](https://github.com/Lutando/Akkatecture/tree/dev/examples/cluster/README.md) for the sample for a good overview of the example.\n\n* **[Web](https://github.com/Lutando/Akkatecture/tree/dev/examples/web):** This sample shows how to integrate akka into an aspnet core project, specifically how to inject actor references when using akkatecture. Furthermore this project models a long running process that might be run behind a web application or something similar. Read the [readme](https://github.com/Lutando/Akkatecture/tree/dev/examples/web/README.md) for more detailed information about the example.\n\n* **[Jobs](https://github.com/Lutando/Akkatecture/tree/dev/examples/jobs):** A simple sample that demonstrates how you would make a scheduled persistent job. Jobs are commands that can be persisted and scheduled to be executed at any arbitrary trigger point in time. Read the [readme](https://github.com/Lutando/Akkatecture/tree/dev/examples/jobs/README.md) for more detailed information about the example. The documentation for this can be found [here](https://akkatecture.net/docs/scheduled-jobs).\n\n* **[Tests](https://github.com/Lutando/Akkatecture/tree/dev/test/Akkatecture.Tests):** The test examples found in the Akkatecture.Test project is there to provide assistance when doing testing for Akkatecture. There is a simple domain modelled within the [Akkatecture.TestHelpers](https://github.com/Lutando/Akkatecture/tree/dev/test/Akkatecture.TestHelpers) project that includes a model of an aggregate with a simple aggregate saga, and these are used to do simple black box style testing on Akkatecture using akka.net's TestKit.\n\n\n**Note:** This example is part of the Akkatecture simple example project, so checkout [the\ncode](https://github.com/Lutando/Akkatecture/blob/master/examples/simple/Akkatecture.Examples.Application/Program.cs#L13) and give it a run.\n```csharp\n//Create actor system\nvar system = ActorSystem.Create(\"useraccount-example\");\n\n//Create supervising aggregate manager for UserAccount aggregate root actors\nvar aggregateManager = system.ActorOf(Props.Create(() =\u003e new UserAccountAggregateManager()));\n\n//Build create user account aggregate command with name \"foo bar\"\nvar aggregateId = UserAccountId.New;\nvar createUserAccountCommand = new CreateUserAccountCommand(aggregateId, \"foo bar\");\n\n//Send command, this is equivalent to command.publish() in other cqrs frameworks\naggregateManager.Tell(createUserAccountCommand);\n\n//tell the aggregateManager to change the name of the aggregate root to \"foo bar baz\"\nvar changeNameCommand = new UserAccountChangeNameCommand(aggregateId, \"foo bar baz\");\naggregateManager.Tell(changeNameCommand);\n```\n\n### Assumptions About Akkatecture Developers\n\nIt would be ideal if you have some experience in domain driven design, cqrs, and event sourcing.\nIt would also be beneficial for you to be familiar with actor systems, akka.net, and the extensibility points that akka gives you through hocon configuration. If you need to skill up on akka.net, check out petabridge's [akka-bootcamp](https://github.com/petabridge/akka-bootcamp). If you are already familiar with akka.net, go through the [walkthrough](https://akkatecture.net/docs/walkthrough-introduction) and you would have covered most of the concepts that this framework offers.\n\n### Status of Akkatecture\n\nAkkatecture is still in development. The goal of this projects first version is to provide you with the neccassary building blocks to build out your own cqrs and event sourced application without having to think of the implementation details of akka.net coupled with CQRS and event sourcing. Right now Akkatecture is focussed on developing the story for projection rebuilding. Projection rebuilding is a crucial feature that will lend Akkatecture to a version `1.0.0` release.\n\n### Contributing\n\n**Code** - If you want to contribute to the framework, do so on the `dev` branch and submit a PR. \n\n**Documentation** - Akkatecture's documentation source is [here](https://github.com/Akkatecture/Documentation), if you have any suggestions or improvements that can be made to them.\n\nAll contributions big or small are greatly appreciated!\n\n### Useful Resources\n\nThere are many different authoritative sources that prescribe best practices when building these kinds of systems that Akkatecture models. Here are a few articles and resources that can give you a good foundational grounding on the concepts used extensively in this project.\n\n#### Domain-Driven Design\n\n - [Domain-Driven Design Reference](https://domainlanguage.com/ddd/reference/) by Eric Evans\n#### CQRS \u0026 Event sourcing\n\n - [CQRS Journey by Microsoft](https://msdn.microsoft.com/en-us/library/jj554200.aspx)\n   published by Microsoft\n - [An In-Depth Look At CQRS](https://blog.sapiensworks.com/post/2015/09/01/In-Depth-CQRS)\n   by Mike Mogosanu\n - [CQRS, Task Based UIs, Event Sourcing agh!](http://codebetter.com/gregyoung/2010/02/16/cqrs-task-based-uis-event-sourcing-agh/)\n   by Greg Young\n - [Busting some CQRS myths](https://lostechies.com/jimmybogard/2012/08/22/busting-some-cqrs-myths/)\n   by Jimmy Bogard\n - [CQRS applied](https://lostechies.com/gabrielschenker/2015/04/12/cqrs-applied/)\n   by Gabriel Schenker\n#### Eventual consistency\n\n - [How To Ensure Idempotency In An Eventual Consistent DDD/CQRS Application](https://blog.sapiensworks.com/post/2015/08/26/How-To-Ensure-Idempotency)\n   by Mike Mogosanu\n#### Video Content\n\n- [CQRS and Event Sourcing](https://www.youtube.com/watch?v=JHGkaShoyNs) by Eric Evans\n- [An Introduction to CQRS and Event Sourcing Patterns](https://www.youtube.com/watch?v=9a1PqwFrMP0\u0026t=2042s) by Mathew McLoughling\n- [The Future of Distributed Programming in .NET](https://youtu.be/ozelpjr9SXE) by Aaron Stannard\n\n## Motivations\n\nDoing domain driven design in a distributed scenario is quite tricky. And even more so when you add cqrs and event sourcing style mechanics to your business domain. Akka.net gives you powerful ways to co-ordinate and organise your business rules by using actors and message passing, which can be done by sending messages through location transparent addresses (or references). The major benefits of using akka.net is that we can isolate our domain models into actors where it makes sense, in Akkatecture's case, an actor = aggregate root, this design decision is done because actors are inherently consistent between message handles, which is very much the same as aggregate roots in domain driven design. There is a high impedance match when you impose the actor model onto domain driven design, because actors can only guarantee their own internal state's consistency just like aggregate roots which maintain their own consistency boundary. Modelling aggregates as actors in the actor model is highly congruent.\n\nAkkatecture gives you a set of opinionated generic constructs that you can use to wire up your application so that you can focus on your main task, modelling and codifying your business domain.\n\nAkka.net gives us a wealth of good APIs out of the box that can be used to build entire systems out of. It also has a decent ecosystem and [community](https://gitter.im/akkadotnet/akka.net) for support. Akkatecture is also of the opinion that commands translate well semantically in actor systems since telling commands is a form of message passing that fits well into the actor model paradigm.\n\n## Changelog\n\nAkkatecture uses the methods of [Keep A Changelog](https://github.com/olivierlacan/keep-a-changelog) to keep track of features or functionality that has been added, changed, deprecated, removed, fixed, or patched for security reasons. The changelog also serves as a source of truth for the project's [release notes](https://github.com/Lutando/Akkatecture/releases).\n\n## Prerelease and Nightly Builds\nPrerelease feeds and nightly feeds (called alpha feeds in this project). Provide the most up to date packages for the project. Roughly speaking the prerelease feed is the most up to date packages that reflect master, and the nightly feed reflects the most up to packages derived from the dev branch. In other words, alpha feed is less stable than the prerelease feed but gets the features and fixes first. The access to the feeds: \n\n**Prerelease Feed** - [This](https://dev.azure.com/lutando/Akkatecture/_packaging?_a=feed\u0026feed=prerelease) is the Azure Artifacts URL, and [this](https://pkgs.dev.azure.com/lutando/Akkatecture/_packaging/prerelease/nuget/v3/index.json) is the NuGet feed URL.\n\n**Nightly Feed** - - [This](https://dev.azure.com/lutando/Akkatecture/_packaging?_a=feed\u0026feed=alpha) is the Azure Artifacts URL, and [this](https://pkgs.dev.azure.com/lutando/Akkatecture/_packaging/alpha/nuget/v3/index.json) is the NuGet feed URL.\n\n## Acknowledgements\n\n- [Akka.NET](https://github.com/akkadotnet/akka.net) - The project which AKkatecture builds ontop of, without akka.net, Akkatecture wouldnt exist.\n- [EventFlow](https://github.com/eventflow/EventFlow) - Akkatecture has adapted the api surface from event flow to work in the akka actor world.\n- [Nact](https://nact.io/) - For giving us basis to write our [documentation](https://akkatecture.net). Powered by [gatsbyjs](https://www.gatsbyjs.org/).\n\n## License\n\n```\nThe MIT License (MIT)\n\nCopyright (c) 2018 - 2021 Lutando Ngqakaza\n\nhttps://github.com/Lutando/Akkatecture\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FThembisileNGQ%2FAkkatecture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FThembisileNGQ%2FAkkatecture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FThembisileNGQ%2FAkkatecture/lists"}