refactor: Update documentation to reflect test project splitting and simplify localization examples.

Author: aalmada

CONTRIBUTING.md

@@ -202,7 +202,10 @@ Understanding the architecture helps you contribute effectively:
 - **BookStore.Web** - Blazor frontend
 - **BookStore.AppHost** - Aspire orchestration
 - **BookStore.ServiceDefaults** - Shared configuration
-- **BookStore.Tests** - Unit tests
+- **BookStore.Shared** - Shared library
+- **BookStore.Shared.Tests** - Shared unit tests
+- **BookStore.ApiService.Tests** - API unit tests
+- **BookStore.Web.Tests** - Web tests
 
 Key patterns:
 - **Event Sourcing** - All state changes via events

README.md

@@ -188,8 +188,8 @@ curl -X POST http://localhost:5000/api/admin/categories \
   -d '{
     "name": "Software Architecture",
     "translations": {
-      "pt": {"name": "Arquitetura de Software"},
-      "es": {"name": "Arquitectura de Software"}
+      "en": {"name": "Software Architecture"},
+      "pt": {"name": "Arquitetura de Software"}
     }
   }'
 ```

docs/getting-started.md

@@ -150,6 +150,10 @@ curl -X POST http://localhost:5000/api/admin/categories \
     "name": "Software Architecture",
     "description": "Books about software design and architecture",
     "translations": {
+      "en": {
+        "name": "Software Architecture",
+        "description": "Books about software design and architecture"
+      },
       "pt": {
         "name": "Arquitetura de Software",
         "description": "Livros sobre design e arquitetura de software"
@@ -271,10 +275,10 @@ The project uses **TUnit**, a modern testing framework for .NET with built-in co
 dotnet test
 
 # Run tests for specific project
-dotnet test --project src/BookStore.Tests/BookStore.Tests.csproj
+dotnet test --project src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj
 
 # Alternative: Run tests directly
-dotnet run --project src/BookStore.Tests/BookStore.Tests.csproj
+dotnet run --project src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj
 ```
 
 ### Test Structure

docs/localization-guide.md

@@ -50,7 +50,7 @@ Localization is configured in `appsettings.json` under the `Localization` sectio
 {
   "Localization": {
     "DefaultCulture": "en-US",
-    "SupportedCultures": ["en-US", "pt-PT", "es-ES", "fr-FR", "de-DE"]
+    "SupportedCultures": ["en-US", "pt-PT"]
   }
 }
 ```
@@ -60,7 +60,7 @@ Localization is configured in `appsettings.json` under the `Localization` sectio
 {
   "Localization": {
     "DefaultCulture": "pt-PT",
-    "SupportedCultures": ["pt-PT", "en-US", "es-ES"]
+    "SupportedCultures": ["pt-PT", "en-US"]
   }
 }
 ```
@@ -119,10 +119,7 @@ public record CategoryTranslation(string Name, string? Description);
 ```json
 {
   "en": { "name": "Programming", "description": null },
-  "pt": { "name": "Programação", "description": null },
-  "es": { "name": "Programación", "description": null },
-  "fr": { "name": "Programmation", "description": null },
-  "de": { "name": "Programmierung", "description": null }
+  "pt": { "name": "Programação", "description": null }
 }
 ```
 
@@ -170,7 +167,7 @@ You can configure different languages for different environments:
 {
   "Localization": {
     "DefaultCulture": "en-US",
-    "SupportedCultures": ["en-US", "pt-PT", "es-ES", "fr-FR", "de-DE"]
+    "SupportedCultures": ["en-US", "pt-PT"]
   }
 }
 ```

docs/testing-guide.md

@@ -22,10 +22,10 @@ The project uses **TUnit v1.6.28**, a modern testing framework for .NET that pro
 dotnet test
 
 # Run tests for specific project
-dotnet test --project src/BookStore.Tests/BookStore.Tests.csproj
+dotnet test --project src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj
 
 # Run tests directly (alternative method)
-dotnet run --project src/BookStore.Tests/BookStore.Tests.csproj
+dotnet run --project src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj
 ```
 
 ### IDE Support
@@ -41,11 +41,10 @@ TUnit works with all major .NET IDEs:
 ### Test Files
 
 ```
-src/BookStore.Tests/
+src/ApiService/BookStore.ApiService.Tests/
 ├── Handlers/
 │   └── BookHandlerTests.cs          # Command handler tests
-├── JsonSerializationTests.cs        # JSON standards verification
-└── WebTests.cs                      # Integration tests with Aspire
+└── JsonSerializationTests.cs        # JSON standards verification
 ```
 
 ### Test Anatomy
@@ -145,7 +144,7 @@ await Assert.ThrowsAsync<InvalidOperationException>(async () =>
 
 Test individual command handlers in isolation using mocked dependencies.
 
-**Example**: [BookHandlerTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/BookStore.Tests/Handlers/BookHandlerTests.cs)
+**Example**: [BookHandlerTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/ApiService/BookStore.ApiService.Tests/Handlers/BookHandlerTests.cs)
 
 ```csharp
 [Test]
@@ -171,7 +170,7 @@ public async Task UpdateBookHandler_WithMissingBook_ShouldReturnNotFound()
 
 Verify that the API follows JSON standards (ISO 8601, camelCase, etc.).
 
-**Example**: [JsonSerializationTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/BookStore.Tests/JsonSerializationTests.cs)
+**Example**: [JsonSerializationTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/ApiService/BookStore.ApiService.Tests/JsonSerializationTests.cs)
 
 ```csharp
 [Test]
@@ -188,7 +187,7 @@ public async Task DateTimeOffset_Should_Serialize_As_ISO8601_With_UTC()
 
 Test the full application stack using Aspire.Hosting.Testing.
 
-**Example**: [WebTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/BookStore.Tests/WebTests.cs)
+**Example**: [WebTests.cs](file:///Users/antaoalmada/Projects/BookStore/src/Web/BookStore.Web.Tests/BookStore.Web.Tests.csproj)
 
 ```csharp
 [Test]
@@ -286,7 +285,7 @@ When running in GitHub Actions, TUnit automatically:
   run: dotnet build --no-restore --configuration Release
 
 - name: Run tests
-  run: dotnet test --project src/BookStore.Tests/BookStore.Tests.csproj --configuration Release --no-build ${{ github.event_name == 'pull_request' && '--fail-fast' || '' }}
+  run: dotnet test --project src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj --configuration Release --no-build ${{ github.event_name == 'pull_request' && '--fail-fast' || '' }}
   # TUnit automatically generates GitHub Actions test summary
   # Results appear in the workflow run summary with collapsible details
   # --fail-fast: Stop on first failure in PRs for quick feedback