Add tests for DevExpressPdfProcessor and roadmap updates

Updated ROADMAP.md to reflect progress on the TDD process for
DevExpressPdfProcessor, including the creation of unit tests
(6 tests in the Red Phase). Updated progress to 4/7 mini-steps
completed and outlined the next step (Green Phase).

Added `DevExpressPdfProcessorTests.cs` with unit tests to
validate PDF files and extract metadata. Tests cover valid
PDFs, null/empty inputs, corrupted PDFs, and file size
calculations. Used `FluentAssertions` for assertions.

Cleaned up `DocumentOperator.Tests.csproj` by removing an
unused folder reference. No functional changes to the project
structure.

DocumentOperator.API/ROADMAP.md

@@ -434,8 +434,17 @@ public class ApplyStampHandler : IRequestHandler<ApplyStampCommand, byte[]>
 | Package | Version | Purpose |
 |---------|---------|---------|
 | **DevExpress.Pdf.Core** | 25.2.8 | PDF-Operationen (Merge, Extract, Sign, etc.) |
+| **DevExpress Universal License** | ? Verfügbar | **Vollzugriff auf alle DevExpress Bibliotheken** |
 | **Microsoft.Extensions.Options.ConfigurationExtensions** | 8.0.0 | Options Pattern |
 
+**Hinweis zur DevExpress Lizenz:**
+- ? Universal License vorhanden - wir können **ALLE** DevExpress Pakete nutzen
+- Neben `DevExpress.Pdf.Core` können wir auch weitere Pakete integrieren:
+  - `DevExpress.Office.Core` (Word, Excel)
+  - `DevExpress.Document.Processor` (erweiterte Dokumenten-Verarbeitung)
+  - `DevExpress.Blazor` (falls UI später benötigt wird)
+  - Alle weiteren DevExpress Produkte nach Bedarf
+
 #### Domain Layer
 
 | Package | Version | Purpose |
@@ -726,10 +735,12 @@ DocumentOperator.Tests/
 
 ---
 
-### ?? PHASE 2: Domain Layer (Minimal) - **IN PROGRESS**
+### ? PHASE 2: Domain Layer (Minimal) - **COMPLETED**
 
 **Ziel:** Nur was wirklich gebraucht wird!
 
+**Status:** ? **Alle Steps abgeschlossen!**
+
 ---
 
 #### ? Step 2.1: Domain Exceptions erstellen - **COMPLETED**
@@ -802,7 +813,7 @@ DocumentOperator.Tests/
 
 ---
 
-#### ?? Step 2.3: Value Objects erstellen - **NEXT**
+#### ? Step 2.3: Value Objects erstellen - **COMPLETED**
 
 **Aufgabe:** Typsichere, selbst-validierende Wert-Objekte
 
@@ -812,49 +823,58 @@ DocumentOperator.Tests/
 - ? Immutable (keine Änderungen nach Erstellung)
 - ? Wiederverwendbar (in Domain, Application, Infrastructure)
 
-**Was du erstellen wirst:**
+**Was du erstellt hast:**
 
-1. **Base64String.cs**
+1. **Base64String.cs** ?
    - Factory Method: `Create(string value)`
    - Validierung: Gültiges Base64-Format
    - Konvertierung: `ToByteArray()`, `FromByteArray(byte[])`
    - Wirft `DomainValidationException` bei Fehler
 
-2. **TenantId.cs**
+2. **TenantId.cs** ?
    - Factory Method: `Create(string value)`
    - Validierung: Nicht leer, Max 100 Zeichen
    - Normalisierung: `.ToLowerInvariant()`
    - Wirft `DomainValidationException` bei Fehler
 
-3. **PdfMetadata.cs**
+3. **PdfMetadata.cs** ?
    - Properties: PageCount, FileSizeBytes, PdfVersion, HasAttachments, AttachmentCount
    - Computed Property: `FileSizeMB`
    - Keine Validierung (nur Daten-Container)
 
 **Wo:** `Domain/Models/ValueObjects/`
 
-**Detaillierte Anleitung kommt in Step 2.3!**
+**Status:** ? **COMPLETED** (17.01.2025)
+- ? Base64String.cs erstellt (sealed, Factory Methods, Validierung, Equality)
+- ? TenantId.cs erstellt (sealed, Normalisierung, Validierung, Equality)
+- ? PdfMetadata.cs erstellt (sealed, Computed Property, ToString())
+- ? Build erfolgreich
+
+**?? Phase 2 (Domain Layer) komplett abgeschlossen!**
 
 ---
 
