akka-hosting-actor-patterns

What problem does it solve?

This Skill provides patterns and tooling to host Akka.NET actors in both local test environments and clustered production, reducing boilerplate and improving testability.

Core Features & Use Cases

• Generic child-per-entity parent for local testing that mimics cluster semantics without heavy overhead.
• Message extractors using Akka.Cluster.Sharding interfaces for consistent routing.
• Akka.Hosting extension methods for fluent configuration across local and cluster modes.
• ITimeProvider integration to enable testable time-based logic via the ActorSystem.Scheduler.
• Akka.Reminders integration to schedule durable tasks with both in-memory and SQL storage options.
• Marker types for registry to reference parent shards and singleton actors clearly.
• Scoped DI per message pattern to ensure fresh DbContext or scoped services during message handling.

Quick Start

Configure hosting with execution mode appropriate for your environment, then resolve actors through the registry or use the provided extension methods to wire up domain actors and optional reminders. For example, in startup code, call WithOrderDomainActors(executionMode) and register TimeProvider in the DI container. Then send messages to your actors to verify behavior.