feat: Introduce BookStore.Shared project for common domain models and DTOs, updating the main README with its structure and clarifying test scope.

Author: aalmada

README.md

@@ -101,12 +101,13 @@ BookStore/
 │   ├── BookStore.AppHost/         # Aspire orchestration
 │   │   └── Program.cs             # Service configuration
 │   │
-│   ├── BookStore.ServiceDefaults/ # Shared configuration
 │   │   └── Extensions.cs          # OpenTelemetry, health checks
 │   │
-│   └── BookStore.Tests/           # Unit tests
-│       ├── Handlers/              # Handler tests
-│       └── JsonSerializationTests.cs
+│   ├── BookStore.Shared/          # Shared domain models & DTOs
+│   │   ├── BookStore.Shared/      # Shared library
+│   │   └── BookStore.Shared.Tests/# Unit tests for shared code
+│   │
+│   └── BookStore.Tests/           # Integration tests
 │
 ├── docs/                          # Documentation
 │   ├── getting-started.md         # Setup guide

src/Shared/BookStore.Shared/README.md

@@ -0,0 +1,16 @@
+# BookStore.Shared
+
+This project contains shared domain models, DTOs, value objects, and utilities used across both the backend (`BookStore.ApiService`) and frontend (`BookStore.Web`) projects.
+
+## Purpose
+
+The main goal of this library is to ensure type safety and consistency between the API and the Blazor client by sharing the same data structures.
+
+## Key Components
+
+### Value Objects
+- **`PartialDate`**: A custom value object for handling incomplete dates (e.g., "2023", "2023-05"), used extensively for publication dates.
+
+### Models & DTOs
+- Contains Data Transfer Objects (DTOs) for books, authors, categories, etc.
+- Enums and constants shared across the solution.