-### ? PHASE 3: Infrastructure Layer (Outside-In!)
+### ? PHASE 3: Infrastructure Layer (Outside-In!) - **NEXT**
 
 **Ziel:** DevExpress Services implementieren (wir sehen **echten** Code!)
 
 ---
 
-#### ? Step 3.1: IPdfProcessor Interface erstellen
+#### ? Step 3.1: IPdfProcessor Interface erstellen - **COMPLETED**
 
 **Aufgabe:** Abstraction für PDF-Operationen
 
-**Was du erstellen wirst:**
+**Was du erstellt hast:**
-- **Wo:** `Application/Common/Interfaces/IPdfProcessor.cs`
+- **Wo:** `Application/Common/Interfaces/IPdfProcessor.cs` ?
 - **Inhalt:**
   ```csharp
+  using DocumentOperator.Domain.Models.ValueObjects;
+
+  namespace DocumentOperator.Application.Common.Interfaces;
+
   public interface IPdfProcessor
   {
       Task<PdfMetadata> ValidateAsync(byte[] pdfBytes);
-      // Weitere Methoden später (YAGNI!)
   }
   ```
 
@@ -863,9 +883,15 @@ DocumentOperator.Tests/
 - Infrastructure implementiert
 - TDD: Test ? Interface ? Implementation
 
+**Status:** ? **COMPLETED** (17.01.2025)
+- ? Interface erstellt mit XML Comments
+- ? Using Statement korrekt
+- ? Namespace korrekt
+- ? Build erfolgreich
+
 ---
 
-#### ? Step 3.2: DevExpressPdfProcessor implementieren (mit TDD!)
+#### ?? Step 3.2: DevExpressPdfProcessor implementieren (mit TDD!) - **NEXT**
 
 **Aufgabe:** DevExpress Integration
 
@@ -1271,20 +1297,63 @@ public async Task POST_ValidatePdf_InvalidPdf_Returns400() { }
 ## ?? CURRENT STATUS
 
 ### ? Completed
-- **Phase 1:** Foundation & Clean Architecture Setup
+- **Phase 1:** Foundation & Clean Architecture Setup ?
+  - Solution Structure ?
   - Dependencies ?
-  - Packages ?
+  - NuGet Packages ?
   - Folder Structure ?
-  - Configuration ?
+  - Configuration (appsettings.json) ?
-  - Serilog ?
+  - Serilog Setup ?
+  - Program.cs Setup ?
+
+- **Phase 2:** Domain Layer (Minimal) ?
+  - ? Step 2.1 - Domain Exceptions (4 Exceptions erstellt)
+    - `DomainException.cs`
+    - `DomainValidationException.cs`
+    - `NotFoundException.cs`
+    - `PdfProcessingException.cs`
+  - ? Step 2.2 - Enums (DocumentOperationType, ProcessingStatus)
+  - ? Step 2.3 - Value Objects (Base64String, TenantId, PdfMetadata)
+
+- **Phase 3:** Infrastructure Layer (Outside-In!)
+  - ? Step 3.1 - IPdfProcessor Interface erstellt
+  - ?? Step 3.2 - DevExpressPdfProcessor implementieren (TDD - **IN PROGRESS**)
+    - ? Step 3.2.1 - ProcessDocument Ordner gelöscht (Application Layer cleanup)
+    - ? Step 3.2.2 - Test-Ordnerstruktur erstellt (Unit/Infrastructure/Services/PdfProcessing)
+    - ? Step 3.2.3 - Test-PDF Datei hinzugefügt (valid.pdf als Embedded Resource)
+    - ? Step 3.2.4 - DevExpressPdfProcessorTests.cs erstellt (TDD Red Phase - 6 Tests)
 
 ### ?? In Progress
-- **Phase 2:** Domain Layer (Minimal)
+- **Phase 3, Step 3.2:** DevExpressPdfProcessor (TDD)
-  - ? Step 2.1 - Domain Exceptions
+  - **NEXT:** Step 3.2.5 - DevExpressPdfProcessor.cs implementieren (TDD Green Phase)
-  - **NEXT:** Step 2.2 - Enums
+  - **Progress:** 4/7 Mini-Steps abgeschlossen
 
 ### ? Pending
