Enhance ExtractSwissQrCode feature documentation

Updated `DocumentEndpoints` to include detailed requirements, return values, and use case for the `ExtractSwissQrCode` endpoint.

Marked Feature 2 (`ExtractSwissQrCode`) as completed in `PHASENPLAN.md` and `ROADMAP.md`, summarizing achievements and outlining next steps for Feature 3 (`ExtractAttachments`).

Enhanced `ExtractSwissQrCodeRequest` and `ExtractSwissQrCodeResponse` DTOs with example JSON payloads for clarity.

Expanded `SwissQrCodeDataDto` and `AddressDataDto` with detailed field-level documentation to improve usability and adherence to Swiss QR Bill Standard 2.0.

DocumentOperator.API/Endpoints/v1/DocumentEndpoints.cs

@@ -33,7 +33,19 @@ public static class DocumentEndpoints
         group.MapPost("/extract-swiss-qr-code", ExtractSwissQrCode)
             .WithName("ExtractSwissQrCode")
             .WithSummary("Extracts Swiss QR Code from the last page of a PDF document")
-            .WithDescription("Extracts and parses a Swiss QR Code (Swiss QR Bill Standard 2.0) from the last page of a PDF. Returns references (passed through) and all QR code fields.")
+            .WithDescription(@"Extracts and parses a Swiss QR Code (Swiss QR Bill Standard 2.0) from the last page of a PDF document.
+
+**Requirements:**
+- PDF must contain a valid Swiss QR Code on the last page
+- QR Code must conform to Swiss QR Bill Standard 2.0
+- References array is required (can be empty)
+
+**Returns:**
+- All QR code fields (IBAN, amount, creditor, debtor, reference, etc.)
+- References array (passed through from request)
+
+**Use Case:**
+Extract payment information from Swiss QR invoices for automated processing.")
             .Produces<ExtractSwissQrCodeResponse>(StatusCodes.Status200OK)
             .Produces<ProblemDetails>(StatusCodes.Status400BadRequest)
             .Produces<ProblemDetails>(StatusCodes.Status404NotFound)