TaskHub.Shared.Commands.Implementation 2.3.62

TaskHub.Shared

TaskHub.Shared is a set of small, independent modules that act as the shared foundation for microservices. It provides shared primitives, abstractions, contracts, and infrastructure adapters designed around Domain-Driven Design (DDD) and Clean Architecture principles.

Overview

TaskHub.Shared contains the fundamental components and patterns used across all bounded contexts in TaskHub. It promotes consistency, scalability, and observability across the entire microservice ecosystem.

Modules

🧩 Core & Abstractions

• TaskHub.Shared.Abstractions — Common service interfaces and marker interfaces for dependency inversion.
• TaskHub.Shared.Response — Unified result system (Result, ValueResult<T>) integrated with OpenTelemetry for consistent success/error handling.
• TaskHub.Shared.ValueObjects — Common DDD value objects (e.g., Email, PhoneNumber, Address, Coordinates) used across services.
• TaskHub.Shared.ConfigurationTools — Utilities for advanced configuration selection and binding helpers.

🏗️ Domain-Driven Design

• TaskHub.Shared.Domain — Base entities, aggregate roots, domain events, and exceptions for implementing rich domain models.
• TaskHub.Shared.Events.Abstractions — Domain and cross-service event abstractions for asynchronous communication.

⚡ CQRS Pipeline

• TaskHub.Shared.Commands.Abstractions — Contracts for commands, handlers, and pipeline behaviors (Pre/Post/Transformer).
• TaskHub.Shared.Commands.Implementation — High-performance in-process command bus with automatic DI scoping and observability integration.

💾 Persistence

• TaskHub.Shared.Persistence.Abstractions — Core interfaces for repositories, unit of work, and outbox contracts.
• TaskHub.Shared.Persistence.Repository — Generic repository patterns and automated registration logic.
• TaskHub.Shared.Persistence.EntityFramework — EF Core base context, configurations, and interceptors for audit and observability.
• TaskHub.Shared.Persistence.Redis — Integration with Redis for caching and distributed state management.
• TaskHub.Shared.Persistence.Outbox — Core abstractions for the Outbox pattern.
• TaskHub.Shared.Outbox.EntityFramework — EF Core implementation for reliable event persistence and publishing.
• TaskHub.Shared.Persistence.Media — Infrastructure support for media-related data persistence and tracking.

👁️ Observability

• TaskHub.Observability.Logger — Standardized logging implementation built on top of Serilog with structured logging support.
• TaskHub.Observability.Metrics.Abstractions — Interfaces and options for metrics collection (counters, gauges, histograms).
• TaskHub.Observability.Metrics.Implementation — Metrics implementation powered by prometheus-net.
• TaskHub.Observability.OpenTelemetry — Preconfigured OpenTelemetry setup (Traces, Metrics, Logs) for Tempo, Prometheus, and Loki.

🌐 Networking & Resilience

• TaskHub.Shared.Networking.Abstractions — Abstractions for HTTP client settings and resilience policies.
• TaskHub.Shared.Networking.Implementation — Resilient HTTP client configurations using Polly (Retry, Circuit Breaker, Timeout).

🔐 Security & Authorization

• TaskHub.Shared.Authorization.Abstractions — Shared contracts for JWT, roles, permissions, and security policies.
• TaskHub.Shared.Authorization.Identity — Identity-related models, middlewares, and helpers for user context management.

📁 Storage

• TaskHub.Shared.Storage.Abstractions — Standardized interfaces for file and blob storage services.
• TaskHub.Shared.Storage.FileSystem — Local file system implementation for storage abstractions.

📍 GeoCoding

• TaskHub.Shared.GeoCoding.Abstractions — Generic contracts for geocoding and reverse geocoding providers.
• TaskHub.Shared.GeoCoding.Nominatim — Implementation of geocoding services using the Nominatim API.

🛠️ Tools & Utilities

• TaskHub.Shared.Swagger — Unified OpenAPI/Swagger configuration with security schemes and versioning support.
• TaskHub.Shared.Versioning — Consistent API versioning conventions for microservices.
• TaskHub.Shared.RateLimiter — Reusable rate-limiting primitives and policies (Fixed Window, etc.).
• TaskHub.Shared.Refactoring — Reflection-based tools for automated dependency discovery and assembly scanning.

🚀 Bootstrapping

• TaskHub.Shared.Bootstraper.Basic — Lightweight host builder for basic ASP.NET Core services.
• TaskHub.Shared.Bootstraper.Full — "Batteries-included" host builder that automatically configures all infrastructure modules (DB, Redis, Auth, OTEL, etc.).

Design Principles

• DDD & Clean Architecture — Strict separation between domain logic and infrastructure.
• Lightweight & Modular — Services only pull in the specific adapters they need.
• Observability-First — Every module is designed with tracing and metrics in mind.
• Automated Wiring — Heavy use of assembly scanning to reduce boilerplate DI registration.

Author

Andrey Serdyuk