-- Phase 3-9
+- **Phase 3:** Infrastructure Layer
+  - Step 3.2 - DevExpressPdfProcessor Implementation
+
+- **Phase 4:** Application Layer
+  - Step 4.1 - MediatR Setup (DependencyInjection.cs, ValidationBehavior.cs)
+  - Step 4.2 - ValidatePdf Feature (Query, Handler, Validator)
+
+- **Phase 5:** API Layer
+  - Step 5.1 - Exception Handling Middleware
+  - Step 5.2 - Minimal API Endpoint
+  - Step 5.3 - Integration Test
+
+- **Phase 6-9:** Weitere Features, Swagger, Multi-Tenancy, Production
+
+### ?? Hinweise zum aktuellen Stand
+
+1. **Infrastructure Services:**
+   - Ordner existieren (PdfProcessing, FileStorage, DocumentValidation)
+   - **Aber:** Alle leer
+   - ?? **Action:** DevExpressPdfProcessor.cs implementieren (Step 3.2 - IN PROGRESS)
+
+2. **DevExpress Universal License:**
+   - ? **Verfügbar!** Wir können alle DevExpress Pakete nutzen
+   - Aktuell nur: `DevExpress.Pdf.Core`
+   - Bei Bedarf können weitere Pakete hinzugefügt werden
 
 ---
 
@@ -1406,7 +1475,17 @@ public async Task POST_ValidatePdf_InvalidPdf_Returns400() { }
 | 2024-XX-XX | Phase 1 | ? Phase 1 completed |
 | 2024-XX-XX | Phase 2 | ? Step 2.1 completed - Domain Exceptions created |
 | 17.01.2025 | Roadmap | ?? **ROADMAP komplett überarbeitet** (Pragmatisch, Outside-In, TDD) |
-| 17.01.2025 | Phase 2 | ?? Starting Step 2.2 - Enums (vor Value Objects) |
+| 17.01.2025 | Phase 2 | ? Step 2.2 completed - Enums erstellt |
+| 17.01.2025 | Phase 2 | ? Step 2.3 completed - Value Objects erstellt |
+| 17.01.2025 | Phase 2 | ? **Phase 2 (Domain Layer) komplett abgeschlossen!** |
+| 17.01.2025 | Phase 3 | ? Step 3.1 completed - IPdfProcessor Interface erstellt |
+| 17.01.2025 | Roadmap | ?? **ROADMAP Status-Update** - Aktueller Projektstand dokumentiert |
+| 17.01.2025 | Infrastructure | ?? **DevExpress Universal License** hinzugefügt - Vollzugriff auf alle Pakete |
+| 17.01.2025 | Phase 3 | ?? **Step 3.2 gestartet** - DevExpressPdfProcessor (TDD) |
+| 17.01.2025 | Application | ? Step 3.2.1 - ProcessDocument Ordner gelöscht (Cleanup) |
+| 17.01.2025 | Tests | ? Step 3.2.2 - Test-Ordnerstruktur erstellt, UnitTest1.cs gelöscht |
+| 17.01.2025 | Tests | ? Step 3.2.3 - Test-PDF (valid.pdf) als Embedded Resource hinzugefügt |
+| 17.01.2025 | Tests | ? Step 3.2.4 - DevExpressPdfProcessorTests.cs erstellt (TDD Red - 6 Tests) |
 
 ---
 

DocumentOperator.API/STATUS_UPDATE_17_01_2025.md

