TaskHub.Observability.OpenTelemetry 2.1.74

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.

Modules

TaskHub.Shared.Primitives — Core value objects, identifiers, and base types shared across all domains. TaskHub.Shared.Domain — Base entities, aggregates, domain events, and helpers for implementing rich domain models. TaskHub.Shared.Response — Unified result system (Result, ValueResult<T>, ResultFactory) for consistent success/error handling.

TaskHub.Shared.Commands.Abstractions — Abstractions for the command pipeline (interfaces for command handlers, behaviors, buses).

TaskHub.Shared.Commands.Bus — Default in-process command bus implementation with behavior orchestration (behaviors pipeline, cross-cutting concerns).

TaskHub.Shared.Events.Abstractions — Domain event abstractions for cross-service communication and eventual consistency patterns.

TaskHub.Shared.Persistence.Abstractions — Interfaces for read/write repositories, unit of work, and persistence contracts. TaskHub.Shared.Infrastructure.EfCore — EF Core helpers, base configurations, and interceptors for database integration.

TaskHub.Shared.Redis — Integration with Redis for caching and distributed state management. TaskHub.Shared.RateLimiter — Reusable rate-limiting primitives and policies for protecting APIs and internal pipelines.

TaskHub.Shared.Authorization.Abstractions — Authorization contracts, roles/permissions abstractions, and policies shared across services. TaskHub.Shared.Authorization.Identity — Identity-related models and helpers used by TaskHub services (users, claims, roles).

TaskHub.Shared.Swagger — Common Swagger / OpenAPI configuration for ASP.NET Core services (conventions, filters, defaults). TaskHub.Shared.Versioning — Shared conventions and helpers for API versioning across TaskHub microservices. TaskHub.Shared.ConfigurationTools — Utilities for configuration binding, validation, and environment-specific configuration setup. TaskHub.Shared.Bootstraper — Opinionated startup helpers to compose TaskHub modules into a microservice with minimal boilerplate.

TaskHub.Shared.GeoCoding.Abstractions — Abstractions for geocoding providers. TaskHub.Shared.GeoCoding.Nominatim — Implementation of the geocoding service using the Nominatim API.

TaskHub.Observability.Metrics.Abstractions — Abstractions and options for metrics collection (meters, counters, histograms) used across services. TaskHub.Observability.Metrics.Implementation — Default metrics implementation built on top of IMeterFactory and OpenTelemetry metrics. TaskHub.Observability.Traces.Abstractions — Tracing contracts and ActivitySource abstractions for instrumenting command and HTTP pipelines. TaskHub.Observability.Traces — Ready-to-use tracing helpers (e.g., factories, decorators, behaviors) for consistent span creation. TaskHub.Observability.OpenTelemetry — Preconfigured OpenTelemetry setup (resource, exporters, processors) for metrics, traces, and logs (Tempo, Prometheus, Loki).

Design Principles

DDD & Clean Architecture — Clear separation between abstractions and implementations. Lightweight by Design — Each project compiles into a minimal, focused package. Composability — Services import only the shared modules they actually depend on. Cross-Service Consistency — Unified patterns for results, commands, events, authorization, and observability (metrics, traces, logs).

About

Author: Andrey Serdyuk Docs: https://taskhub-server.github.io/TaskHub.Shared/

License

MIT