docs: add culture management migration warnings for Server/Auto

Prepare for Blazor Server/Auto migration by documenting current
WASM-specific culture initialization approach and providing
detailed migration checklist in COPILOT_CONTEXT.md.

COPILOT_CONTEXT.md

@@ -0,0 +1,489 @@
+# EnvelopeGenerator — AI Context Reference
+
+## Purpose
+Digital document signing system with **unified Blazor WASM frontend** for both Senders and Receivers. Senders create envelopes and place signature fields. Receivers view PDFs, sign documents, export stamped PDFs.
+
+**Primary Libraries:** DevExpress + PDF.js (PSPDFKit removed)
+
+---
+
+## Deployment Architecture
+
+**Two Presentation Projects (Both Required):**
+
+1. **EnvelopeGenerator.API** (ASP.NET Core Web API)
+   - Runs independently (development & production)
+   - **YARP Reverse Proxy** configured via `yarp.json`
+   - Proxies requests to:
+     - `EnvelopeGenerator.ReceiverUI` (Blazor WASM)
+     - External Auth.API service
+   - Serves as single entry point for all requests
+
+2. **EnvelopeGenerator.ReceiverUI** (Blazor WebAssembly)
+   - Runs on separate host/port
+   - Accessed **only through API proxy** (not directly)
+   - Serves static files (HTML, JS, CSS, WASM)
+
+**Request Flow:**
+```
+Client ? API:8088 (YARP Proxy) ? ReceiverUI:52936 (Blazor WASM)
+                                ? Auth.API:9090 (External Auth Service)
+```
+
+**Configuration:** `EnvelopeGenerator.API/yarp.json`
+
+---
+
+## ReceiverUI Route Structure
+
+### Root Route
+| Route | File | Purpose |
+|---|---|---|
+| `/` | `Index.razor` | Application entry point (landing page). | 
+
+### Sender Routes
+| Route | File | Purpose |
+|---|---|---|
+| `/sender/login` | `LoginSenderPage.razor` | Username/password authentication |
+| `/sender` | `EnvelopeSenderPage.razor` | Sender dashboard (envelope list) |
+
+### Receiver Routes
+| Route | File | Purpose |
+|---|---|---|
+| `/envelope/login/{EnvelopeKey}` | `LoginReceiverPage.razor` | Access code authentication for specific envelope |
+| `/envelope/{EnvelopeKey}` | `EnvelopeReceiverPage.razor` | View & sign envelope (PDF.js viewer) |
+
+**Multi-Envelope Support:** Receivers can login to multiple envelopes simultaneously (per-envelope cookie authentication).
+
+---
+
+## Architecture Evolution
+
+### Old Architecture (Deprecated)
+- **Sender UI:** `EnvelopeGenerator.Web` (Razor Pages + PSPDFKit)
+- **Receiver UI:** `EnvelopeGenerator.ReceiverUI` (Blazor WASM + PDF.js)
+- **Backend:** `EnvelopeGenerator.API`
+
+### Current Architecture
+- **Unified Frontend:** `EnvelopeGenerator.ReceiverUI` (Blazor WASM) — **Both Senders & Receivers**
+- **Backend:** `EnvelopeGenerator.API` — **Both Senders & Receivers**
+- **Libraries:** DevExpress + PDF.js
+- **PSPDFKit:** **REMOVED**
+
+---
+
+## Solution Structure
+
+| Project | Target | Purpose |
+|---|---|---|
+| `EnvelopeGenerator.API` | net8.0 | ASP.NET Core Web API. Backend for **both Senders & Receivers**. Auth, PDF serving, signature endpoints. |
+| `EnvelopeGenerator.ReceiverUI` | net8.0 WASM | **Unified Blazor WebAssembly Frontend**. UI for **both Senders & Receivers**. YARP proxy to API. |
+| `EnvelopeGenerator.Web` | net7/8/9 | **DEPRECATED.** Legacy Razor Pages (Sender UI). No longer used. |
+| `EnvelopeGenerator.Application` | multi | MediatR CQRS handlers. Business logic. |
+| `EnvelopeGenerator.Domain` | multi | Domain models, constants, interfaces. |
+| `EnvelopeGenerator.Infrastructure` | multi | EF Core repos, DB context. |
+| `EnvelopeGenerator.PdfEditor` | multi | iText7 utilities (NOT used in ReceiverUI). |
+| `EnvelopeGenerator.DependencyInjection` | multi | DI registration helpers. |
+| **VB.NET projects** (Service/Form/BBTests) | net462 | **Legacy. Do NOT touch.** |
+
+---
+
+## Localization & Culture Management
+
+**Current Architecture:** Blazor WebAssembly (client-side culture management)
+
+### Implementation Details
+
+**Culture Storage:**
+- Culture preference stored in browser's `localStorage` (key: `AppCulture`)
+- Managed by `CultureService.cs` (ReceiverUI/Services)
+- Supported cultures: `de-DE`, `en-US`, `fr-FR`
+
+**Culture Initialization:**
+- **Location:** `Program.cs` (lines 53-57)
+- Sets `CultureInfo.DefaultThreadCurrentCulture/UICulture` **before** app runs
+- **WASM-Safe:** Each user has isolated browser instance
+
+**Language Selector:**
+- **Component:** `LanguageSelector.razor` (ReceiverUI/Shared)
+- Displays flag icon + language name
+- Changes culture via `CultureService.SetCultureAsync()`
+- Navigates with `forceLoad: false` (smooth transition, no page reload)
+
+### ⚠️ MIGRATION WARNING: Blazor Server/Auto
+
+**Current approach is WASM-specific and will break in Server/Auto render modes!**
+
+**Why it breaks:**
+- `Program.cs:53-57` sets **global** `DefaultThreadCurrentCulture`
+- In Server/Auto, one app instance serves **all users**
+- User A selects German → User B sees German too (shared state)
+- Thread-safety issues and culture conflicts
+
+**Migration Checklist (when moving to Server/Auto):**
+
+1. **Remove global culture initialization** from `Program.cs` (lines 53-57)
+   - See detailed warning comment in the code
+
+2. **Add RequestLocalizationMiddleware** (Server-side approach):
+   ```csharp
+   app.UseRequestLocalization(options => {
+       options.SupportedCultures = new[] { "de-DE", "en-US", "fr-FR" };
+       options.SupportedUICultures = options.SupportedCultures;
+       options.RequestCultureProviders.Insert(0, new CookieRequestCultureProvider());
+   });
+   ```
+
+3. **OR** Use **per-circuit culture** (Blazor Server approach):
+   - Store culture in circuit-scoped service
+   - Use `CascadingParameter` to distribute to components
+   - See: https://learn.microsoft.com/aspnet/core/blazor/globalization-localization
+
+4. **Update `LanguageSelector.razor`:**
+   - Remove manual `CultureInfo.DefaultThreadCurrentCulture` assignment
+   - Use middleware/circuit culture provider instead
+
+5. **Update `CultureService.cs`:**
+   - Integrate with Server-side culture provider
+   - May need to store in cookies instead of localStorage
+
+**References:**
+- Microsoft Docs: [Blazor Globalization/Localization](https://learn.microsoft.com/aspnet/core/blazor/globalization-localization)
+- Current implementation: `Program.cs`, `CultureService.cs`, `LanguageSelector.razor`
+
+---
+
+## Key Files & Routes
+
+| File | Route/Purpose |
+|---|---|
+| `ReceiverUI/Pages/Index.razor` | `/` — Application entry point (landing page). |
+| `ReceiverUI/Pages/EnvelopeSenderPage.razor` | `/sender` — Sender dashboard (envelope list). |
+| `ReceiverUI/Pages/EnvelopeReceiverPage.razor` | `/envelope/{key}` — Receiver PDF viewer & signing. |
+| `ReceiverUI/Pages/LoginSenderPage.razor` | `/sender/login` — Sender username/password auth. |
+| `ReceiverUI/Pages/LoginReceiverPage.razor` | `/envelope/login/{EnvelopeKey}` — Receiver access code auth. |
+| `ReceiverUI/wwwroot/js/pdf-viewer.js` | PDF.js wrapper (zoom, pagination, thumbnails). |
+| `ReceiverUI/wwwroot/js/receiver-signature.js` | Signature pad (draw/type/image). |
+| `ReceiverUI/wwwroot/css/envelope-viewer.css` | EnvelopeViewer styles. |
+| `ReceiverUI/Services/AuthService.cs` | Receiver + Sender authentication. |
+| `ReceiverUI/Services/SignatureCacheService.cs` | Signature caching (Redis/SQL). |
+| `API/Controllers/CacheController.cs` | Signature cache endpoints. |
+
+---
+
+## Coordinate System — CRITICAL
+
+**Database Format:** INCHES (GdPicture14 native)  
+**Origin:** Top-left corner  
+**Axes:** X right, Y down
+
+### Conversion Formulas
+
+| From INCHES to | Formula | Example |
+|---|---|---|
+| **DevExpress DX** | `x_DX = x_inches * 100` | 1.5" ? 150 DX |
+| **PDF Points** | `x_pt = x_inches * 72` | 1.5" ? 108 pt |
+| **PDF.js Pixels** | Normalize ? scale | `(x_inches / pageWidth) * canvasWidth * scale` |
+
+**A4 Dimensions:**
+- Width: 8.27" = 595pt = 827 DX
+- Height: 11.69" = 842pt = 1169 DX
+
+### Unit Systems
+
+| System | Unit | Origin | Y-Axis |
+|---|---|---|---|
+| **Database (GdPicture14)** | Inches | Top-left | Down |
+| PDF.js | Pixels | Top-left | Down |
+| iText7 PDF | Points (1/72") | **Bottom-left** | **Up** (flip required) |
+| ~~PSPDFKit~~ | ~~Points~~ | ~~Top-left~~ | **REMOVED** |
+
+---
+
+## EnvelopeReceiver — PDF.js Viewer & Signing
+
+**Route:** `/envelope/{EnvelopeKey}`  
+**Tech:** PDF.js 3.11.174 + Blazor WASM + configurable quality  
+**File:** `ReceiverUI/Pages/EnvelopeReceiverPage.razor`
+
+### Key Features
+1. HiDPI/Retina support (4x quality)
+2. Configurable quality (`appsettings.json`)
+3. Unlimited zoom (50%-300%)
+4. Ctrl+Wheel global zoom
+5. Resizable thumbnail sidebar (150-400px, localStorage)
+6. Responsive (desktop/mobile)
+
+### Configuration
+**File:** `ReceiverUI/wwwroot/appsettings.json`
+
+```json
+{
+  "PdfViewer": {
+    "ThumbnailBaseScale": 0.75,
+    "ThumbnailEnableHiDPI": true,
+    "MainCanvasEnableHiDPI": true,
+    "ZoomStepPercentage": 5
+  }
+}
+```
+
+### JavaScript API
+**File:** `ReceiverUI/wwwroot/js/pdf-viewer.js`
+
+```javascript
+window.pdfViewer = {
+    initialize(canvasId, pdfDataUrl, dotNetRef),
+    renderPage(num),
+    renderSignatureButtons(signatures, pageNum, dotNetRef),
+    applySignature(signatureId, dataUrl, fullName, position, place),
+    zoomIn(), zoomOut(), dispose()
+}
+```
+
+---
+
+## Signature Workflow — EnvelopeReceiver
+
+**IMPORTANT:** iText7 NOT used (GPL license issue). Client-side overlay system only.
+
+### Workflow Steps
+
+1. **Page Load:**
+   - Check `SignatureCacheService` for cached signature
+   - If cached ? skip popup, load signature
+   - If not ? show automatic popup (mandatory)
+
+2. **Signature Popup (DxPopup):**
+   - **Cannot close** (no X, no ESC, no outside-click)
+   - **3 Tabs:** Draw (canvas) / Text (font select) / Image (upload)
+   - **Required:** Full name, Place
+   - **Optional:** Position
+   - **Save ?** Store in `_capturedSignature`, cache via API
+
+3. **Signature Buttons:**
+   - Render purple "Unterschreiben" buttons at signature field positions
+   - Coordinates: INCHES ? POINTS ? Pixels (scaled)
+   - File: `pdf-viewer.js` ? `renderSignatureButtons()`
+
+4. **Apply Signature (Click "Unterschreiben"):**
+   - JS: Remove button, create HTML overlay
+   - Format: Image + separator + text (Name, Position, Place, Date)
+   - **NOT stamped on PDF bytes** (visual overlay only)
+
+5. **Re-rendering:**
+   - Zoom/Page change ? recalculate button positions
+   - Session state: `_capturedSignature` (lost on refresh)
+
+### Data Model
+**File:** `ReceiverUI/Models/SignatureCaptureDto.cs`
+
+```csharp
+public sealed record SignatureCaptureDto {
+    public required string DataUrl { get; init; }    // base64 PNG
+    public required string FullName { get; init; }
+    public string Position { get; init; } = "";      // Optional
+    public required string Place { get; init; }
+}
+```
+
+---
+
+## Signature Caching
+
+**Purpose:** Persist signature across page refreshes (distributed cache: Redis/SQL)
+
+### API Endpoints
+**Controller:** `API/Controllers/CacheController.cs`
+
+- `POST /api/Cache/SignatureCapture/{envelopeKey}` — Save
+- `GET /api/Cache/SignatureCapture/{envelopeKey}` — Load
+- `DELETE /api/Cache/SignatureCapture/{envelopeKey}` — Delete
+
+**Cache Key Format:**
+```
+signature:91751687-8ae6-4777-bf5f-b8846085e62e:{envelopeKey}
+```
+
+**Configuration:** `appsettings.json`
+```json
+{
+  "Cache": {
+    "SignatureCacheExpiration": null  // or "02:00:00" for 2h
+  }
+}
+```
+
+### Service
+**File:** `ReceiverUI/Services/SignatureCacheService.cs`
+
+```csharp
+public class SignatureCacheService {
+    Task SaveSignatureAsync(string envelopeKey, SignatureCaptureDto signature);
+    Task<SignatureCaptureDto?> GetSignatureAsync(string envelopeKey);
+    Task DeleteSignatureAsync(string envelopeKey);
+}
+```
+
+**Error Handling:** Fire-and-forget saves, graceful degradation on load failure.
+
+---
+
+## Sender Login
+
+**Route:** `/sender/login`  
+**File:** `ReceiverUI/Pages/LoginSenderPage.razor`  
+**Tech:** Bootstrap 5 + DevExpress Blazing Berry theme
+
+### AuthService Extension
+**File:** `ReceiverUI/Services/AuthService.cs`
+
+```csharp
+public enum SenderLoginResult { Success, InvalidCredentials, Error }
+
+public async Task<SenderLoginResult> LoginSenderAsync(string username, string password) {
+    var response = await http.PostAsJsonAsync(
+        $"{_api.BaseUrl}/api/auth?cookie=true",
+        new { username, password });
+    
+    return response.StatusCode switch {
+        HttpStatusCode.OK => SenderLoginResult.Success,
+        HttpStatusCode.Unauthorized => SenderLoginResult.InvalidCredentials,
+        _ => SenderLoginResult.Error
+    };
+}
+```
+
+### API Integration
+**Endpoint:** `POST /api/auth?cookie=true`
+
+**Request:**
+```json
+{ "username": "TekH", "password": "***" }
+```
+
+**Response:**
+- `200 OK` ? Cookie set, redirect to `/sender`
+- `401 Unauthorized` ? Show error: "Ungültige Anmeldedaten"
+- Other ? Show error: "Serverfehler"
+
+**Cookie:** HTTP-only, Secure (HTTPS), SameSite=Strict
+
+### UI Flow
+1. User enters username + password
+2. Click "Anmelden" or press Enter
+3. Call `AuthService.LoginSenderAsync()`
+4. Success ? `Navigation.NavigateTo("/sender", forceLoad: true)`
+5. Error ? Display alert
+
+---
+
+## Receiver Login
+
+**Route:** `/envelope/login/{EnvelopeKey}`  
+**File:** `ReceiverUI/Pages/LoginReceiverPage.razor`
+
+**Multi-Envelope Support:** Cookies are stored per-envelope (e.g., `AuthTokenSignFLOWReceiver.{envelopeKey}`), allowing simultaneous authentication for multiple envelopes in the same browser session.
+
+### AuthService Method
+```csharp
+public enum EnvelopeLoginResult { Success, InvalidCode, NotFound, Error }
+
+public async Task<EnvelopeLoginResult> LoginEnvelopeReceiverAsync(string key, string accessCode) {
+    var form = new MultipartFormDataContent();
+    form.Add(new StringContent(accessCode), "AccessCode");
+    
+    var response = await http.PostAsync(
+        $"{_api.BaseUrl}/api/Auth/envelope-receiver/{Uri.EscapeDataString(key)}", form);
+    
+    return response.StatusCode switch {
+        HttpStatusCode.OK => EnvelopeLoginResult.Success,
+        HttpStatusCode.Unauthorized => EnvelopeLoginResult.InvalidCode,
+        HttpStatusCode.NotFound => EnvelopeLoginResult.NotFound,
+        _ => EnvelopeLoginResult.Error
+    };
+}
+```
+
+**Success:** Redirect to `/envelope/{key}`
+
+---
+
+## NuGet Packages (ReceiverUI)
+
+| Package | Version | Purpose |
+|---|---|---|
+| `DevExpress.Blazor.*` | 25.2.3 | UI components (grids, popups, etc.) |
+| `SkiaSharp.*` | 3.119.1 | WASM rendering |
+| ~~`itext`~~ | ~~8.0.5~~ | **NOT USED** (GPL license) |
+
+**External CDN:**
+- PDF.js 3.11.174: `https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.min.js`
+
+---
+
+## Mistakes History — Do NOT Repeat
+
+| Mistake | Why Wrong |
+|---|---|
+| Using iText7 in EnvelopeReceiver | GPL license issue. Use overlay system instead. |
+| Using PSPDFKit | Removed from architecture. Use PDF.js + DevExpress. |
+| Hardcoded quality values in PDF.js | Use `appsettings.json` for configurability. |
+| Complex toolbar layouts | User wants simplicity. Keep horizontal layout. |
+| Over-designed UI (gradients/badges) | User prefers simple text labels. |
+| Ignoring "revert" instructions | Revert HTML structure, not just CSS. |
+| `BottomMarginBand` for signatures | Repeats on every page. Use DetailBand. |
+| `imageY = (page-1) * 1169 + ann.Y` | Inflates DetailBand. Calculate per-page. |
+
+---
+
+## Development Notes
+
+### Deprecated Projects
+**DO NOT USE:**
+- `EnvelopeGenerator.Web` (Razor Pages) — Replaced by unified ReceiverUI
+- PSPDFKit — Removed, use PDF.js + DevExpress instead
+
+### Legacy Projects (VB.NET)
+**DO NOT TOUCH:** `EnvelopeGenerator.Service`, `EnvelopeGenerator.Form`, `EnvelopeGenerator.BBTests`
+
+### Signature Coordinate Evidence
+**File:** `EnvelopeGenerator.Form/frmFieldEditor.vb` (VB.NET)
+
+```vb
+Private Const SIGNATURE_WIDTH As Single = 1.77   ' inches
+Private Const SIGNATURE_HEIGHT As Single = 1.96  ' inches
+
+Sub LoadAnnotation(pElement As Signature, ...)
+    oAnnotation.Left = CSng(pElement.X)    ' Direct INCHES assignment
+    oAnnotation.Top = CSng(pElement.Y)
+End Sub
+```
+
+Proves database uses INCHES natively.
+
+---
+
+## Quick Reference
+
+### When working with coordinates:
+1. **Database ? UI:** INCHES × 72 = PDF Points
+2. **UI ? Display:** Points × scale = Pixels
+3. **iText7 stamping:** Flip Y-axis (top-down ? bottom-up)
+
+### When adding features:
+1. Check `Mistakes History` first
+2. Prefer simplicity over complexity
+3. Use `appsettings.json` for configuration
+4. Keep consistent with existing design (Bootstrap 5 + Blazing Berry)
+5. **Unified frontend:** ReceiverUI serves both Senders and Receivers
+
+### When debugging:
+1. **Coordinates:** Always check unit system (inches/points/pixels)
+2. **Authentication:** Check cookie name/domain/SameSite
+3. **Cache:** Check Redis/SQL connection + key format
+4. **Frontend confusion:** Only use ReceiverUI (Web is deprecated)
+
+---
+
+**Last Updated:** Session 19 (Razor file naming convention + Index route proxy)

EnvelopeGenerator.API/AuthScheme.cs

@@ -0,0 +1,17 @@
+namespace EnvelopeGenerator.API;
+
+/// <summary>
+/// 
+/// </summary>
+public static class AuthScheme
+{
+    /// <summary>
+    /// Scheme name used for per-envelope receiver JWT authentication.
+    /// </summary>
+    public const string Receiver = "EnvelopeGenerator.API.ReceiverJWT";
+
+    /// <summary>
+    /// Scheme name used for per-envelope sender JWT authentication.
+    /// </summary>
+    public const string Sender = "EnvelopeGenerator.API.SenderJWT";
+}

EnvelopeGenerator.API/Controllers/AuthController.cs

@@ -40,7 +40,7 @@ public partial class AuthController(IOptions<AuthTokenKeys> authTokenKeyOptions,
     /// <response code="401">Wenn es kein zugelassenes Cookie gibt, wird „nicht zugelassen“ zurückgegeben.</response>
     [ProducesResponseType(typeof(void), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(void), StatusCodes.Status401Unauthorized)]
-    [Authorize(Policy = AuthPolicy.SenderOrReceiver)]
+    [Authorize(AuthenticationSchemes = AuthScheme.Sender)]
     [HttpPost("logout")]
     public async Task<IActionResult> Logout()
     {
@@ -69,7 +69,7 @@ public partial class AuthController(IOptions<AuthTokenKeys> authTokenKeyOptions,
     [ProducesResponseType(typeof(void), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(void), StatusCodes.Status401Unauthorized)]
     [HttpGet("check")]
-    [Authorize]
+    [Authorize(AuthenticationSchemes = AuthScheme.Sender)]
     public IActionResult Check(string? role = null)
         => role is not null && !User.IsInRole(role)
             ? Unauthorized()

EnvelopeGenerator.API/Controllers/ConfigController.cs

@@ -1,4 +1,5 @@
 using EnvelopeGenerator.API.Models.PsPdfKitAnnotation;
+using EnvelopeGenerator.Domain.Constants;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.Options;
@@ -13,7 +14,7 @@ namespace EnvelopeGenerator.API.Controllers;
 /// </remarks>
 [Route("api/[controller]")]
 [ApiController]
-[Authorize]
+[Authorize(Policy = AuthPolicy.SenderOrReceiver)]
 public class ConfigController(IOptionsMonitor<AnnotationParams> annotationParamsOptions) : ControllerBase
 {
     private readonly AnnotationParams _annotationParams = annotationParamsOptions.CurrentValue;

EnvelopeGenerator.API/Controllers/DocReceiverElementController.cs

@@ -15,14 +15,14 @@ namespace EnvelopeGenerator.API.Controllers;
 [Authorize(Policy = AuthPolicy.Receiver)]
 [ApiController]
 [Route("api/[controller]")]
-public class SignatureController : ControllerBase
+public class DocReceiverElementController : ControllerBase
 {
     private readonly IMediator _mediator;
 
     /// <summary>
-    /// Initializes a new instance of <see cref="SignatureController"/>.
+    /// Initializes a new instance of <see cref="DocReceiverElementController"/>.
     /// </summary>
-    public SignatureController(IMediator mediator)
+    public DocReceiverElementController(IMediator mediator)
     {
         _mediator = mediator;
     }

EnvelopeGenerator.API/Controllers/EnvelopeController.cs

@@ -51,7 +51,7 @@ public class EnvelopeController : ControllerBase
     /// <response code="401">Der Benutzer ist nicht authentifiziert.</response>
     /// <response code="403">Der Benutzer hat keine Berechtigung, auf die Ressource zuzugreifen.</response>
     /// <response code="500">Ein unerwarteter Fehler ist aufgetreten.</response>
-    [Authorize]
+    [Authorize(AuthenticationSchemes = AuthScheme.Sender)]
     [HttpGet]
     public async Task<IActionResult> GetAsync([FromQuery] ReadEnvelopeQuery envelope)
     {

EnvelopeGenerator.API/EnvelopeGenerator.API.csproj

@@ -34,6 +34,7 @@
     <PackageReference Include="DigitalData.Auth.Client" Version="1.3.7" />
     <PackageReference Include="DigitalData.Core.API" Version="2.2.1" />
     <PackageReference Include="HtmlSanitizer" Version="9.0.892" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.28" />
     <PackageReference Include="Microsoft.Extensions.Caching.SqlServer" Version="8.0.11" Condition="'$(TargetFramework)' == 'net8.0'" />
     <PackageReference Include="itext" Version="8.0.5" />
     <PackageReference Include="itext.bouncy-castle-adapter" Version="8.0.5" />

EnvelopeGenerator.API/Program.cs

@@ -13,7 +13,6 @@ using EnvelopeGenerator.Application;
 using DigitalData.Auth.Client;
 using DigitalData.Core.Abstractions;
 using EnvelopeGenerator.API.Models;
-using Microsoft.AspNetCore.Authentication.JwtBearer;
 using Microsoft.IdentityModel.Tokens;
 using DigitalData.Core.Abstractions.Security.Extensions;
 using EnvelopeGenerator.API.Middleware;
@@ -21,6 +20,8 @@ using EnvelopeGenerator.API.Options;
 using NLog.Web;
 using NLog;
 using DigitalData.Auth.Claims;
+using EnvelopeGenerator.API;
+using Microsoft.AspNetCore.Authentication.JwtBearer;
 
 var logger = LogManager.Setup().LoadConfigurationFromAppSettings().GetCurrentClassLogger();
 logger.Info("Logging initialized!");
@@ -43,7 +44,11 @@ try
 
     var deferredProvider = new DeferredServiceProvider();
 
-    builder.Services.AddControllers();
+    builder.Services.AddControllers()
+        .AddJsonOptions(options =>
+        {
+            options.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
+        });
     builder.Services.AddHttpClient();
     builder.Services.AddReverseProxy().LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));
 
@@ -130,15 +135,12 @@ try
 
     var authTokenKeys = config.GetOrDefault<AuthTokenKeys>();
 
-    // Scheme name used for per-envelope receiver JWT authentication.
-    const string EnvelopeReceiverScheme = "EnvelopeReceiverJwt";
-
     builder.Services.AddAuthentication(options =>
     {
         options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
         options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
     })
-        .AddJwtBearer(opt =>
+        .AddJwtBearer(AuthScheme.Sender, opt =>
         {
             opt.TokenValidationParameters = new TokenValidationParameters
             {
@@ -176,7 +178,7 @@ try
         // last path segment of the request URL.
         // This enables simultaneous authentication for multiple envelopes
         // within the same browser session.
-        .AddJwtBearer(EnvelopeReceiverScheme, opt =>
+        .AddJwtBearer(AuthScheme.Receiver, opt =>
         {
             opt.TokenValidationParameters = new TokenValidationParameters
             {
@@ -240,19 +242,17 @@ try
     });
 
     builder.Services.AddAuthorizationBuilder()
-        .AddPolicy(AuthPolicy.SenderOrReceiver, policy =>
+        .AddPolicy(AuthPolicy.SenderOrReceiver, policy => policy
-            policy.RequireRole(Role.Sender, Role.Receiver.Full))
+            .RequireRole(Role.Sender, Role.Receiver.Full)
-        .AddPolicy(AuthPolicy.Sender, policy =>
+            .AddAuthenticationSchemes(AuthScheme.Sender, AuthScheme.Receiver))
-            policy.RequireRole(Role.Sender))
+        .AddPolicy(AuthPolicy.Sender, policy => policy
-        // Per-envelope policy: uses the dedicated EnvelopeReceiverJwt scheme so it
+            .RequireRole(Role.Sender)
-        // never conflicts with the default JwtBearer scheme.
+            .AddAuthenticationSchemes(AuthScheme.Sender))
-        .AddPolicy(AuthPolicy.Receiver, policy =>
+        .AddPolicy(AuthPolicy.Receiver, policy => policy
-            policy
+            .AddAuthenticationSchemes(AuthScheme.Receiver)
-                .AddAuthenticationSchemes(EnvelopeReceiverScheme)
+            .RequireAuthenticatedUser()
-                .RequireAuthenticatedUser()
             .RequireRole(Role.Receiver.Full, "receiver"))
-        .AddPolicy(AuthPolicy.ReceiverTFA, policy =>
+        .AddPolicy(AuthPolicy.ReceiverTFA, policy => policy.RequireRole(Role.Receiver.TFA));
-            policy.RequireRole(Role.Receiver.TFA));
 
     // User manager
 #pragma warning disable CS0618 // Type or member is obsolete

EnvelopeGenerator.API/Properties/launchSettings.json

@@ -22,8 +22,8 @@
     "https": {
       "commandName": "Project",
       "dotnetRunMessages": true,
-      "launchBrowser": false,
+      "launchBrowser": true,
-      "launchUrl": "swagger",
+      "launchUrl": "sender",
       "applicationUrl": "https://localhost:8088;http://localhost:5131",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"

EnvelopeGenerator.API/yarp.json

@@ -1,21 +1,16 @@
 {
 "ReverseProxy": {
   "Routes": {
-    "receiver-ui-receiver": {
+    "receiver-ui-root": {
       "ClusterId": "receiver-ui",
-      "Order": 100,
+      "Order": 300,
       "Match": {
-        "Path": "/receiver/{**catch-all}",
+        "Path": "/",
         "Methods": [ "GET", "HEAD" ]
-      }
+      },
-    },
+      "Transforms": [
-    "receiver-ui-login": {
+        { "PathSet": "/index.html" }
-      "ClusterId": "receiver-ui",
+      ]
-      "Order": 100,
-      "Match": {
-        "Path": "/login/{**catch-all}",
-        "Methods": [ "GET", "HEAD" ]
-      }
     },
     "receiver-ui-sender": {
       "ClusterId": "receiver-ui",
@@ -23,7 +18,10 @@
       "Match": {
         "Path": "/sender/{**catch-all}",
         "Methods": [ "GET", "HEAD" ]
-      }
+      },
+      "Transforms": [
+        { "PathSet": "/index.html" }
+      ]
     },
     "receiver-ui-envelope": {
       "ClusterId": "receiver-ui",
@@ -36,6 +34,17 @@
         { "PathSet": "/index.html" }
       ]
     },
+    "receiver-ui-envelope-dxreportviewer": {
+      "ClusterId": "receiver-ui",
+      "Order": 90,
+      "Match": {
+        "Path": "/envelope/{EnvelopeKey}/DxReportViewer",
+        "Methods": [ "GET", "HEAD" ]
+      },
+      "Transforms": [
+        { "PathSet": "/index.html" }
+      ]
+    },
     "receiver-ui-blazor-framework": {
       "ClusterId": "receiver-ui",
       "Order": 50,

EnvelopeGenerator.Application/Common/Dto/ConfigDto.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto;
-
-namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// Data Transfer Object representing configuration settings.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class ConfigDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/DocReceiverElementDto.cs

@@ -1,14 +1,11 @@
 using EnvelopeGenerator.Domain.Constants;
 using EnvelopeGenerator.Domain.Interfaces;
-using Microsoft.AspNetCore.Mvc;
-using System.ComponentModel.DataAnnotations.Schema;
 
 namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// Data Transfer Object representing a positioned element assigned to a document receiver.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class DocReceiverElementDto : IDocReceiverElement
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/DocumentDto.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto;
-
-namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// Data Transfer Object representing a document within an envelope, including optional binary data and form elements.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class DocumentDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/DocumentStatusDto.cs

@@ -1,12 +1,10 @@
 using EnvelopeGenerator.Domain.Constants;
-using Microsoft.AspNetCore.Mvc;
 
 namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// Data Transfer Object representing the status of a document for a specific receiver.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class DocumentStatusDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/EnvelopeDto.cs

@@ -1,16 +1,14 @@
 using DigitalData.EmailProfilerDispatcher.Abstraction.Attributes;
 using DigitalData.UserManager.Application.DTOs.User;
+using EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
 using EnvelopeGenerator.Domain.Constants;
 using EnvelopeGenerator.Domain.Entities;
 using EnvelopeGenerator.Domain.Interfaces;
-using Microsoft.AspNetCore.Mvc;
-
 namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record EnvelopeDto : IEnvelope
 {
 	/// <summary>
@@ -126,4 +124,9 @@ public record EnvelopeDto : IEnvelope
     /// 
     /// </summary>
     public IEnumerable<DocumentDto>? Documents { get; set; }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public IEnumerable<EnvelopeReceiverDto>? EnvelopeReceivers { get; set; }
 }

EnvelopeGenerator.Application/Common/Dto/EnvelopeReceiver/EnvelopeReceiverDto.cs

@@ -1,13 +1,11 @@
 using DigitalData.EmailProfilerDispatcher.Abstraction.Attributes;
 using EnvelopeGenerator.Application.Common.Dto.Receiver;
-using Microsoft.AspNetCore.Mvc;
 
 namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
 
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record EnvelopeReceiverDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/EnvelopeReceiver/EnvelopeReceiverSecretDto.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
-
-namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
 
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record EnvelopeReceiverSecretDto : EnvelopeReceiverDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/EnvelopeReceiverReadOnly/EnvelopeReceiverReadOnlyCreateDto.cs

@@ -1,5 +1,4 @@
-using Microsoft.AspNetCore.Mvc;
+using System.ComponentModel.DataAnnotations;
-using System.ComponentModel.DataAnnotations;
 using System.Text.Json.Serialization;
 
 namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
@@ -8,7 +7,6 @@ namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
 /// 
 /// </summary>
 /// <param name="DateValid"></param>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record EnvelopeReceiverReadOnlyCreateDto(
     DateTime DateValid)
 {

EnvelopeGenerator.Application/Common/Dto/EnvelopeReceiverReadOnly/EnvelopeReceiverReadOnlyDto.cs

@@ -1,6 +1,4 @@
-using EnvelopeGenerator.Application.Common.Dto;
+using EnvelopeGenerator.Application.Common.Dto.Receiver;
-using EnvelopeGenerator.Application.Common.Dto.Receiver;
-using Microsoft.AspNetCore.Mvc;
 
 namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
 
@@ -8,7 +6,6 @@ namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
 /// Represents a read-only Data Transfer Object (DTO) for an envelope receiver.
 /// Contains information about the receiver, associated envelope, and audit details.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class EnvelopeReceiverReadOnlyDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/EnvelopeReceiverReadOnly/EnvelopeReceiverReadOnlyUpdateDto.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
-
-namespace EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiverReadOnly;
 
 /// <summary>
 /// Data Transfer Object for updating a read-only envelope receiver.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class EnvelopeReceiverReadOnlyUpdateDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/EnvelopeTypeDto.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto;
-
-namespace EnvelopeGenerator.Application.Common.Dto;
 
 /// <summary>
 /// Data Transfer Object representing a type of envelope with its configuration settings.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class EnvelopeTypeDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/Messaging/GtxMessagingResponse.cs

@@ -1,9 +1,6 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto.Messaging;
-
-namespace EnvelopeGenerator.Application.Common.Dto.Messaging;
 
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class GtxMessagingResponse : Dictionary<string, object?> { }

EnvelopeGenerator.Application/Common/Dto/Messaging/SmsResponse.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Common.Dto.Messaging;
-
-namespace EnvelopeGenerator.Application.Common.Dto.Messaging;
 
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record SmsResponse
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/Receiver/ReceiverDto.cs

@@ -1,5 +1,4 @@
 using EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
-using Microsoft.AspNetCore.Mvc;
 using System.Text.Json.Serialization;
 
 namespace EnvelopeGenerator.Application.Common.Dto.Receiver;
@@ -7,7 +6,6 @@ namespace EnvelopeGenerator.Application.Common.Dto.Receiver;
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class ReceiverDto
 {
     /// <summary>

EnvelopeGenerator.Application/Common/Dto/Signature.cs

@@ -15,7 +15,7 @@ public sealed record Signature
     /// <summary>
     /// TBDD_DOCUMENT_RECEIVER_ELEMENT.ID - identifies the specific signature field on the PDF page.
     /// </summary>
-    public required int ElementId { get; init; }
+    public required int Id { get; init; }
 
     /// <summary>
     /// Base64-encoded data URL of the signature image.

EnvelopeGenerator.Application/Common/Extensions/AutoMapperAuditingExtensions.cs

@@ -1,5 +1,6 @@
 using AutoMapper;
 using EnvelopeGenerator.Domain.Interfaces.Auditing;
+using System;
 
 namespace EnvelopeGenerator.Application.Common.Extensions;
 
@@ -21,4 +22,21 @@ public static class AutoMapperAuditingExtensions
     public static IMappingExpression<TSource, TDestination> MapChangedWhen<TSource, TDestination>(this IMappingExpression<TSource, TDestination> expression)
         where TDestination : IHasChangedWhen
         => expression.ForMember(dest => dest.ChangedWhen, opt => opt.MapFrom(_ => DateTime.Now));
+
+    /// <summary>
+    /// Converts a base64 data URL string to a byte array.
+    /// Handles data URLs in the format: "data:image/png;base64,iVBORw0KG..."
+    /// </summary>
+    /// <param name="dataUrl">The base64 data URL string from Canvas.toDataURL()</param>
+    /// <returns>The decoded byte array, or null if the input is null or empty</returns>
+    public static byte[]? MapDataUrlToRequiredBytes(this string dataUrl)
+    {
+        // Remove data URL prefix (e.g., "data:image/png;base64,")
+        var base64Index = dataUrl.IndexOf(',', StringComparison.Ordinal);
+        if (base64Index == -1)
+            throw new ArgumentException("Invalid data URL format. Unable to extract base64 data.", nameof(dataUrl));
+
+        var base64Data = dataUrl[(base64Index + 1)..];
+        return Convert.FromBase64String(base64Data);
+    }
 }

EnvelopeGenerator.Application/Common/MappingProfile.cs

@@ -7,7 +7,9 @@ using EnvelopeGenerator.Application.Common.Dto.Receiver;
 using EnvelopeGenerator.Application.Common.Extensions;
 using EnvelopeGenerator.Domain.Entities;
 
-namespace EnvelopeGenerator.Application.Common.Dto;
+using EnvelopeGenerator.Application.Common.Dto;
+
+namespace EnvelopeGenerator.Application.Common;
 
 /// <summary>
 /// Represents the AutoMapper profile configuration for mapping between
@@ -28,30 +30,32 @@ public class MappingProfile : Profile
         CreateMap<EmailTemplate, EmailTemplateDto>();
         CreateMap<Envelope, EnvelopeDto>();
         CreateMap<Document, DocumentDto>();
-        CreateMap<Domain.Entities.History, HistoryDto>().ForMember(dest => dest.ActionDate, opt => opt.MapFrom(src => src.ChangedWhen));
+        CreateMap<History, HistoryDto>().ForMember(dest => dest.ActionDate, opt => opt.MapFrom(src => src.ChangedWhen));
-        CreateMap<Domain.Entities.History, HistoryCreateDto>().ForMember(dest => dest.ActionDate, opt => opt.MapFrom(src => src.ChangedWhen));
+        CreateMap<History, HistoryCreateDto>().ForMember(dest => dest.ActionDate, opt => opt.MapFrom(src => src.ChangedWhen));
-        CreateMap<Domain.Entities.EnvelopeReceiver, EnvelopeReceiverDto>();
+        CreateMap<EnvelopeReceiver, EnvelopeReceiverDto>();
-        CreateMap<Domain.Entities.EnvelopeReceiver, EnvelopeReceiverSecretDto>();
+        CreateMap<EnvelopeReceiver, EnvelopeReceiverSecretDto>();
         CreateMap<EnvelopeType, EnvelopeTypeDto>();
-        CreateMap<Domain.Entities.Receiver, ReceiverDto>();
+        CreateMap<Receiver, ReceiverDto>();
-        CreateMap<Domain.Entities.EnvelopeReceiverReadOnly, EnvelopeReceiverReadOnlyDto>();
+        CreateMap<EnvelopeReceiverReadOnly, EnvelopeReceiverReadOnlyDto>();
         CreateMap<ElementAnnotation, AnnotationDto>();
 
         // DTO to Entity mappings
         CreateMap<ConfigDto, Config>();
         CreateMap<DocReceiverElementDto, DocReceiverElement>();
-        CreateMap<Signature, DocReceiverElement>().MapChangedWhen();
+        CreateMap<Signature, DocReceiverElement>()
+            .ForMember(dest => dest.Ink, opt => opt.MapFrom(src => src.DataUrl.MapDataUrlToRequiredBytes()))
+            .MapChangedWhen();
         CreateMap<DocumentStatusDto, DocumentStatus>();
         CreateMap<EmailTemplateDto, EmailTemplate>();
         CreateMap<EnvelopeDto, Envelope>();
         CreateMap<DocumentDto, Document>();
-        CreateMap<HistoryDto, Domain.Entities.History>().ForMember(dest => dest.ChangedWhen, opt => opt.MapFrom(src => src.ActionDate));
+        CreateMap<HistoryDto, History>().ForMember(dest => dest.ChangedWhen, opt => opt.MapFrom(src => src.ActionDate));
-        CreateMap<HistoryCreateDto, Domain.Entities.History>().ForMember(dest => dest.ChangedWhen, opt => opt.MapFrom(src => src.ActionDate));
+        CreateMap<HistoryCreateDto, History>().ForMember(dest => dest.ChangedWhen, opt => opt.MapFrom(src => src.ActionDate));
-        CreateMap<EnvelopeReceiverDto, Domain.Entities.EnvelopeReceiver>();
+        CreateMap<EnvelopeReceiverDto, EnvelopeReceiver>();
         CreateMap<EnvelopeTypeDto, EnvelopeType>();
-        CreateMap<ReceiverDto, Domain.Entities.Receiver>().ForMember(rcv => rcv.EnvelopeReceivers, rcvReadDto => rcvReadDto.Ignore());
+        CreateMap<ReceiverDto, Receiver>().ForMember(rcv => rcv.EnvelopeReceivers, rcvReadDto => rcvReadDto.Ignore());
-        CreateMap<EnvelopeReceiverReadOnlyCreateDto, Domain.Entities.EnvelopeReceiverReadOnly>();
+        CreateMap<EnvelopeReceiverReadOnlyCreateDto, EnvelopeReceiverReadOnly>();
-        CreateMap<EnvelopeReceiverReadOnlyUpdateDto, Domain.Entities.EnvelopeReceiverReadOnly>();
+        CreateMap<EnvelopeReceiverReadOnlyUpdateDto, EnvelopeReceiverReadOnly>();
         CreateMap<AnnotationCreateDto, ElementAnnotation>()
             .MapAddedWhen();
 

EnvelopeGenerator.Application/DocReceiverElements/Behaviors/AnnotationBehavior.cs

@@ -1,4 +1,5 @@
 using DigitalData.Core.Abstraction.Application.Repository;
+using DigitalData.Core.Exceptions;
 using EnvelopeGenerator.Application.Common.Dto;
 using EnvelopeGenerator.Application.DocReceiverElements.Commands;
 using EnvelopeGenerator.Domain.Entities;
@@ -10,13 +11,13 @@ namespace EnvelopeGenerator.Application.DocReceiverElements.Behaviors;
 /// Pipeline behavior that saves annotations.
 /// Executes first in the signing process.
 /// </summary>
-[Obsolete("This notification is deprecated. Use Signature.Commands.SignCommand instead.")]
+[Obsolete("The PSPDFKit library is deprecated.")]
 public class AnnotationBehavior : IPipelineBehavior<SigningCommand, Unit>
 {
     private readonly IRepository<ElementAnnotation> _repo;
 
     /// <summary>
-    /// 
+    /// Initializes a new instance of the <see cref="AnnotationBehavior"/> class.
     /// </summary>
     /// <param name="repository"></param>
     public AnnotationBehavior(IRepository<ElementAnnotation> repository)
@@ -29,13 +30,21 @@ public class AnnotationBehavior : IPipelineBehavior<SigningCommand, Unit>
     /// </summary>
     /// <param name="request"></param>
     /// <param name="next"></param>
-    /// <param name="cancellationToken"></param>
+    /// <param name="cancel"></param>
     /// <returns></returns>
-    public async Task<Unit> Handle(SigningCommand request, RequestHandlerDelegate<Unit> next, CancellationToken cancellationToken)
+    public async Task<Unit> Handle(SigningCommand request, RequestHandlerDelegate<Unit> next, CancellationToken cancel)
     {
-        if (request.PsPdfKitAnnotation is PsPdfKitAnnotation annot)
+        if(request.ReceiverAppType != ReceiverAppType.LegacyWeb)
-            await _repo.CreateAsync(annot.Structured, cancellationToken);
+            if(request.PsPdfKitAnnotation is null)
+                return await next(cancel);
+            else
+                throw new BadRequestException("PsPdfKit Annotation are only supported for the legacy web receiver type.");
 
-        return await next(cancellationToken);
+        if (request.PsPdfKitAnnotation is PsPdfKitAnnotation annot)
+                await _repo.CreateAsync(annot.Structured, cancel);
+            else
+                throw new BadRequestException("Annotation data is missing or invalid.");
+
+            return await next(cancel);
     }
 }

EnvelopeGenerator.Application/DocReceiverElements/Behaviors/SaveSignatureBehavior.cs

@@ -1,22 +1,11 @@
+using AutoMapper;
+using DigitalData.Core.Abstraction.Application.Repository;
+using DigitalData.Core.Exceptions;
 using EnvelopeGenerator.Application.Common.Dto;
-using EnvelopeGenerator.Application.DocStatus.Commands;
+using EnvelopeGenerator.Application.DocReceiverElements.Commands;
-using EnvelopeGenerator.Domain.Constants;
+using EnvelopeGenerator.Domain.Entities;
 using MediatR;
-using System.Text.Json;
+using Microsoft.EntityFrameworkCore;
-
-<<<<<<< TODO: Unmerged change from project 'EnvelopeGenerator.Application (net8.0)', Before:
-=======
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand.SigningCommand;
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand;
->>>>>>> After
-
-<<<<<<< TODO: Unmerged change from project 'EnvelopeGenerator.Application (net9.0)', Before:
-=======
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand;
->>>>>>> After
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand.SigningCommand.SigningCommand;
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand.SigningCommand;
-using EnvelopeGenerator.Application.DocReceiverElements.Commands.SigningCommand;
 
 namespace EnvelopeGenerator.Application.DocReceiverElements.Behaviors;
 
@@ -28,13 +17,22 @@ public class SaveSignatureBehavior : IPipelineBehavior<SigningCommand, Unit>
 {
     private readonly ISender _sender;
 
+    private readonly IRepository<DocReceiverElement> _elementRepo;
+
+    private readonly IMapper _mapper;
+
     /// <summary>
     /// 
     /// </summary>
     /// <param name="sender"></param>
-    public SaveSignatureBehavior(ISender sender)
+    /// <param name="elementRepo"></param>
+    /// <param name="mapper"></param>
+    public SaveSignatureBehavior(ISender sender, IRepository<DocReceiverElement> elementRepo, IMapper mapper)
     {
         _sender = sender;
+        _elementRepo = elementRepo;
+        _elementRepo = elementRepo;
+        _mapper = mapper;
     }
 
     /// <summary>
@@ -42,10 +40,31 @@ public class SaveSignatureBehavior : IPipelineBehavior<SigningCommand, Unit>
     /// </summary>
     /// <param name="request"></param>
     /// <param name="next"></param>
-    /// <param name="cancellationToken"></param>
+    /// <param name="cancel"></param>
     /// <returns></returns>
-    public async Task<Unit> Handle(SigningCommand request, RequestHandlerDelegate<Unit> next, CancellationToken cancellationToken)
+    public async Task<Unit> Handle(SigningCommand request, RequestHandlerDelegate<Unit> next, CancellationToken cancel)
     {
-        return await next(cancellationToken);
+        if (request.ReceiverAppType == ReceiverAppType.LegacyWeb)
+            return await next(cancel);
+        else if(request.Signatures is not IEnumerable<Signature> signatures)
+            throw new BadRequestException($"Signatures are required for saving signature behavior.");
+
+        var elements = await _elementRepo
+            .Where(e => e.Document.EnvelopeId == request.Envelope.Id)
+            .Where(e => e.ReceiverId == request.Receiver.Id)
+            .ToListAsync(cancel);
+
+        foreach (var element in elements)
+        {
+            var signatures = request.Signatures.Where(s => s.Id == element.Id).ToList();
+            if(signatures.Count == 0)
+                throw new BadRequestException("No signature found for element with id {element.Id}.");
+            else if(signatures.Count > 1)
+                throw new BadRequestException("Multiple signatures found for element with id {element.Id}.");
+            
+            await _elementRepo.UpdateAsync(signatures.First(), e => e.Id == element.Id, cancel);
+        }
+
+        return await next(cancel);
     }
 }

EnvelopeGenerator.Application/DocReceiverElements/Commands/SigningCommand.cs

@@ -36,6 +36,11 @@ public record SigningCommand : EnvelopeReceiverQueryBase, IRequest
     /// 
     /// </summary>
     public IEnumerable<Signature>? Signatures { get; init; }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public ReceiverAppType ReceiverAppType { get; init; } = ReceiverAppType.ReceiverUI;
 }
 
 /// <summary>
@@ -54,4 +59,20 @@ public class SignCommandHandler : IRequestHandler<SigningCommand>
     {
         return Task.CompletedTask;
     }
+}
+
+/// <summary>
+/// 
+/// </summary>
+public enum ReceiverAppType
+{
+    /// <summary>
+    /// 
+    /// </summary>
+    ReceiverUI = 0,
+
+    /// <summary>
+    /// 
+    /// </summary>
+    LegacyWeb = 1,
 }

EnvelopeGenerator.Application/EnvelopeGenerator.Application.csproj

@@ -7,7 +7,7 @@
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 		<DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>
 	</PropertyGroup>
-
+	
 	<ItemGroup>
 		<None Remove="Resources\Model.Designer.vb" />
 	</ItemGroup>
@@ -21,7 +21,6 @@
 		<PackageReference Include="DigitalData.EmailProfilerDispatcher" Version="3.1.1" />
 		<PackageReference Include="HtmlSanitizer" Version="9.0.892" />
 		<PackageReference Include="MediatR" Version="12.5.0" />
-		<PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="7.0.18" />
 		<PackageReference Include="Microsoft.Identity.Client" Version="4.82.1" />
 		<PackageReference Include="Otp.NET" Version="1.4.0" />
 		<PackageReference Include="QRCoder" Version="1.6.0" />
@@ -79,25 +78,25 @@
 	</ItemGroup>
 
 	<ItemGroup Condition="'$(TargetFramework)' == 'net7.0'">
-	  <PackageReference Include="AutoMapper" Version="13.0.1" />
+		<PackageReference Include="AutoMapper" Version="13.0.1" />
-	  <PackageReference Include="Microsoft.Data.SqlClient" Version="5.2.2" />
+		<PackageReference Include="Microsoft.Data.SqlClient" Version="5.2.2" />
-	  <PackageReference Include="CommandDotNet">
+		<PackageReference Include="CommandDotNet">
 		<Version>7.0.5</Version>
-	  </PackageReference>
+		</PackageReference>
 	</ItemGroup>
 
 	<ItemGroup Condition="'$(TargetFramework)' == 'net8.0'">
-	  <PackageReference Include="AutoMapper" Version="14.0.0" />
+		<PackageReference Include="AutoMapper" Version="14.0.0" />
-	  <PackageReference Include="CommandDotNet">
+		<PackageReference Include="CommandDotNet">
-	    <Version>8.1.1</Version>
+		<Version>8.1.1</Version>
-	  </PackageReference>
+		</PackageReference>
 	</ItemGroup>
 
 	<ItemGroup Condition="'$(TargetFramework)' == 'net9.0'">
-	  <PackageReference Include="AutoMapper" Version="14.0.0" />
+		<PackageReference Include="AutoMapper" Version="14.0.0" />
-	  <PackageReference Include="CommandDotNet">
+		<PackageReference Include="CommandDotNet">
-	    <Version>8.1.1</Version>
+		<Version>8.1.1</Version>
-	  </PackageReference>
+		</PackageReference>
 	</ItemGroup>
 
 </Project>

EnvelopeGenerator.Application/Envelopes/Queries/ReadEnvelopeQuery.cs

@@ -14,6 +14,16 @@ namespace EnvelopeGenerator.Application.Envelopes.Queries;
 /// </summary>
 public record ReadEnvelopeQuery : EnvelopeQueryBase, IRequest<IEnumerable<EnvelopeDto>>
 {
+    /// <summary>
+    /// 
+    /// </summary>
+    public bool OnlyActive { get; init; } = false;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public bool OnlyCompleted { get; init; } = false;
+
     /// <summary>
     /// Abfrage des Include des Umschlags
     /// </summary>
@@ -22,7 +32,7 @@ public record ReadEnvelopeQuery : EnvelopeQueryBase, IRequest<IEnumerable<Envelo
     /// <summary>
     /// Optionaler Benutzerfilter; wenn gesetzt, werden nur Umschläge des Benutzers geladen.
     /// </summary>
-    public int? UserId { get; init; }
+    internal int? UserId { get; init; }
 
     /// <summary>
     /// Setzt den Benutzerkontext für die Abfrage.
@@ -132,8 +142,14 @@ public class ReadEnvelopeQueryHandler : IRequestHandler<ReadEnvelopeQuery, IEnum
                 query = query.Where(e => !status.Ignore.Contains(e.Status));
         }
 
+        if(request is { OnlyActive: true })
+            query = query.Where(e => Status.Active.Contains(e.Status));
+
+        if (request is { OnlyCompleted: true })
+            query = query.Where(e => Status.Completed.Contains(e.Status));
+
         var envelopes = await query
-            .Include(e => e.Documents)
+            .Include(e => e.EnvelopeReceivers).ThenInclude(er => er.Receiver)
             .ToListAsync(cancel);
 
         return _mapper.Map<IEnumerable<EnvelopeDto>>(envelopes);

EnvelopeGenerator.Application/Receivers/Commands/CreateReceiverCommand.cs

@@ -3,7 +3,6 @@ using DigitalData.Core.Abstraction.Application.Repository;
 using EnvelopeGenerator.Application.Common.Dto.Receiver;
 using EnvelopeGenerator.Domain.Entities;
 using MediatR;
-using Microsoft.AspNetCore.Mvc;
 using Microsoft.EntityFrameworkCore;
 using System.ComponentModel.DataAnnotations;
 using System.Security.Cryptography;
@@ -14,7 +13,6 @@ namespace EnvelopeGenerator.Application.Receivers.Commands;
 /// <summary>
 /// 
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public record CreateReceiverCommand : IRequest<(ReceiverDto Receiver, bool AlreadyExists)>
 {
     /// <summary>

EnvelopeGenerator.Application/Receivers/Commands/UpdateReceiverCommand.cs

@@ -1,11 +1,8 @@
-using Microsoft.AspNetCore.Mvc;
+namespace EnvelopeGenerator.Application.Receivers.Commands;
-
-namespace EnvelopeGenerator.Application.Receivers.Commands;
 
 /// <summary>
 /// Data Transfer Object for updating a receiver's information.
 /// </summary>
-[ApiExplorerSettings(IgnoreApi = true)]
 public class UpdateReceiverCommand
 {
     /// <summary>

EnvelopeGenerator.Application/Resources/Resource.cs

@@ -397,4 +397,412 @@ public static class Extensions
     /// <param name="suffix"></param>
     /// <returns></returns>
     public static string LockedFooterBody(this IStringLocalizer localizer, string suffix) => localizer[nameof(LockedFooterBody) + suffix].Value;
+
+    // Sender-side UI resources
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string NewEnvelope(this IStringLocalizer localizer) => localizer[nameof(NewEnvelope)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string LoadEnvelope(this IStringLocalizer localizer) => localizer[nameof(LoadEnvelope)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string DeleteEnvelope(this IStringLocalizer localizer) => localizer[nameof(DeleteEnvelope)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string RefreshData(this IStringLocalizer localizer) => localizer[nameof(RefreshData)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string RefreshedAt(this IStringLocalizer localizer) => localizer[nameof(RefreshedAt)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ShowDocument(this IStringLocalizer localizer) => localizer[nameof(ShowDocument)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ContactReceiver(this IStringLocalizer localizer) => localizer[nameof(ContactReceiver)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string EnvelopeId(this IStringLocalizer localizer) => localizer[nameof(EnvelopeId)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string OpenLogDirectory(this IStringLocalizer localizer) => localizer[nameof(OpenLogDirectory)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ShowResultsReport(this IStringLocalizer localizer) => localizer[nameof(ShowResultsReport)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string SupportMail(this IStringLocalizer localizer) => localizer[nameof(SupportMail)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ResendInvitation(this IStringLocalizer localizer) => localizer[nameof(ResendInvitation)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Export(this IStringLocalizer localizer) => localizer[nameof(Export)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Receivers(this IStringLocalizer localizer) => localizer[nameof(Receivers)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string EmailSalutation(this IStringLocalizer localizer) => localizer[nameof(EmailSalutation)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string SignedWhen(this IStringLocalizer localizer) => localizer[nameof(SignedWhen)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string AccessCode(this IStringLocalizer localizer) => localizer[nameof(AccessCode)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string User(this IStringLocalizer localizer) => localizer[nameof(User)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Type(this IStringLocalizer localizer) => localizer[nameof(Type)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Title(this IStringLocalizer localizer) => localizer[nameof(Title)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string CreatedOn(this IStringLocalizer localizer) => localizer[nameof(CreatedOn)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string LastModified(this IStringLocalizer localizer) => localizer[nameof(LastModified)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string OpenEnvelopes(this IStringLocalizer localizer) => localizer[nameof(OpenEnvelopes)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string CompletedEnvelopes(this IStringLocalizer localizer) => localizer[nameof(CompletedEnvelopes)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string SendAccessCode(this IStringLocalizer localizer) => localizer[nameof(SendAccessCode)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string TwoFactorProperties(this IStringLocalizer localizer) => localizer[nameof(TwoFactorProperties)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Name(this IStringLocalizer localizer) => localizer[nameof(Name)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string PhoneNumber(this IStringLocalizer localizer) => localizer[nameof(PhoneNumber)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string AddReceiver(this IStringLocalizer localizer) => localizer[nameof(AddReceiver)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string DeleteReceiver(this IStringLocalizer localizer) => localizer[nameof(DeleteReceiver)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string AddFile(this IStringLocalizer localizer) => localizer[nameof(AddFile)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string MergeFiles(this IStringLocalizer localizer) => localizer[nameof(MergeFiles)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string DeleteFile(this IStringLocalizer localizer) => localizer[nameof(DeleteFile)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ShowFile(this IStringLocalizer localizer) => localizer[nameof(ShowFile)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string EditFields(this IStringLocalizer localizer) => localizer[nameof(EditFields)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string EditData(this IStringLocalizer localizer) => localizer[nameof(EditData)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Save(this IStringLocalizer localizer) => localizer[nameof(Save)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string SendEnvelope(this IStringLocalizer localizer) => localizer[nameof(SendEnvelope)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Cancel(this IStringLocalizer localizer) => localizer[nameof(Cancel)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string AddSignature(this IStringLocalizer localizer) => localizer[nameof(AddSignature)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string DeleteSignature(this IStringLocalizer localizer) => localizer[nameof(DeleteSignature)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Language(this IStringLocalizer localizer) => localizer[nameof(Language)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string UseAccessCode(this IStringLocalizer localizer) => localizer[nameof(UseAccessCode)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string TwoFactorEnabled(this IStringLocalizer localizer) => localizer[nameof(TwoFactorEnabled)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string CertificationType(this IStringLocalizer localizer) => localizer[nameof(CertificationType)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string FinalEmailToCreator(this IStringLocalizer localizer) => localizer[nameof(FinalEmailToCreator)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string FinalEmailToReceivers(this IStringLocalizer localizer) => localizer[nameof(FinalEmailToReceivers)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string SendReminderEmails(this IStringLocalizer localizer) => localizer[nameof(SendReminderEmails)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string FirstReminderDays(this IStringLocalizer localizer) => localizer[nameof(FirstReminderDays)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ReminderIntervalDays(this IStringLocalizer localizer) => localizer[nameof(ReminderIntervalDays)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ExpiresWhenDays(this IStringLocalizer localizer) => localizer[nameof(ExpiresWhenDays)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string ExpiresWarningDays(this IStringLocalizer localizer) => localizer[nameof(ExpiresWarningDays)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Message(this IStringLocalizer localizer) => localizer[nameof(Message)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string EnvelopeType(this IStringLocalizer localizer) => localizer[nameof(EnvelopeType)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string AllOptions(this IStringLocalizer localizer) => localizer[nameof(AllOptions)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string DeleteReason(this IStringLocalizer localizer) => localizer[nameof(DeleteReason)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string PleaseProvideReason(this IStringLocalizer localizer) => localizer[nameof(PleaseProvideReason)].Value;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="localizer"></param>
+    /// <returns></returns>
+    public static string Status(this IStringLocalizer localizer) => localizer[nameof(Status)].Value;
 }

EnvelopeGenerator.Application/Resources/Resource.de-DE.resx

@@ -477,4 +477,178 @@
   <data name="Confirmations" xml:space="preserve">
     <value>Bestätigungen</value>
   </data>
+  <data name="NewEnvelope" xml:space="preserve">
+    <value>Neuer Umschlag</value>
+  </data>
+  <data name="LoadEnvelope" xml:space="preserve">
+    <value>Umschlag laden</value>
+  </data>
+  <data name="DeleteEnvelope" xml:space="preserve">
+    <value>Umschlag zurückrufen/löschen</value>
+  </data>
+  <data name="RefreshData" xml:space="preserve">
+    <value>Daten Aktualisieren</value>
+  </data>
+  <data name="RefreshedAt" xml:space="preserve">
+    <value>Aktualisiert: {0}</value>
+  </data>
+  <data name="ShowDocument" xml:space="preserve">
+    <value>Dokument anzeigen</value>
+  </data>
+  <data name="ContactReceiver" xml:space="preserve">
+    <value>Empfänger kontaktieren</value>
+  </data>
+  <data name="EnvelopeId" xml:space="preserve">
+    <value>Umschlag-ID: {0}</value>
+  </data>
+  <data name="OpenLogDirectory" xml:space="preserve">
+    <value>Öffne Log Verzeichnis</value>
+  </data>
+  <data name="ShowResultsReport" xml:space="preserve">
+    <value>Ergebnisbericht anzeigen</value>
+  </data>
+  <data name="SupportMail" xml:space="preserve">
+    <value>Support Mail</value>
+  </data>
+  <data name="ResendInvitation" xml:space="preserve">
+    <value>Einladung manuell versenden</value>
+  </data>
+  <data name="Export" xml:space="preserve">
+    <value>Export</value>
+  </data>
+  <data name="Receivers" xml:space="preserve">
+    <value>Empfänger</value>
+  </data>
+  <data name="EmailSalutation" xml:space="preserve">
+    <value>Email Anrede</value>
+  </data>
+  <data name="SignedWhen" xml:space="preserve">
+    <value>Unterschrieben wann</value>
+  </data>
+  <data name="AccessCode" xml:space="preserve">
+    <value>Zugangscode</value>
+  </data>
+  <data name="User" xml:space="preserve">
+    <value>Benutzer</value>
+  </data>
+  <data name="Type" xml:space="preserve">
+    <value>Typ</value>
+  </data>
+  <data name="Title" xml:space="preserve">
+    <value>Titel</value>
+  </data>
+  <data name="CreatedOn" xml:space="preserve">
+    <value>Erstellt am</value>
+  </data>
+  <data name="LastModified" xml:space="preserve">
+    <value>Zuletzt geändert am</value>
+  </data>
+  <data name="OpenEnvelopes" xml:space="preserve">
+    <value>Offene Umschläge</value>
+  </data>
+  <data name="CompletedEnvelopes" xml:space="preserve">
+    <value>Abgeschlossene Umschläge</value>
+  </data>
+  <data name="SendAccessCode" xml:space="preserve">
+    <value>Zugangscode senden</value>
+  </data>
+  <data name="TwoFactorProperties" xml:space="preserve">
+    <value>2-Faktor Eigenschaften</value>
+  </data>
+  <data name="Name" xml:space="preserve">
+    <value>Name</value>
+  </data>
+  <data name="PhoneNumber" xml:space="preserve">
+    <value>Telefonnummer</value>
+  </data>
+  <data name="AddReceiver" xml:space="preserve">
+    <value>Empfänger hinzufügen</value>
+  </data>
+  <data name="DeleteReceiver" xml:space="preserve">
+    <value>Empfänger löschen</value>
+  </data>
+  <data name="AddFile" xml:space="preserve">
+    <value>Datei hinzufügen</value>
+  </data>
+  <data name="MergeFiles" xml:space="preserve">
+    <value>Dateien zusammenführen</value>
+  </data>
+  <data name="DeleteFile" xml:space="preserve">
+    <value>Datei löschen</value>
+  </data>
+  <data name="ShowFile" xml:space="preserve">
+    <value>Datei anzeigen</value>
+  </data>
+  <data name="EditFields" xml:space="preserve">
+    <value>Felder bearbeiten</value>
+  </data>
+  <data name="EditData" xml:space="preserve">
+    <value>Daten bearbeiten</value>
+  </data>
+  <data name="Save" xml:space="preserve">
+    <value>Speichern</value>
+  </data>
+  <data name="SendEnvelope" xml:space="preserve">
+    <value>Umschlag versenden</value>
+  </data>
+  <data name="Cancel" xml:space="preserve">
+    <value>Abbrechen</value>
+  </data>
+  <data name="AddSignature" xml:space="preserve">
+    <value>Signatur hinzufügen</value>
+  </data>
+  <data name="DeleteSignature" xml:space="preserve">
+    <value>Signatur löschen</value>
+  </data>
+  <data name="Language" xml:space="preserve">
+    <value>Sprache</value>
+  </data>
+  <data name="UseAccessCode" xml:space="preserve">
+    <value>Zugangscode verwenden</value>
+  </data>
+  <data name="TwoFactorEnabled" xml:space="preserve">
+    <value>2-Faktor-Authentifizierung aktiviert</value>
+  </data>
+  <data name="CertificationType" xml:space="preserve">
+    <value>Zertifizierungstyp</value>
+  </data>
+  <data name="FinalEmailToCreator" xml:space="preserve">
+    <value>Finale E-Mail an Ersteller</value>
+  </data>
+  <data name="FinalEmailToReceivers" xml:space="preserve">
+    <value>Finale E-Mail an Empfänger</value>
+  </data>
+  <data name="SendReminderEmails" xml:space="preserve">
+    <value>Erinnerungs-E-Mails senden</value>
+  </data>
+  <data name="FirstReminderDays" xml:space="preserve">
+    <value>Erste Erinnerung (Tage)</value>
+  </data>
+  <data name="ReminderIntervalDays" xml:space="preserve">
+    <value>Erinnerungsintervall (Tage)</value>
+  </data>
+  <data name="ExpiresWhenDays" xml:space="preserve">
+    <value>Läuft ab nach (Tage)</value>
+  </data>
+  <data name="ExpiresWarningDays" xml:space="preserve">
+    <value>Ablaufwarnung (Tage)</value>
+  </data>
+  <data name="Message" xml:space="preserve">
+    <value>Nachricht</value>
+  </data>
+  <data name="EnvelopeType" xml:space="preserve">
+    <value>Umschlagtyp</value>
+  </data>
+  <data name="AllOptions" xml:space="preserve">
+    <value>Alle Optionen</value>
+  </data>
+  <data name="DeleteReason" xml:space="preserve">
+    <value>Grund für Löschung</value>
+  </data>
+  <data name="PleaseProvideReason" xml:space="preserve">
+    <value>Bitte geben Sie einen Grund an</value>
+  </data>
+  <data name="Status" xml:space="preserve">
+    <value>Status</value>
+  </data>
 </root>

EnvelopeGenerator.Application/Resources/Resource.en-US.resx

@@ -477,4 +477,178 @@
   <data name="Confirmations" xml:space="preserve">
     <value>Confirmations</value>
   </data>
+  <data name="NewEnvelope" xml:space="preserve">
+    <value>New Envelope</value>
+  </data>
+  <data name="LoadEnvelope" xml:space="preserve">
+    <value>Load Envelope</value>
+  </data>
+  <data name="DeleteEnvelope" xml:space="preserve">
+    <value>Delete Envelope</value>
+  </data>
+  <data name="RefreshData" xml:space="preserve">
+    <value>Reload Data</value>
+  </data>
+  <data name="RefreshedAt" xml:space="preserve">
+    <value>Refreshed: {0}</value>
+  </data>
+  <data name="ShowDocument" xml:space="preserve">
+    <value>Show Document</value>
+  </data>
+  <data name="ContactReceiver" xml:space="preserve">
+    <value>Contact Receiver</value>
+  </data>
+  <data name="EnvelopeId" xml:space="preserve">
+    <value>Envelope-ID: {0}</value>
+  </data>
+  <data name="OpenLogDirectory" xml:space="preserve">
+    <value>Open Log Directory</value>
+  </data>
+  <data name="ShowResultsReport" xml:space="preserve">
+    <value>Show Results Report</value>
+  </data>
+  <data name="SupportMail" xml:space="preserve">
+    <value>Support Mail</value>
+  </data>
+  <data name="ResendInvitation" xml:space="preserve">
+    <value>Send Invitation Again</value>
+  </data>
+  <data name="Export" xml:space="preserve">
+    <value>Export</value>
+  </data>
+  <data name="Receivers" xml:space="preserve">
+    <value>Receivers</value>
+  </data>
+  <data name="EmailSalutation" xml:space="preserve">
+    <value>Email Salutation</value>
+  </data>
+  <data name="SignedWhen" xml:space="preserve">
+    <value>Signed When</value>
+  </data>
+  <data name="AccessCode" xml:space="preserve">
+    <value>Access Code</value>
+  </data>
+  <data name="User" xml:space="preserve">
+    <value>User</value>
+  </data>
+  <data name="Type" xml:space="preserve">
+    <value>Type</value>
+  </data>
+  <data name="Title" xml:space="preserve">
+    <value>Title</value>
+  </data>
+  <data name="CreatedOn" xml:space="preserve">
+    <value>Created On</value>
+  </data>
+  <data name="LastModified" xml:space="preserve">
+    <value>Last Modified</value>
+  </data>
+  <data name="OpenEnvelopes" xml:space="preserve">
+    <value>Open Envelopes</value>
+  </data>
+  <data name="CompletedEnvelopes" xml:space="preserve">
+    <value>Completed Envelopes</value>
+  </data>
+  <data name="SendAccessCode" xml:space="preserve">
+    <value>Send Access Code</value>
+  </data>
+  <data name="TwoFactorProperties" xml:space="preserve">
+    <value>2-Factor Properties</value>
+  </data>
+  <data name="Name" xml:space="preserve">
+    <value>Name</value>
+  </data>
+  <data name="PhoneNumber" xml:space="preserve">
+    <value>Phone Number</value>
+  </data>
+  <data name="AddReceiver" xml:space="preserve">
+    <value>Add Receiver</value>
+  </data>
+  <data name="DeleteReceiver" xml:space="preserve">
+    <value>Delete Receiver</value>
+  </data>
+  <data name="AddFile" xml:space="preserve">
+    <value>Add File</value>
+  </data>
+  <data name="MergeFiles" xml:space="preserve">
+    <value>Merge Files</value>
+  </data>
+  <data name="DeleteFile" xml:space="preserve">
+    <value>Delete File</value>
+  </data>
+  <data name="ShowFile" xml:space="preserve">
+    <value>Show File</value>
+  </data>
+  <data name="EditFields" xml:space="preserve">
+    <value>Edit Fields</value>
+  </data>
+  <data name="EditData" xml:space="preserve">
+    <value>Edit Data</value>
+  </data>
+  <data name="Save" xml:space="preserve">
+    <value>Save</value>
+  </data>
+  <data name="SendEnvelope" xml:space="preserve">
+    <value>Send Envelope</value>
+  </data>
+  <data name="Cancel" xml:space="preserve">
+    <value>Cancel</value>
+  </data>
+  <data name="AddSignature" xml:space="preserve">
+    <value>Add Signature</value>
+  </data>
+  <data name="DeleteSignature" xml:space="preserve">
+    <value>Delete Signature</value>
+  </data>
+  <data name="Language" xml:space="preserve">
+    <value>Language</value>
+  </data>
+  <data name="UseAccessCode" xml:space="preserve">
+    <value>Use Access Code</value>
+  </data>
+  <data name="TwoFactorEnabled" xml:space="preserve">
+    <value>2-Factor Authentication Enabled</value>
+  </data>
+  <data name="CertificationType" xml:space="preserve">
+    <value>Certification Type</value>
+  </data>
+  <data name="FinalEmailToCreator" xml:space="preserve">
+    <value>Final Email to Creator</value>
+  </data>
+  <data name="FinalEmailToReceivers" xml:space="preserve">
+    <value>Final Email to Receivers</value>
+  </data>
+  <data name="SendReminderEmails" xml:space="preserve">
+    <value>Send Reminder Emails</value>
+  </data>
+  <data name="FirstReminderDays" xml:space="preserve">
+    <value>First Reminder (Days)</value>
+  </data>
+  <data name="ReminderIntervalDays" xml:space="preserve">
+    <value>Reminder Interval (Days)</value>
+  </data>
+  <data name="ExpiresWhenDays" xml:space="preserve">
+    <value>Expires After (Days)</value>
+  </data>
+  <data name="ExpiresWarningDays" xml:space="preserve">
+    <value>Expiry Warning (Days)</value>
+  </data>
+  <data name="Message" xml:space="preserve">
+    <value>Message</value>
+  </data>
+  <data name="EnvelopeType" xml:space="preserve">
+    <value>Envelope Type</value>
+  </data>
+  <data name="AllOptions" xml:space="preserve">
+    <value>All Options</value>
+  </data>
+  <data name="DeleteReason" xml:space="preserve">
+    <value>Deletion Reason</value>
+  </data>
+  <data name="PleaseProvideReason" xml:space="preserve">
+    <value>Please provide a reason</value>
+  </data>
+  <data name="Status" xml:space="preserve">
+    <value>Status</value>
+  </data>
 </root>

EnvelopeGenerator.Application/Resources/Resource.fr-FR.resx

@@ -477,4 +477,178 @@
   <data name="Confirmations" xml:space="preserve">
     <value>Confirmations</value>
   </data>
+  <data name="NewEnvelope" xml:space="preserve">
+    <value>Nouvelle enveloppe</value>
+  </data>
+  <data name="LoadEnvelope" xml:space="preserve">
+    <value>Charger l'enveloppe</value>
+  </data>
+  <data name="DeleteEnvelope" xml:space="preserve">
+    <value>Supprimer l'enveloppe</value>
+  </data>
+  <data name="RefreshData" xml:space="preserve">
+    <value>Actualiser les données</value>
+  </data>
+  <data name="RefreshedAt" xml:space="preserve">
+    <value>Actualisé : {0}</value>
+  </data>
+  <data name="ShowDocument" xml:space="preserve">
+    <value>Afficher le document</value>
+  </data>
+  <data name="ContactReceiver" xml:space="preserve">
+    <value>Contacter le destinataire</value>
+  </data>
+  <data name="EnvelopeId" xml:space="preserve">
+    <value>ID d'enveloppe : {0}</value>
+  </data>
+  <data name="OpenLogDirectory" xml:space="preserve">
+    <value>Ouvrir le répertoire des logs</value>
+  </data>
+  <data name="ShowResultsReport" xml:space="preserve">
+    <value>Afficher le rapport de résultats</value>
+  </data>
+  <data name="SupportMail" xml:space="preserve">
+    <value>E-mail de support</value>
+  </data>
+  <data name="ResendInvitation" xml:space="preserve">
+    <value>Renvoyer l'invitation</value>
+  </data>
+  <data name="Export" xml:space="preserve">
+    <value>Exporter</value>
+  </data>
+  <data name="Receivers" xml:space="preserve">
+    <value>Destinataires</value>
+  </data>
+  <data name="EmailSalutation" xml:space="preserve">
+    <value>Formule de politesse</value>
+  </data>
+  <data name="SignedWhen" xml:space="preserve">
+    <value>Signé quand</value>
+  </data>
+  <data name="AccessCode" xml:space="preserve">
+    <value>Code d'accès</value>
+  </data>
+  <data name="User" xml:space="preserve">
+    <value>Utilisateur</value>
+  </data>
+  <data name="Type" xml:space="preserve">
+    <value>Type</value>
+  </data>
+  <data name="Title" xml:space="preserve">
+    <value>Titre</value>
+  </data>
+  <data name="CreatedOn" xml:space="preserve">
+    <value>Créé le</value>
+  </data>
+  <data name="LastModified" xml:space="preserve">
+    <value>Dernière modification</value>
+  </data>
+  <data name="OpenEnvelopes" xml:space="preserve">
+    <value>Enveloppes ouvertes</value>
+  </data>
+  <data name="CompletedEnvelopes" xml:space="preserve">
+    <value>Enveloppes terminées</value>
+  </data>
+  <data name="SendAccessCode" xml:space="preserve">
+    <value>Envoyer le code d'accès</value>
+  </data>
+  <data name="TwoFactorProperties" xml:space="preserve">
+    <value>Propriétés 2-facteurs</value>
+  </data>
+  <data name="Name" xml:space="preserve">
+    <value>Nom</value>
+  </data>
+  <data name="PhoneNumber" xml:space="preserve">
+    <value>Numéro de téléphone</value>
+  </data>
+  <data name="AddReceiver" xml:space="preserve">
+    <value>Ajouter un destinataire</value>
+  </data>
+  <data name="DeleteReceiver" xml:space="preserve">
+    <value>Supprimer le destinataire</value>
+  </data>
+  <data name="AddFile" xml:space="preserve">
+    <value>Ajouter un fichier</value>
+  </data>
+  <data name="MergeFiles" xml:space="preserve">
+    <value>Fusionner les fichiers</value>
+  </data>
+  <data name="DeleteFile" xml:space="preserve">
+    <value>Supprimer le fichier</value>
+  </data>
+  <data name="ShowFile" xml:space="preserve">
+    <value>Afficher le fichier</value>
+  </data>
+  <data name="EditFields" xml:space="preserve">
+    <value>Modifier les champs</value>
+  </data>
+  <data name="EditData" xml:space="preserve">
+    <value>Modifier les données</value>
+  </data>
+  <data name="Save" xml:space="preserve">
+    <value>Enregistrer</value>
+  </data>
+  <data name="SendEnvelope" xml:space="preserve">
+    <value>Envoyer l'enveloppe</value>
+  </data>
+  <data name="Cancel" xml:space="preserve">
+    <value>Annuler</value>
+  </data>
+  <data name="AddSignature" xml:space="preserve">
+    <value>Ajouter une signature</value>
+  </data>
+  <data name="DeleteSignature" xml:space="preserve">
+    <value>Supprimer la signature</value>
+  </data>
+  <data name="Language" xml:space="preserve">
+    <value>Langue</value>
+  </data>
+  <data name="UseAccessCode" xml:space="preserve">
+    <value>Utiliser un code d'accès</value>
+  </data>
+  <data name="TwoFactorEnabled" xml:space="preserve">
+    <value>Authentification à 2 facteurs activée</value>
+  </data>
+  <data name="CertificationType" xml:space="preserve">
+    <value>Type de certification</value>
+  </data>
+  <data name="FinalEmailToCreator" xml:space="preserve">
+    <value>E-mail final au créateur</value>
+  </data>
+  <data name="FinalEmailToReceivers" xml:space="preserve">
+    <value>E-mail final aux destinataires</value>
+  </data>
+  <data name="SendReminderEmails" xml:space="preserve">
+    <value>Envoyer des e-mails de rappel</value>
+  </data>
+  <data name="FirstReminderDays" xml:space="preserve">
+    <value>Premier rappel (jours)</value>
+  </data>
+  <data name="ReminderIntervalDays" xml:space="preserve">
+    <value>Intervalle de rappel (jours)</value>
+  </data>
+  <data name="ExpiresWhenDays" xml:space="preserve">
+    <value>Expire après (jours)</value>
+  </data>
+  <data name="ExpiresWarningDays" xml:space="preserve">
+    <value>Avertissement d'expiration (jours)</value>
+  </data>
+  <data name="Message" xml:space="preserve">
+    <value>Message</value>
+  </data>
+  <data name="EnvelopeType" xml:space="preserve">
+    <value>Type d'enveloppe</value>
+  </data>
+  <data name="AllOptions" xml:space="preserve">
+    <value>Toutes les options</value>
+  </data>
+  <data name="DeleteReason" xml:space="preserve">
+    <value>Motif de suppression</value>
+  </data>
+  <data name="PleaseProvideReason" xml:space="preserve">
+    <value>Veuillez indiquer une raison</value>
+  </data>
+  <data name="Status" xml:space="preserve">
+    <value>Statut</value>
+  </data>
 </root>

EnvelopeGenerator.Domain/Constants/EnvelopeStatus.cs

@@ -1,8 +1,10 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
+using System.Linq;
 
 namespace EnvelopeGenerator.Domain.Constants
 {
-    // http://wiki.dd/xwiki13/bin/view/Anwendungen/Produkt-Handbuch/Sonstiges/SignFlow/Envelope%20Status/
+    // http://wiki.dd/xwiki_prod/bin/view/Anwendungen/Produkt-Handbuch/Sonstiges/signFLOW/signFLOW%20-%20Enwickler-Handbuch/4.%20Anhang/4.3%20Historie%20und%20Status%20der%20Umschl%C3%A4ge/
     public enum EnvelopeStatus
     {
         Invalid = 0,
@@ -49,5 +51,28 @@ namespace EnvelopeGenerator.Domain.Constants
                 EnvelopeStatus.EnvelopeCreated,
                 EnvelopeStatus.DocumentMod_Rotation
             };
+
+        public static readonly List<EnvelopeStatus> Active = Enum.GetValues(typeof(EnvelopeStatus))
+            .Cast<EnvelopeStatus>()
+            .Where(status => status.IsActive())
+            .ToList();
+
+        public static readonly List<EnvelopeStatus> Completed = Enum.GetValues(typeof(EnvelopeStatus))
+            .Cast<EnvelopeStatus>()
+            .Where(status => status.IsCompleted())
+            .ToList();
+    }
+
+    public static class EnvelopeStatusExtensions
+    {
+        public static bool IsActive(this EnvelopeStatus status)
+        {
+            return status >= EnvelopeStatus.EnvelopeCreated && status < EnvelopeStatus.EnvelopePartlySigned;
+        }
+
+        public static bool IsCompleted(this EnvelopeStatus status)
+        {
+            return status >= EnvelopeStatus.EnvelopeCompletelySigned && status <= EnvelopeStatus.EnvelopeWithdrawn;
+        }
     }
 }

EnvelopeGenerator.Domain/Entities/Envelope.cs

@@ -94,7 +94,7 @@ namespace EnvelopeGenerator.Domain.Entities
         public string Language { get; set; }
 
         [Column("SEND_REMINDER_EMAILS")]
-        public bool SendReminderEmails { get; set; }
+        public bool? SendReminderEmails { get; set; }
 
         [Column("FIRST_REMINDER_DAYS")]
         public int? FirstReminderDays { get; set; }
@@ -114,7 +114,7 @@ namespace EnvelopeGenerator.Domain.Entities
         public int? CertificationType { get; set; }
 
         [Column("USE_ACCESS_CODE")]
-        public bool UseAccessCode { get; set; }
+        public bool? UseAccessCode { get; set; }
 
         [Column("FINAL_EMAIL_TO_CREATOR")]
         public int? FinalEmailToCreator { get; set; }
@@ -132,7 +132,7 @@ namespace EnvelopeGenerator.Domain.Entities
         public User User { get; set; }
 
         [Column("TFA_ENABLED")]
-        public bool TfaEnabled { get; set; }
+        public bool? TfaEnabled { get; set; }
 #if NETFRAMEWORK
             = false;
 #endif

EnvelopeGenerator.Infrastructure/EGDbContextFactory.cs

@@ -1,48 +0,0 @@
-#if NET
-using EnvelopeGenerator.Application.Common.Configurations;
-using Microsoft.EntityFrameworkCore;
-using Microsoft.EntityFrameworkCore.Design;
-using Microsoft.Extensions.Configuration;
-using Microsoft.Extensions.Options;
-
-namespace EnvelopeGenerator.Infrastructure
-{
-    public class EGDbContextFactory : IDesignTimeDbContextFactory<EGDbContext>
-    {
-        public EGDbContext CreateDbContext(string[] args)
-        {
-            var config = new ConfigurationBuilder()
-                .SetBasePath(Directory.GetCurrentDirectory())
-                .AddJsonFile("appsettings.migration.json")
-                .Build();
-
-            // create DbContextOptions
-            var optionsBuilder = new DbContextOptionsBuilder<EGDbContext>();
-            optionsBuilder.UseSqlServer(config.GetConnectionString("Default"));
-
-            // create DbTriggerParams
-            var triggerLists = config.GetSection("DbTriggerParams").Get<Dictionary<string, List<string>>>();
-            var dbTriggerParams = new DbTriggerParams();
-            if (triggerLists is not null)
-                foreach (var triggerList in triggerLists)
-                {
-                    if (triggerList.Value.Count == 0)
-                        continue; // Skip empty trigger lists
-
-                    var tableName = triggerList.Key;
-
-                    dbTriggerParams[tableName] = new List<string>();
-
-                    foreach (var trigger in triggerList.Value)
-                    {
-                        dbTriggerParams[tableName].Add(trigger);
-                    }
-                }
-
-            var dbContext = new EGDbContext(optionsBuilder.Options, Options.Create(dbTriggerParams));
-            dbContext.IsMigration = true;
-            return dbContext;
-        }
-    }
-}
-#endif

EnvelopeGenerator.ReceiverUI/App.razor

@@ -1,4 +1,6 @@
-<Router AppAssembly="@typeof(Program).Assembly">
+@using System.Globalization
+
+<Router AppAssembly="@typeof(Program).Assembly">
     <Found Context="routeData">
         <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
     </Found>
@@ -7,4 +9,4 @@
             <p>Sorry, there's nothing at this address.</p>
         </LayoutView>
     </NotFound>
-</Router>
+</Router>

EnvelopeGenerator.ReceiverUI/EnvelopeGenerator.ReceiverUI.csproj

@@ -14,21 +14,23 @@
 	<PackageIcon>Assets\icon.ico</PackageIcon>
 	<PackageTags>digital data envelope generator web</PackageTags>
 	<Description>EnvelopeGenerator.ReceiverUI is a Blazor WebAssembly application developed to manage signing processes. It uses Entity Framework Core (EF Core) for database operations. The user interface for signing processes is developed with Razor View Engine (.cshtml files) and JavaScript under wwwroot, integrated with PSPDFKit. This integration allows users to view and sign documents seamlessly.</Description>
-	<Version>1.4.1</Version>
+	<Version>1.4.2</Version>
 	<!-- NuGet package version -->
-	<AssemblyVersion>1.4.1.0</AssemblyVersion>
+	<AssemblyVersion>1.4.2.0</AssemblyVersion>
 	<!-- Assembly version for API compatibility -->
-	<FileVersion>1.4.1.0</FileVersion>
+	<FileVersion>1.4.2.0</FileVersion>
 	<!-- Windows file version -->
 	<Copyright>Copyright © 2026 Digital Data GmbH. All rights reserved.</Copyright>
 	  
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="DevExpress.Blazor.PdfViewer" Version="25.2.3" />
+    <PackageReference Include="DevExpress.Blazor.PdfViewer" Version="25.2.8" />
-    <PackageReference Include="DevExpress.Blazor.Reporting.JSBasedControls" Version="25.2.3" />
+    <PackageReference Include="DevExpress.Blazor.Reporting.JSBasedControls" Version="25.2.8" />
-    <PackageReference Include="DevExpress.Blazor.Reporting.Viewer" Version="25.2.3" />
+    <PackageReference Include="DevExpress.Blazor.Reporting.Viewer" Version="25.2.8" />
-    <PackageReference Include="DevExpress.Drawing.Skia" Version="25.2.3" />
+    <PackageReference Include="DevExpress.Drawing.Skia" Version="25.2.8" />
     <PackageReference Include="HarfBuzzSharp.NativeAssets.WebAssembly" Version="8.3.1.2" />
+    <PackageReference Include="Microsoft.AspNetCore.WebUtilities" Version="8.0.28" />
+    <PackageReference Include="Microsoft.Extensions.Localization" Version="8.0.11" />
     <PackageReference Include="SkiaSharp.NativeAssets.WebAssembly" Version="3.119.1" />
     <PackageReference Include="SkiaSharp.Views.Blazor" Version="3.119.1" />
     <NativeFileReference Include="$(HarfBuzzSharpStaticLibraryPath)\2.0.23\*.a" />
@@ -40,6 +42,9 @@
   <ItemGroup>
     <Folder Include="Properties\PublishProfiles\" />
   </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\EnvelopeGenerator.Application\EnvelopeGenerator.Application.csproj" />
+  </ItemGroup>
   <ItemGroup>
     <Content Update="wwwroot\docs\privacy-policy.en-US.html">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>

EnvelopeGenerator.ReceiverUI/Models/AnnotationDto.cs

@@ -1,32 +0,0 @@
-namespace EnvelopeGenerator.ReceiverUI.Models;
-
-/// <summary>
-/// Represents a pre-assigned signature annotation position on a specific page.
-/// <br/><br/>
-/// <b>Coordinate unit (X, Y):</b> Inches (GdPicture14 native unit),
-/// origin at the <b>top-left</b> corner of the page, both axes increase downward/rightward.
-/// <br/><br/>
-/// <b>Conversion to DevExpress:</b> Multiply by 100 (DX uses 1/100 inch).
-/// Convert: <c>xDX = xInches * 100.0</c>
-/// <br/>
-/// <b>Conversion to PDF Points:</b> Multiply by 72 (1 inch = 72 points).
-/// Convert: <c>xPt = xInches * 72.0</c>
-/// <br/>
-/// <b>Y-axis for PDF (bottom-left origin):</b> Flip required for iText7.
-/// Convert: <c>yPt = (pageHeightInches - yInches - elemHeightInches) * 72.0</c>
-/// </summary>
-[Obsolete("Use SignatureDto with SignatureService.")]
-public record AnnotationDto
-{
-    /// <summary>Unique identifier of the annotation.</summary>
-    public long Id { get; init; }
-
-    /// <summary>1-based page number within the document.</summary>
-    public int Page { get; init; }
-
-    /// <summary>Horizontal position in INCHES from the left edge of the page.</summary>
-    public double X { get; init; }
-
-    /// <summary>Vertical position in INCHES from the top edge of the page.</summary>
-    public double Y { get; init; }
-}

EnvelopeGenerator.ReceiverUI/Models/EnvelopeDto.cs

@@ -0,0 +1,39 @@
+using System.Text.Json.Serialization;
+
+namespace EnvelopeGenerator.ReceiverUI.Models;
+
+public class EnvelopeDto
+{
+    [JsonPropertyName("id")]
+    public int Id { get; set; }
+
+    [JsonPropertyName("uuid")]
+    public string? Uuid { get; set; }
+
+    [JsonPropertyName("title")]
+    public string? Title { get; set; }
+
+    [JsonPropertyName("status")]
+    public int Status { get; set; }
+
+    [JsonPropertyName("docResult")]
+    public byte[]? DocResult { get; set; }
+
+    [JsonPropertyName("envelopeReceivers")]
+    public List<EnvelopeReceiverSimpleDto> EnvelopeReceivers { get; set; } = new();
+}
+
+/// <summary>
+/// Simplified receiver model for envelope list display
+/// </summary>
+public class EnvelopeReceiverSimpleDto
+{
+    [JsonPropertyName("name")]
+    public string? Name { get; set; }
+
+    [JsonPropertyName("email")]
+    public string? Email { get; set; }
+
+    [JsonPropertyName("signed")]
+    public bool Signed { get; set; }
+}

EnvelopeGenerator.ReceiverUI/Options/ApiOptions.cs

@@ -6,5 +6,5 @@ public class ApiOptions
 
     public string BaseUrl { get; set; } = string.Empty;
 
-    public bool ForceToUseFakeDocument { get; set; } = false;
+    public bool UsePredefinedReports { get; set; } = false;
 }

EnvelopeGenerator.ReceiverUI/Pages/EnvelopeReceiverPage.razor

@@ -11,12 +11,12 @@
 @inject IOptions<ApiOptions> AppOptions
 @inject IOptions<PdfViewerOptions> PdfViewerOptions
 @inject IJSRuntime JSRuntime
-@inject SignatureService SignatureService
+@inject DocReceiverElementService SignatureService
 @inject SignatureCacheService SignatureCacheService
 @inject EnvelopeGenerator.ReceiverUI.Services.AuthService AuthService
 @inject EnvelopeGenerator.ReceiverUI.Services.EnvelopeReceiverService EnvelopeReceiverService
 @inject AppVersionService AppVersion
-@inject ILogger<EnvelopeViewer> logger
+@inject ILogger<EnvelopeReceiverPage> logger
 @implements IAsyncDisposable
 
 <link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
@@ -511,7 +511,7 @@ int _totalPages = 0;
 int _currentZoom = 150;
 bool _showThumbnails = true;
 bool _isLoggingOut = false;
-DotNetObjectReference<EnvelopeViewer>? _dotNetRef;
+DotNetObjectReference<EnvelopeReceiverPage>? _dotNetRef;
 IReadOnlyList<SignatureDto> _signatures = [];
 EnvelopeReceiverDto? _envelopeReceiver;
 
@@ -545,7 +545,7 @@ const int MaxThumbnailWidth = 400;
         _isLoggingOut = true;
         await InvokeAsync(StateHasChanged);
         await AuthService.LogoutEnvelopeReceiverAsync(EnvelopeKey);
-        Navigation.NavigateTo($"/login/{Uri.EscapeDataString(EnvelopeKey)}", forceLoad: true);
+        Navigation.NavigateTo($"/envelope/login/{Uri.EscapeDataString(EnvelopeKey)}", forceLoad: true);
     }
 
     protected override async Task OnInitializedAsync() {
@@ -558,24 +558,28 @@ const int MaxThumbnailWidth = 400;
         // Check authentication
         var hasAccess = await AuthService.CheckEnvelopeAccessAsync(EnvelopeKey);
         if (!hasAccess) {
-            Navigation.NavigateTo($"/login/{Uri.EscapeDataString(EnvelopeKey)}");
+            Navigation.NavigateTo($"/envelope/login/{Uri.EscapeDataString(EnvelopeKey)}");
             return;
         }
 
         try {
-            var (pdfBytes, statusCode) = await DocumentService.GetDocumentAsync(EnvelopeKey);
+            var pdfBytes = await DocumentService.GetDocumentAsync(EnvelopeKey);
 
             if (pdfBytes is { Length: > 0 }) {
                 var base64 = Convert.ToBase64String(pdfBytes);
                 _pdfDataUrl = $"data:application/pdf;base64,{base64}";
             } else {
-                _errorMessage = $"Dokument konnte nicht geladen werden. HTTP Status: {statusCode}";
+                _errorMessage = "Dokument konnte nicht geladen werden: Keine Daten empfangen.";
             }
 
             var signatures = await SignatureService.GetAsync(EnvelopeKey);
             _signatures = signatures.Convert(UnitOfLength.Point);
 
             _envelopeReceiver = await EnvelopeReceiverService.GetAsync(EnvelopeKey);
+            if (_envelopeReceiver is null)
+            {
+                logger.LogWarning("Envelope receiver data is null for envelope {EnvelopeKey}", EnvelopeKey);
+            }
 
             await JSRuntime.InvokeVoidAsync("console.log", "Loaded signatures:", _signatures);
 
@@ -608,8 +612,12 @@ const int MaxThumbnailWidth = 400;
                 _popupValidationMessage = null;
             }
 
+        } catch (HttpRequestException ex) {
+            _errorMessage = $"Dokument konnte nicht geladen werden: {ex.Message}";
+            logger.LogError(ex, "Failed to load document for envelope {EnvelopeKey}", EnvelopeKey);
         } catch (Exception ex) {
             _errorMessage = $"Fehler: {ex.Message}";
+            logger.LogError(ex, "Unexpected error during initialization for envelope {EnvelopeKey}", EnvelopeKey);
         }
 
         _isLoading = false;

EnvelopeGenerator.ReceiverUI/Pages/EnvelopeReceiverPage_DxPdfViewer.razor

@@ -0,0 +1,112 @@
+@page "/envelope/DxPdfViewer"
+@using System.IO
+@using DevExpress.Blazor
+@using System.Reflection
+
+<link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
+
+<style>
+    .custom-drop-zone {
+        padding: 0 !important;
+        border-style: dashed;
+        border-width: 2px !important;
+        height: 230px;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        background-color: rgba(183, 183, 183, 0.1);
+    }
+
+        .custom-drop-zone.custom-drop-zone-hover {
+            border-style: solid;
+        }
+
+        .custom-drop-zone svg {
+            width: 42px;
+            height: 42px;
+        }
+
+        .custom-drop-zone > *:not(#overviewDemoSelectButton) {
+            pointer-events: none;
+        }
+
+    .pdf-viewer {
+        height: 800px !important;
+        min-height: 800px !important;
+    }
+
+    .pdf-viewer .dxbrv-surface-wrapper,
+    .pdf-viewer .dxbrv-document-surface {
+        height: 100% !important;
+        min-height: 750px !important;
+    }
+
+    .pdf-viewer .dxbrv-report-preview-content {
+        width: auto !important;
+        height: auto !important;
+        min-width: 200px !important;
+        min-height: 200px !important;
+    }
+</style>
+
+<div id="overviewDemoDropZone" class="card custom-drop-zone rounded-3 w-100 m-0">
+    <span class="drop-file-icon mb-3"></span>
+    <span class="drop-file-label">Drag and Drop File Here</span><span class="m-1">or</span>
+    <DxButton Id="overviewDemoSelectButton"
+              CssClass="m-1"
+              RenderStyle="ButtonRenderStyle.Primary"
+              Text="Select File" />
+</div>
+<DxFileInput @ref="fileInput"
+             AcceptedFileTypes="@ALLOWED_FILE_TYPES"
+             AllowedFileExtensions="@ALLOWED_FILE_TYPES"
+             CssClass="w-100"
+             ExternalDropZoneCssSelector="#overviewDemoDropZone"
+             ExternalDropZoneDragOverCssClass="custom-drop-zone-hover"
+             ExternalSelectButtonCssSelector="#overviewDemoSelectButton"
+             FilesUploading="OnFilesUploading"
+             MaxFileSize="2000000">
+</DxFileInput>
+
+@if (DocumentContent != null && DocumentContent.Length > 0)
+{
+    <div class="alert alert-success mt-3">
+        PDF loaded: @DocumentContent.Length bytes
+    </div>
+    <DxPdfViewer CssClass="w-100 pdf-viewer" DocumentContent="@DocumentContent" />
+}
+else
+{
+    <div class="alert alert-info mt-3">
+        Please upload a PDF file to view it.
+    </div>
+}
+
+@code {
+    readonly List<string> ALLOWED_FILE_TYPES = new List<string> { ".pdf" };
+    DxFileInput fileInput;
+    byte[] DocumentContent { get; set; }
+    protected override void OnInitialized()
+    {
+        Assembly assembly = Assembly.GetExecutingAssembly();
+        Stream stream = assembly.GetManifestResourceStream("EnvelopeGenerator.ReceiverUI.Resources.Invoice.pdf");
+        if (stream != null)
+        {
+            using (stream)
+            using (var binaryReader = new BinaryReader(stream))
+                DocumentContent = binaryReader.ReadBytes((int)stream.Length);
+        }
+    }
+    protected async Task OnFilesUploading(FilesUploadingEventArgs args)
+    {
+        using (MemoryStream stream = new MemoryStream())
+        {
+            IFileInputSelectedFile file = args.Files[0];
+            await file.OpenReadStream(file.Size).CopyToAsync(stream);
+            DocumentContent = stream.ToArray();
+            await InvokeAsync(StateHasChanged);
+        }
+    }
+}
+

EnvelopeGenerator.ReceiverUI/Pages/EnvelopeReceiverPage_DxReportViewer.razor

@@ -0,0 +1,49 @@
+@page "/envelope/{EnvelopeKey}/DxReportViewer"
+@using XtraReport = DevExpress.XtraReports.UI.XtraReport
+@using DevExpress.Blazor.Reporting
+@using Microsoft.Extensions.Options
+@using EnvelopeGenerator.ReceiverUI.Options
+@using EnvelopeGenerator.ReceiverUI.Services
+@inject InMemoryReportStorageWebExtension ReportStorage
+@inject DocumentService DocumentService
+@inject IOptions<ApiOptions> AppOptions
+
+<link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
+<link href="_content/DevExpress.Blazor.Reporting.Viewer/css/dx-blazor-reporting-components.bs5.css" rel="stylesheet" />
+
+
+@if (_report is not null) {
+    <DxReportViewer Report="_report" RootCssClasses="w-100 h-100" Zoom="1.3" />
+}
+
+@code {
+    [Parameter] public string EnvelopeKey { get; init; } = null!;
+
+    XtraReport? _report = null;
+
+    protected override async Task OnInitializedAsync() 
+    {
+        _report = await CreateReport();
+    }
+
+    async Task<XtraReport> CreateReport()
+    {
+        if (AppOptions.Value.UsePredefinedReports)
+        {
+            return PredefinedReports.ReportsFactory.GetReport("LargeDatasetReport");
+        }
+        else
+        {
+
+            var pdfBytes = await DocumentService.GetDocumentAsync(EnvelopeKey);
+            if (pdfBytes is null || pdfBytes.Length == 0)
+                throw new InvalidOperationException($"No PDF bytes found for EnvelopeKey: {EnvelopeKey}");
+
+            var report = new XtraReport();
+            var detail = new DevExpress.XtraReports.UI.DetailBand();
+            report.Bands.Add(detail);
+            detail.Controls.Add(new DevExpress.XtraReports.UI.XRPdfContent { Source = pdfBytes, GenerateOwnPages = true });
+            return report;
+        }
+    }
+}

EnvelopeGenerator.ReceiverUI/Pages/EnvelopeReceiverPage_embed.razor

@@ -0,0 +1,123 @@
+@page "/envelope/Embed"
+@using System.IO
+@using DevExpress.Blazor
+@using System.Reflection
+
+<link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
+
+<style>
+    .custom-drop-zone {
+        padding: 0 !important;
+        border-style: dashed;
+        border-width: 2px !important;
+        height: 230px;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        background-color: rgba(183, 183, 183, 0.1);
+    }
+
+        .custom-drop-zone.custom-drop-zone-hover {
+            border-style: solid;
+        }
+
+        .custom-drop-zone svg {
+            width: 42px;
+            height: 42px;
+        }
+
+        .custom-drop-zone > *:not(#overviewDemoSelectButton) {
+            pointer-events: none;
+        }
+
+    .pdf-viewer {
+        height: 800px !important;
+        min-height: 800px !important;
+    }
+
+    .pdf-viewer .dxbrv-surface-wrapper,
+    .pdf-viewer .dxbrv-document-surface {
+        height: 100% !important;
+        min-height: 750px !important;
+    }
+
+    .pdf-viewer .dxbrv-report-preview-content {
+        width: auto !important;
+        height: auto !important;
+        min-width: 200px !important;
+        min-height: 200px !important;
+    }
+</style>
+
+<div id="overviewDemoDropZone" class="card custom-drop-zone rounded-3 w-100 m-0">
+    <span class="drop-file-icon mb-3"></span>
+    <span class="drop-file-label">Drag and Drop File Here</span><span class="m-1">or</span>
+    <DxButton Id="overviewDemoSelectButton"
+              CssClass="m-1"
+              RenderStyle="ButtonRenderStyle.Primary"
+              Text="Select File" />
+</div>
+<DxFileInput @ref="fileInput"
+             AcceptedFileTypes="@ALLOWED_FILE_TYPES"
+             AllowedFileExtensions="@ALLOWED_FILE_TYPES"
+             CssClass="w-100"
+             ExternalDropZoneCssSelector="#overviewDemoDropZone"
+             ExternalDropZoneDragOverCssClass="custom-drop-zone-hover"
+             ExternalSelectButtonCssSelector="#overviewDemoSelectButton"
+             FilesUploading="OnFilesUploading"
+             MaxFileSize="2000000">
+</DxFileInput>
+
+@if (DocumentContent != null && DocumentContent.Length > 0)
+{
+    <div class="alert alert-success mt-3">
+        PDF loaded: @DocumentContent.Length bytes
+    </div>
+    <embed src="@GetPdfDataUrl()" type="application/pdf" class="w-100 pdf-viewer" />
+}
+else
+{
+    <div class="alert alert-info mt-3">
+        Please upload a PDF file to view it.
+    </div>
+}
+
+@code {
+    readonly List<string> ALLOWED_FILE_TYPES = new List<string> { ".pdf" };
+    DxFileInput fileInput;
+    byte[] DocumentContent { get; set; }
+    
+    protected override void OnInitialized()
+    {
+        Assembly assembly = Assembly.GetExecutingAssembly();
+        Stream stream = assembly.GetManifestResourceStream("EnvelopeGenerator.ReceiverUI.Resources.Invoice.pdf");
+        if (stream != null)
+        {
+            using (stream)
+            using (var binaryReader = new BinaryReader(stream))
+                DocumentContent = binaryReader.ReadBytes((int)stream.Length);
+        }
+    }
+    
+    protected async Task OnFilesUploading(FilesUploadingEventArgs args)
+    {
+        using (MemoryStream stream = new MemoryStream())
+        {
+            IFileInputSelectedFile file = args.Files[0];
+            await file.OpenReadStream(file.Size).CopyToAsync(stream);
+            DocumentContent = stream.ToArray();
+            await InvokeAsync(StateHasChanged);
+        }
+    }
+    
+    private string GetPdfDataUrl()
+    {
+        if (DocumentContent == null || DocumentContent.Length == 0)
+            return string.Empty;
+        
+        string base64 = Convert.ToBase64String(DocumentContent);
+        return $"data:application/pdf;base64,{base64}#toolbar=0&navpanes=0&scrollbar=1";
+    }
+}
+

EnvelopeGenerator.ReceiverUI/Pages/EnvelopeSenderPage.razor

@@ -0,0 +1,442 @@
+@page "/sender"
+@attribute [Microsoft.AspNetCore.Authorization.Authorize(Policy = "Sender")]
+
+@using System.Text.Json
+@using EnvelopeGenerator.Domain.Constants
+@using EnvelopeGenerator.ReceiverUI.Models
+@using DevExpress.Blazor
+@using EnvelopeGenerator.ReceiverUI.Services
+@inject EnvelopeGenerator.ReceiverUI.Services.EnvelopeService EnvelopeService
+@inject EnvelopeGenerator.ReceiverUI.Services.AuthService AuthService
+@inject NavigationManager Navigation
+@inject IJSRuntime JSRuntime
+@inject AppVersionService AppVersion
+
+<link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
+<link href="@AppVersion.GetVersionedUrl("css/envelope-viewer.css")" rel="stylesheet" />
+<link href="@AppVersion.GetVersionedUrl("css/sender-page.css")" rel="stylesheet" />
+
+<div class="sender-dashboard-layout">
+    <div class="sender-action-bar">
+        <div class="sender-action-bar__inner">
+            <div class="sender-title-section">
+                <div class="sender-logo">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" fill="currentColor" viewBox="0 0 16 16">
+                        <path d="M0 4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V4Zm2-1a1 1 0 0 0-1 1v.217l7 4.2 7-4.2V4a1 1 0 0 0-1-1H2Zm13 2.383-4.708 2.825L15 11.105V5.383Zm-.034 6.876-5.64-3.471L8 9.583l-1.326-.795-5.64 3.47A1 1 0 0 0 2 13h12a1 1 0 0 0 .966-.741ZM1 11.105l4.708-2.897L1 5.383v5.722Z"/>
+                    </svg>
+                </div>
+                <div class="sender-title">Umschlag-Übersicht</div>
+            </div>
+
+            <div class="sender-toolbar">
+                <button class="sender-btn sender-btn--primary" @onclick="CreateEnvelope" title="Neuen Umschlag erstellen">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                        <path d="M8 4a.5.5 0 0 1 .5.5v3h3a.5.5 0 0 1 0 1h-3v3a.5.5 0 0 1-1 0v-3h-3a.5.5 0 0 1 0-1h3v-3A.5.5 0 0 1 8 4z"/>
+                    </svg>
+                    Neuer Umschlag
+                </button>
+
+                <button class="sender-btn" @onclick="EditEnvelope" disabled="@(_selectedEnvelope == null || IsEnvelopeSent(_selectedEnvelope))" title="Ausgewählten Umschlag bearbeiten">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                        <path d="M12.146.146a.5.5 0 0 1 .708 0l3 3a.5.5 0 0 1 0 .708l-10 10a.5.5 0 0 1-.168.11l-5 2a.5.5 0 0 1-.65-.65l2-5a.5.5 0 0 1 .11-.168l10-10zM11.207 2.5 13.5 4.793 14.793 3.5 12.5 1.207 11.207 2.5zm1.586 3L10.5 3.207 4 9.707V10h.5a.5.5 0 0 1 .5.5v.5h.5a.5.5 0 0 1 .5.5v.5h.293l6.5-6.5zm-9.761 5.175-.106.106-1.528 3.821 3.821-1.528.106-.106A.5.5 0 0 1 5 12.5V12h-.5a.5.5 0 0 1-.5-.5V11h-.5a.5.5 0 0 1-.468-.325z"/>
+                    </svg>
+                    Bearbeiten
+                </button>
+
+                <button class="sender-btn sender-btn--danger" @onclick="DeleteEnvelope" disabled="@(_selectedEnvelope == null)" title="Ausgewählten Umschlag löschen">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                        <path d="M5.5 5.5A.5.5 0 0 1 6 6v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm2.5 0a.5.5 0 0 1 .5.5v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm3 .5a.5.5 0 0 0-1 0v6a.5.5 0 0 0 1 0V6z"/>
+                        <path fill-rule="evenodd" d="M14.5 3a1 1 0 0 1-1 1H13v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V4h-.5a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1H6a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1h3.5a1 1 0 0 1 1 1v1zM4.118 4 4 4.059V13a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1V4.059L11.882 4H4.118zM2.5 3V2h11v1h-11z"/>
+                    </svg>
+                    Löschen
+                </button>
+
+                <button class="sender-btn" @onclick="RefreshEnvelopes" disabled="@_isLoading" title="Aktualisieren">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                        <path fill-rule="evenodd" d="M8 3a5 5 0 1 0 4.546 2.914.5.5 0 0 1 .908-.417A6 6 0 1 1 8 2v1z"/>
+                        <path d="M8 4.466V.534a.25.25 0 0 1 .41-.192l2.36 1.966c.12.1.12.284 0 .384L8.41 4.658A.25.25 0 0 1 8 4.466z"/>
+                    </svg>
+                    @if (_isLoading) {
+                        <span class="spinner-border spinner-border-sm" style="width: 14px; height: 14px;"></span>
+                    }
+                </button>
+
+                <button class="sender-btn sender-btn--logout" @onclick="LogoutAsync" disabled="@_isLoggingOut" title="Abmelden">
+                    @if (_isLoggingOut) {
+                        <span class="spinner-border spinner-border-sm" style="width: 14px; height: 14px;"></span>
+                    } else {
+                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                            <path fill-rule="evenodd" d="M10 12.5a.5.5 0 0 1-.5.5h-8a.5.5 0 0 1-.5-.5v-9a.5.5 0 0 1 .5-.5h8a.5.5 0 0 1 .5.5v2a.5.5 0 0 0 1 0v-2A1.5 1.5 0 0 0 9.5 2h-8A1.5 1.5 0 0 0 0 3.5v9A1.5 1.5 0 0 0 1.5 14h8a1.5 1.5 0 0 0 1.5-1.5v-2a.5.5 0 0 0-1 0v2z"/>
+                            <path fill-rule="evenodd" d="M15.854 8.354a.5.5 0 0 0 0-.708l-3-3a.5.5 0 0 0-.708.708L14.293 7.5H5.5a.5.5 0 0 0 0 1h8.793l-2.147 2.146a.5.5 0 0 0 .708.708l3-3z"/>
+                        </svg>
+                    }
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <div class="sender-content">
+        @if (_isLoading && _allEnvelopes == null) {
+            <div class="d-flex justify-content-center align-items-center h-100">
+                <div class="text-center">
+                    <div class="spinner-border text-white mb-3" style="width: 3.5rem; height: 3.5rem;" role="status">
+                        <span class="visually-hidden">Lädt...</span>
+                    </div>
+                    <p class="text-white fw-semibold">Umschläge werden geladen...</p>
+                </div>
+            </div>
+        } else if (_errorMessage != null) {
+            <div class="error-container">
+                <div class="alert alert-danger shadow-lg">
+                    <div class="d-flex align-items-start">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" fill="currentColor" class="me-3 flex-shrink-0" viewBox="0 0 16 16">
+                            <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+                            <path d="M7.002 11a1 1 0 1 1 2 0 1 1 0 0 1-2 0zM7.1 4.995a.905.905 0 1 1 1.8 0l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 4.995z"/>
+                        </svg>
+                        <div>
+                            <h5 class="mb-2">Fehler beim Laden der Umschläge</h5>
+                            <p class="mb-0">@_errorMessage</p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        } else {
+            <div class="sender-grid-container">
+                <div class="sender-tabs">
+                    <button class="sender-tab @(_activeTab == "active" ? "sender-tab--active" : "")" @onclick='() => _activeTab = "active"'>
+                        <span>Aktive Umschläge</span>
+                        @if (_activeEnvelopes != null) {
+                            <span style="opacity: 0.6; margin-left: 0.5rem;">(@_activeEnvelopes.Count())</span>
+                        }
+                    </button>
+                    <button class="sender-tab @(_activeTab == "completed" ? "sender-tab--active" : "")" @onclick='() => _activeTab = "completed"'>
+                        <span>Abgeschlossene Umschläge</span>
+                        @if (_completedEnvelopes != null) {
+                            <span style="opacity: 0.6; margin-left: 0.5rem;">(@_completedEnvelopes.Count())</span>
+                        }
+                    </button>
+                </div>
+
+                <div class="sender-grid-wrapper">
+                    @if (_activeTab == "active") {
+                        <DxGrid Data="@_activeEnvelopes"
+                                @ref="_gridActive"
+                                ShowFilterRow="true"
+                                ShowSearchBox="true"
+                                AllowColumnReorder="true"
+                                AllowSort=true
+                                ColumnResizeMode="GridColumnResizeMode.ColumnsContainer"
+                                PageSize="20"
+                                PagerVisible="true"
+                                SelectionMode="GridSelectionMode.Single"
+                                SelectedDataItem="@_selectedEnvelope"
+                                SelectedDataItemChanged="@OnSelectedEnvelopeChanged"
+                                CustomizeElement="OnCustomizeElement">
+                            <Columns>
+                                <DxGridDataColumn FieldName="Id" Caption="ID">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @((cellContext.DataItem as EnvelopeDto)?.Id)
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="Title" Caption="Titel">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        <strong>@((cellContext.DataItem as EnvelopeDto)?.Title)</strong>
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="Status" Caption="Status">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @{
+                                            var envelope = cellContext.DataItem as EnvelopeDto;
+                                            if (envelope != null) {
+                                                var statusInfo = GetStatusInfo(envelope.Status);
+                                                <div class="status-badge status-badge--@statusInfo.CssClass">
+                                                    <span class="status-dot status-dot--@statusInfo.DotColor"></span>
+                                                    @statusInfo.Label
+                                                </div>
+                                            }
+                                        }
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="EnvelopeReceivers" Caption="Empfänger">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @{
+                                            var envelope = cellContext.DataItem as EnvelopeDto;
+                                            if (envelope != null) {
+                                                var receivers = envelope.EnvelopeReceivers ?? new List<EnvelopeReceiverSimpleDto>();
+                                                var signed = receivers.Count(r => r.Signed);
+                                                var total = receivers.Count;
+                                                <div style="display: flex; align-items: center; gap: 0.5rem;">
+                                                    <span style="font-size: 0.875rem; color: #6b7280;">
+                                                        @signed / @total unterschrieben
+                                                    </span>
+                                                    @if (total > 0) {
+                                                        <div style="flex: 1; min-width: 60px; max-width: 120px; height: 6px; background: #e5e7eb; border-radius: 3px; overflow: hidden;">
+                                                            <div style="height: 100%; background: linear-gradient(90deg, #81c784 0%, #66bb6a 100%); width: @((signed * 100.0 / total).ToString("F0"))%;"></div>
+                                                        </div>
+                                                    }
+                                                </div>
+                                            }
+                                        }
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                            </Columns>
+                            <DetailRowTemplate Context="detailContext">
+                                <div style="padding: 1rem; background: #f9fafb;">
+                                    <h6 style="font-weight: 600; color: #374151; margin-bottom: 0.75rem;">Empfänger</h6>
+                                    @{
+                                        var envelope = detailContext.DataItem as EnvelopeDto;
+                                        if (envelope?.EnvelopeReceivers?.Any() == true) {
+                                            <div style="display: flex; flex-direction: column; gap: 0.5rem;">
+                                                @foreach (var receiver in envelope.EnvelopeReceivers) {
+                                                    <div style="display: flex; align-items: center; gap: 1rem; padding: 0.5rem; background: white; border-radius: 6px; border: 1px solid #e5e7eb;">
+                                                        <span class="receiver-badge receiver-badge--@(receiver.Signed ? "signed" : "unsigned")" style="min-width: 100px;">
+                                                            @if (receiver.Signed) {
+                                                                <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" fill="currentColor" viewBox="0 0 16 16">
+                                                                    <path d="M13.854 3.646a.5.5 0 0 1 0 .708l-7 7a.5.5 0 0 1-.708 0l-3.5-3.5a.5.5 0 1 1 .708-.708L6.5 10.293l6.646-6.647a.5.5 0 0 1 .708 0z"/>
+                                                                </svg>
+                                                                <span>Unterschrieben</span>
+                                                            } else {
+                                                                <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" fill="currentColor" viewBox="0 0 16 16">
+                                                                    <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+                                                                    <path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/>
+                                                                </svg>
+                                                                <span>Ausstehend</span>
+                                                            }
+                                                        </span>
+                                                        <div style="flex: 1; font-size: 0.875rem;">
+                                                            <strong style="color: #1f2937;">@receiver.Name</strong>
+                                                            <span style="color: #6b7280; margin-left: 0.5rem;">@receiver.Email</span>
+                                                        </div>
+                                                    </div>
+                                                }
+                                            </div>
+                                        } else {
+                                            <p style="color: #9ca3af; font-size: 0.875rem; margin: 0;">Keine Empfänger</p>
+                                        }
+                                    }
+                                </div>
+                            </DetailRowTemplate>
+                        </DxGrid>
+                    } else {
+                        <DxGrid Data="@_completedEnvelopes"
+                                @ref="_gridCompleted"
+                                ShowFilterRow="true"
+                                ShowSearchBox="true"
+                                PageSize="20"
+                                PagerVisible="true"
+                                SelectionMode="GridSelectionMode.Single"
+                                SelectedDataItem="@_selectedEnvelope"
+                                SelectedDataItemChanged="@OnSelectedEnvelopeChanged"
+                                CustomizeElement="OnCustomizeElement">
+                            <Columns>
+                                <DxGridDataColumn FieldName="Id" Caption="ID">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @((cellContext.DataItem as EnvelopeDto)?.Id)
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="Title" Caption="Titel">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        <strong>@((cellContext.DataItem as EnvelopeDto)?.Title)</strong>
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="Status" Caption="Status">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @{
+                                            var envelope = cellContext.DataItem as EnvelopeDto;
+                                            if (envelope != null) {
+                                                var statusInfo = GetStatusInfo(envelope.Status);
+                                                <div class="status-badge status-badge--@statusInfo.CssClass">
+                                                    <span class="status-dot status-dot--@statusInfo.DotColor"></span>
+                                                    @statusInfo.Label
+                                                </div>
+                                            }
+                                        }
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                                <DxGridDataColumn FieldName="EnvelopeReceivers" Caption="Empfänger">
+                                    <CellDisplayTemplate Context="cellContext">
+                                        @{
+                                            var envelope = cellContext.DataItem as EnvelopeDto;
+                                            if (envelope != null) {
+                                                var receivers = envelope.EnvelopeReceivers ?? new List<EnvelopeReceiverSimpleDto>();
+                                                var signed = receivers.Count(r => r.Signed);
+                                                var total = receivers.Count;
+                                                <div style="display: flex; align-items: center; gap: 0.5rem;">
+                                                    <span style="font-size: 0.875rem; color: #6b7280;">
+                                                        @signed / @total unterschrieben
+                                                    </span>
+                                                    @if (total > 0) {
+                                                        <div style="flex: 1; min-width: 60px; max-width: 120px; height: 6px; background: #e5e7eb; border-radius: 3px; overflow: hidden;">
+                                                            <div style="height: 100%; background: linear-gradient(90deg, #81c784 0%, #66bb6a 100%); width: @((signed * 100.0 / total).ToString("F0"))%;"></div>
+                                                        </div>
+                                                    }
+                                                </div>
+                                            }
+                                        }
+                                    </CellDisplayTemplate>
+                                </DxGridDataColumn>
+                            </Columns>
+                            <DetailRowTemplate Context="detailContext">
+                                <div style="padding: 1rem; background: #f9fafb;">
+                                    <h6 style="font-weight: 600; color: #374151; margin-bottom: 0.75rem;">Empfänger</h6>
+                                    @{
+                                        var envelope = detailContext.DataItem as EnvelopeDto;
+                                        if (envelope?.EnvelopeReceivers?.Any() == true) {
+                                            <div style="display: flex; flex-direction: column; gap: 0.5rem;">
+                                                @foreach (var receiver in envelope.EnvelopeReceivers) {
+                                                    <div style="display: flex; align-items: center; gap: 1rem; padding: 0.5rem; background: white; border-radius: 6px; border: 1px solid #e5e7eb;">
+                                                        <span class="receiver-badge receiver-badge--@(receiver.Signed ? "signed" : "unsigned")" style="min-width: 100px;">
+                                                            @if (receiver.Signed) {
+                                                                <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" fill="currentColor" viewBox="0 0 16 16">
+                                                                    <path d="M13.854 3.646a.5.5 0 0 1 0 .708l-7 7a.5.5 0 0 1-.708 0l-3.5-3.5a.5.5 0 1 1 .708-.708L6.5 10.293l6.646-6.647a.5.5 0 0 1 .708 0z"/>
+                                                                </svg>
+                                                                <span>Unterschrieben</span>
+                                                            } else {
+                                                                <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" fill="currentColor" viewBox="0 0 16 16">
+                                                                    <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+                                                                    <path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/>
+                                                                </svg>
+                                                                <span>Ausstehend</span>
+                                                            }
+                                                        </span>
+                                                        <div style="flex: 1; font-size: 0.875rem;">
+                                                            <strong style="color: #1f2937;">@receiver.Name</strong>
+                                                            <span style="color: #6b7280; margin-left: 0.5rem;">@receiver.Email</span>
+                                                        </div>
+                                                    </div>
+                                                }
+                                            </div>
+                                        } else {
+                                            <p style="color: #9ca3af; font-size: 0.875rem; margin: 0;">Keine Empfänger</p>
+                                        }
+                                    }
+                                </div>
+                            </DetailRowTemplate>
+                        </DxGrid>
+                    }
+                </div>
+            </div>
+        }
+    </div>
+</div>
+
+@code {
+    private IEnumerable<EnvelopeDto>? _allEnvelopes;
+    private IEnumerable<EnvelopeDto>? _activeEnvelopes;
+    private IEnumerable<EnvelopeDto>? _completedEnvelopes;
+    private EnvelopeDto? _selectedEnvelope;
+    private string _activeTab = "active";
+    private bool _isLoading = true;
+    private bool _isLoggingOut = false;
+    private string? _errorMessage;
+    private DxGrid? _gridActive;
+    private DxGrid? _gridCompleted;
+
+    protected override async Task OnInitializedAsync()
+    {
+        var hasAccess = await AuthService.CheckSenderAsync();
+        if (!hasAccess)
+        {
+            Navigation.NavigateTo($"/sender/login");
+            return;
+        }
+
+        await LoadEnvelopesAsync();
+    }
+
+    async Task LoadEnvelopesAsync()
+    {
+        _isLoading = true;
+        _errorMessage = null;
+        await InvokeAsync(StateHasChanged);
+
+        try
+        {
+            _allEnvelopes = await EnvelopeService.GetAsync() ?? [];
+            
+            // Split into active and completed based on status
+            var envelopes = _allEnvelopes.ToList();
+            _activeEnvelopes = envelopes.Where(e => ((EnvelopeStatus)e.Status).IsActive()).ToList();
+            _completedEnvelopes = envelopes.Where(e => ((EnvelopeStatus)e.Status).IsCompleted()).ToList();
+
+            await JSRuntime.InvokeVoidAsync("console.log", $"Loaded {_activeEnvelopes.Count()} active and {_completedEnvelopes.Count()} completed envelopes");
+        }
+        catch (Exception ex)
+        {
+            _errorMessage = ex.Message;
+            await JSRuntime.InvokeVoidAsync("console.error", "Fehler beim Laden der Umschläge:", ex.ToString());
+        }
+        finally
+        {
+            _isLoading = false;
+            await InvokeAsync(StateHasChanged);
+        }
+    }
+
+    async Task RefreshEnvelopes()
+    {
+        await LoadEnvelopesAsync();
+    }
+
+    void CreateEnvelope()
+    {
+        // TODO: Navigate to envelope creation page
+        JSRuntime.InvokeVoidAsync("console.log", "Create envelope clicked - not yet implemented");
+    }
+
+    void EditEnvelope()
+    {
+        if (_selectedEnvelope == null) return;
+        // TODO: Navigate to envelope editor
+        JSRuntime.InvokeVoidAsync("console.log", $"Edit envelope {_selectedEnvelope.Id} clicked - not yet implemented");
+    }
+
+    void DeleteEnvelope()
+    {
+        if (_selectedEnvelope == null) return;
+        // TODO: Show delete confirmation dialog
+        JSRuntime.InvokeVoidAsync("console.log", $"Delete envelope {_selectedEnvelope.Id} clicked - not yet implemented");
+    }
+
+    async Task LogoutAsync()
+    {
+        _isLoggingOut = true;
+        await InvokeAsync(StateHasChanged);
+        await AuthService.LogoutSenderAsync();
+        Navigation.NavigateTo("/sender/login", forceLoad: true);
+    }
+
+    bool IsEnvelopeSent(EnvelopeDto envelope)
+    {
+        var status = (EnvelopeStatus)envelope.Status;
+        return status >= EnvelopeStatus.EnvelopeQueued;
+    }
+
+    (string Label, string CssClass, string DotColor) GetStatusInfo(int statusCode)
+    {
+        var status = (EnvelopeStatus)statusCode;
+        return status switch
+        {
+            EnvelopeStatus.EnvelopePartlySigned => ("Teilweise unterschrieben", "partly-signed", "green"),
+            EnvelopeStatus.EnvelopeQueued => ("In Warteschlange", "queued", "orange"),
+            EnvelopeStatus.EnvelopeSent => ("Gesendet", "sent", "orange"),
+            EnvelopeStatus.EnvelopeCompletelySigned => ("Vollständig unterschrieben", "completed", "green"),
+            EnvelopeStatus.EnvelopeDeleted => ("Gelöscht", "deleted", "red"),
+            EnvelopeStatus.EnvelopeRejected => ("Abgelehnt", "rejected", "red"),
+            EnvelopeStatus.EnvelopeWithdrawn => ("Zurückgezogen", "withdrawn", "red"),
+            EnvelopeStatus.EnvelopeCreated => ("Erstellt", "created", "blue"),
+            EnvelopeStatus.EnvelopeSaved => ("Gespeichert", "saved", "blue"),
+            _ => ("Unbekannt", "unknown", "blue")
+        };
+    }
+
+    void OnCustomizeElement(GridCustomizeElementEventArgs e)
+    {
+        // Future: Add custom row coloring based on status if needed
+    }
+
+    void OnSelectedEnvelopeChanged(object envelope)
+    {
+        _selectedEnvelope = envelope as EnvelopeDto;
+    }
+}

EnvelopeGenerator.ReceiverUI/Pages/Example/ReportViewer.razor

@@ -6,6 +6,7 @@
 @using DevExpress.Utils
 @using DevExpress.XtraPrinting
 @using DevExpress.XtraPrinting.Drawing
+@using EnvelopeGenerator.Application.Common.Dto
 @using Microsoft.JSInterop
 @using XtraReport = DevExpress.XtraReports.UI.XtraReport
 @using BottomMarginBand = DevExpress.XtraReports.UI.BottomMarginBand
@@ -301,7 +302,10 @@ Shown="OnPopupShownAsync">
     bool IsLoggingOut;
 
     IReadOnlyList<AnnotationDto> _annotations = [];
-    IEnumerable<int> AnnotationPages => _annotations.Select(a => a.Page).Distinct().OrderBy(p => p);
+    IEnumerable<int> AnnotationPages => _annotations
+    .Select(a => a.Page ?? throw new InvalidOperationException($"Annotation page is missing for annotation ID {a.Id}. Annotation details: X={a.X}, Y={a.Y}"))
+    .Distinct()
+    .OrderBy(p => p);
     EnvelopeReceiverDto? _envelopeReceiver;
     record SignatureCapture(string DataUrl, string FullName, string Position, string Place);
     SignatureCapture? _capturedSignature;
@@ -342,13 +346,24 @@ Shown="OnPopupShownAsync">
             }
         }
 
-        _annotations = await AnnotationService.GetAnnotationsAsync(EnvelopeKey ?? "fake");
+        _annotations = await AnnotationService.GetAnnotationsAsync(EnvelopeKey);
-        _envelopeReceiver = await EnvelopeReceiverService.GetAsync(EnvelopeKey ?? "fake");
+        
+        try {
+            _envelopeReceiver = await EnvelopeReceiverService.GetAsync(EnvelopeKey);
+        } catch (HttpRequestException ex) {
+            // Log error but continue - UI will handle null envelope receiver gracefully
+            Console.WriteLine($"Failed to load envelope receiver: {ex.Message}");
+        }
 
-        if (!AppOptions.Value.ForceToUseFakeDocument && !string.IsNullOrWhiteSpace(EnvelopeKey)) {
+        if (!AppOptions.Value.UsePredefinedReports && !string.IsNullOrWhiteSpace(EnvelopeKey)) {
-            var (pdfBytes, _) = await DocumentService.GetDocumentAsync(EnvelopeKey);
+            try {
-            if (pdfBytes is { Length: > 0 })
+                var pdfBytes = await DocumentService.GetDocumentAsync(EnvelopeKey);
-                _basePdfBytes = pdfBytes;
+                if (pdfBytes is { Length: > 0 })
+                    _basePdfBytes = pdfBytes;
+            } catch (HttpRequestException ex) {
+                // Log error but continue - will use predefined report instead
+                Console.WriteLine($"Failed to load document: {ex.Message}");
+            }
         }
 
         var initialReport = BuildFreshBaseReport();

EnvelopeGenerator.ReceiverUI/Pages/LoginReceiverPage.razor

@@ -1,4 +1,4 @@
-@page "/login/{EnvelopeKey}"
+@page "/envelope/login/{EnvelopeKey}"
 @using EnvelopeGenerator.ReceiverUI.Services
 @inject AuthService AuthService
 @inject NavigationManager Navigation

EnvelopeGenerator.ReceiverUI/Pages/LoginSenderPage.razor

@@ -0,0 +1,172 @@
+@page "/sender/login"
+@using EnvelopeGenerator.ReceiverUI.Services
+@inject AuthService AuthService
+@inject NavigationManager Navigation
+
+<link href="_content/DevExpress.Blazor.Themes/blazing-berry.bs5.min.css" rel="stylesheet" />
+
+<div class="login-page-wrapper d-flex align-items-center justify-content-center min-vh-100">
+    <div class="login-card card shadow border-0" style="max-width: 440px; width: 100%;">
+
+        <div class="card-header text-white text-center py-4 border-0" style="background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%); border-radius: calc(0.375rem - 1px) calc(0.375rem - 1px) 0 0;">
+            <div class="mb-2">
+                <svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" fill="currentColor" viewBox="0 0 16 16">
+                    <path d="M11 6a3 3 0 1 1-6 0 3 3 0 0 1 6 0z"/>
+                    <path fill-rule="evenodd" d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8zm8-7a7 7 0 0 0-5.468 11.37C3.242 11.226 4.805 10 8 10s4.757 1.225 5.468 2.37A7 7 0 0 0 8 1z"/>
+                </svg>
+            </div>
+            <h5 class="mb-0 fw-semibold">Sender Anmeldung</h5>
+            <p class="mb-0 mt-1 opacity-75" style="font-size: 0.85rem;">Sicherer Zugang zum Sender-Dashboard</p>
+        </div>
+
+        <div class="card-body p-4">
+
+            <p class="text-muted mb-4" style="font-size: 0.875rem; line-height: 1.5;">
+                Bitte melden Sie sich mit Ihren Zugangsdaten an, um auf das Sender-Dashboard zuzugreifen.
+            </p>
+
+            @if (LoginResult == SenderLoginResult.InvalidCredentials) {
+                <div class="alert alert-danger d-flex align-items-start gap-2 py-2" role="alert">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" class="flex-shrink-0 mt-1" viewBox="0 0 16 16">
+                        <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zM5.354 4.646a.5.5 0 1 0-.708.708L7.293 8l-2.647 2.646a.5.5 0 0 0 .708.708L8 8.707l2.646 2.647a.5.5 0 0 0 .708-.708L8.707 8l2.647-2.646a.5.5 0 0 0-.708-.708L8 7.293 5.354 4.646z"/>
+                    </svg>
+                    <div>
+                        <strong>Ungültige Anmeldedaten.</strong><br />
+                        <span style="font-size:0.85rem;">Benutzername oder Passwort ist falsch. Bitte versuchen Sie es erneut.</span>
+                    </div>
+                </div>
+            } else if (LoginResult == SenderLoginResult.Error) {
+                <div class="alert alert-secondary d-flex align-items-start gap-2 py-2" role="alert">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" class="flex-shrink-0 mt-1" viewBox="0 0 16 16">
+                        <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+                        <path d="M7.002 11a1 1 0 1 1 2 0 1 1 0 0 1-2 0zM7.1 4.995a.905.905 0 1 1 1.8 0l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 4.995z"/>
+                    </svg>
+                    <div>
+                        <strong>Serverfehler.</strong><br />
+                        <span style="font-size:0.85rem;">Ein unerwarteter Fehler ist aufgetreten. Bitte versuchen Sie es später erneut.</span>
+                    </div>
+                </div>
+            }
+
+            <div class="mb-3">
+                <label class="form-label fw-medium" for="login-username">
+                    Benutzername
+                    <span class="text-danger ms-1">*</span>
+                </label>
+                <div class="input-group">
+                    <span class="input-group-text bg-light">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="#6c757d" viewBox="0 0 16 16">
+                            <path d="M3 14s-1 0-1-1 1-4 6-4 6 3 6 4-1 1-1 1H3Zm5-6a3 3 0 1 0 0-6 3 3 0 0 0 0 6Z"/>
+                        </svg>
+                    </span>
+                    <input id="login-username"
+                           type="text"
+                           class="form-control @(LoginResult == SenderLoginResult.InvalidCredentials ? "is-invalid" : null)"
+                           placeholder="Benutzername eingeben"
+                           @bind="Username"
+                           @bind:event="oninput"
+                           @onkeydown="OnKeyDownAsync"
+                           disabled="@IsLoading"
+                           autocomplete="username" />
+                </div>
+            </div>
+
+            <div class="mb-4">
+                <label class="form-label fw-medium" for="login-password">
+                    Passwort
+                    <span class="text-danger ms-1">*</span>
+                </label>
+                <div class="input-group">
+                    <span class="input-group-text bg-light border-end-0">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="#6c757d" viewBox="0 0 16 16">
+                            <path d="M8 1a2 2 0 0 1 2 2v4H6V3a2 2 0 0 1 2-2zm3 6V3a3 3 0 0 0-6 0v4a2 2 0 0 0-2 2v5a2 2 0 0 0 2 2h6a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2z"/>
+                        </svg>
+                    </span>
+                    <input id="login-password"
+                           type="@(ShowPassword ? "text" : "password")"
+                           class="form-control border-start-0 border-end-0 @(LoginResult == SenderLoginResult.InvalidCredentials ? "is-invalid" : null)"
+                           placeholder="Passwort eingeben"
+                           @bind="Password"
+                           @bind:event="oninput"
+                           @onkeydown="OnKeyDownAsync"
+                           disabled="@IsLoading"
+                           autocomplete="current-password" />
+                    <button type="button"
+                            class="btn btn-outline-secondary border-start-0"
+                            style="border-left: none;"
+                            tabindex="-1"
+                            @onclick="() => ShowPassword = !ShowPassword">
+                        @if (ShowPassword) {
+                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                                <path d="M13.359 11.238C15.06 9.72 16 8 16 8s-3-5.5-8-5.5a7.028 7.028 0 0 0-2.79.588l.77.771A5.944 5.944 0 0 1 8 3.5c2.12 0 3.879 1.168 5.168 2.457A13.134 13.134 0 0 1 14.828 8c-.058.087-.122.183-.195.288-.335.48-.83 1.12-1.465 1.755-.165.165-.337.328-.517.486l.708.709z"/>
+                                <path d="M11.297 9.176a3.5 3.5 0 0 0-4.474-4.474l.823.823a2.5 2.5 0 0 1 2.829 2.829l.822.822zm-2.943 1.299.822.822a3.5 3.5 0 0 1-4.474-4.474l.823.823a2.5 2.5 0 0 0 2.829 2.829z"/>
+                                <path d="M3.35 5.47c-.18.16-.353.322-.518.487A13.134 13.134 0 0 0 1.172 8l.195.288c.335.48.83 1.12 1.465 1.755C4.121 11.332 5.881 12.5 8 12.5c.716 0 1.39-.133 2.02-.36l.77.772A7.029 7.029 0 0 1 8 13.5C3 13.5 0 8 0 8s.939-1.721 2.641-3.238l.708.709z"/>
+                                <path fill-rule="evenodd" d="M13.646 14.354l-12-12 .708-.708 12 12-.708.708z"/>
+                            </svg>
+                        } else {
+                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                                <path d="M16 8s-3-5.5-8-5.5S0 8 0 8s3 5.5 8 5.5S16 8 16 8zM1.173 8a13.133 13.133 0 0 1 1.66-2.043C4.12 4.668 5.88 3.5 8 3.5c2.12 0 3.879 1.168 5.168 2.457A13.133 13.133 0 0 1 14.828 8c-.058.087-.122.183-.195.288-.335.48-.83 1.12-1.465 1.755C11.879 11.332 10.119 12.5 8 12.5c-2.12 0-3.879-1.168-5.168-2.457A13.134 13.134 0 0 1 1.172 8z"/>
+                                <path d="M8 5.5a2.5 2.5 0 1 0 0 5 2.5 2.5 0 0 0 0-5zM4.5 8a3.5 3.5 0 1 1 7 0 3.5 3.5 0 0 1-7 0z"/>
+                            </svg>
+                        }
+                    </button>
+                </div>
+            </div>
+
+            <button class="btn btn-primary w-100 py-2 fw-medium"
+                    style="background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%); border: none;"
+                    @onclick="SubmitAsync"
+                    disabled="@(IsLoading || string.IsNullOrWhiteSpace(Username) || string.IsNullOrWhiteSpace(Password))">
+                @if (IsLoading) {
+                    <span class="spinner-border spinner-border-sm me-2" role="status" aria-hidden="true"></span>
+                    <span>Anmelden …</span>
+                } else {
+                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="me-2" viewBox="0 0 16 16">
+                        <path fill-rule="evenodd" d="M10 3.5a.5.5 0 0 0-.5-.5h-8a.5.5 0 0 0-.5.5v9a.5.5 0 0 0 .5.5h8a.5.5 0 0 0 .5-.5v-2a.5.5 0 0 1 1 0v2A1.5 1.5 0 0 1 9.5 14h-8A1.5 1.5 0 0 1 0 12.5v-9A1.5 1.5 0 0 1 1.5 2h8A1.5 1.5 0 0 1 11 3.5v2a.5.5 0 0 1-1 0v-2z"/>
+                        <path fill-rule="evenodd" d="M4.146 8.354a.5.5 0 0 1 0-.708l3-3a.5.5 0 1 1 .708.708L5.707 7.5H14.5a.5.5 0 0 1 0 1H5.707l2.147 2.146a.5.5 0 0 1-.708.708l-3-3z"/>
+                    </svg>
+                    <span>Anmelden</span>
+                }
+            </button>
+
+        </div>
+
+        <div class="card-footer text-center text-muted py-3 border-0 bg-transparent" style="font-size: 0.78rem;">
+            Bei Problemen wenden Sie sich bitte an den Administrator.
+        </div>
+
+    </div>
+</div>
+
+@code {
+    string Username = string.Empty;
+    string Password = string.Empty;
+    bool ShowPassword;
+    bool IsLoading;
+    SenderLoginResult? LoginResult;
+
+    async Task OnKeyDownAsync(Microsoft.AspNetCore.Components.Web.KeyboardEventArgs e) {
+        if (e.Key == "Enter")
+            await SubmitAsync();
+    }
+
+    async Task SubmitAsync() {
+        if (string.IsNullOrWhiteSpace(Username) || string.IsNullOrWhiteSpace(Password) || IsLoading) return;
+
+        IsLoading = true;
+        LoginResult = null;
+        await InvokeAsync(StateHasChanged);
+
+        var result = await AuthService.LoginSenderAsync(Username.Trim(), Password.Trim());
+
+        if (result == SenderLoginResult.Success) {
+            Navigation.NavigateTo("/sender", forceLoad: true);
+            return;
+        }
+
+        LoginResult = result;
+        IsLoading = false;
+        await InvokeAsync(StateHasChanged);
+    }
+}
+

EnvelopeGenerator.ReceiverUI/Program.cs

@@ -7,6 +7,9 @@ using EnvelopeGenerator.ReceiverUI.Options;
 using DevExpress.XtraReports.Services;
 using DevExpress.Blazor.Reporting;
 using DevExpress.XtraReports.Web.Extensions;
+using EnvelopeGenerator.Application.Resources;
+using Microsoft.Extensions.Localization;
+using System.Globalization;
 
 var builder = WebAssemblyHostBuilder.CreateDefault(args);
 builder.RootComponents.Add<App>("#app");
@@ -20,9 +23,14 @@ builder.Services.AddScoped<DocumentService>();
 builder.Services.AddScoped<AuthService>();
 builder.Services.AddScoped<AnnotationService>();
 builder.Services.AddScoped<EnvelopeReceiverService>();
-builder.Services.AddScoped<SignatureService>();
+builder.Services.AddScoped<DocReceiverElementService>();
 builder.Services.AddScoped<SignatureCacheService>();
 builder.Services.AddSingleton<AppVersionService>();
+builder.Services.AddScoped<EnvelopeService>();
+builder.Services.AddScoped<CultureService>();
+
+// Localization services
+builder.Services.AddLocalization();
 
 builder.Services.AddDevExpressWebAssemblyBlazorReportViewer();
 builder.Services.AddDevExpressWebAssemblyBlazorPdfViewer();
@@ -41,5 +49,30 @@ builder.Services.AddScoped<IReportProviderAsync, CustomReportProvider>();
 ReportStorageWebExtension.RegisterExtensionGlobal(new InMemoryReportStorageWebExtension());
 
 var host = builder.Build();
+
+// ⚠️ IMPORTANT: BLAZOR WASM-SPECIFIC CULTURE INITIALIZATION
+// This approach sets DefaultThreadCurrentCulture globally, which is SAFE for WebAssembly
+// because each user runs their own isolated app instance in their browser.
+// 
+// ⚠️ TODO: REMOVE/REFACTOR WHEN MIGRATING TO BLAZOR SERVER/AUTO
+// In Server/Auto render modes, this is DANGEROUS because:
+// - Server runs a single shared instance for all users
+// - Setting global culture affects ALL connected users simultaneously
+// - Race conditions and culture conflicts will occur
+//
+// Migration Guide:
+// - Option 1: Use RequestLocalizationMiddleware for per-request culture
+// - Option 2: Use CascadingParameter with per-circuit culture state
+// - See: https://learn.microsoft.com/aspnet/core/blazor/globalization-localization
+//
+// Related files to update on migration:
+// - LanguageSelector.razor (remove manual culture setting)
+// - App.razor (may need CascadingValue for culture)
+// - Startup/Program.cs (add middleware)
+var cultureService = host.Services.GetRequiredService<CultureService>();
+var culture = await cultureService.InitializeCultureAsync();
+CultureInfo.DefaultThreadCurrentCulture = culture;
+CultureInfo.DefaultThreadCurrentUICulture = culture;
+
 await FontLoader.LoadFonts(host.Services.GetRequiredService<HttpClient>(), new List<string> { "opensans.ttf" });
 await host.RunAsync();

EnvelopeGenerator.ReceiverUI/Properties/launchSettings.json

@@ -2,7 +2,7 @@
   "profiles": {
     "EnvelopeGenerator.ReceiverUI": {
       "commandName": "Project",
-      "launchBrowser": true,
+      "launchBrowser": false,
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"
       },

EnvelopeGenerator.ReceiverUI/Services/AnnotationService.cs

@@ -1,5 +1,6 @@
 using System.Net.Http.Json;
 using System.Text.Json;
+using EnvelopeGenerator.Application.Common.Dto;
 using EnvelopeGenerator.ReceiverUI.Models;
 using EnvelopeGenerator.ReceiverUI.Options;
 using Microsoft.Extensions.Options;

EnvelopeGenerator.ReceiverUI/Services/AuthService.cs

@@ -1,4 +1,5 @@
 using System.Net;
+using System.Net.Http.Json;
 using EnvelopeGenerator.ReceiverUI.Options;
 using Microsoft.Extensions.Options;
 
@@ -6,6 +7,8 @@ namespace EnvelopeGenerator.ReceiverUI.Services;
 
 public enum EnvelopeLoginResult { Success, InvalidCode, NotFound, Error }
 
+public enum SenderLoginResult { Success, InvalidCredentials, Error }
+
 public class AuthService(HttpClient http, IOptions<ApiOptions> apiOptions)
 {
     private readonly ApiOptions _api = apiOptions.Value;
@@ -54,4 +57,47 @@ public class AuthService(HttpClient http, IOptions<ApiOptions> apiOptions)
             null, cancel);
         return response.IsSuccessStatusCode;
     }
+
+    /// <summary>
+    /// Checks whether the current user holds a valid receiver token for the given envelope key.
+    /// Calls GET /api/auth/check/envelope/{envelopeKey}.
+    /// </summary>
+    public async Task<bool> CheckSenderAsync(CancellationToken cancel = default)
+    {
+        var response = await http.GetAsync($"{_api.BaseUrl}/api/auth/check", cancel);
+        return response.StatusCode == HttpStatusCode.OK;
+    }
+
+    /// <summary>
+    /// Authenticates a sender user with username and password.
+    /// Calls POST /api/auth?cookie=true with JSON body.
+    /// On success the API sets an authentication cookie automatically.
+    /// </summary>
+    public async Task<SenderLoginResult> LoginSenderAsync(string username, string password, CancellationToken cancel = default)
+    {
+        var requestBody = new { username, password };
+
+        var response = await http.PostAsJsonAsync(
+            $"{_api.BaseUrl}/api/auth?cookie=true",
+            requestBody, cancel);
+
+        return response.StatusCode switch
+        {
+            HttpStatusCode.OK => SenderLoginResult.Success,
+            HttpStatusCode.Unauthorized => SenderLoginResult.InvalidCredentials,
+            _ => SenderLoginResult.Error
+        };
+    }
+
+    /// <summary>
+    /// Logs out the sender user by removing the authentication cookie.
+    /// Calls POST /api/auth/logout.
+    /// </summary>
+    public async Task<bool> LogoutSenderAsync(CancellationToken cancel = default)
+    {
+        var response = await http.PostAsync(
+            $"{_api.BaseUrl}/api/auth/logout",
+            null, cancel);
+        return response.IsSuccessStatusCode;
+    }
 }

EnvelopeGenerator.ReceiverUI/Services/CultureService.cs

@@ -0,0 +1,74 @@
+using System.Globalization;
+using Microsoft.JSInterop;
+
+namespace EnvelopeGenerator.ReceiverUI.Services;
+
+/// <summary>
+/// Service for managing application culture/localization.
+/// </summary>
+public class CultureService
+{
+    private readonly IJSRuntime _jsRuntime;
+    private const string CULTURE_KEY = "AppCulture";
+
+    public CultureService(IJSRuntime jsRuntime)
+    {
+        _jsRuntime = jsRuntime;
+    }
+
+    /// <summary>
+    /// Gets the list of supported cultures.
+    /// </summary>
+    public static CultureInfo[] SupportedCultures { get; } = new[]
+    {
+        new CultureInfo("de-DE"),
+        new CultureInfo("en-US"),
+        new CultureInfo("fr-FR")
+    };
+
+    /// <summary>
+    /// Sets the application culture and stores it in localStorage.
+    /// </summary>
+    public async Task SetCultureAsync(string culture)
+    {
+        if (!SupportedCultures.Any(c => c.Name == culture))
+            throw new ArgumentException($"Culture '{culture}' is not supported.", nameof(culture));
+
+        await _jsRuntime.InvokeVoidAsync("localStorage.setItem", CULTURE_KEY, culture);
+    }
+
+    /// <summary>
+    /// Gets the stored culture from localStorage.
+    /// </summary>
+    public async Task<string?> GetCultureAsync()
+    {
+        try
+        {
+            return await _jsRuntime.InvokeAsync<string?>("localStorage.getItem", CULTURE_KEY);
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// Initializes the culture from localStorage or browser settings.
+    /// </summary>
+    public async Task<CultureInfo> InitializeCultureAsync()
+    {
+        var storedCulture = await GetCultureAsync();
+        
+        if (!string.IsNullOrEmpty(storedCulture) && 
+            SupportedCultures.Any(c => c.Name == storedCulture))
+        {
+            return new CultureInfo(storedCulture);
+        }
+
+        // Fallback to browser culture or default
+        var browserCulture = CultureInfo.CurrentCulture.Name;
+        var matchedCulture = SupportedCultures.FirstOrDefault(c => c.Name == browserCulture);
+        
+        return matchedCulture ?? SupportedCultures[0]; // Default to German
+    }
+}

EnvelopeGenerator.ReceiverUI/Services/DocReceiverElementService.cs

@@ -6,13 +6,13 @@ using Microsoft.Extensions.Options;
 
 namespace EnvelopeGenerator.ReceiverUI.Services;
 
-public class SignatureService(HttpClient http, IOptions<ApiOptions> apiOptions)
+public class DocReceiverElementService(HttpClient http, IOptions<ApiOptions> apiOptions)
 {
     private static readonly JsonSerializerOptions _jsonOptions = new(JsonSerializerDefaults.Web);
 
     public async Task<IReadOnlyList<SignatureDto>> GetAsync(string envelopeKey, CancellationToken cancel = default)
     {
-        var url = $"{apiOptions.Value.BaseUrl}/api/Signature/{Uri.EscapeDataString(envelopeKey)}";
+        var url = $"{apiOptions.Value.BaseUrl}/api/DocReceiverElement/{Uri.EscapeDataString(envelopeKey)}";
         var response = await http.GetAsync(url, cancel);
 
         if (!response.IsSuccessStatusCode)

EnvelopeGenerator.ReceiverUI/Services/DocumentService.cs

@@ -11,17 +11,25 @@ public class DocumentService(HttpClient http, IOptions<ApiOptions> apiOptions)
 
     /// <summary>
     /// Fetches the PDF bytes for the given envelope key from the API.
-    /// Returns null bytes with the HTTP status code on failure.
+    /// Throws HttpRequestException on failure with appropriate status code.
     /// </summary>
-    public async Task<(byte[]? Bytes, HttpStatusCode StatusCode)> GetDocumentAsync(string envelopeKey, CancellationToken cancel = default)
+    /// <exception cref="HttpRequestException">Thrown when the API request fails.</exception>
+    public async Task<byte[]?> GetDocumentAsync(string envelopeKey, CancellationToken cancel = default)
     {
         var response = await http.GetAsync($"{_api.BaseUrl}/api/Document/{Uri.EscapeDataString(envelopeKey)}", cancel);
 
         if (!response.IsSuccessStatusCode)
-            return (null, response.StatusCode);
+        {
+            var statusCode = (int)response.StatusCode;
+            var reasonPhrase = response.ReasonPhrase ?? "Unknown error";
+            throw new HttpRequestException(
+                $"Failed to load document. Status: {statusCode} ({reasonPhrase})",
+                null,
+                response.StatusCode);
+        }
 
         var bytes = await response.Content.ReadAsByteArrayAsync(cancel);
-        return (bytes, response.StatusCode);
+        return bytes;
     }
 }
 

EnvelopeGenerator.ReceiverUI/Services/EnvelopeReceiverService.cs

@@ -1,3 +1,4 @@
+using System.Net;
 using System.Net.Http.Json;
 using System.Text.Json;
 using EnvelopeGenerator.ReceiverUI.Models;
@@ -14,13 +15,25 @@ public class EnvelopeReceiverService(HttpClient http, IOptions<ApiOptions> apiOp
 {
     private static readonly JsonSerializerOptions _jsonOptions = new(JsonSerializerDefaults.Web);
 
+    /// <summary>
+    /// Fetches the envelope receiver data for the given envelope key from the API.
+    /// Throws HttpRequestException on failure with appropriate status code.
+    /// </summary>
+    /// <exception cref="HttpRequestException">Thrown when the API request fails.</exception>
     public async Task<EnvelopeReceiverDto?> GetAsync(string envelopeKey, CancellationToken cancel = default)
     {
         var url = $"{apiOptions.Value.BaseUrl}/api/EnvelopeReceiver/{Uri.EscapeDataString(envelopeKey)}";
         var response = await http.GetAsync(url, cancel);
 
         if (!response.IsSuccessStatusCode)
-            return null;
+        {
+            var statusCode = (int)response.StatusCode;
+            var reasonPhrase = response.ReasonPhrase ?? "Unknown error";
+            throw new HttpRequestException(
+                $"Failed to load envelope receiver data. Status: {statusCode} ({reasonPhrase})",
+                null,
+                response.StatusCode);
+        }
 
         return await response.Content.ReadFromJsonAsync<EnvelopeReceiverDto>(_jsonOptions, cancel);
     }

EnvelopeGenerator.ReceiverUI/Services/EnvelopeService.cs

@@ -0,0 +1,72 @@
+using System.Net.Http.Json;
+using System.Text.Json;
+using EnvelopeGenerator.ReceiverUI.Models;
+using EnvelopeGenerator.ReceiverUI.Options;
+using Microsoft.AspNetCore.WebUtilities;
+using Microsoft.Extensions.Options;
+
+namespace EnvelopeGenerator.ReceiverUI.Services;
+
+/// <summary>
+/// Retrieves <see cref="EnvelopeDto"/>s from the API.
+/// </summary>
+public class EnvelopeService
+{
+    private readonly HttpClient _http;
+    private readonly ApiOptions _apiOptions;
+    private static readonly JsonSerializerOptions _jsonOptions = new(JsonSerializerDefaults.Web);
+
+    public EnvelopeService(HttpClient http, IOptions<ApiOptions> apiOptions)
+    {
+        _http = http;
+        _apiOptions = apiOptions.Value;
+    }
+
+    /// <summary>
+    /// Fetches envelopes from the API with optional filters.
+    /// </summary>
+    /// <exception cref="HttpRequestException">Thrown when the API request fails.</exception>
+    public async Task<IEnumerable<EnvelopeDto>?> GetAsync(
+        int? id = null,
+        string? uuid = null,
+        bool? onlyActive = null,
+        bool? onlyCompleted = null,
+        CancellationToken cancel = default)
+    {
+        var baseUrl = $"{_apiOptions.BaseUrl}/api/Envelope";
+        var queryParams = new Dictionary<string, string?>();
+
+        if (id.HasValue)
+        {
+            queryParams["Id"] = id.Value.ToString();
+        }
+        if (!string.IsNullOrEmpty(uuid))
+        {
+            queryParams["Uuid"] = uuid;
+        }
+        if (onlyActive.HasValue)
+        {
+            queryParams["OnlyActive"] = onlyActive.Value.ToString();
+        }
+        if (onlyCompleted.HasValue)
+        {
+            queryParams["OnlyCompleted"] = onlyCompleted.Value.ToString();
+        }
+
+        var url = QueryHelpers.AddQueryString(baseUrl, queryParams);
+
+        var response = await _http.GetAsync(url, cancel);
+
+        if (!response.IsSuccessStatusCode)
+        {
+            var statusCode = (int)response.StatusCode;
+            var reasonPhrase = response.ReasonPhrase ?? "Unknown error";
+            throw new HttpRequestException(
+                $"Failed to load envelopes. Status: {statusCode} ({reasonPhrase})",
+                null,
+                response.StatusCode);
+        }
+
+        return await response.Content.ReadFromJsonAsync<IEnumerable<EnvelopeDto>>(_jsonOptions, cancel);
+    }
+}

EnvelopeGenerator.ReceiverUI/Shared/LanguageSelector.razor

@@ -0,0 +1,80 @@
+@using System.Globalization
+@using EnvelopeGenerator.ReceiverUI.Services
+@inject IJSRuntime JSRuntime
+@inject NavigationManager Navigation
+@inject CultureService CultureService
+
+<div class="language-selector">
+    <button class="language-selector__trigger" @onclick="ToggleDropdown" aria-label="Select Language">
+        <span class="fi fi-@GetFlagCode(CurrentCulture)"></span>
+        <span class="language-selector__arrow">@GetLanguageName(CurrentCulture)</span>
+    </button>
+    
+    @if (isOpen)
+    {
+        <div class="language-selector__dropdown">
+            <button class="language-selector__option" @onclick="@(() => ChangeLanguageAsync("de-DE"))">
+                <span class="fi fi-de"></span>
+                <span>Deutsch</span>
+            </button>
+            <button class="language-selector__option" @onclick="@(() => ChangeLanguageAsync("en-US"))">
+                <span class="fi fi-us"></span>
+                <span>English</span>
+            </button>
+            <button class="language-selector__option" @onclick="@(() => ChangeLanguageAsync("fr-FR"))">
+                <span class="fi fi-fr"></span>
+                <span>Français</span>
+            </button>
+        </div>
+    }
+</div>
+
+@code {
+    private bool isOpen = false;
+    private string CurrentCulture => CultureInfo.CurrentCulture.Name;
+
+    private void ToggleDropdown()
+    {
+        isOpen = !isOpen;
+    }
+
+    private async Task ChangeLanguageAsync(string culture)
+    {
+        if (CultureInfo.CurrentCulture.Name != culture)
+        {
+            await CultureService.SetCultureAsync(culture);
+            
+            // Set culture without page reload
+            var cultureInfo = new CultureInfo(culture);
+            CultureInfo.DefaultThreadCurrentCulture = cultureInfo;
+            CultureInfo.DefaultThreadCurrentUICulture = cultureInfo;
+            
+            // Navigate without reload to trigger re-render
+            Navigation.NavigateTo(Navigation.Uri, forceLoad: false);
+        }
+        
+        isOpen = false;
+    }
+
+    private string GetFlagCode(string culture)
+    {
+        return culture switch
+        {
+            "de-DE" => "de",
+            "en-US" => "us",
+            "fr-FR" => "fr",
+            _ => "de"
+        };
+    }
+
+    private string GetLanguageName(string culture)
+    {
+        return culture switch
+        {
+            "de-DE" => "Deutsch",
+            "en-US" => "English",
+            "fr-FR" => "Français",
+            _ => "Deutsch"
+        };
+    }
+}

EnvelopeGenerator.ReceiverUI/Shared/MainLayout.razor

@@ -8,9 +8,12 @@
         </article>
     </main>
     <footer class="receiver-footer">
-        <span>&copy; SignFlow 2023-2024 <a href="https://digitaldata.works" target="_blank" rel="noopener">Digital Data GmbH</a></span>
+        <div class="receiver-footer__content">
-        <span class="receiver-footer__sep">&#124;</span>
+            <span>&copy; SignFlow 2023-2024 <a href="https://digitaldata.works" target="_blank" rel="noopener">Digital Data GmbH</a></span>
-        <a href="docs/privacy-policy.de-DE.html" target="_blank" rel="noopener">Datenschutz</a>
+            <span class="receiver-footer__sep">&#124;</span>
+            <a href="docs/privacy-policy.de-DE.html" target="_blank" rel="noopener">Datenschutz</a>
+        </div>
+        <LanguageSelector />
     </footer>
 </div>
 

EnvelopeGenerator.ReceiverUI/Shared/MainLayout.razor.css

@@ -15,3 +15,18 @@ article {
     padding: 0 !important;
     margin: 0 !important;
 }
+
+.receiver-footer {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 1rem 2rem;
+    gap: 1rem;
+}
+
+.receiver-footer__content {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+

EnvelopeGenerator.ReceiverUI/wwwroot/appsettings.json

@@ -1,7 +1,7 @@
 {
   "Api": {
     "BaseUrl": "",
-    "ForceToUseFakeDocument": false
+    "UsePredefinedReports": false
   },
   "PdfViewer": {
     "ThumbnailBaseScale": 0.75,

EnvelopeGenerator.ReceiverUI/wwwroot/css/app.css

@@ -365,4 +365,75 @@ article {
 
 .receiver-footer__sep {
     opacity: 0.4;
-}
+}
+
+/* ── Language Selector (Footer) ──────────────────────────────────────────── */
+.language-selector {
+    position: relative;
+    display: inline-block;
+}
+
+.language-selector__trigger {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    padding: 0.25rem 0.5rem;
+    background: rgba(255, 255, 255, 0.1);
+    border: 1px solid rgba(255, 255, 255, 0.2);
+    border-radius: 4px;
+    color: rgba(255, 255, 255, 0.9);
+    cursor: pointer;
+    font-size: 1rem;
+    transition: all 0.2s ease;
+}
+
+.language-selector__trigger:hover {
+    background: rgba(255, 255, 255, 0.15);
+    border-color: rgba(255, 255, 255, 0.3);
+}
+
+.language-selector__arrow {
+    font-size: 0.6rem;
+    transition: transform 0.2s ease;
+    opacity: 0.7;
+}
+
+.language-selector__dropdown {
+    position: absolute;
+    bottom: calc(100% + 0.5rem);
+    right: 0;
+    background: white;
+    border: 1px solid #ddd;
+    border-radius: 6px;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+    min-width: 160px;
+    z-index: 1000;
+    overflow: hidden;
+}
+
+.language-selector__option {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    width: 100%;
+    padding: 0.65rem 1rem;
+    background: white;
+    border: none;
+    color: #333;
+    cursor: pointer;
+    font-size: 0.9rem;
+    transition: background-color 0.2s ease;
+    text-align: left;
+}
+
+.language-selector__option:hover {
+    background-color: #f5f5f5;
+}
+
+.language-selector__option .fi {
+    font-size: 1.25rem;
+}
+
+.language-selector__option span:last-child {
+    font-weight: 500;
+}

EnvelopeGenerator.ReceiverUI/wwwroot/css/sender-page.css

@@ -0,0 +1,297 @@
+.sender-dashboard-layout {
+    display: flex;
+    flex-direction: column;
+    height: 100vh;
+    overflow: hidden;
+    background: linear-gradient(135deg, #1e3c72 0%, #2a5298 50%, #7e22ce 100%);
+}
+
+.sender-action-bar {
+    background: rgba(255, 255, 255, 0.95);
+    backdrop-filter: blur(20px);
+    border-bottom: 3px solid rgba(126, 34, 206, 0.3);
+    padding: 1rem 2rem;
+    flex-shrink: 0;
+    box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
+}
+
+.sender-action-bar__inner {
+    max-width: 1600px;
+    margin: 0 auto;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 1.5rem;
+}
+
+.sender-title-section {
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+}
+
+.sender-logo svg {
+    filter: drop-shadow(0 2px 4px rgba(126, 34, 206, 0.3));
+    color: #7e22ce;
+}
+
+.sender-title {
+    font-size: 1.25rem;
+    font-weight: 700;
+    color: #1e293b;
+    letter-spacing: -0.025em;
+}
+
+.sender-toolbar {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    flex-wrap: wrap;
+}
+
+.sender-btn {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.625rem 1.125rem;
+    background: linear-gradient(135deg, rgba(126, 34, 206, 0.05) 0%, rgba(42, 82, 152, 0.05) 100%);
+    border: 1px solid rgba(126, 34, 206, 0.2);
+    border-radius: 8px;
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: #1e293b;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    white-space: nowrap;
+}
+
+    .sender-btn:hover:not(:disabled) {
+        background: linear-gradient(135deg, rgba(126, 34, 206, 0.1) 0%, rgba(42, 82, 152, 0.1) 100%);
+        border-color: rgba(126, 34, 206, 0.4);
+        transform: translateY(-1px);
+        box-shadow: 0 4px 12px rgba(126, 34, 206, 0.2);
+    }
+
+    .sender-btn:disabled {
+        opacity: 0.4;
+        cursor: not-allowed;
+        background: rgba(0, 0, 0, 0.02);
+        border-color: rgba(0, 0, 0, 0.1);
+    }
+
+.sender-btn--primary {
+    background: linear-gradient(135deg, #7e22ce 0%, #2a5298 100%);
+    border-color: transparent;
+    color: white;
+}
+
+    .sender-btn--primary:hover:not(:disabled) {
+        background: linear-gradient(135deg, #6b1cb0 0%, #1e3a72 100%);
+        transform: translateY(-1px);
+        box-shadow: 0 4px 16px rgba(126, 34, 206, 0.3);
+    }
+
+.sender-btn--danger {
+    background: linear-gradient(135deg, rgba(239, 68, 68, 0.08) 0%, rgba(220, 38, 38, 0.08) 100%);
+    border-color: rgba(239, 68, 68, 0.3);
+    color: #dc2626;
+}
+
+    .sender-btn--danger:hover:not(:disabled) {
+        background: linear-gradient(135deg, #ef4444 0%, #dc2626 100%);
+        border-color: transparent;
+        color: white;
+    }
+
+.sender-btn--logout {
+    padding: 0.5rem;
+    min-width: 38px;
+}
+
+.sender-content {
+    flex: 1;
+    min-height: 0;
+    padding: 1.5rem;
+    position: relative;
+    overflow: auto;
+}
+
+.sender-grid-container {
+    background: rgba(255, 255, 255, 0.98);
+    backdrop-filter: blur(20px);
+    border-radius: 16px;
+    box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25), 0 0 0 1px rgba(255, 255, 255, 0.1);
+    overflow: hidden;
+    position: relative;
+    max-width: 1600px;
+    margin: 0 auto;
+}
+
+    .sender-grid-container::before {
+        content: '';
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        height: 4px;
+        background: linear-gradient(90deg, #7e22ce 0%, #2a5298 100%);
+        z-index: 1;
+        border-radius: 16px 16px 0 0;
+    }
+
+.sender-tabs {
+    display: flex;
+    border-bottom: 2px solid rgba(126, 34, 206, 0.1);
+    padding: 0 2rem;
+    background: rgba(126, 34, 206, 0.02);
+}
+
+.sender-tab {
+    padding: 1rem 1.5rem;
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: #6b7280;
+    background: transparent;
+    border: none;
+    border-bottom: 3px solid transparent;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    white-space: nowrap;
+}
+
+    .sender-tab:hover {
+        color: #7e22ce;
+        background: rgba(126, 34, 206, 0.05);
+    }
+
+.sender-tab--active {
+    color: #7e22ce;
+    border-bottom-color: #7e22ce;
+    background: white;
+}
+
+.sender-grid-wrapper {
+    padding: 1.5rem 2rem 2rem;
+}
+
+/* Hide DevExpress empty cells */
+.dxbl-grid-empty-cell {
+    display: none !important;
+}
+
+.status-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+    padding: 0.25rem 0.625rem;
+    border-radius: 6px;
+    font-size: 0.75rem;
+    font-weight: 600;
+    white-space: nowrap;
+}
+
+.status-badge--partly-signed,
+.status-badge--completed {
+    background: rgba(129, 199, 132, 0.15);
+    color: #2e7d32;
+}
+
+.status-badge--queued,
+.status-badge--sent {
+    background: rgba(255, 183, 77, 0.15);
+    color: #e65100;
+}
+
+.status-badge--deleted,
+.status-badge--rejected,
+.status-badge--withdrawn {
+    background: rgba(229, 115, 115, 0.15);
+    color: #c62828;
+}
+
+.status-badge--created,
+.status-badge--saved {
+    background: rgba(100, 181, 246, 0.15);
+    color: #1565c0;
+}
+
+.status-dot {
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+}
+
+.status-dot--green {
+    background: #81c784;
+}
+
+.status-dot--orange {
+    background: #ffb74d;
+}
+
+.status-dot--red {
+    background: #e57373;
+}
+
+.status-dot--blue {
+    background: #64b5f6;
+}
+
+.receiver-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.25rem;
+    padding: 0.125rem 0.5rem;
+    background: #f3f4f6;
+    border-radius: 4px;
+    font-size: 0.75rem;
+    color: #374151;
+    white-space: nowrap;
+}
+
+.receiver-badge--signed {
+    background: rgba(129, 199, 132, 0.15);
+    color: #2e7d32;
+}
+
+.receiver-badge--unsigned {
+    background: rgba(229, 115, 115, 0.15);
+    color: #c62828;
+}
+
+@@media (max-width: 768px) {
+    .sender-action-bar {
+        padding: 1rem 1.25rem;
+    }
+
+    .sender-action-bar__inner {
+        flex-wrap: wrap;
+    }
+
+    .sender-toolbar {
+        width: 100%;
+        justify-content: flex-start;
+    }
+
+    .sender-title {
+        font-size: 1.125rem;
+    }
+
+    .sender-content {
+        padding: 0.75rem;
+    }
+
+    .sender-grid-wrapper {
+        padding: 1rem;
+    }
+
+    .sender-tabs {
+        padding: 0 1rem;
+        overflow-x: auto;
+    }
+
+    .sender-tab {
+        padding: 0.875rem 1rem;
+        font-size: 0.813rem;
+    }
+}

EnvelopeGenerator.ReceiverUI/wwwroot/index.html

@@ -12,6 +12,7 @@
     <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
     <link href="EnvelopeGenerator.ReceiverUI.styles.css" rel="stylesheet" />
     <link href="css/app.css" rel="stylesheet" />
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/css/flag-icons.min.css" />
     <style type="text/css">
         .splash-screen {
             display: flex;

EnvelopeGenerator.sln

@@ -21,7 +21,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "core", "core", "{9943209E-1
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{134D4164-B291-4E19-99B9-E4FA3AFAB62C}"
 	ProjectSection(SolutionItems) = preProject
-		COPILOT_CONTEXT_EN.md = COPILOT_CONTEXT_EN.md
+		COPILOT_CONTEXT.md = COPILOT_CONTEXT.md
+		FORM_APPLICATION_CONTEXT.md = FORM_APPLICATION_CONTEXT.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{0CBC2432-A561-4440-89BC-671B66A24146}"

FORM_APPLICATION_CONTEXT.md

@@ -0,0 +1,788 @@
+# EnvelopeGenerator.Form – VB.NET Desktop Application Context
+
+## Purpose
+**Legacy Windows Forms application** for envelope creation, management, and signature field placement. Built with **DevExpress components** and **GdPicture14** for PDF manipulation. This application is being **migrated to ReceiverUI + API** architecture.
+
+**Primary Libraries:** DevExpress XtraGrid/XtraEditors, GdPicture14, VB.NET (.NET Framework 4.6.2)
+
+---
+
+## Application Architecture
+
+### Projects Structure
+| Project | Purpose |
+|---|---|
+| **EnvelopeGenerator.Form** | Main WinForms UI (VB.NET) |
+| **EnvelopeGenerator.CommonServices** | Shared services/helpers |
+| **EnvelopeGenerator.Service** | Windows Service (legacy) |
+| **EnvelopeGenerator.BBTests** | Tests |
+
+### Key Forms (Pages)
+
+#### 1. **frmMain.vb** - Envelope Overview (Dashboard)
+**Route Equivalent:** `/sender` (EnvelopeSenderPage.razor)
+
+**Purpose:** Main dashboard showing all envelopes with status filtering.
+
+**Key Features:**
+- **Tab-based layout** with 2+2 tabs:
+  - **Tab 0:** Active Envelopes (not sent/partially signed)
+  - **Tab 1:** Completed Envelopes (signed/rejected/deleted)
+  - **Tab 2:** Reports (Admin only)
+  - **Tab 3:** Additional Reports (Admin only)
+
+**Envelope Status Colors:**
+| Status | Color | Hex Code | Description |
+|---|---|---|---|
+| `EnvelopePartlySigned` | Green | `#81C784` (GREEN_300) | At least one receiver signed |
+| `EnvelopeQueued` / `EnvelopeSent` | Orange | `#FFB74D` (ORANGE_300) | Sent to receivers, awaiting signatures |
+| `EnvelopeCompletelySigned` | Green | `#81C784` (GREEN_300) | All receivers signed |
+| `EnvelopeDeleted` / `EnvelopeWithdrawn` / `EnvelopeRejected` | Red | `#E57373` (RED_300) | Envelope cancelled/rejected |
+
+**Receiver Status Colors (in detail grids):**
+| Status | Color | Hex Code |
+|---|---|---|
+| `Signed` | Green | `#81C784` (GREEN_300) |
+| `Not Signed` | Red | `#E57373` (RED_300) |
+
+**Grid Layouts:**
+
+1. **GridEnvelopes** (Active):
+   - Columns: ID, Title, Status, Created Date, Creator
+   - **Master-Detail:** Expands to show:
+     - **ViewReceivers:** Receiver list with status colors
+     - **ViewHistory:** Envelope history (status changes, emails sent)
+
+2. **GridCompleted** (Completed):
+   - Same structure as GridEnvelopes
+   - **ViewReceiversCompleted** and **ViewHistoryCompleted** detail grids
+
+**Toolbar Actions:**
+| Button | Action | Enabled When |
+|---|---|---|
+| **Create Envelope** | Opens `frmEnvelopeEditor` | Always |
+| **Edit Envelope** | Opens `frmEnvelopeEditor` with selected envelope | Envelope selected & not sent |
+| **Delete Envelope** | Shows `frmRueckruf` (reason dialog) ? deletes | Envelope selected |
+| **Show Document** | Opens PDF in temp folder | Envelope & document selected |
+| **Contact Receiver** | Opens mailto link | Receiver selected |
+| **Resend Invitation** | Resends email to receiver | Receiver selected |
+| **Send Access Code** | Manually sends access code email | Receiver selected & UseAccessCode=true |
+| **Info Mail** | Opens mailto to support team | Receiver selected (for issues) |
+| **2FA Properties** | Shows `frm2Factor_Properties` dialog | Receiver selected & TFA enabled |
+| **Export Report (EB)** | Exports completed envelope result PDF | Completed envelope selected |
+| **Refresh** | Reloads data | Always |
+| **Export to Excel** | Exports current grid to XLSX | Always |
+
+**Auto-Refresh:** Timer refreshes every N seconds (configurable), but **only when `frmEnvelopeEditor` is not open**.
+
+**Persistence:** Grid layouts saved to `{GridViewName}_UserLayout.xml` in user AppData folder.
+
+---
+
+#### 2. **frmEnvelopeEditor.vb** - Envelope Creation/Edit
+**Route Equivalent:** `/sender/envelope/{id}` (future)
+
+**Purpose:** Create or edit envelope details, add documents, manage receivers.
+
+**Workflow:**
+1. **On New Envelope:** Opens `frmEnvelopeMainData` popup **first** (title, type, settings)
+2. **After popup OK:** Main editor loads
+3. **Add Document:** Single PDF file (via Open Dialog or Drag & Drop)
+4. **Add Receivers:** Grid with auto-complete from previous emails
+5. **Edit Fields:** Opens `frmFieldEditor` for signature field placement
+6. **Send Envelope:** Validates and sends invitations
+
+**UI Layout:**
+- **Top Ribbon:** DevExpress ribbon with actions
+- **Left Panel:** Document list (thumbnail + details)
+- **Right Panel:** Receiver list (name, email, access code, phone)
+- **Bottom Bar:** Envelope ID, Creator Email, Info messages
+
+**Ribbon Actions:**
+| Button | Action | Enabled When |
+|---|---|---|
+| **Add File** | Opens file dialog | No document added |
+| **Merge Files** | Opens `frmOrderFiles` to concatenate PDFs | No document added |
+| **Delete File** | Removes document | Document selected |
+| **Show File** | Opens PDF in default viewer | Document selected |
+| **Edit Fields** | Opens `frmFieldEditor` | Document + receivers exist |
+| **Edit Data** | Opens `frmEnvelopeMainData` | Always |
+| **Save** | Saves envelope without validation | Always |
+| **Send Envelope** | Validates & sends invitations | Document + receivers exist |
+| **Cancel** | Closes with save prompt | Always |
+| **Delete Receiver** | Removes receiver from list | Receiver selected |
+
+**Receiver Grid:**
+- **Columns:** Name, Email, Access Code, Phone (if TFA enabled)
+- **Auto-complete:** Email field suggests previous receivers
+- **Validation:** Email format, Phone format (+49... for TFA)
+- **Access Code:** Auto-generated on email entry (if UseAccessCode=true)
+- **Color Assignment:** Each receiver gets a unique color (for signature fields)
+
+**Document Grid:**
+- **Single file only** (currently limited to 1 PDF)
+- **Thumbnail:** Generated via GdPicture14
+- **Page Count:** Displayed
+
+**Drag & Drop:**
+- Drop PDF files directly onto form
+- Only 1 file allowed
+- Visual feedback (red bar if >1 file)
+
+**Validation:**
+- Title required
+- Message required
+- At least 1 document
+- At least 1 receiver
+- Valid email addresses
+- Valid phone numbers (if TFA enabled)
+- Signature fields exist for each receiver (before sending)
+
+---
+
+#### 3. **frmEnvelopeMainData.vb** - Envelope Settings Popup
+**Route Equivalent:** Part of `/sender/envelope/{id}` (inline in ReceiverUI)
+
+**Purpose:** Configure envelope metadata and behavior. **Shown as modal popup** before main editor.
+
+**Fields:**
+
+| Field | Type | Description |
+|---|---|---|
+| **Title** | Text | Envelope title (required) |
+| **Envelope Type** | Dropdown | Template (ContractType, Language, defaults) |
+| **Language** | Dropdown | de/en |
+| **Use Access Code** | Checkbox | Require 6-digit code for signing |
+| **2FA Enabled** | Checkbox | Require SMS verification (forces Access Code ON) |
+| **Certification Type** | Dropdown | Basic / Advanced / Qualified |
+| **Final Email to Creator** | Dropdown | No / OnComplete / OnCompleteOrReject |
+| **Final Email to Receivers** | Dropdown | No / OnComplete / OnCompleteOrReject |
+| **Send Reminder Emails** | Checkbox | Auto-send reminders |
+| **First Reminder Days** | Number | Days before first reminder |
+| **Reminder Interval Days** | Number | Days between reminders |
+| **Expires When Days** | Number | Days until envelope expires |
+| **Expires Warning Days** | Number | Days before expiry to warn |
+
+**Layout:**
+- **Compact mode:** Only Title, Type, Language visible
+- **Expanded mode:** Click "All Options" to show reminder/expiry settings
+
+**Behavior:**
+- **On Type Selection:** Auto-fills all settings from template
+- **On 2FA Enable:** Forces "Use Access Code" ON and disables checkbox
+- **On New Envelope:** Shows before main editor
+- **On Edit Envelope:** Opens as separate dialog, Type field read-only
+
+**Validation:** Title is required (red border via Adorner).
+
+---
+
+#### 4. **frmFieldEditor.vb** - Signature Field Placement
+**Route Equivalent:** `/sender/envelope/{id}/fields` (future, or inline in editor)
+
+**Purpose:** Place signature fields on PDF pages using **GdPicture14** viewer with annotations.
+
+**UI Layout:**
+- **Left:** PDF Viewer (GdViewer) with annotation tools
+- **Right:** Thumbnail navigator (ThumbnailEx2)
+- **Top:** Toolbar with receiver selector and actions
+
+**Toolbar:**
+| Button | Action |
+|---|---|
+| **Receiver Selector** | Popup menu with receiver names (colored circles) |
+| **Add Signature** | Draws new signature annotation |
+| **Delete** | Removes selected annotation |
+| **Save** | Saves signature fields to database |
+
+**Signature Field Details:**
+- **Size:** 1.77" × 1.96" (4.5cm × 5cm) - **FIXED SIZE**
+- **Color:** Matches receiver color (from grid assignment)
+- **Label:** "SIGNATUR" (or localized "Signature")
+- **Position:** Draggable on PDF canvas
+- **Database Format:** Coordinates stored in **INCHES** (GdPicture native)
+
+**Coordinate System:**
+- **Origin:** Top-left corner
+- **Units:** Inches (not points or pixels)
+- **Axes:** X right, Y down
+- **Storage:** Direct INCHES values (no conversion)
+
+**Evidence from Code:**
+```vb
+Private Const SIGNATURE_WIDTH As Single = 1.77   ' inches
+Private Const SIGNATURE_HEIGHT As Single = 1.96  ' inches
+
+Sub LoadAnnotation(pElement As DocReceiverElement, ...)
+    oAnnotation.Left = CSng(pElement.X)    ' Direct INCHES assignment
+    oAnnotation.Top = CSng(pElement.Y)
+End Sub
+```
+
+**Multi-Receiver Support:**
+- **Receiver switcher:** Click receiver name in popup menu
+- **Current receiver:** Highlighted in toolbar (name + colored circle)
+- **Other receivers' fields:** Shown semi-transparent (30% opacity), not selectable
+- **Save:** Saves current receiver's fields, switches receiver, reloads all annotations
+
+**Annotation Behavior:**
+- **New annotation:** User clicks "Add Signature" ? draws interactive annotation ? auto-sized to 1.77×1.96
+- **Existing annotation:** Loaded from database, locked size (can move but not resize)
+- **Styling:** Filled rectangle with centered text "SIGNATUR"
+- **Validation:** No resize, no text edit, no rotation
+
+**Unsaved Changes Prompt:**
+- On form close: "There are unsaved changes. Save? Yes/No/Cancel"
+- Yes ? Saves ? Closes
+- No ? Discards ? Closes
+- Cancel ? Stays open
+
+---
+
+#### 5. **frmRueckruf.vb** - Delete Reason Dialog
+**Route Equivalent:** Inline confirmation in ReceiverUI
+
+**Purpose:** Capture reason for envelope deletion/withdrawal.
+
+**Fields:**
+- **Envelope ID** (display only)
+- **Envelope Title** (display only)
+- **Reason** (required text box)
+
+**Buttons:**
+- **OK:** Confirms deletion with reason
+- **Cancel:** Cancels operation
+
+**Global Variables:**
+```vb
+Public CurrentEnvelopID As Long
+Public CurrentEnvelopetitle As String
+Public Shared Continue_Reject As Boolean = False
+Public Shared Reject_reason As String = ""
+```
+
+---
+
+#### 6. **frm2Factor_Properties.vb** - 2FA Management
+**Route Equivalent:** `/admin/2fa/{email}` (future admin panel)
+
+**Purpose:** View/manage 2FA settings for a receiver.
+
+**Fields:**
+- **Email Address** (display only)
+- **TOTP Secret Key** (display only)
+- **Registration Deadline** (display only)
+
+**Usage:** Admin tool to debug 2FA issues or reset TOTP secrets.
+
+---
+
+#### 7. **frmOrderFiles.vb** - PDF Merge Tool
+**Route Equivalent:** Inline in ReceiverUI (future)
+
+**Purpose:** Select multiple PDFs and merge them into a single document.
+
+**UI:**
+- **File list:** Selected PDFs
+- **Up/Down buttons:** Reorder files
+- **Add/Remove buttons:** Manage list
+
+**Merge Logic:**
+- Uses GdPicture14 `MergeDocuments()`
+- Output: Single PDF in temp folder
+- Auto-loaded as envelope document
+
+---
+
+## Data Models (Controllers)
+
+### EnvelopeListController
+**Purpose:** Load envelope lists for dashboard grids.
+
+**Methods:**
+- `ListEnvelopes()` ? Active envelopes (not completed)
+- `ListCompleted()` ? Completed envelopes (signed/rejected/deleted)
+- `DeleteEnvelope(envelope, reason)` ? Soft delete with reason
+- `GetPieChart()` ? DevExpress ChartControl (not used)
+- `GetEnvelopeReceiverAddresses(userId)` ? List of previous receiver emails (for auto-complete)
+
+---
+
+### EnvelopeEditorController
+**Purpose:** Manage envelope CRUD and document/receiver operations.
+
+**Key Methods:**
+
+| Method | Purpose |
+|---|---|
+| `CreateDocument(filePath)` | Imports PDF, extracts pages/thumbnail, saves to DB |
+| `DeleteDocument(document)` | Removes document from envelope |
+| `SaveReceivers(envelope, receivers)` | Saves/updates receivers with access codes |
+| `DeleteReceiver(receiver)` | Removes receiver (checks if fields exist) |
+| `ElementsExist(receiverId)` | Checks if signature fields exist for receiver |
+| `SaveEnvelope()` | Persists envelope to database |
+| `SendEnvelope()` | Validates, queues emails, sends invitations |
+| `ValidateEnvelopeForSending(errors)` | Checks all receivers have signature fields |
+| `GetLastNameByEmailAdress(email)` | Returns previous name for email (auto-fill) |
+| `GetLastPhoneByEmailAdress(email)` | Returns previous phone for email (auto-fill) |
+| `DeleteEnvelopeFromDisk(envelope)` | Cleans up temp files |
+
+**ActionService Methods:**
+- `ResendReceiver(envelope, receiver)` ? Resends invitation email
+- `ManuallySendAccessCode(envelope, receiver)` ? Sends access code email
+
+---
+
+### FieldEditorController
+**Purpose:** Manage signature field annotations (DocReceiverElement).
+
+**Key Methods:**
+
+| Method | Purpose |
+|---|---|
+| `LoadElements()` | Loads all signature fields from database |
+| `AddOrUpdateElement(annotation, orientation)` | Converts GdPicture annotation ? DocReceiverElement |
+| `SaveElements(receiverId)` | Persists signature fields for receiver |
+| `DeleteElement(element)` | Removes signature field |
+| `GetElement(annotation)` | Finds element by annotation tag |
+| `GetElementInfo(tag)` | Parses annotation tag (receiverId\|page\|guid) |
+
+**Annotation Tag Format:**
+```
+"{receiverId}|{page}|{elementId}"
+Example: "42|1|-1"  (receiver 42, page 1, unsaved)
+Example: "42|1|137" (receiver 42, page 1, element ID 137)
+```
+
+**Element Coordinate Conversion:**
+```vb
+' Database stores INCHES directly (GdPicture native)
+Sub AddOrUpdateElement(annotation, orientation)
+    element.X = annotation.Left        ' INCHES
+    element.Y = annotation.Top         ' INCHES
+    element.Width = annotation.Width   ' INCHES
+    element.Height = annotation.Height ' INCHES
+    element.Page = currentPage
+End Sub
+```
+
+---
+
+## Migration to ReceiverUI + API
+
+### Mapping Table
+
+| Form Feature | ReceiverUI Equivalent | Status |
+|---|---|---|
+| **frmMain** (Envelope list) | `/sender` (EnvelopeSenderPage.razor) | ? Exists |
+| Tab 0: Active Envelopes | `/sender` default view | ? Grid with filters |
+| Tab 1: Completed Envelopes | `/sender` with status filter | ? Same grid |
+| Status colors (Green/Orange/Red) | CSS classes `.status-signed`, `.status-pending`, etc. | ?? **Needs implementation** |
+| Master-detail grids (Receivers/History) | Expandable rows or modal dialogs | ?? **Needs implementation** |
+| Toolbar: Create Envelope | Button ? `/sender/envelope/new` | ?? **Needs implementation** |
+| Toolbar: Edit Envelope | Button ? `/sender/envelope/{id}` | ?? **Needs implementation** |
+| Toolbar: Delete Envelope | Button ? Shows delete reason modal | ?? **Needs implementation** |
+| Toolbar: Show Document | Downloads PDF | ?? **Needs implementation** |
+| Toolbar: Contact Receiver | `mailto:` link | ?? **Needs implementation** |
+| Toolbar: Resend Invitation | API call ? refresh grid | ?? **Needs implementation** |
+| Toolbar: Export Excel | Download XLSX | ?? **Needs implementation** |
+| Auto-refresh timer | SignalR or polling | ?? **Needs implementation** |
+| Grid layout persistence | LocalStorage | ?? **Needs implementation** |
+| **frmEnvelopeEditor** | `/sender/envelope/{id}` | ? **Not implemented** |
+| ? **frmEnvelopeMainData** popup | Inline form section or stepper | ? **Not implemented** |
+| Document upload (Drag & Drop) | Blazor InputFile with drag zone | ?? **Needs implementation** |
+| Receiver grid (auto-complete) | DevExpress Blazor Grid with lookup | ?? **Needs implementation** |
+| Merge PDFs (frmOrderFiles) | Client-side PDF.js or server-side | ?? **Needs implementation** |
+| **frmFieldEditor** | `/sender/envelope/{id}/fields` or inline | ? **Not implemented** |
+| GdPicture PDF viewer | PDF.js + canvas overlay (like EnvelopeReceiverPage) | ?? **Partial (receiver side only)** |
+| Signature field placement | Drag & drop signature boxes on canvas | ? **Not implemented** |
+| Receiver color coding | CSS variables + signature field borders | ? **Not implemented** |
+| Multi-receiver switcher | Dropdown or tabs | ? **Not implemented** |
+| Thumbnail navigator | PDF.js thumbnail sidebar (like receiver) | ?? **Exists for receiver** |
+| Save signature fields | API POST `/api/Envelope/{id}/Elements` | ? **Not implemented** |
+| **frm2Factor_Properties** | Admin panel `/admin/2fa/{email}` | ? **Not implemented** |
+| **frmRueckruf** (Delete reason) | Modal dialog in EnvelopeSenderPage | ?? **Needs implementation** |
+
+---
+
+## Critical Implementation Notes
+
+### 1. **Coordinate System Consistency**
+**Database (Form App):** INCHES (GdPicture native)  
+**ReceiverUI (PDF.js):** Pixels on canvas  
+**Conversion Required:**
+```csharp
+// Sender side (placing fields):
+float xInches = canvasPixelX / (canvasWidth / pageWidthInches);
+float yInches = canvasPixelY / (canvasHeight / pageHeightInches);
+
+// Receiver side (displaying fields):
+float canvasX = (xInches / pageWidthInches) * canvasWidth;
+float canvasY = (yInches / pageHeightInches) * canvasHeight;
+```
+
+**A4 Page Dimensions:**
+- Width: 8.27" = 595pt
+- Height: 11.69" = 842pt
+
+---
+
+### 2. **Status Color System**
+Form app uses **DevExpress CustomDrawCell** event for row coloring. ReceiverUI should use:
+
+```css
+/* Envelope status colors */
+.envelope-row.status-partly-signed { background-color: #81C784; } /* GREEN_300 */
+.envelope-row.status-queued,
+.envelope-row.status-sent { background-color: #FFB74D; } /* ORANGE_300 */
+.envelope-row.status-completed { background-color: #81C784; } /* GREEN_300 */
+.envelope-row.status-deleted,
+.envelope-row.status-rejected { background-color: #E57373; } /* RED_300 */
+
+/* Receiver status colors */
+.receiver-row.signed { background-color: #81C784; }
+.receiver-row.unsigned { background-color: #E57373; }
+```
+
+---
+
+### 3. **Master-Detail Grid Pattern**
+Form app uses **nested GridViews** (ViewReceivers, ViewHistory). ReceiverUI options:
+
+**Option A:** DevExpress Blazor Grid with master-detail template
+```razor
+<DxGrid Data="@Envelopes">
+    <DxGridDataColumn FieldName="Title" />
+    <DxGridDetailRowTemplate>
+        <DxGrid Data="@context.EnvelopeReceivers">
+            <DxGridDataColumn FieldName="Name" />
+            <DxGridDataColumn FieldName="Status" />
+        </DxGrid>
+    </DxGridDetailRowTemplate>
+</DxGrid>
+```
+
+**Option B:** Click row ? show modal with receivers/history
+```razor
+<DxGrid @ref="grid" Data="@Envelopes" RowClick="OnRowClick">
+...
+</DxGrid>
+
+<DxPopup @bind-Visible="showDetailPopup">
+    <DxGrid Data="@selectedEnvelope.EnvelopeReceivers">
+    ...
+    </DxGrid>
+</DxPopup>
+```
+
+---
+
+### 4. **Signature Field Editor Architecture**
+
+**Form App:**
+- GdPicture14 native annotations
+- Fixed size (1.77×1.96 inches)
+- Color-coded per receiver
+- Draggable, non-resizable
+
+**ReceiverUI Equivalent:**
+- PDF.js canvas + HTML overlay (like receiver signature buttons)
+- `<div class="signature-field-placeholder">` positioned absolutely
+- Drag & drop with JS (`onmousedown`, `onmousemove`, `onmouseup`)
+- Snap to grid (optional)
+- Store coordinates in INCHES (convert from pixels)
+
+**Example HTML Overlay:**
+```html
+<div class="pdf-signature-layer">
+    <div class="signature-field" 
+         data-receiver-id="42" 
+         data-page="1"
+         style="position: absolute; left: 200px; top: 300px; width: 177px; height: 196px; background: rgba(255,0,0,0.3); border: 2px dashed red;">
+        Receiver: John Doe
+    </div>
+</div>
+```
+
+**JS Dragging Logic:**
+```javascript
+function makeSignatureFieldDraggable(element) {
+    let offsetX, offsetY;
+    element.onmousedown = (e) => {
+        offsetX = e.clientX - element.offsetLeft;
+        offsetY = e.clientY - element.offsetTop;
+        document.onmousemove = (e) => {
+            element.style.left = (e.clientX - offsetX) + 'px';
+            element.style.top = (e.clientY - offsetY) + 'px';
+        };
+        document.onmouseup = () => {
+            document.onmousemove = null;
+            saveFieldPosition(element); // Convert px ? inches ? API
+        };
+    };
+}
+```
+
+---
+
+### 5. **Auto-Complete Receiver Email**
+Form app uses **DevExpress ComboBox** with `AllReceiverEmails` list. ReceiverUI options:
+
+**Option A:** DevExpress Blazor TagBox with remote data
+```razor
+<DxTagBox Data="@previousEmails" 
+          @bind-Values="@selectedEmails"
+          AllowCustomTags="true"
+          ClearButtonDisplayMode="Auto">
+</DxTagBox>
+```
+
+**Option B:** HTML5 datalist
+```razor
+<input list="receiver-emails" @bind="newReceiverEmail" />
+<datalist id="receiver-emails">
+    @foreach (var email in previousEmails) {
+        <option value="@email" />
+    }
+</datalist>
+```
+
+---
+
+### 6. **Drag & Drop File Upload**
+Form app uses **WinForms DragDrop** events. ReceiverUI equivalent:
+
+```razor
+<div class="file-drop-zone" 
+     @ondragover="HandleDragOver" 
+     @ondragover:preventDefault 
+     @ondrop="HandleDrop" 
+     @ondrop:preventDefault>
+    <p>Drop PDF here or click to browse</p>
+    <InputFile OnChange="HandleFileSelected" accept=".pdf" />
+</div>
+
+@code {
+    async Task HandleDrop(DragEventArgs e) {
+        var files = e.DataTransfer.Files;
+        if (files.Length > 1) {
+            errorMessage = "Only one file allowed";
+            return;
+        }
+        await UploadDocument(files[0]);
+    }
+}
+```
+
+---
+
+### 7. **PDF Merge (frmOrderFiles)**
+Form app uses **GdPicture14 MergeDocuments**. ReceiverUI options:
+
+**Option A:** Server-side merge (iText7 or PDFSharp)
+```csharp
+[HttpPost("api/Document/Merge")]
+public async Task<IActionResult> MergePDFs([FromForm] List<IFormFile> files) {
+    using var outputStream = new MemoryStream();
+    using var pdfDocument = new PdfDocument(new PdfWriter(outputStream));
+    
+    foreach (var file in files) {
+        using var inputStream = file.OpenReadStream();
+        using var sourcePdf = new PdfDocument(new PdfReader(inputStream));
+        sourcePdf.CopyPagesTo(1, sourcePdf.GetNumberOfPages(), pdfDocument);
+    }
+    
+    pdfDocument.Close();
+    return File(outputStream.ToArray(), "application/pdf", "merged.pdf");
+}
+```
+
+**Option B:** Client-side merge (PDF-lib.js in Blazor JS interop)
+```javascript
+async function mergePDFs(fileDataUrls) {
+    const pdfDoc = await PDFDocument.create();
+    for (const dataUrl of fileDataUrls) {
+        const existingPdfBytes = await fetch(dataUrl).then(res => res.arrayBuffer());
+        const pdf = await PDFDocument.load(existingPdfBytes);
+        const copiedPages = await pdfDoc.copyPages(pdf, pdf.getPageIndices());
+        copiedPages.forEach(page => pdfDoc.addPage(page));
+    }
+    const pdfBytes = await pdfDoc.save();
+    return pdfBytes;
+}
+```
+
+---
+
+## Form App Workflow Summary
+
+### New Envelope Workflow (Sender)
+```
+1. Click "Create Envelope" in frmMain
+   ?
+2. frmEnvelopeMainData popup opens
+   - Enter Title (required)
+   - Select Envelope Type (loads defaults)
+   - Configure settings (Access Code, 2FA, Language, etc.)
+   - Click OK
+   ?
+3. frmEnvelopeEditor opens
+   - Add PDF document (drag & drop or browse)
+   - Add receivers (email auto-complete, access code auto-gen)
+   - Click "Edit Fields"
+   ?
+4. frmFieldEditor opens
+   - Select receiver from dropdown (colored circles)
+   - Click "Add Signature" ? draw box on PDF
+   - Drag to position (1.77×1.96 inches, fixed size)
+   - Repeat for each receiver
+   - Click "Save"
+   ?
+5. Back to frmEnvelopeEditor
+   - Click "Send Envelope"
+   - Validation:
+     * Title exists
+     * Message exists
+     * Document exists
+     * Receivers exist
+     * All receivers have signature fields
+   - Confirmation: "Do you want to start the signature process now?"
+   - Click Yes ? Envelope status = EnvelopeSent
+   ?
+6. Emails sent to receivers with invitation links
+   ?
+7. frmMain refreshes, envelope moves to "Sent" (orange color)
+```
+
+### Receiver Signing Workflow (External)
+```
+1. Receiver clicks link in email
+   ?
+2. Web browser opens (EnvelopeGenerator.Web or ReceiverUI)
+   - If UseAccessCode=true: Enter 6-digit code
+   - If TFA=true: Enter SMS code
+   ?
+3. PDF viewer loads with signature fields highlighted
+   - Click "Sign" button on each field
+   - Draw/type/upload signature
+   - Enter name, position, place
+   ?
+4. Submit ? Backend stamps signature on PDF
+   ?
+5. Envelope status updates:
+   - First signature ? EnvelopePartlySigned (green)
+   - Last signature ? EnvelopeCompletelySigned (green)
+   ?
+6. Final emails sent (if configured):
+   - To creator: "All receivers signed"
+   - To receivers: "Envelope completed, download PDF"
+```
+
+---
+
+## Missing Features in ReceiverUI (To Implement)
+
+### High Priority
+1. ? **Envelope list grid** (`/sender`) with status colors
+2. ? **Master-detail grids** (receivers/history)
+3. ? **Create/Edit envelope form** (`/sender/envelope/{id}`)
+4. ? **Envelope settings popup/stepper** (title, type, options)
+5. ? **Document upload** (drag & drop, single PDF)
+6. ? **Receiver management** (add/edit/delete with auto-complete)
+7. ? **Signature field editor** (PDF.js + draggable overlays)
+8. ? **Send envelope** (validation + API call)
+
+### Medium Priority
+9. ? **Delete envelope** (with reason modal)
+10. ? **Resend invitation** (per receiver)
+11. ? **Show document** (PDF preview)
+12. ? **Contact receiver** (mailto link)
+13. ? **Export to Excel** (grid data)
+14. ? **PDF merge tool** (multi-file select + merge)
+15. ? **Grid layout persistence** (LocalStorage)
+
+### Low Priority
+16. ? **2FA management** (admin panel)
+17. ? **Reports tab** (statistics, admin only)
+18. ? **Auto-refresh** (SignalR or polling)
+19. ? **Ghost mode** (impersonate user, admin only)
+20. ? **Log file export** (debug tool)
+
+---
+
+## Data Flow Diagram
+
+```
+????????????????????????
+?   frmMain            ?  ? Envelope list (Active/Completed tabs)
+?   (Dashboard)        ?  ? Status colors (Green/Orange/Red)
+????????????????????????  ? Master-detail grids (Receivers/History)
+          ?                ? Toolbar actions (Create/Edit/Delete/Send)
+          ? Click "Create"
+          ?
+????????????????????????
+? frmEnvelopeMainData  ?  ? Popup: Title, Type, Settings
+? (Settings Popup)     ?  ? Dropdowns: Language, Certification, Final Emails
+????????????????????????  ? Checkboxes: Access Code, 2FA, Reminders
+          ? Click OK
+          ?
+????????????????????????
+? frmEnvelopeEditor    ?  ? Document upload (drag & drop)
+? (Main Editor)        ?  ? Receiver grid (email auto-complete)
+????????????????????????  ? Merge PDFs button
+          ? Click "Edit Fields"
+          ?
+????????????????????????
+? frmFieldEditor       ?  ? GdPicture PDF viewer
+? (Signature Placer)   ?  ? Receiver selector (colored circles)
+????????????????????????  ? Draggable signature boxes (1.77×1.96")
+          ? Click "Save"
+          ?
+????????????????????????
+? Database             ?  ? DocReceiverElement (X, Y, Width, Height in INCHES)
+? (TBSIG_ELEMENT)      ?  ? EnvelopeReceiver (Name, Email, Access Code, Phone)
+????????????????????????  ? Envelope (Title, Status, Settings)
+          ? Click "Send Envelope"
+          ?
+????????????????????????
+? Email Service        ?  ? Send invitation emails to receivers
+?                      ?  ? Template: Link + Access Code (if enabled)
+????????????????????????
+          ?
+          ?
+????????????????????????
+? Receiver Web Page    ?  ? PDF.js viewer with signature buttons
+? (EnvelopeReceiverPage)? ? Click button ? Signature popup (draw/type/image)
+????????????????????????  ? Submit ? API stamps signature on PDF
+          ?
+          ?
+????????????????????????
+? Database Update      ?  ? EnvelopeHistory (Signed, Timestamp)
+?                      ?  ? Envelope Status ? PartlySigned / CompletelySigned
+????????????????????????
+          ? All signed?
+          ?
+????????????????????????
+? Final Email Service  ?  ? Send "Completed" email to creator/receivers
+?                      ?  ? Attach signed PDF
+????????????????????????
+```
+
+---
+
+## Key Takeaways for Migration
+
+1. **Tab-based layout** ? Single grid with status filter dropdown
+2. **Status colors** ? CSS classes or inline styles
+3. **Master-detail grids** ? Expandable rows or modal dialogs
+4. **Popup settings form** ? Inline form or stepper UI
+5. **GdPicture PDF viewer** ? PDF.js with canvas overlay
+6. **Signature field dragging** ? HTML5 drag & drop + absolute positioning
+7. **Coordinate system** ? **ALWAYS INCHES** in database, convert to/from pixels for UI
+8. **Receiver colors** ? CSS variables or inline styles
+9. **Auto-complete emails** ? DevExpress TagBox or HTML5 datalist
+10. **PDF merge** ? Server-side (iText7) or client-side (PDF-lib.js)
+
+---
+
+**Last Updated:** Session 20 (Form Application Analysis)