@@ -0,0 +1,218 @@
+# ?? Status Update - DocumentOperator (17.01.2025)
+
+## ? Was wurde aktualisiert?
+
+Die **ROADMAP.md** wurde vollständig mit dem **tatsächlichen Projektstand** abgeglichen und aktualisiert.
+
+---
+
+## ?? Haupterkenntnisse
+
+### 1. **DevExpress Universal License** ?
+
+**Wichtig:** Das Projekt verfügt über eine **DevExpress Universal License**!
+
+**Das bedeutet:**
+- ? Vollzugriff auf **ALLE** DevExpress Bibliotheken
+- ? Nicht nur `DevExpress.Pdf.Core` - wir können **jedes** DevExpress Paket nutzen
+- ? Falls künftig Word/Excel-Verarbeitung benötigt wird ? einfach hinzufügen!
+
+**Aktuell verwendet:**
+- `DevExpress.Pdf.Core` v25.2.8
+
+**Bei Bedarf verfügbar:**
+- `DevExpress.Office.Core` (Word, Excel)
+- `DevExpress.Document.Processor` (erweiterte Dokumenten-Verarbeitung)
+- `DevExpress.Blazor` (falls UI später benötigt wird)
+- Alle weiteren DevExpress Produkte
+
+---
+
+### 2. **Aktueller Projektstand**
+
+#### ? Abgeschlossen (Completed)
+
+**Phase 1: Foundation**
+- ? Solution Structure (4 Projekte + Tests)
+- ? Dependencies (Clean Architecture Rules)
+- ? NuGet Packages installiert
+- ? Folder Structure erstellt
+- ? Configuration (appsettings.json, Options Pattern)
+- ? Serilog Setup
+- ? Program.cs Setup
+
+**Phase 2: Domain Layer (Minimal)**
+- ? **4 Domain Exceptions:**
+  - `DomainException.cs` (Basis)
+  - `DomainValidationException.cs` (Value Object Validierung)
+  - `NotFoundException.cs` (Resource nicht gefunden)
+  - `PdfProcessingException.cs` (PDF-spezifische Fehler)
+
+- ? **2 Enums:**
+  - `DocumentOperationType` (Validate, ExtractAttachments, Concatenate, ApplyStamp, EmbedCertificate)
+  - `ProcessingStatus` (Pending, Processing, Success, Failed)
+
+- ? **3 Value Objects:**
+  - `Base64String` (typsicher, selbst-validierend, mit Factory Methods)
+  - `TenantId` (normalisiert, validiert)
+  - `PdfMetadata` (PageCount, FileSizeBytes, PdfVersion, HasAttachments, etc.)
+
+**Phase 3: Infrastructure Layer**
+- ? **IPdfProcessor Interface** erstellt
+  - `Task<PdfMetadata> ValidateAsync(byte[] pdfBytes)`
+  - Mit XML Comments dokumentiert
+
+---
+
+#### ?? In Arbeit (In Progress)
+
+**Phase 3: Infrastructure Layer**
+- **NEXT:** Step 3.2 - `DevExpressPdfProcessor` implementieren (mit TDD!)
+  - Ordner `Services/PdfProcessing/` existiert bereits
+  - **Aber:** Noch leer - muss implementiert werden
+
+---
+
+#### ?? Wichtige Hinweise
+
+**1. Application Layer - ProcessDocument vs ValidatePdf**
+- **Problem:** 
+  - Ordner: `Features/Documents/ProcessDocument/`
+  - Dateien: `ProcessDocumentCommand.cs`, `ProcessDocumentHandler.cs`, `ProcessDocumentValidator.cs`
+  - **Alle leer!**
+
+- **Roadmap sagt:** 
+  - Wir sollten mit `ValidatePdf` Feature starten (nicht ProcessDocument)
+
+- **Action Required:**
+  - Entweder ProcessDocument-Dateien löschen
+  - Oder umbenennen zu ValidatePdf
+  - Oder erst später nutzen (wenn wir ein generisches ProcessDocument Command brauchen)
+
+**2. Tests Layer**
+- **Problem:** Nur `UnitTest1.cs` (Dummy-Test)
+- **Action Required:**
+  - Ordnerstruktur erstellen:
+    ```
+    Tests/
+    ??? Unit/
+    ?   ??? Application/
+    ?   ??? Infrastructure/
+    ?   ??? Domain/
+    ??? Integration/
+        ??? API/
+    ```
+  - `UnitTest1.cs` löschen
+
+**3. Infrastructure Services**
+- **Problem:** Ordner existieren, aber leer
+  - `Services/PdfProcessing/` ? DevExpressPdfProcessor.cs fehlt
+  - `Services/FileStorage/` ? leer
+  - `Services/DocumentValidation/` ? leer
+
+- **Action Required:**
+  - Step 3.2 durchführen: DevExpressPdfProcessor implementieren
+
+---
+
+## ?? Nächste Schritte (Roadmap)
+
+### Schritt 1: DevExpressPdfProcessor implementieren (Phase 3, Step 3.2)
+
+**TDD-Flow:**
+1. **Test schreiben** (Red)
+   - `Tests/Unit/Infrastructure/Services/PdfProcessing/DevExpressPdfProcessorTests.cs`
+   - Test: `ValidateAsync_ValidPdf_ReturnsMetadata()`
+
+2. **Code schreiben** (Green)
+   - `Infrastructure/Services/PdfProcessing/DevExpressPdfProcessor.cs`
+   - `IPdfProcessor` Interface implementieren
+   - DevExpress PDF API nutzen
+
+3. **Test grün machen**
+
+4. **Refactoring** (falls nötig)
+
+---
+
+### Schritt 2: Application Layer aufräumen
+
+**Option A: ProcessDocument löschen**
+```powershell
+Remove-Item "DocumentOperator.Application\Features\Documents\ProcessDocument" -Recurse
+```
+
+**Option B: Zu ValidatePdf umbenennen**
+```powershell
+Rename-Item "ProcessDocument" "ValidatePdf"
+# Dann Dateien umbenennen + Namespaces anpassen
+```
+
+**Option C: Behalten und später nutzen**
+- Erst ValidatePdf neu erstellen
+- ProcessDocument später für generisches Command nutzen
+
+---
+
+### Schritt 3: MediatR Setup (Phase 4, Step 4.1)
+
+**Erstellen:**
+1. `Application/DependencyInjection.cs`
+   - MediatR registrieren
+   - FluentValidation registrieren
+   - ValidationBehavior registrieren
+
+2. `Application/Common/Behaviors/ValidationBehavior.cs`
+   - Pipeline Behavior für FluentValidation
+
+---
+
+### Schritt 4: ValidatePdf Feature (Phase 4, Step 4.2)
+
+**Erstellen:**
+1. `Application/Features/Documents/ValidatePdf/ValidatePdfQuery.cs`
+2. `Application/Features/Documents/ValidatePdf/ValidatePdfHandler.cs`
+3. `Application/Features/Documents/ValidatePdf/ValidatePdfValidator.cs`
+
+**Mit TDD:**
+- `Tests/Unit/Application/Features/ValidatePdf/ValidatePdfHandlerTests.cs`
+
+---
+
+## ?? Empfehlung
+
+**Nächster Sprint:**
+1. ? ROADMAP.md ist aktuell
+2. **Jetzt:** DevExpressPdfProcessor implementieren (mit TDD)
+3. **Dann:** Application Layer aufräumen (ProcessDocument ? ValidatePdf)
+4. **Dann:** MediatR Setup + ValidationBehavior
+5. **Dann:** ValidatePdf Feature komplett durchziehen
+
+**Vorteil dieses Ansatzes:**
+- Wir sehen **echten** Code (DevExpress Integration)
+- Wir wissen welche Exceptions geworfen werden
+- Application Layer kann darauf aufbauen
+- Schneller Feedback-Loop
+
+---
+
+## ?? Build Status
+
+? **Build erfolgreich!** (17.01.2025)
+
+Alle Projekte kompilieren ohne Fehler.
+
+---
+
+## ?? Dokumentation
+
+- ? **ROADMAP.md** vollständig aktualisiert
+- ? **STATUS_UPDATE_17_01_2025.md** erstellt (diese Datei)
+- ? DevExpress Universal License dokumentiert
+- ? Aktueller Projektstand dokumentiert
+- ? Nächste Schritte klar definiert
+
+---
+
+**Last Updated:** 17.01.2025  
+**Status:** Ready für Phase 3, Step 3.2 (DevExpressPdfProcessor)

