Nuget ready

Author: andrey-serdyuk

.gitignore

@@ -360,4 +360,7 @@ MigrationBackup/
 .ionide/
 
 # Fody - auto-generated XML schema
-FodyWeavers.xsd
+FodyWeavers.xsd
+
+#nuget
+.nuget/

Directory.Build.props

@@ -4,11 +4,18 @@
 		<ImplicitUsings>enable</ImplicitUsings>
 		<Nullable>enable</Nullable>
 		<IsPackable>true</IsPackable>
-		<Version>2.1.71</Version>
+		<Version>2.1.72</Version>
 		<Authors>Andrey Serdyuk</Authors>
 		<Company>TaskHub</Company>
-		<PackageTags>#TaskHub</PackageTags>
-		<Description>Shared package for TaskHub project.</Description>
+		<Title>TaskHub.Shared - Reusable Primitives for .NET Microservices</Title>
+		<Description>TaskHub.Shared is a lightweight, modular shared kernel for .NET microservices. Built on DDD and Clean Architecture principles, it provides reusable primitives, CQRS pipelines, observability integrations (OpenTelemetry), and infrastructure adapters (EF Core, Redis, GeoCoding). Perfect for scalable task management systems. Explore modules for consistent cross-service patterns.</Description>
+		<PackageTags>dotnet;microservices;ddd;clean-architecture;cqrs;event-sourcing;observability;opentelemetry;redis;efcore;nuget-shared</PackageTags>
+		<Copyright>Copyright © 2025 TaskHub</Copyright>
+		<ProjectUrl>https://github.com/TaskHub-Server/TaskHub.Shared</ProjectUrl>
+		<PackageProjectUrl>https://taskhub-server.github.io/TaskHub.Shared/</PackageProjectUrl>
+		<RepositoryUrl>https://github.com/TaskHub-Server/TaskHub.Shared</RepositoryUrl>
+		<RepositoryType>github</RepositoryType>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
 		<PackageLicenseExpression>MIT</PackageLicenseExpression>
 		<IncludeProjectReferences>true</IncludeProjectReferences>
 		<IncludeSymbols>true</IncludeSymbols>

README.md

@@ -1,31 +1,54 @@
 # TaskHub.Shared
-**TaskHub.Shared** is the core foundation of the TaskHub ecosystem — a collection of lightweight, reusable building blocks that power all TaskHub microservices.
-It provides shared primitives, abstractions, contracts, and infrastructure adapters designed around **Domain-Driven Design (DDD)** and **Clean Architecture** principles.
+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.Primitives** — Core value objects, identifiers, and base types shared across all domains.
-- **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.
-- **TaskHub.Shared.Events.Abstractions** — Domain event abstractions for cross-service communication.
-- **TaskHub.Shared.Persistence.Abstractions** — Interfaces for read/write repositories, unit of work, and persistence contracts.
-- **TaskHub.Shared.Infrastructure.EfCore** — EF Core helpers, interceptors, and base configurations for database integration.
-- **TaskHub.Shared.Redis** — Integration with Redis for caching and distributed state management.
-- **TaskHub.Shared.OpenTelemetry** — Preconfigured telemetry setup for metrics, traces, and logs (Tempo, Prometheus, Loki).
-- **TaskHub.Shared.Swagger** — Common Swagger and API documentation configuration for ASP.NET Core services.
-- **TaskHub.Shared.GeoCoding.Abstractions** — Abstractions for geocoding providers.
-- **TaskHub.Shared.GeoCoding.Nominatim** — Implementation of the geocoding service using the Nominatim API.
-- **TaskHub.Shared.GeoCoding.Bootstraper** — Provides a lightweight entry-point that simplifies service startup and composition across TaskHub microservices..
+**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** — separation between abstractions and implementations.  
-- **Lightweight by Design** — each project compiles into a minimal, focused package.  
-- **Composability** — services import only the shared modules they depend on.  
-- **Cross-Service Consistency** — unified patterns for results, commands, events, and telemetry.
+**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](https://www.linkedin.com/in/andrey-serdyuk)
+Docs: <https://taskhub-server.github.io/TaskHub.Shared/>
+
+## License
+[MIT](./LICENSE)