DocumentOperator.Application/Common/Interfaces/IPdfProcessor.cs

@@ -0,0 +1,16 @@
+using DocumentOperator.Domain.Models.ValueObjects;
+
+namespace DocumentOperator.Application.Common.Interfaces;
+
+public interface IPdfProcessor
+{
+    /// <summary>
+    /// Validates a PDF and extracts metadata.
+    /// </summary>
+    /// <param name="pdfBytes">PDF content as byte array</param>
+    /// <returns>PDF metadata (page count, size, version, attachments)</returns>
+    /// <exception cref="Domain.Common.Exceptions.PdfProcessingException">
+    /// Thrown when PDF is corrupted or cannot be processed
+    /// </exception>
+    Task<PdfMetadata> ValidateAsync(byte[] pdfBytes);
+}

DocumentOperator.Application/DocumentOperator.Application.csproj

@@ -17,7 +17,6 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Folder Include="Common\Interfaces\" />
     <Folder Include="Common\Behaviors\" />
     <Folder Include="Common\DTOs\" />
     <Folder Include="Common\Mappings\" />

DocumentOperator.Application/Features/Documents/ProcessDocument/ProcessDocumentCommand.cs

@@ -1,12 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace DocumentOperator.Application.Features.Documents.ProcessDocument
-{
-    internal class ProcessDocumentCommand
-    {
-    }
-}

DocumentOperator.Application/Features/Documents/ProcessDocument/ProcessDocumentHandler.cs

@@ -1,12 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace DocumentOperator.Application.Features.Documents.ProcessDocument
-{
-    internal class ProcessDocumentHandler
-    {
-    }
-}

DocumentOperator.Application/Features/Documents/ProcessDocument/ProcessDocumentValidator.cs

@@ -1,12 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace DocumentOperator.Application.Features.Documents.ProcessDocument
-{
-    internal class ProcessDocumentValidator
-    {
-    }
-}

DocumentOperator.Domain/DocumentOperator.Domain.csproj

@@ -9,7 +9,6 @@
   <ItemGroup>
     <Folder Include="Common\Results\" />
     <Folder Include="Constants\" />
-    <Folder Include="Models\ValueObjects\" />
   </ItemGroup>
 
 </Project>

DocumentOperator.Domain/Models/ValueObjects/Base64String.cs

@@ -0,0 +1,59 @@
+namespace DocumentOperator.Domain.Models.ValueObjects;
+
+public sealed class Base64String
+{
+    public string Value { get; }
+
+    private Base64String(string value)
+    {
+        Value = value;
+    }
+
+    public static Base64String Create(string value)
+    {
+        if (string.IsNullOrWhiteSpace(value))
+            throw new Common.Exceptions.DomainValidationException("Base64 string cannot be empty.");
+
+        // Validierung: Ist es gültiges Base64?
+        try
+        {
+            Convert.FromBase64String(value);
+        }
+        catch (FormatException)
+        {
+            throw new Common.Exceptions.DomainValidationException("Invalid Base64 format.");
+        }
+
+        return new Base64String(value);
+    }
+
+    public static Base64String FromByteArray(byte[] bytes)
+    {
+        if (bytes == null || bytes.Length == 0)
+            throw new Common.Exceptions.DomainValidationException("Byte array cannot be null or empty.");
+
+        var base64 = Convert.ToBase64String(bytes);
+        return new Base64String(base64);
+    }
+
+    public byte[] ToByteArray()
+    {
+        return Convert.FromBase64String(Value);
+    }
+
+    public override string ToString() => Value;
+
+    // Equality (wichtig für Value Objects!)
+    public override bool Equals(object? obj)
+    {
+        if (obj is not Base64String other)
+            return false;
+
+        return Value == other.Value;
+    }
+
+    public override int GetHashCode()
+    {
+        return Value.GetHashCode();
+    }
+}

DocumentOperator.Domain/Models/ValueObjects/PdfMetadata.cs

@@ -0,0 +1,32 @@
+namespace DocumentOperator.Domain.Models.ValueObjects;
+
+public sealed class PdfMetadata
+{
+    public int PageCount { get; }
+    public long FileSizeBytes { get; }
+    public string PdfVersion { get; }
+    public bool HasAttachments { get; }
+    public int AttachmentCount { get; }
+
+    // Computed Property (berechnet aus FileSizeBytes)
+    public double FileSizeMB => FileSizeBytes / 1024.0 / 1024.0;
+
+    public PdfMetadata(
+        int pageCount,
+        long fileSizeBytes,
+        string pdfVersion,
+        bool hasAttachments,
+        int attachmentCount)
+    {
+        PageCount = pageCount;
+        FileSizeBytes = fileSizeBytes;
+        PdfVersion = pdfVersion;
+        HasAttachments = hasAttachments;
+        AttachmentCount = attachmentCount;
+    }
+
+    public override string ToString()
+    {
+        return $"PDF: {PageCount} pages, {FileSizeMB:F2} MB, Version {PdfVersion}, Attachments: {AttachmentCount}";
+    }
+}

DocumentOperator.Domain/Models/ValueObjects/TenantId.cs

@@ -0,0 +1,41 @@
+namespace DocumentOperator.Domain.Models.ValueObjects;
+
+public sealed class TenantId
+{
+    public string Value { get; }
+
+    private TenantId(string value)
+    {
+        Value = value;
+    }
+
+    public static TenantId Create(string value)
+    {
+        if (string.IsNullOrWhiteSpace(value))
+            throw new Common.Exceptions.DomainValidationException("TenantId cannot be empty.");
+
+        if (value.Length > 100)
+            throw new Common.Exceptions.DomainValidationException("TenantId cannot exceed 100 characters.");
+
+        // Normalisierung: Lowercase
+        var normalized = value.Trim().ToLowerInvariant();
+
+        return new TenantId(normalized);
+    }
+
+    public override string ToString() => Value;
+
+    // Equality
+    public override bool Equals(object? obj)
+    {
+        if (obj is not TenantId other)
+            return false;
+
+        return Value == other.Value;
+    }
+
+    public override int GetHashCode()
+    {
+        return Value.GetHashCode();
+    }
+}

DocumentOperator.Tests/DocumentOperator.Tests.csproj

@@ -0,0 +1,42 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Remove="TestData\Pdfs\valid.pdf" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <EmbeddedResource Include="TestData\Pdfs\valid.pdf" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="coverlet.collector" Version="6.0.0" />
+    <PackageReference Include="FluentAssertions" Version="7.0.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
+    <PackageReference Include="Moq" Version="4.20.72" />
+    <PackageReference Include="xunit" Version="2.9.3" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="Xunit" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\DocumentOperator.Domain\DocumentOperator.Domain.csproj" />
+    <ProjectReference Include="..\DocumentOperator.Application\DocumentOperator.Application.csproj" />
+    <ProjectReference Include="..\DocumentOperator.Infrastructure\DocumentOperator.Infrastructure.csproj" />
+  </ItemGroup>
+
+</Project>

DocumentOperator.Tests/Unit/Infrastructure/Services/PdfProcessing/DevExpressPdfProcessorTests.cs

@@ -0,0 +1,146 @@
+using System.Reflection;
+using DocumentOperator.Application.Common.Interfaces;
+using DocumentOperator.Domain.Common.Exceptions;
+using DocumentOperator.Domain.Models.ValueObjects;
+using DocumentOperator.Infrastructure.Services.PdfProcessing;
+using FluentAssertions;
+
+namespace DocumentOperator.Tests.Unit.Infrastructure.Services.PdfProcessing;
+
+/// <summary>
+/// Unit tests for DevExpressPdfProcessor.
+/// Tests PDF validation and metadata extraction.
+/// </summary>
+public class DevExpressPdfProcessorTests
+{
+    private readonly IPdfProcessor _sut; // SUT = System Under Test
+
+    public DevExpressPdfProcessorTests()
+    {
+        // Arrange: Create instance (wird später implementiert)
+        _sut = new DevExpressPdfProcessor();
+    }
+
+    #region Helper Methods
+
+    /// <summary>
+    /// Loads a test PDF from embedded resources.
+    /// </summary>
+    /// <param name="filename">Name of the PDF file (e.g., "valid.pdf")</param>
+    /// <returns>PDF content as byte array</returns>
+    private static byte[] LoadTestPdf(string filename)
+    {
+        var assembly = Assembly.GetExecutingAssembly();
+        var resourceName = $"DocumentOperator.Tests.TestData.Pdfs.{filename}";
+
+        using var stream = assembly.GetManifestResourceStream(resourceName);
+
+        if (stream == null)
+        {
+            throw new FileNotFoundException(
+                $"Embedded resource '{resourceName}' not found. " +
+                $"Available resources: {string.Join(", ", assembly.GetManifestResourceNames())}");
+        }
+
+        using var memoryStream = new MemoryStream();
+        stream.CopyTo(memoryStream);
+        return memoryStream.ToArray();
+    }
+
+    #endregion
+
+    #region ValidateAsync Tests
+
+    [Fact]
+    public async Task ValidateAsync_ValidPdf_ReturnsPdfMetadata()
+    {
+        // Arrange
+        byte[] pdfBytes = LoadTestPdf("valid.pdf");
+
+        // Act
+        var metadata = await _sut.ValidateAsync(pdfBytes);
+
+        // Assert
+        metadata.Should().NotBeNull("a valid PDF should return metadata");
+        metadata.PageCount.Should().BeGreaterThan(0, "PDF must have at least one page");
+        metadata.FileSizeBytes.Should().Be(pdfBytes.Length, "file size should match input");
+        metadata.PdfVersion.Should().NotBeNullOrEmpty("PDF version should be detected");
+    }
+
+    [Fact]
+    public async Task ValidateAsync_ValidPdf_ReturnsCorrectPageCount()
+    {
+        // Arrange
+        byte[] pdfBytes = LoadTestPdf("valid.pdf");
+
+        // Act
+        var metadata = await _sut.ValidateAsync(pdfBytes);
+
+        // Assert
+        // Deine valid.pdf hat wahrscheinlich 1-5 Seiten - passe an!
+        metadata.PageCount.Should().BeInRange(1, 100, "test PDF should have reasonable page count");
+    }
+
+    [Fact]
+    public async Task ValidateAsync_NullBytes_ThrowsPdfProcessingException()
+    {
+        // Arrange
+        byte[]? pdfBytes = null;
+
+        // Act
+        Func<Task> act = async () => await _sut.ValidateAsync(pdfBytes!);
+
+        // Assert
+        await act.Should().ThrowAsync<PdfProcessingException>()
+            .WithMessage("*null*", "null input should be rejected");
+    }
+
+    [Fact]
+    public async Task ValidateAsync_EmptyBytes_ThrowsPdfProcessingException()
+    {
+        // Arrange
+        byte[] pdfBytes = Array.Empty<byte>();
+
+        // Act
+        Func<Task> act = async () => await _sut.ValidateAsync(pdfBytes);
+
+        // Assert
+        await act.Should().ThrowAsync<PdfProcessingException>()
+            .WithMessage("*empty*", "empty input should be rejected");
+    }
+
+    [Fact]
+    public async Task ValidateAsync_CorruptedPdf_ThrowsPdfProcessingException()
+    {
+        // Arrange
+        byte[] pdfBytes = "This is not a valid PDF content"u8.ToArray();
+
+        // Act
+        Func<Task> act = async () => await _sut.ValidateAsync(pdfBytes);
+
+        // Assert
+        await act.Should().ThrowAsync<PdfProcessingException>()
+            .WithMessage("*invalid*", "corrupted PDF should throw exception");
+    }
+
+    #endregion
+
+    #region Metadata Tests
+
+    [Fact]
+    public async Task ValidateAsync_ValidPdf_FileSizeMBCalculatedCorrectly()
+    {
+        // Arrange
+        byte[] pdfBytes = LoadTestPdf("valid.pdf");
+
+        // Act
+        var metadata = await _sut.ValidateAsync(pdfBytes);
+
+        // Assert
+        double expectedSizeMB = pdfBytes.Length / 1024.0 / 1024.0;
+        metadata.FileSizeMB.Should().BeApproximately(expectedSizeMB, 0.01,
+            "FileSizeMB should be calculated correctly from bytes");
+    }
+
+    #endregion
+}

DocumentOperator.sln

@@ -11,6 +11,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DocumentOperator.Infrastruc
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DocumentOperator.Domain", "DocumentOperator.Domain\DocumentOperator.Domain.csproj", "{B4C1C3ED-D3E8-4272-8704-2E73CEA6A0DD}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DocumentOperator.Tests", "DocumentOperator.Tests\DocumentOperator.Tests.csproj", "{32D2E997-3DA7-4061-8A50-DBB34BBC3E5A}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -33,6 +35,10 @@ Global
 		{B4C1C3ED-D3E8-4272-8704-2E73CEA6A0DD}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{B4C1C3ED-D3E8-4272-8704-2E73CEA6A0DD}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{B4C1C3ED-D3E8-4272-8704-2E73CEA6A0DD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{32D2E997-3DA7-4061-8A50-DBB34BBC3E5A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{32D2E997-3DA7-4061-8A50-DBB34BBC3E5A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{32D2E997-3DA7-4061-8A50-DBB34BBC3E5A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{32D2E997-3DA7-4061-8A50-DBB34BBC3E5A}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE