Add YARP reverse proxy for /api routes and API config

Integrate YARP to forward all /api/** requests from the browser to the backend EnvelopeGenerator.API service. Add Yarp.ReverseProxy package, configure proxy routes and clusters in appsettings.json, and register YARP in Program.cs. Add API base URL configuration and register ReceiverApiClient, LocalizationService, and ReceiverAuthState as scoped services to support both server and client scenarios. This improves API/UI separation and authentication handling.

EnvelopeGenerator.API/Controllers/AnnotationController.cs

@@ -1,5 +1,6 @@
 using DigitalData.Core.Abstraction.Application.DTO;
 using DigitalData.Core.Exceptions;
+using EnvelopeGenerator.Application.Common.Dto;
 using EnvelopeGenerator.Application.Common.Extensions;
 using EnvelopeGenerator.Application.Common.Interfaces.Services;
 using EnvelopeGenerator.Application.Common.Notifications.DocSigned;
@@ -7,11 +8,13 @@ using EnvelopeGenerator.Application.EnvelopeReceivers.Queries;
 using EnvelopeGenerator.Application.Histories.Queries;
 using EnvelopeGenerator.Domain.Constants;
 using EnvelopeGenerator.API.Extensions;
+using EnvelopeGenerator.API.Models;
 using MediatR;
 using Microsoft.AspNetCore.Authentication;
 using Microsoft.AspNetCore.Authentication.Cookies;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
+using System.Dynamic;
 
 namespace EnvelopeGenerator.API.Controllers;
 
@@ -115,4 +118,127 @@ public class AnnotationController : ControllerBase
         _logger.LogNotice(histRes.Notices);
         return StatusCode(500, histRes.Messages);
     }
+
+    /// <summary>
+    /// Returns the signature placeholders (id, page, x, y, width, height)
+    /// the authenticated receiver must sign on the current envelope.
+    /// Used by the Blazor receiver UI to render a custom signature overlay
+    /// on top of the DevExpress PDF viewer.
+    /// </summary>
+    [Authorize(Policy = AuthPolicy.Receiver)]
+    [HttpGet("elements")]
+    public async Task<IActionResult> GetElements(CancellationToken cancel)
+    {
+        var signature = User.GetReceiverSignatureOfReceiver();
+        var uuid = User.GetEnvelopeUuidOfReceiver();
+
+        var envelopeReceiver = await _mediator.ReadEnvelopeReceiverAsync(uuid, signature, cancel)
+            ?? throw new NotFoundException("Envelope receiver is not found.");
+
+        var elements = envelopeReceiver.Envelope?.Documents?.FirstOrDefault()?.Elements
+            ?? Enumerable.Empty<Application.Common.Dto.SignatureDto>();
+
+        // Only expose what the overlay needs (no internal columns).
+        var payload = elements
+            .Where(e => e.ReceiverId == envelopeReceiver.ReceiverId)
+            .Select(e => new
+            {
+                id       = e.Id,
+                page     = e.Page,
+                x        = e.X,
+                y        = e.Y,
+                width    = e.Width,
+                height   = e.Height,
+                required = e.Required,
+                tooltip  = e.Tooltip,
+            });
+
+        return Ok(payload);
+    }
+
+    /// <summary>
+    /// Signs the document for the authenticated receiver using a Blazor /
+    /// DevExpress friendly payload (one PNG image per placeholder, plus
+    /// optional position / city per placeholder).
+    ///
+    /// Internally produces a <see cref="PsPdfKitAnnotation"/> wrapping a
+    /// list of <see cref="AnnotationCreateDto"/> entries so that the
+    /// existing notification pipeline (mail / status / annotation persistence)
+    /// is fully reused. The Instant JSON is left blank because the Blazor
+    /// pipeline does not depend on PSPDFKit-side rendering.
+    /// </summary>
+    [Authorize(Policy = AuthPolicy.Receiver)]
+    [HttpPost("blazor")]
+    public async Task<IActionResult> SignBlazor([FromBody] BlazorSignaturePayload payload, CancellationToken cancel)
+    {
+        if (payload is null || payload.Signatures.Count == 0)
+            return BadRequest();
+
+        var signature = User.GetReceiverSignatureOfReceiver();
+        var uuid = User.GetEnvelopeUuidOfReceiver();
+
+        var envelopeReceiver = await _mediator.ReadEnvelopeReceiverAsync(uuid, signature, cancel)
+            ?? throw new NotFoundException("Envelope receiver is not found.");
+
+        if (await _mediator.IsSignedAsync(uuid, signature, cancel))
+            return Problem(statusCode: StatusCodes.Status409Conflict);
+
+        if (await _mediator.AnyHistoryAsync(uuid, new[] { EnvelopeStatus.EnvelopeRejected, EnvelopeStatus.DocumentRejected }, cancel))
+            return Problem(statusCode: StatusCodes.Status423Locked);
+
+        // Build a structured AnnotationCreateDto list out of the lightweight
+        // payload. One DTO per (element, kind) tuple, mirroring how the legacy
+        // PSPDFKit pipeline produced multiple form fields per placeholder.
+        var structured = new List<AnnotationCreateDto>();
+        foreach (var entry in payload.Signatures)
+        {
+            structured.Add(new AnnotationCreateDto
+            {
+                ElementId = entry.ElementId,
+                Name      = $"{entry.ElementId}#signature",
+                Type      = "signature",
+                Value     = entry.SignatureDataUrl,
+            });
+            if (!string.IsNullOrWhiteSpace(entry.Position))
+            {
+                structured.Add(new AnnotationCreateDto
+                {
+                    ElementId = entry.ElementId,
+                    Name      = $"{entry.ElementId}#position",
+                    Type      = "position",
+                    Value     = entry.Position!,
+                });
+            }
+            if (!string.IsNullOrWhiteSpace(entry.City))
+            {
+                structured.Add(new AnnotationCreateDto
+                {
+                    ElementId = entry.ElementId,
+                    Name      = $"{entry.ElementId}#city",
+                    Type      = "city",
+                    Value     = entry.City!,
+                });
+            }
+            structured.Add(new AnnotationCreateDto
+            {
+                ElementId = entry.ElementId,
+                Name      = $"{entry.ElementId}#date",
+                Type      = "date",
+                Value     = entry.SignedAt.ToString("o"),
+            });
+        }
+
+        // No PSPDFKit Instant JSON for the Blazor flow — pass an empty object.
+        var psPdfKitAnnotation = new PsPdfKitAnnotation(new ExpandoObject(), structured);
+
+        var docSignedNotification = await _mediator
+            .ReadEnvelopeReceiverAsync(uuid, signature, cancel)
+            .ToDocSignedNotification(psPdfKitAnnotation)
+            ?? throw new NotFoundException("Envelope receiver is not found.");
+
+        await _mediator.PublishSafely(docSignedNotification, cancel);
+        await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);
+
+        return Ok();
+    }
 }

EnvelopeGenerator.API/Controllers/ReceiverAuthController.cs

@@ -0,0 +1,407 @@
+using EnvelopeGenerator.API.Models;
+using EnvelopeGenerator.Application.Common.Extensions;
+using EnvelopeGenerator.Application.Common.Interfaces.Services;
+using EnvelopeGenerator.Application.EnvelopeReceivers.Queries;
+using EnvelopeGenerator.Domain.Constants;
+using EnvelopeGenerator.API.Extensions;
+using MediatR;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Authentication.Cookies;
+using Microsoft.AspNetCore.Mvc;
+using OtpNet;
+
+namespace EnvelopeGenerator.API.Controllers;
+
+/// <summary>
+/// REST-API für den Empfänger-Authentifizierungs-Flow.
+/// 
+/// Entspricht der Logik in EnvelopeGenerator.Web.Controllers.EnvelopeController
+/// (Main + LogInEnvelope), aber gibt JSON statt Views zurück.
+/// 
+/// Der Blazor-Client (ReceiverUI) ruft diese Endpunkte auf.
+/// 
+/// FLOW:
+/// 1. Client ruft GET  /api/receiverauth/{key}/status     → Prüft Status
+/// 2. Client ruft POST /api/receiverauth/{key}/access-code → Sendet AccessCode
+/// 3. Client ruft POST /api/receiverauth/{key}/tfa         → Sendet TFA-Code
+/// 
+/// Nach erfolgreicher Authentifizierung wird ein Cookie gesetzt (SignInEnvelopeAsync).
+/// Danach kann der Client die Dokument-Daten über die bestehenden Envelope-Endpunkte laden.
+/// </summary>
+[Route("api/[controller]")]
+[ApiController]
+public class ReceiverAuthController : ControllerBase
+{
+    private readonly ILogger<ReceiverAuthController> _logger;
+    private readonly IMediator _mediator;
+    private readonly IEnvelopeReceiverService _envRcvService;
+    private readonly IEnvelopeHistoryService _historyService;
+    private readonly IAuthenticator _authenticator;
+    private readonly IReceiverService _rcvService;
+    private readonly IEnvelopeSmsHandler _envSmsHandler;
+
+    public ReceiverAuthController(
+        ILogger<ReceiverAuthController> logger,
+        IMediator mediator,
+        IEnvelopeReceiverService envRcvService,
+        IEnvelopeHistoryService historyService,
+        IAuthenticator authenticator,
+        IReceiverService rcvService,
+        IEnvelopeSmsHandler envSmsHandler)
+    {
+        _logger = logger;
+        _mediator = mediator;
+        _envRcvService = envRcvService;
+        _historyService = historyService;
+        _authenticator = authenticator;
+        _rcvService = rcvService;
+        _envSmsHandler = envSmsHandler;
+    }
+
+    // ══════════════════════════════════════════════════════════════
+    // ENDPUNKT 1: STATUS PRÜFEN
+    // Entspricht: Web.EnvelopeController.Main()
+    // ══════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Prüft den aktuellen Status eines Umschlags für den Empfänger.
+    /// Entscheidet ob: NotFound, Rejected, Signed, AccessCode nötig, oder direkt anzeigen.
+    /// </summary>
+    /// <param name="key">Der EnvelopeReceiver-Key aus der URL (Base64-kodiert)</param>
+    /// <param name="cancel">Cancellation-Token</param>
+    /// <returns>ReceiverAuthResponse mit dem aktuellen Status</returns>
+    [HttpGet("{key}/status")]
+    public async Task<IActionResult> GetStatus([FromRoute] string key, CancellationToken cancel)
+    {
+        try
+        {
+            // ── Key dekodieren ──
+            if (!key.TryDecode(out var decoded))
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            // ── ReadOnly-Links ──
+            if (decoded.GetEncodeType() == EncodeType.EnvelopeReceiverReadOnly)
+            {
+                return Ok(new ReceiverAuthResponse
+                {
+                    Status = "show_document",
+                    ReadOnly = true
+                });
+            }
+
+            // ── EnvelopeReceiver laden (Light-Query: ohne Documents/Elements) ──
+            var er = await _mediator.Send(
+                new ReadEnvelopeReceiverLightQuery { Key = key }, cancel);
+            if (er is null)
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            // ── Abgelehnt? ──
+            var rejRcvrs = await _historyService.ReadRejectingReceivers(er.Envelope!.Id);
+            if (rejRcvrs.Any())
+            {
+                await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);
+                return Ok(new ReceiverAuthResponse
+                {
+                    Status = "rejected",
+                    Title = er.Envelope.Title,
+                    SenderEmail = er.Envelope.User?.Email
+                });
+            }
+
+            // ── Bereits signiert? ──
+            if (await _historyService.IsSigned(
+                    envelopeId: er.Envelope.Id,
+                    userReference: er.Receiver!.EmailAddress))
+            {
+                await HttpContext.SignOutAsync(CookieAuthenticationDefaults.AuthenticationScheme);
+                return Ok(new ReceiverAuthResponse
+                {
+                    Status = "already_signed",
+                    Title = er.Envelope.Title,
+                    SenderEmail = er.Envelope.User?.Email
+                });
+            }
+
+            // ── Kein AccessCode nötig? → Direkt SignIn ──
+            if (!er.Envelope.UseAccessCode)
+            {
+                (string? uuid, string? signature) = decoded.ParseEnvelopeReceiverId();
+                var erSecretRes = await _envRcvService.ReadWithSecretByUuidSignatureAsync(
+                    uuid: uuid!, signature: signature!);
+
+                if (erSecretRes.IsFailed)
+                    return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+                await HttpContext.SignInEnvelopeAsync(erSecretRes.Data, Role.ReceiverFull);
+
+                return Ok(new ReceiverAuthResponse
+                {
+                    Status = "show_document",
+                    Title = er.Envelope.Title,
+                    Message = er.Envelope.Message,
+                    SenderEmail = er.Envelope.User?.Email,
+                    ReadOnly = er.Envelope.ReadOnly
+                });
+            }
+
+            // ── AccessCode nötig ──
+            // HINWEIS: Die E-Mail mit dem AccessCode wird NICHT hier gesendet.
+            // Das passiert bereits im Web-Projekt, wenn der Link generiert wird.
+            // Der Blazor-Flow übernimmt erst NACH dem E-Mail-Versand.
+            bool accessCodeAlreadyRequested = await _historyService.AccessCodeAlreadyRequested(
+                envelopeId: er.Envelope.Id,
+                userReference: er.Receiver.EmailAddress);
+
+            if (!accessCodeAlreadyRequested)
+            {
+                // AccessCode wurde noch nie angefordert — das bedeutet der Empfänger
+                // kommt zum ersten Mal. Wir zeichnen es auf, aber die E-Mail
+                // wurde bereits vom Web-Projekt gesendet.
+                await _historyService.RecordAsync(
+                    er.EnvelopeId, er.Receiver.EmailAddress, EnvelopeStatus.AccessCodeRequested);
+            }
+
+            // ── Prüfe ob der Nutzer bereits eingeloggt ist ──
+            if (User.IsInRole(Role.ReceiverFull))
+            {
+                return Ok(new ReceiverAuthResponse
+                {
+                    Status = "show_document",
+                    Title = er.Envelope.Title,
+                    Message = er.Envelope.Message,
+                    SenderEmail = er.Envelope.User?.Email,
+                    ReadOnly = er.Envelope.ReadOnly
+                });
+            }
+
+            return Ok(new ReceiverAuthResponse
+            {
+                Status = "requires_access_code",
+                Title = er.Envelope.Title,
+                SenderEmail = er.Envelope.User?.Email,
+                TfaEnabled = er.Envelope.TFAEnabled,
+                HasPhoneNumber = er.HasPhoneNumber
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error checking status for key {Key}", key);
+            return StatusCode(500, new ReceiverAuthResponse
+            {
+                Status = "error",
+                ErrorMessage = "Ein unerwarteter Fehler ist aufgetreten."
+            });
+        }
+    }
+
+    // ══════════════════════════════════════════════════════════════
+    // ENDPUNKT 2: ACCESS-CODE PRÜFEN
+    // ══════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Prüft den eingegebenen Zugangscode.
+    /// Bei Erfolg: SignIn oder TFA-Weiterleitung.
+    /// Bei Fehler: Fehlermeldung zurückgeben.
+    /// </summary>
+    [HttpPost("{key}/access-code")]
+    public async Task<IActionResult> SubmitAccessCode(
+        [FromRoute] string key,
+        [FromBody] AccessCodeRequest request,
+        CancellationToken cancel)
+    {
+        try
+        {
+            // ── Key dekodieren + Daten laden ──
+            (string? uuid, string? signature) = key.DecodeEnvelopeReceiverId();
+            if (uuid is null || signature is null)
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            var erSecretRes = await _envRcvService.ReadWithSecretByUuidSignatureAsync(
+                uuid: uuid, signature: signature);
+
+            if (erSecretRes.IsFailed)
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            var erSecret = erSecretRes.Data;
+
+            // ── AccessCode prüfen ──
+            if (erSecret.AccessCode != request.AccessCode)
+            {
+                await _historyService.RecordAsync(
+                    erSecret.EnvelopeId,
+                    erSecret.Receiver!.EmailAddress,
+                    EnvelopeStatus.AccessCodeIncorrect);
+
+                return Unauthorized(new ReceiverAuthResponse
+                {
+                    Status = "requires_access_code",
+                    Title = erSecret.Envelope!.Title,
+                    SenderEmail = erSecret.Envelope.User?.Email,
+                    TfaEnabled = erSecret.Envelope.TFAEnabled,
+                    HasPhoneNumber = erSecret.HasPhoneNumber,
+                    ErrorMessage = "Falscher Zugangscode."
+                });
+            }
+
+            // ── AccessCode korrekt ──
+            await _historyService.RecordAsync(
+                erSecret.EnvelopeId,
+                erSecret.Receiver!.EmailAddress,
+                EnvelopeStatus.AccessCodeCorrect);
+
+            // ── TFA erforderlich? ──
+            if (erSecret.Envelope!.TFAEnabled)
+            {
+                var rcv = erSecret.Receiver;
+                if (rcv.TotpSecretkey is null)
+                {
+                    rcv.TotpSecretkey = _authenticator.GenerateTotpSecretKey();
+                    await _rcvService.UpdateAsync(rcv);
+                }
+
+                await HttpContext.SignInEnvelopeAsync(erSecret, Role.ReceiverTFA);
+
+                if (request.PreferSms)
+                {
+                    var (smsRes, expiration) = await _envSmsHandler.SendTotpAsync(erSecret);
+
+                    return Ok(new ReceiverAuthResponse
+                    {
+                        Status = "requires_tfa",
+                        TfaType = "sms",
+                        TfaExpiration = expiration,
+                        Title = erSecret.Envelope.Title,
+                        SenderEmail = erSecret.Envelope.User?.Email,
+                        HasPhoneNumber = erSecret.HasPhoneNumber
+                    });
+                }
+                else
+                {
+                    return Ok(new ReceiverAuthResponse
+                    {
+                        Status = "requires_tfa",
+                        TfaType = "authenticator",
+                        Title = erSecret.Envelope.Title,
+                        SenderEmail = erSecret.Envelope.User?.Email,
+                        HasPhoneNumber = erSecret.HasPhoneNumber
+                    });
+                }
+            }
+
+            // ── Kein TFA → Direkt SignIn ──
+            await HttpContext.SignInEnvelopeAsync(erSecret, Role.ReceiverFull);
+
+            return Ok(new ReceiverAuthResponse
+            {
+                Status = "show_document",
+                Title = erSecret.Envelope.Title,
+                Message = erSecret.Envelope.Message,
+                SenderEmail = erSecret.Envelope.User?.Email,
+                ReadOnly = erSecret.Envelope.ReadOnly
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error submitting access code for key {Key}", key);
+            return StatusCode(500, new ReceiverAuthResponse
+            {
+                Status = "error",
+                ErrorMessage = "Ein unerwarteter Fehler ist aufgetreten."
+            });
+        }
+    }
+
+    // ══════════════════════════════════════════════════════════════
+    // ENDPUNKT 3: TFA-CODE PRÜFEN
+    // ══════════════════════════════════════════════════════════════
+
+    /// <summary>
+    /// Prüft den TFA-Code (SMS oder Authenticator).
+    /// Setzt voraus, dass der Nutzer bereits mit ReceiverTFA-Rolle eingeloggt ist.
+    /// </summary>
+    [HttpPost("{key}/tfa")]
+    public async Task<IActionResult> SubmitTfaCode(
+        [FromRoute] string key,
+        [FromBody] TfaCodeRequest request,
+        CancellationToken cancel)
+    {
+        try
+        {
+            if (!User.IsInRole(Role.ReceiverTFA))
+                return Unauthorized(new ReceiverAuthResponse
+                {
+                    Status = "requires_access_code",
+                    ErrorMessage = "Bitte zuerst den Zugangscode eingeben."
+                });
+
+            (string? uuid, string? signature) = key.DecodeEnvelopeReceiverId();
+            if (uuid is null || signature is null)
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            var erSecretRes = await _envRcvService.ReadWithSecretByUuidSignatureAsync(
+                uuid: uuid, signature: signature);
+
+            if (erSecretRes.IsFailed)
+                return NotFound(new ReceiverAuthResponse { Status = "not_found" });
+
+            var erSecret = erSecretRes.Data;
+
+            if (erSecret.Receiver!.TotpSecretkey is null)
+            {
+                _logger.LogError("TotpSecretkey is null for receiver {Signature}", signature);
+                return StatusCode(500, new ReceiverAuthResponse
+                {
+                    Status = "error",
+                    ErrorMessage = "TFA-Konfiguration fehlt."
+                });
+            }
+
+            bool codeValid;
+
+            if (request.Type == "sms")
+            {
+                codeValid = _envSmsHandler.VerifyTotp(request.Code, erSecret.Receiver.TotpSecretkey);
+            }
+            else
+            {
+                codeValid = _authenticator.VerifyTotp(
+                    request.Code,
+                    erSecret.Receiver.TotpSecretkey,
+                    window: VerificationWindow.RfcSpecifiedNetworkDelay);
+            }
+
+            if (!codeValid)
+            {
+                return Unauthorized(new ReceiverAuthResponse
+                {
+                    Status = "requires_tfa",
+                    TfaType = request.Type,
+                    Title = erSecret.Envelope!.Title,
+                    SenderEmail = erSecret.Envelope.User?.Email,
+                    HasPhoneNumber = erSecret.HasPhoneNumber,
+                    ErrorMessage = "Falscher Code."
+                });
+            }
+
+            await HttpContext.SignInEnvelopeAsync(erSecret, Role.ReceiverFull);
+
+            return Ok(new ReceiverAuthResponse
+            {
+                Status = "show_document",
+                Title = erSecret.Envelope!.Title,
+                Message = erSecret.Envelope.Message,
+                SenderEmail = erSecret.Envelope.User?.Email,
+                ReadOnly = erSecret.Envelope.ReadOnly
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error submitting TFA code for key {Key}", key);
+            return StatusCode(500, new ReceiverAuthResponse
+            {
+                Status = "error",
+                ErrorMessage = "Ein unerwarteter Fehler ist aufgetreten."
+            });
+        }
+    }
+}

EnvelopeGenerator.API/Models/BlazorSignaturePayload.cs

@@ -0,0 +1,42 @@
+namespace EnvelopeGenerator.API.Models;
+
+/// <summary>
+/// Lightweight payload used by the Blazor receiver UI to submit signatures.
+/// Each entry corresponds to one signature placeholder rendered as an
+/// overlay on top of the DevExpress PDF viewer.
+///
+/// The legacy MVC flow ships a full PSPDFKit InstantJSON payload via
+/// <see cref="EnvelopeGenerator.Application.Common.Notifications.DocSigned.PsPdfKitAnnotation"/>.
+/// That format is browser-library specific. The Blazor client uses a
+/// transport-neutral DTO instead: only what the server actually needs
+/// to persist the signed document (image + metadata per placeholder).
+///
+/// Conversion to the internal <c>PsPdfKitAnnotation</c> happens inside
+/// <see cref="EnvelopeGenerator.API.Controllers.AnnotationController"/>.
+/// </summary>
+public class BlazorSignaturePayload
+{
+    /// <summary>The receiver-specific signed placeholders for this envelope.</summary>
+    public List<BlazorSignatureEntry> Signatures { get; set; } = new();
+}
+
+/// <summary>
+/// A single signed placeholder.
+/// </summary>
+public class BlazorSignatureEntry
+{
+    /// <summary>The receiver's <c>DocumentReceiverElement.Id</c> being signed.</summary>
+    public int ElementId { get; set; }
+
+    /// <summary>Signature image as a data URL (e.g. "data:image/png;base64,...").</summary>
+    public string SignatureDataUrl { get; set; } = string.Empty;
+
+    /// <summary>Optional position / job title entered by the receiver.</summary>
+    public string? Position { get; set; }
+
+    /// <summary>Optional city / location entered by the receiver.</summary>
+    public string? City { get; set; }
+
+    /// <summary>Capture timestamp (client local time).</summary>
+    public DateTime SignedAt { get; set; }
+}

EnvelopeGenerator.API/Models/ReceiverAuthResponse.cs

@@ -0,0 +1,78 @@
+namespace EnvelopeGenerator.API.Models;
+
+/// <summary>
+/// Einheitliche Antwort des ReceiverAuthControllers.
+/// 
+/// WARUM ein einziges Response-Objekt für alle Endpunkte?
+/// - Der Client braucht nur ein Format zu verstehen
+/// - Der Status-String bestimmt, welche Felder relevant sind
+/// - Entspricht dem, was der Web-Controller bisher über ViewData verteilt hat
+/// 
+/// Status-Werte und was sie bedeuten:
+/// - "requires_access_code" → AccessCode-Eingabe zeigen
+/// - "requires_tfa"         → TFA-Code-Eingabe zeigen (nach AccessCode)
+/// - "show_document"        → Dokument laden und anzeigen
+/// - "already_signed"       → Info-Seite "Bereits unterschrieben"
+/// - "rejected"             → Info-Seite "Abgelehnt"
+/// - "not_found"            → Fehler-Seite "Nicht gefunden"
+/// - "expired"              → Fehler-Seite "Link abgelaufen"
+/// </summary>
+public class ReceiverAuthResponse
+{
+    /// <summary>Aktueller Status des Empfänger-Flows</summary>
+    public required string Status { get; init; }
+
+    /// <summary>Titel des Umschlags (z.B. "Vertragsdokument")</summary>
+    public string? Title { get; init; }
+
+    /// <summary>Nachricht des Absenders</summary>
+    public string? Message { get; init; }
+
+    /// <summary>E-Mail des Absenders (für Rückfragen-Hinweis)</summary>
+    public string? SenderEmail { get; init; }
+
+    /// <summary>Name des Empfängers</summary>
+    public string? ReceiverName { get; init; }
+
+    /// <summary>Ob TFA für diesen Umschlag aktiviert ist</summary>
+    public bool TfaEnabled { get; init; }
+
+    /// <summary>Ob der Empfänger eine Telefonnummer hat (für SMS-TFA)</summary>
+    public bool HasPhoneNumber { get; init; }
+
+    /// <summary>Ob das Dokument nur gelesen werden soll (ReadAndConfirm)</summary>
+    public bool ReadOnly { get; init; }
+
+    /// <summary>TFA-Typ: "sms" oder "authenticator" (wenn Status = "requires_tfa")</summary>
+    public string? TfaType { get; init; }
+
+    /// <summary>Ablaufzeit des SMS-Codes (für Countdown-Timer)</summary>
+    public DateTime? TfaExpiration { get; init; }
+
+    /// <summary>Fehlermeldung (z.B. "Falscher Zugangscode")</summary>
+    public string? ErrorMessage { get; init; }
+}
+
+/// <summary>
+/// Request-Body für POST /api/receiverauth/{key}/access-code
+/// </summary>
+public class AccessCodeRequest
+{
+    /// <summary>Der vom Empfänger eingegebene Zugangscode</summary>
+    public required string AccessCode { get; init; }
+
+    /// <summary>Ob SMS statt Authenticator bevorzugt wird</summary>
+    public bool PreferSms { get; init; }
+}
+
+/// <summary>
+/// Request-Body für POST /api/receiverauth/{key}/tfa
+/// </summary>
+public class TfaCodeRequest
+{
+    /// <summary>Der eingegebene TFA-Code (6-stellig)</summary>
+    public required string Code { get; init; }
+
+    /// <summary>"sms" oder "authenticator"</summary>
+    public required string Type { get; init; }
+}

EnvelopeGenerator.Application/Common/Notifications/DocSigned/Handlers/DocStatusHandler.cs

@@ -29,12 +29,15 @@ public class DocStatusHandler : INotificationHandler<DocSignedNotification>
     /// <param name="notification"></param>
     /// <param name="cancel"></param>
     /// <returns></returns>
-    public Task Handle(DocSignedNotification notification, CancellationToken cancel) => _sender.Send(new CreateDocStatusCommand()
+    public async Task Handle(DocSignedNotification notification, CancellationToken cancel)
     {
-        EnvelopeId = notification.EnvelopeId,
+        await _sender.Send(new SaveDocStatusCommand()
-        ReceiverId = notification.ReceiverId,
+        {
-        Value = notification.PsPdfKitAnnotation is PsPdfKitAnnotation annot
+            Envelope = new() { Id = notification.EnvelopeId },
-                    ? JsonSerializer.Serialize(annot.Instant, Format.Json.ForAnnotations)
+            Receiver = new() { Id = notification.ReceiverId},
+            Value = notification.PsPdfKitAnnotation is PsPdfKitAnnotation annot 
+                    ? JsonSerializer.Serialize(annot.Instant, Format.Json.ForAnnotations) 
                     : BlankAnnotationJson
-    }, cancel);
+        }, cancel);
+    }
 }

EnvelopeGenerator.Application/DocStatus/Commands/CreateDocStatusCommand.cs

@@ -8,22 +8,12 @@ namespace EnvelopeGenerator.Application.DocStatus.Commands;
 /// <summary>
 /// 
 /// </summary>
-public record CreateDocStatusCommand : IRequest<DocumentStatus>
+public record CreateDocStatusCommand : ModifyDocStatusCommandBase, IRequest<DocumentStatus>
 {
     /// <summary>
-    /// 
+    /// Gets timestamp when this record was added. Returns the StatusChangedWhen value.
     /// </summary>
-    public int EnvelopeId { get; set; }
+    public DateTime AddedWhen => StatusChangedWhen;
-
-    /// <summary>
-    /// 
-    /// </summary>
-    public int ReceiverId { get; set; }
-
-    /// <summary>
-    /// Gets or sets the display value associated with the status.
-    /// </summary>
-    public string? Value { get; set; }
 }
 
 /// <summary>

EnvelopeGenerator.Application/DocStatus/Commands/ModifyDocStatusCommandBase.cs

@@ -0,0 +1,54 @@
+using EnvelopeGenerator.Application.Common.Query;
+using EnvelopeGenerator.Domain.Constants;
+
+namespace EnvelopeGenerator.Application.DocStatus.Commands;
+
+/// <summary>
+/// 
+/// </summary>
+public record ModifyDocStatusCommandBase : EnvelopeReceiverQueryBase
+{
+    /// <summary>
+    /// 
+    /// </summary>
+    public int? EnvelopeId => Envelope.Id;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public int? ReceiverId => Receiver.Id;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public override ReceiverQueryBase Receiver { get => base.Receiver; set => base.Receiver = value; }
+
+    /// <summary>
+    /// Gets the current status code.
+    /// </summary>
+    public DocumentStatus Status => Value is null ? DocumentStatus.Created : DocumentStatus.Signed;
+
+    /// <summary>
+    /// Gets or sets the display value associated with the status.
+    /// </summary>
+    public string? Value { get; set; }
+
+    /// <summary>
+    /// Gets timestamp when this record was added.
+    /// </summary>
+    public DateTime StatusChangedWhen { get; } = DateTime.Now;
+
+    /// <summary>
+    /// Maps the current command to a new instance of the specified type.
+    /// </summary>
+    /// <typeparam name="TDest"></typeparam>
+    /// <returns></returns>
+    public TDest To<TDest>() where TDest : ModifyDocStatusCommandBase, new()
+        => new()
+        {
+            Key = Key,
+            Envelope = Envelope,
+            Receiver = Receiver,
+            Value = Value
+        };
+}

EnvelopeGenerator.Application/DocStatus/Commands/SaveDocStatusCommand.cs

@@ -0,0 +1,77 @@
+using DigitalData.Core.Abstraction.Application.Repository;
+using EnvelopeGenerator.Domain.Entities;
+using MediatR;
+using Microsoft.EntityFrameworkCore;
+using AutoMapper;
+using EnvelopeGenerator.Application.Common.Dto;
+using EnvelopeGenerator.Application.Common.Extensions;
+
+namespace EnvelopeGenerator.Application.DocStatus.Commands;
+
+/// <summary>
+/// Represents a command to save the status of a document, either by creating a new status or updating an existing one based on the provided envelope and receiver identifiers.
+/// It returns the identifier of the saved document status.
+/// </summary>
+public record SaveDocStatusCommand : ModifyDocStatusCommandBase, IRequest<DocumentStatusDto?>;
+
+/// <summary>
+/// 
+/// </summary>
+public class SaveDocStatusCommandHandler : IRequestHandler<SaveDocStatusCommand, DocumentStatusDto?>
+{
+    private readonly IMapper _mapper;
+
+    private readonly IRepository<DocumentStatus> _repo;
+
+    private readonly IRepository<Envelope> _envRepo;
+
+    private readonly IRepository<Receiver> _rcvRepo;
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="mapper"></param>
+    /// <param name="repo"></param>
+    /// <param name="rcvRepo"></param>
+    /// <param name="envRepo"></param>
+    public SaveDocStatusCommandHandler(IMapper mapper, IRepository<DocumentStatus> repo, IRepository<Receiver> rcvRepo, IRepository<Envelope> envRepo)
+    {
+        _mapper = mapper;
+        _repo = repo;
+        _rcvRepo = rcvRepo;
+        _envRepo = envRepo;
+    }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    /// <param name="request"></param>
+    /// <param name="cancel"></param>
+    /// <returns></returns>
+    public async Task<DocumentStatusDto?> Handle(SaveDocStatusCommand request, CancellationToken cancel)
+    {
+        // ceck if exists
+        bool isExists = await _repo.ReadOnly().Where(request).AnyAsync(cancel);
+
+        var env = await _envRepo.ReadOnly().Where(request.Envelope).FirstAsync(cancel);
+        var rcv = await _rcvRepo.ReadOnly().Where(request.Receiver).FirstAsync(cancel);
+
+        request.Envelope.Id = env.Id;
+        request.Receiver.Id = rcv.Id;
+
+        if (isExists)
+        {
+            var uReq = request.To<UpdateDocStatusCommand>();
+            await _repo.UpdateAsync(uReq, q => q.Where(request), cancel);
+        }
+        else
+        {
+            var cReq = request.To<CreateDocStatusCommand>();
+            await _repo.CreateAsync(cReq, cancel);
+        }
+
+        var docStatus = await _repo.ReadOnly().Where(request).SingleOrDefaultAsync(cancel);
+        
+        return _mapper.Map<DocumentStatusDto>(docStatus);
+    }
+}

EnvelopeGenerator.Application/DocStatus/Commands/UpdateDocStatusCommand.cs

@@ -1,41 +1,14 @@
-using EnvelopeGenerator.Application.Common.Commands;
+using EnvelopeGenerator.Domain;
-using EnvelopeGenerator.Domain.Entities;
-using System.Linq.Expressions;
 
 namespace EnvelopeGenerator.Application.DocStatus.Commands;
 
 /// <summary>
 /// 
 /// </summary>
-/// <param name="Value"></param>
+public record UpdateDocStatusCommand : ModifyDocStatusCommandBase
-public record DocStatusUpdateDto(string? Value);
-
-/// <summary>
-/// 
-/// </summary>
-public record UpdateDocStatusCommand : UpdateCommand<DocStatusUpdateDto, DocumentStatus>
 {
     /// <summary>
-    /// 
+    /// Gets timestamp when this record was added. Returns the StatusChangedWhen value.
     /// </summary>
-    public int EnvelopeId { get; set; }
+    public DateTime? ChangedWhen => StatusChangedWhen;
-
-    /// <summary>
-    /// 
-    /// </summary>
-    public int ReceiverId { get; set; }
-
-    /// <summary>
-    /// Gets or sets the display value associated with the status.
-    /// </summary>
-    public string? Value { get; set; }
-
-    /// <summary>
-    /// 
-    /// </summary>
-    /// <returns></returns>
-    public override Expression<Func<DocumentStatus, bool>> BuildQueryExpression()
-    {
-        return ds => ds.EnvelopeId == EnvelopeId && ds.ReceiverId == ReceiverId;
-    }
 }

EnvelopeGenerator.Application/DocStatus/MappingProfile.cs

@@ -18,16 +18,11 @@ public class MappingProfile : Profile
         CreateMap<CreateDocStatusCommand, DocumentStatus>()
         .ForMember(dest => dest.Envelope, opt => opt.Ignore())
         .ForMember(dest => dest.Receiver, opt => opt.Ignore())
-        .ForMember(dest => dest.Status, opt => opt.MapFrom(
-            src => src.Value == null 
-                ? Domain.Constants.DocumentStatus.Created 
-                : Domain.Constants.DocumentStatus.Signed))
         .MapAddedWhen();
 
         CreateMap<UpdateDocStatusCommand, DocumentStatus>()
         .ForMember(dest => dest.Envelope, opt => opt.Ignore())
         .ForMember(dest => dest.Receiver, opt => opt.Ignore())
-        .ForMember(dest => dest.StatusChangedWhen, opt => opt.MapFrom(src => DateTime.UtcNow))
         .MapChangedWhen();
     }
 }

EnvelopeGenerator.Application/EnvelopeReceivers/Queries/ReadEnvelopeReceiverLightQuery.cs

@@ -0,0 +1,60 @@
+using AutoMapper;
+using DigitalData.Core.Abstraction.Application.Repository;
+using EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver;
+using EnvelopeGenerator.Application.Common.Extensions;
+using EnvelopeGenerator.Application.Common.Query;
+using EnvelopeGenerator.Application.Envelopes.Queries;
+using EnvelopeGenerator.Application.Receivers.Queries;
+using EnvelopeGenerator.Domain.Entities;
+using MediatR;
+using Microsoft.EntityFrameworkCore;
+
+namespace EnvelopeGenerator.Application.EnvelopeReceivers.Queries;
+
+/// <summary>
+/// Leichte Variante von <see cref="ReadEnvelopeReceiverQuery"/>:
+/// Lädt NUR Envelope (mit Histories + User) und Receiver.
+/// Lädt NICHT Documents/Elements.
+/// 
+/// Verwendung: Status-Prüfungen wo keine Dokument-Daten benötigt werden
+/// (z.B. ReceiverAuthController.GetStatus).
+/// </summary>
+public record ReadEnvelopeReceiverLightQuery
+    : EnvelopeReceiverQueryBase<ReadEnvelopeQuery, ReadReceiverQuery>, IRequest<EnvelopeReceiverDto?>;
+
+/// <summary>
+/// Handler für <see cref="ReadEnvelopeReceiverLightQuery"/>.
+/// </summary>
+public class ReadEnvelopeReceiverLightQueryHandler
+    : IRequestHandler<ReadEnvelopeReceiverLightQuery, EnvelopeReceiverDto?>
+{
+    private readonly IRepository<EnvelopeReceiver> _repo;
+    private readonly IMapper _mapper;
+
+    /// <summary>
+    /// Konstruktor.
+    /// </summary>
+    /// <param name="repo">EnvelopeReceiver-Repository</param>
+    /// <param name="mapper">AutoMapper</param>
+    public ReadEnvelopeReceiverLightQueryHandler(IRepository<EnvelopeReceiver> repo, IMapper mapper)
+    {
+        _repo = repo;
+        _mapper = mapper;
+    }
+
+    /// <summary>
+    /// Lädt einen EnvelopeReceiver ohne Documents/Elements.
+    /// </summary>
+    public async Task<EnvelopeReceiverDto?> Handle(ReadEnvelopeReceiverLightQuery request, CancellationToken cancel)
+    {
+        var envRcv = await _repo.Query
+            .Where(request, notnull: false)
+            .AsNoTracking()
+            .Include(er => er.Envelope).ThenInclude(e => e!.Histories)
+            .Include(er => er.Envelope).ThenInclude(e => e!.User)
+            .Include(er => er.Receiver)
+            .FirstOrDefaultAsync(cancel);
+
+        return envRcv is null ? null : _mapper.Map<EnvelopeReceiverDto>(envRcv);
+    }
+}

EnvelopeGenerator.Application/Histories/Commands/CreateHistoryCommand.cs

@@ -34,7 +34,7 @@ public record CreateHistoryCommand : EnvelopeReceiverQueryBase, IRequest<History
     /// <summary>
     /// 
     /// </summary>
-    public DateTime AddedWhen { get; } = DateTime.UtcNow;
+    public DateTime AddedWhen { get; } = DateTime.Now;
 
     /// <summary>
     /// 

EnvelopeGenerator.Application/Histories/MappingProfile.cs

@@ -1,5 +1,4 @@
 using AutoMapper;
-using EnvelopeGenerator.Application.Common.Extensions;
 using EnvelopeGenerator.Application.Histories.Commands;
 using EnvelopeGenerator.Domain.Entities;
 
@@ -18,7 +17,6 @@ public class MappingProfile: Profile
         CreateMap<CreateHistoryCommand, History>()
             .ForMember(dest => dest.Envelope, opt => opt.Ignore())
             .ForMember(dest => dest.Sender, opt => opt.Ignore())
-            .ForMember(dest => dest.Receiver, opt => opt.Ignore())
+            .ForMember(dest => dest.Receiver, opt => opt.Ignore());
-            .MapAddedWhen();
     }
 }

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

@@ -250,7 +250,7 @@
     <value>Sie können bei Bedarf mit {0}, &lt;a href="mailto:{1}?subject={2}&amp;body=Sehr geehrte(r)%20{0},%0A%0A%0A"&gt;{1}&lt;/a&gt; Kontakt aufnehmen.</value>
   </data>
   <data name="RejectionInfo2_ext" xml:space="preserve">
-    <value>Der Vorgang wurde von einer der beteiligten Parteien abgelehnt. Sie können bei Bedarf mit {0}, &lt;a href="mailto:{1}?subject={2}&amp;body=Sehr geehrte(r)%20{0},%0A%0A%0A"&gt;{1}&lt;/a&gt; Kontakt aufnehmen.</value>
+    <value>Das Vorgang wurde von einer der beteiligten Parteien abgelehnt. Sie können bei Bedarf mit {0}, &lt;a href="mailto:{1}?subject={2}&amp;body=Sehr geehrte(r)%20{0},%0A%0A%0A"&gt;{1}&lt;/a&gt; Kontakt aufnehmen.</value>
   </data>
   <data name="RejectionReasonQ" xml:space="preserve">
     <value>Bitte geben Sie einen Grund an:</value>
@@ -261,6 +261,9 @@
   <data name="SignDoc" xml:space="preserve">
     <value>Dokument unterschreiben</value>
   </data>
+  <data name="SigningProcessTitle" xml:space="preserve">
+    <value>Titel des Unterzeichnungs-Vorgangs</value>
+  </data>
   <data name="UnexpectedError" xml:space="preserve">
     <value>Ein unerwarteter Fehler ist aufgetreten.</value>
   </data>
@@ -444,37 +447,4 @@
   <data name="DocumentReset" xml:space="preserve">
     <value>Dokument wurde zurückgesetzt.</value>
   </data>
-  <data name="DocumentSuccessfullyConfirmed" xml:space="preserve">
-    <value>Dokument erfolgreich gelesen und bestätigt!</value>
-  </data>
-  <data name="DocumentConfirmedConfirmationMessage" xml:space="preserve">
-    <value>Sie haben das Dokument gelesen und bestätigt. Im Anschluss erhalten Sie eine schriftliche Bestätigung.</value>
-  </data>
-  <data name="Confirm" xml:space="preserve">
-    <value>Bestätigen</value>
-  </data>
-  <data name="RejectionInfoConfirmation" xml:space="preserve">
-    <value>Dieser Bestätigungsvorgang wurde abgelehnt!</value>
-  </data>
-  <data name="ConfirmDoc" xml:space="preserve">
-    <value>Dokument bestätigen</value>
-  </data>
-  <data name="DocConfirmed" xml:space="preserve">
-    <value>Dokument bestätigt</value>
-  </data>
-  <data name="ConfirmAgree" xml:space="preserve">
-    <value>Durch Klick auf Abschließen bestätige ich, das Dokument gelesen und zur Kenntnis genommen zu haben.</value>
-  </data>
-  <data name="ConfirmedBy" xml:space="preserve">
-    <value>Bestätigt von</value>
-  </data>
-  <data name="ConfirmationProcessTitle" xml:space="preserve">
-    <value>Titel des Lesebetätigungs-Vorgangs</value>
-  </data>
-  <data name="SigningProcessTitle" xml:space="preserve">
-    <value>Titel des Unterzeichnungs-Vorgangs</value>
-  </data>
-  <data name="Confirmations" xml:space="preserve">
-    <value>Bestätigungen</value>
-  </data>
 </root>

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

@@ -261,6 +261,9 @@
   <data name="SignDoc" xml:space="preserve">
     <value>Sign document</value>
   </data>
+  <data name="SigningProcessTitle" xml:space="preserve">
+    <value>Title of the signing process</value>
+  </data>
   <data name="UnexpectedError" xml:space="preserve">
     <value>An unexpected error has occurred.</value>
   </data>
@@ -444,37 +447,4 @@
   <data name="DocumentReset" xml:space="preserve">
     <value>Document has been reset.</value>
   </data>
-  <data name="DocumentSuccessfullyConfirmed" xml:space="preserve">
-    <value>Document successfully red and confirmed!</value>
-  </data>
-  <data name="DocumentConfirmedConfirmationMessage" xml:space="preserve">
-    <value>You have read and confirmed the document. You will receive a written confirmation afterwards.</value>
-  </data>
-  <data name="Confirm" xml:space="preserve">
-    <value>Confirm</value>
-  </data>
-  <data name="RejectionInfoConfirmation" xml:space="preserve">
-    <value>This confirmation process has been rejected!</value>
-  </data>
-  <data name="ConfirmDoc" xml:space="preserve">
-    <value>Confirm Document</value>
-  </data>
-  <data name="DocConfirmed" xml:space="preserve">
-    <value>Document confirmed</value>
-  </data>
-  <data name="ConfirmAgree" xml:space="preserve">
-    <value>By clicking on “Complete”, I confirm that I have read and taken note of the document.</value>
-  </data>
-  <data name="ConfirmedBy" xml:space="preserve">
-    <value>Confirmed by</value>
-  </data>
-  <data name="ConfirmationProcessTitle" xml:space="preserve">
-    <value>Title of the read confirmation process</value>
-  </data>
-  <data name="SigningProcessTitle" xml:space="preserve">
-    <value>Title of the signing process</value>
-  </data>
-  <data name="Confirmations" xml:space="preserve">
-    <value>Confirmations</value>
-  </data>
 </root>

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

@@ -261,6 +261,9 @@
   <data name="SignDoc" xml:space="preserve">
     <value>Signer le document</value>
   </data>
+  <data name="SigningProcessTitle" xml:space="preserve">
+    <value>Titre du processus de signature</value>
+  </data>
   <data name="UnexpectedError" xml:space="preserve">
     <value>Une erreur inattendue s’est produite.</value>
   </data>
@@ -444,37 +447,4 @@
   <data name="DocumentReset" xml:space="preserve">
     <value>Le document a été réinitialisé.</value>
   </data>
-  <data name="DocumentSuccessfullyConfirmed" xml:space="preserve">
-    <value>Document lu et confirmé avec succès !</value>
-  </data>
-  <data name="DocumentConfirmedConfirmationMessage" xml:space="preserve">
-    <value>Vous avez lu et confirmé le document. Vous recevrez une confirmation écrite par la suite.</value>
-  </data>
-  <data name="Confirm" xml:space="preserve">
-    <value>Confirmer</value>
-  </data>
-  <data name="RejectionInfoConfirmation" xml:space="preserve">
-    <value>Cette procédure de confirmation a été rejetée !</value>
-  </data>
-  <data name="ConfirmDoc" xml:space="preserve">
-    <value>Confirmer le document</value>
-  </data>
-  <data name="DocConfirmed" xml:space="preserve">
-    <value>Document confirmé</value>
-  </data>
-  <data name="ConfirmAgree" xml:space="preserve">
-    <value>En cliquant sur « Terminer », je confirme avoir lu et pris connaissance du document.</value>
-  </data>
-  <data name="ConfirmedBy" xml:space="preserve">
-    <value>Confirmé par</value>
-  </data>
-  <data name="ConfirmationProcessTitle" xml:space="preserve">
-    <value>Titre de la procédure de confirmation de lecture</value>
-  </data>
-  <data name="SigningProcessTitle" xml:space="preserve">
-    <value>Titre du processus de signature</value>
-  </data>
-  <data name="Confirmations" xml:space="preserve">
-    <value>Confirmations</value>
-  </data>
 </root>

EnvelopeGenerator.BBTests/frmFinalizePDF.vb

@@ -7,10 +7,11 @@ Imports GdPicture14
 Imports Newtonsoft.Json.Linq
 Imports EnvelopeGenerator.Infrastructure
 Imports Microsoft.EntityFrameworkCore
+Imports System.Text
 Imports DigitalData.Core.Abstractions
 
 Public Class frmFinalizePDF
-    Private Const CONNECTIONSTRING = "Server=sDD-VMP04-SQL17\DD_DEVELOP01;Database=DD_ECM;User Id=sa;Password=+bk8oAbbQP1AzoHtvZUbd+Mbok2f8Fl4miEx1qssJ5yEaEWoQJ9prg4L14fURpPnqi1WMNs9fE4=;" + "Encrypt=True;TrustServerCertificate=True;"
+    Private Const CONNECTIONSTRING = "Server=sDD-VMP04-SQL17\DD_DEVELOP01;Database=DD_ECM;User Id=sa;Password=+bk8oAbbQP1AzoHtvZUbd+Mbok2f8Fl4miEx1qssJ5yEaEWoQJ9prg4L14fURpPnqi1WMNs9fE4=;"
 
     Private Database As MSSQLServer
     Private LogConfig As LogConfig
@@ -92,36 +93,56 @@ Public Class frmFinalizePDF
     End Function
 
     Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
-        Dim oTable = LoadAnnotationDataForEnvelope()
+        Try
-        Dim oJsonList = oTable.Rows.
-            Cast(Of DataRow).
-            Select(Function(r As DataRow) r.Item("VALUE").ToString()).
-            ToList()
 
-        Dim envelopeId As Integer = CInt(txtEnvelope.Text)
+            Dim oTable = LoadAnnotationDataForEnvelope()
-        Dim oBuffer As Byte() = ReadEnvelope(envelopeId)
+            Dim oJsonList = oTable.Rows.
-        Dim oNewBuffer = PDFBurner.BurnAnnotsToPDF(oBuffer, oJsonList, envelopeId)
+                Cast(Of DataRow).
-        Dim desktopPath As String = Environment.GetFolderPath(Environment.SpecialFolder.Desktop)
+                Select(Function(r As DataRow) r.Item("VALUE").ToString()).
-        Dim oNewPath = Path.Combine(desktopPath, $"E{txtEnvelope.Text}R{txtReceiver.Text}.burned.pdf")
+                ToList()
 
-        File.WriteAllBytes(oNewPath, oNewBuffer)
+            Dim envelopeId As Integer = CInt(txtEnvelope.Text)
+            Dim oBuffer As Byte() = ReadEnvelope(envelopeId)
+            Dim oNewBuffer = PDFBurner.BurnAnnotsToPDF(oBuffer, oJsonList, envelopeId)
+            Dim desktopPath As String = Environment.GetFolderPath(Environment.SpecialFolder.Desktop)
+            Dim oNewPath = Path.Combine(desktopPath, $"E{txtEnvelope.Text}R{txtReceiver.Text}.burned.pdf")
+
+            File.WriteAllBytes(oNewPath, oNewBuffer)
+
+            Process.Start(oNewPath)
+        Catch ex As Exception
+            Dim exMsg As StringBuilder = New StringBuilder(ex.Message).AppendLine()
+
+            Dim innerEx = ex.InnerException
+            While (innerEx IsNot Nothing)
+                exMsg.AppendLine(innerEx.Message)
+                innerEx = innerEx.InnerException
+            End While
+
+            MsgBox(exMsg.ToString(), MsgBoxStyle.Critical)
+        End Try
 
-        Process.Start(oNewPath)
     End Sub
 
     Private Sub Button2_Click(sender As Object, e As EventArgs) Handles Button2.Click
-        Dim oTable = LoadAnnotationDataForEnvelope()
+        Try
-        Dim oJsonList = oTable.Rows.
+            Dim oTable = LoadAnnotationDataForEnvelope()
-            Cast(Of DataRow).
+            Dim oJsonList = oTable.Rows.
-            Select(Function(r As DataRow) r.Item("VALUE").ToString()).
+                Cast(Of DataRow).
-            Select(Function(s As String) JObject.Parse(s)).
+                Select(Function(r As DataRow) r.Item("VALUE").ToString()).
-            ToList()
+                Select(Function(s As String) JObject.Parse(s)).
+                ToList()
 
-        Dim oJObject1 = oJsonList.First()
+            Dim oJObject1 = oJsonList.First()
-        Dim oJObject2 = oJsonList.ElementAt(1)
+            Dim oJObject2 = oJsonList.ElementAt(1)
 
-        oJObject1.Merge(oJObject2)
+            oJObject1.Merge(oJObject2)
 
-        txtResult.Text = oJObject1.ToString()
+            txtResult.Text = oJObject1.ToString()
+
+
+        Catch ex As Exception
+            MsgBox(ex.Message, MsgBoxStyle.Critical)
+        End Try
     End Sub
 End Class

EnvelopeGenerator.Domain/Entities/DocumentStatus.cs

@@ -35,10 +35,6 @@ namespace EnvelopeGenerator.Domain.Entities
         [Column("STATUS")]
         public Constants.DocumentStatus Status { get; set; }
 
-        [Required]
-        [Column("STATUS_CHANGED_WHEN", TypeName = "datetime")]
-        public DateTime? StatusChangedWhen { get; set; }
-
         [Required]
         [Column("ADDED_WHEN", TypeName = "datetime")]
         public DateTime AddedWhen { get; set; }

EnvelopeGenerator.Domain/Entities/History.cs

@@ -35,10 +35,8 @@ namespace EnvelopeGenerator.Domain.Entities
         public DateTime AddedWhen { get; set; }
 
         [Column("ACTION_DATE", TypeName = "datetime")]
-        public DateTime? ActionDate { get; set; }
+        public DateTime? ChangedWhen { get; set; }
-
+        
-        public DateTime? ChangedWhen { get => ActionDate; set => ActionDate = value; }
-
         [Column("COMMENT", TypeName = "nvarchar(max)")]
         public string
 #if nullable

EnvelopeGenerator.Jobs/EnvelopeGenerator.Jobs.csproj

@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="BouncyCastle.Cryptography" Version="2.6.2" />
+    <PackageReference Include="HtmlSanitizer" Version="9.0.892" />
+    <PackageReference Include="Microsoft.Identity.Client" Version="4.82.1" />
+    <PackageReference Include="Quartz" Version="3.9.0" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.3" />
+    <PackageReference Include="Microsoft.Data.SqlClient" Version="6.1.4" />
+    <PackageReference Include="SixLabors.ImageSharp" Version="3.1.12" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\EnvelopeGenerator.Domain\EnvelopeGenerator.Domain.csproj" />
+    <ProjectReference Include="..\EnvelopeGenerator.Infrastructure\EnvelopeGenerator.Infrastructure.csproj" />
+    <ProjectReference Include="..\EnvelopeGenerator.PdfEditor\EnvelopeGenerator.PdfEditor.csproj" />
+  </ItemGroup>
+
+</Project>

EnvelopeGenerator.Jobs/Jobs/APIBackendJobs/APIEnvelopeJob.cs

@@ -0,0 +1,151 @@
+using System.Collections.Generic;
+using System.Data;
+using System.Threading.Tasks;
+using EnvelopeGenerator.Domain.Constants;
+using Microsoft.Data.SqlClient;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using Quartz;
+
+namespace EnvelopeGenerator.Jobs.APIBackendJobs;
+
+public class APIEnvelopeJob(ILogger<APIEnvelopeJob>? logger = null) : IJob
+{
+    private readonly ILogger<APIEnvelopeJob> _logger = logger ?? NullLogger<APIEnvelopeJob>.Instance;
+
+    public async Task Execute(IJobExecutionContext context)
+    {
+        var jobId = context.JobDetail.Key.ToString();
+        _logger.LogDebug("API Envelopes - Starting job {JobId}", jobId);
+
+        try
+        {
+            var connectionString = context.MergedJobDataMap.GetString(Value.DATABASE);
+            if (string.IsNullOrWhiteSpace(connectionString))
+            {
+                _logger.LogWarning("API Envelopes - Connection string missing");
+                return;
+            }
+
+            await using var connection = new SqlConnection(connectionString);
+            await connection.OpenAsync(context.CancellationToken);
+
+            await ProcessInvitationsAsync(connection, context.CancellationToken);
+            await ProcessWithdrawnAsync(connection, context.CancellationToken);
+
+            _logger.LogDebug("API Envelopes - Completed job {JobId} successfully", jobId);
+        }
+        catch (System.Exception ex)
+        {
+            _logger.LogError(ex, "API Envelopes job failed");
+        }
+        finally
+        {
+            _logger.LogDebug("API Envelopes execution for {JobId} ended", jobId);
+        }
+    }
+
+    private async Task ProcessInvitationsAsync(SqlConnection connection, System.Threading.CancellationToken cancellationToken)
+    {
+        const string sql = "SELECT GUID FROM TBSIG_ENVELOPE WHERE SOURCE = 'API' AND STATUS = 1003 ORDER BY GUID";
+        var envelopeIds = new List<int>();
+
+        await using (var command = new SqlCommand(sql, connection))
+        await using (var reader = await command.ExecuteReaderAsync(cancellationToken))
+        {
+            while (await reader.ReadAsync(cancellationToken))
+            {
+                if (reader[0] is int id)
+                {
+                    envelopeIds.Add(id);
+                }
+            }
+        }
+
+        if (envelopeIds.Count == 0)
+        {
+            _logger.LogDebug("SendInvMail - No envelopes found");
+            return;
+        }
+
+        _logger.LogInformation("SendInvMail - Found {Count} envelopes", envelopeIds.Count);
+        var total = envelopeIds.Count;
+        var current = 1;
+
+        foreach (var id in envelopeIds)
+        {
+            _logger.LogInformation("SendInvMail - Processing Envelope {EnvelopeId} ({Current}/{Total})", id, current, total);
+            try
+            {
+                // Placeholder for invitation email sending logic.
+                _logger.LogDebug("SendInvMail - Marking envelope {EnvelopeId} as queued", id);
+                const string updateSql = "UPDATE TBSIG_ENVELOPE SET CURRENT_WORK_APP = @App WHERE GUID = @Id";
+                await using var updateCommand = new SqlCommand(updateSql, connection);
+                updateCommand.Parameters.AddWithValue("@App", "signFLOW_API_EnvJob_InvMail");
+                updateCommand.Parameters.AddWithValue("@Id", id);
+                await updateCommand.ExecuteNonQueryAsync(cancellationToken);
+            }
+            catch (System.Exception ex)
+            {
+                _logger.LogWarning(ex, "SendInvMail - Unhandled exception while working envelope {EnvelopeId}", id);
+            }
+
+            current++;
+            _logger.LogInformation("SendInvMail - Envelope finalized");
+        }
+    }
+
+    private async Task ProcessWithdrawnAsync(SqlConnection connection, System.Threading.CancellationToken cancellationToken)
+    {
+        const string sql = @"SELECT ENV.GUID, REJ.COMMENT AS REJECTION_REASON FROM 
+                (SELECT * FROM TBSIG_ENVELOPE WHERE STATUS = 1009 AND SOURCE = 'API') ENV INNER JOIN
+                (SELECT MAX(GUID) GUID, ENVELOPE_ID, MAX(ADDED_WHEN) ADDED_WHEN, MAX(ACTION_DATE) ACTION_DATE, COMMENT FROM TBSIG_ENVELOPE_HISTORY WHERE STATUS = 1009 GROUP BY ENVELOPE_ID, COMMENT ) REJ ON ENV.GUID = REJ.ENVELOPE_ID LEFT JOIN
+                (SELECT * FROM TBSIG_ENVELOPE_HISTORY WHERE STATUS = 3004 ) M_Send ON ENV.GUID = M_Send.ENVELOPE_ID
+                WHERE M_Send.GUID IS NULL";
+
+        var withdrawn = new List<(int EnvelopeId, string Reason)>();
+        await using (var command = new SqlCommand(sql, connection))
+        await using (var reader = await command.ExecuteReaderAsync(cancellationToken))
+        {
+            while (await reader.ReadAsync(cancellationToken))
+            {
+                var id = reader.GetInt32(0);
+                var reason = reader.IsDBNull(1) ? string.Empty : reader.GetString(1);
+                withdrawn.Add((id, reason));
+            }
+        }
+
+        if (withdrawn.Count == 0)
+        {
+            _logger.LogDebug("WithdrawnEnv - No envelopes found");
+            return;
+        }
+
+        _logger.LogInformation("WithdrawnEnv - Found {Count} envelopes", withdrawn.Count);
+        var total = withdrawn.Count;
+        var current = 1;
+
+        foreach (var (envelopeId, reason) in withdrawn)
+        {
+            _logger.LogInformation("WithdrawnEnv - Processing Envelope {EnvelopeId} ({Current}/{Total})", envelopeId, current, total);
+            try
+            {
+                // Log withdrawn mail trigger placeholder
+                const string insertHistory = "INSERT INTO TBSIG_ENVELOPE_HISTORY (ENVELOPE_ID, STATUS, USER_REFERENCE, ADDED_WHEN, ACTION_DATE, COMMENT) VALUES (@EnvelopeId, @Status, @UserReference, GETDATE(), GETDATE(), @Comment)";
+                await using var insertCommand = new SqlCommand(insertHistory, connection);
+                insertCommand.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+                insertCommand.Parameters.AddWithValue("@Status", 3004);
+                insertCommand.Parameters.AddWithValue("@UserReference", "API");
+                insertCommand.Parameters.AddWithValue("@Comment", reason ?? string.Empty);
+                await insertCommand.ExecuteNonQueryAsync(cancellationToken);
+            }
+            catch (System.Exception ex)
+            {
+                _logger.LogWarning(ex, "WithdrawnEnv - Unhandled exception while working envelope {EnvelopeId}", envelopeId);
+            }
+
+            current++;
+            _logger.LogInformation("WithdrawnEnv - Envelope finalized");
+        }
+    }
+}

EnvelopeGenerator.Jobs/Jobs/DataRowExtensions.cs

@@ -0,0 +1,30 @@
+using System;
+using System.Data;
+
+namespace EnvelopeGenerator.Jobs;
+
+public static class DataRowExtensions
+{
+    public static T? GetValueOrDefault<T>(this DataRow row, string columnName, T? defaultValue = default)
+    {
+        if (!row.Table.Columns.Contains(columnName))
+        {
+            return defaultValue;
+        }
+
+        var value = row[columnName];
+        if (value == DBNull.Value)
+        {
+            return defaultValue;
+        }
+
+        try
+        {
+            return (T)Convert.ChangeType(value, typeof(T));
+        }
+        catch
+        {
+            return defaultValue;
+        }
+    }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/FinalizeDocumentExceptions.cs

@@ -0,0 +1,28 @@
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public static class FinalizeDocumentExceptions
+{
+    public class MergeDocumentException : ApplicationException
+    {
+        public MergeDocumentException(string message) : base(message) { }
+        public MergeDocumentException(string message, Exception innerException) : base(message, innerException) { }
+    }
+
+    public class BurnAnnotationException : ApplicationException
+    {
+        public BurnAnnotationException(string message) : base(message) { }
+        public BurnAnnotationException(string message, Exception innerException) : base(message, innerException) { }
+    }
+
+    public class CreateReportException : ApplicationException
+    {
+        public CreateReportException(string message) : base(message) { }
+        public CreateReportException(string message, Exception innerException) : base(message, innerException) { }
+    }
+
+    public class ExportDocumentException : ApplicationException
+    {
+        public ExportDocumentException(string message) : base(message) { }
+        public ExportDocumentException(string message, Exception innerException) : base(message, innerException) { }
+    }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/FinalizeDocumentJob.cs

@@ -0,0 +1,229 @@
+using System.Collections.Generic;
+using System.Data;
+using System.IO;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using EnvelopeGenerator.Domain.Constants;
+using EnvelopeGenerator.Domain.Entities;
+using Microsoft.Data.SqlClient;
+using Microsoft.Extensions.Logging;
+using Quartz;
+using static EnvelopeGenerator.Jobs.FinalizeDocument.FinalizeDocumentExceptions;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class FinalizeDocumentJob : IJob
+{
+    private readonly ILogger<FinalizeDocumentJob> _logger;
+    private readonly PDFBurner _pdfBurner;
+    private readonly PDFMerger _pdfMerger;
+    private readonly ReportCreator _reportCreator;
+
+    private record ConfigSettings(string DocumentPath, string DocumentPathOrigin, string ExportPath);
+
+    public FinalizeDocumentJob(
+        ILogger<FinalizeDocumentJob> logger,
+        PDFBurner pdfBurner,
+        PDFMerger pdfMerger,
+        ReportCreator reportCreator)
+    {
+        _logger = logger;
+        _pdfBurner = pdfBurner;
+        _pdfMerger = pdfMerger;
+        _reportCreator = reportCreator;
+    }
+
+    public async Task Execute(IJobExecutionContext context)
+    {
+        var jobId = context.JobDetail.Key.ToString();
+        _logger.LogDebug("Starting job {JobId}", jobId);
+
+        try
+        {
+            var connectionString = context.MergedJobDataMap.GetString(Value.DATABASE);
+            if (string.IsNullOrWhiteSpace(connectionString))
+            {
+                _logger.LogWarning("FinalizeDocument - Connection string missing");
+                return;
+            }
+
+            await using var connection = new SqlConnection(connectionString);
+            await connection.OpenAsync(context.CancellationToken);
+
+            var config = await LoadConfigurationAsync(connection, context.CancellationToken);
+            var envelopes = await LoadCompletedEnvelopesAsync(connection, context.CancellationToken);
+
+            if (envelopes.Count == 0)
+            {
+                _logger.LogInformation("No completed envelopes found");
+                return;
+            }
+
+            var total = envelopes.Count;
+            var current = 1;
+
+            foreach (var envelopeId in envelopes)
+            {
+                _logger.LogInformation("Finalizing Envelope {EnvelopeId} ({Current}/{Total})", envelopeId, current, total);
+                try
+                {
+                    var envelopeData = await GetEnvelopeDataAsync(connection, envelopeId, context.CancellationToken);
+                    if (envelopeData is null)
+                    {
+                        _logger.LogWarning("Envelope data not found for {EnvelopeId}", envelopeId);
+                        continue;
+                    }
+
+                    var data = envelopeData.Value;
+
+                    var envelope = new Envelope
+                    {
+                        Id = envelopeId,
+                        Uuid = data.EnvelopeUuid ?? string.Empty,
+                        Title = data.Title ?? string.Empty,
+                        FinalEmailToCreator = (int)FinalEmailType.No,
+                        FinalEmailToReceivers = (int)FinalEmailType.No
+                    };
+
+                    var burned = _pdfBurner.BurnAnnotsToPDF(data.DocumentBytes, data.AnnotationData, envelopeId);
+                    var report = _reportCreator.CreateReport(connection, envelope);
+                    var merged = _pdfMerger.MergeDocuments(burned, report);
+
+                    var outputDirectory = Path.Combine(config.ExportPath, data.ParentFolderUid);
+                    Directory.CreateDirectory(outputDirectory);
+                    var outputPath = Path.Combine(outputDirectory, $"{envelope.Uuid}.pdf");
+                    await File.WriteAllBytesAsync(outputPath, merged, context.CancellationToken);
+
+                    await UpdateDocumentResultAsync(connection, envelopeId, merged, context.CancellationToken);
+                    await ArchiveEnvelopeAsync(connection, envelopeId, context.CancellationToken);
+                }
+                catch (MergeDocumentException ex)
+                {
+                    _logger.LogWarning(ex, "Certificate Document job failed at merging documents");
+                }
+                catch (ExportDocumentException ex)
+                {
+                    _logger.LogWarning(ex, "Certificate Document job failed at exporting document");
+                }
+                catch (Exception ex)
+                {
+                    _logger.LogError(ex, "Unhandled exception while working envelope {EnvelopeId}", envelopeId);
+                }
+
+                current++;
+                _logger.LogInformation("Envelope {EnvelopeId} finalized", envelopeId);
+            }
+
+            _logger.LogDebug("Completed job {JobId} successfully", jobId);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Certificate Document job failed");
+        }
+        finally
+        {
+            _logger.LogDebug("Job execution for {JobId} ended", jobId);
+        }
+    }
+
+    private async Task<ConfigSettings> LoadConfigurationAsync(SqlConnection connection, CancellationToken cancellationToken)
+    {
+        const string sql = "SELECT TOP 1 DOCUMENT_PATH, EXPORT_PATH FROM TBSIG_CONFIG";
+        await using var command = new SqlCommand(sql, connection);
+        await using var reader = await command.ExecuteReaderAsync(cancellationToken);
+        if (await reader.ReadAsync(cancellationToken))
+        {
+            var documentPath = reader.IsDBNull(0) ? string.Empty : reader.GetString(0);
+            var exportPath = reader.IsDBNull(1) ? string.Empty : reader.GetString(1);
+            return new ConfigSettings(documentPath, documentPath, exportPath);
+        }
+
+        return new ConfigSettings(string.Empty, string.Empty, Path.GetTempPath());
+    }
+
+    private async Task<List<int>> LoadCompletedEnvelopesAsync(SqlConnection connection, CancellationToken cancellationToken)
+    {
+        const string sql = "SELECT GUID FROM TBSIG_ENVELOPE WHERE STATUS = @Status AND DATEDIFF(minute, CHANGED_WHEN, GETDATE()) >= 1 ORDER BY GUID";
+        var ids = new List<int>();
+        await using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@Status", (int)EnvelopeStatus.EnvelopeCompletelySigned);
+        await using var reader = await command.ExecuteReaderAsync(cancellationToken);
+        while (await reader.ReadAsync(cancellationToken))
+        {
+            ids.Add(reader.GetInt32(0));
+        }
+
+        return ids;
+    }
+
+    private async Task<(int EnvelopeId, string? EnvelopeUuid, string? Title, byte[] DocumentBytes, List<string> AnnotationData, string ParentFolderUid)?> GetEnvelopeDataAsync(SqlConnection connection, int envelopeId, CancellationToken cancellationToken)
+    {
+        const string sql = @"SELECT T.GUID, T.ENVELOPE_UUID, T.TITLE, T2.FILEPATH, T2.BYTE_DATA FROM [dbo].[TBSIG_ENVELOPE] T
+                JOIN TBSIG_ENVELOPE_DOCUMENT T2 ON T.GUID = T2.ENVELOPE_ID
+                WHERE T.GUID = @EnvelopeId";
+
+        await using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+        await using var reader = await command.ExecuteReaderAsync(CommandBehavior.SingleRow, cancellationToken);
+        if (!await reader.ReadAsync(cancellationToken))
+        {
+            return null;
+        }
+
+        var envelopeUuid = reader.IsDBNull(1) ? string.Empty : reader.GetString(1);
+        var title = reader.IsDBNull(2) ? string.Empty : reader.GetString(2);
+        var filePath = reader.IsDBNull(3) ? string.Empty : reader.GetString(3);
+        var bytes = reader.IsDBNull(4) ? Array.Empty<byte>() : (byte[])reader[4];
+        await reader.CloseAsync();
+
+        if (bytes.Length == 0 && !string.IsNullOrWhiteSpace(filePath) && File.Exists(filePath))
+        {
+            bytes = await File.ReadAllBytesAsync(filePath, cancellationToken);
+        }
+
+        var annotations = await GetAnnotationDataAsync(connection, envelopeId, cancellationToken);
+
+        var parentFolderUid = !string.IsNullOrWhiteSpace(filePath)
+            ? Path.GetFileName(Path.GetDirectoryName(filePath) ?? string.Empty)
+            : envelopeUuid;
+
+        return (envelopeId, envelopeUuid, title, bytes, annotations, parentFolderUid ?? envelopeUuid ?? envelopeId.ToString());
+    }
+
+    private async Task<List<string>> GetAnnotationDataAsync(SqlConnection connection, int envelopeId, CancellationToken cancellationToken)
+    {
+        const string sql = "SELECT VALUE FROM TBSIG_DOCUMENT_STATUS WHERE ENVELOPE_ID = @EnvelopeId";
+        var result = new List<string>();
+        await using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+        await using var reader = await command.ExecuteReaderAsync(cancellationToken);
+        while (await reader.ReadAsync(cancellationToken))
+        {
+            if (!reader.IsDBNull(0))
+            {
+                result.Add(reader.GetString(0));
+            }
+        }
+
+        return result;
+    }
+
+    private static async Task UpdateDocumentResultAsync(SqlConnection connection, int envelopeId, byte[] bytes, CancellationToken cancellationToken)
+    {
+        const string sql = "UPDATE TBSIG_ENVELOPE SET DOC_RESULT = @ImageData WHERE GUID = @EnvelopeId";
+        await using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@ImageData", bytes);
+        command.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+        await command.ExecuteNonQueryAsync(cancellationToken);
+    }
+
+    private static async Task ArchiveEnvelopeAsync(SqlConnection connection, int envelopeId, CancellationToken cancellationToken)
+    {
+        const string sql = "UPDATE TBSIG_ENVELOPE SET STATUS = @Status, CHANGED_WHEN = GETDATE() WHERE GUID = @EnvelopeId";
+        await using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@Status", (int)EnvelopeStatus.EnvelopeArchived);
+        command.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+        await command.ExecuteNonQueryAsync(cancellationToken);
+    }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/PDFBurner.cs

@@ -0,0 +1,277 @@
+using System.Collections.Generic;
+using System.Drawing;
+using System.Linq;
+using iText.IO.Image;
+using iText.Kernel.Colors;
+using iText.Kernel.Pdf;
+using iText.Kernel.Pdf.Canvas;
+using iText.Layout;
+using iText.Layout.Element;
+using iText.Layout.Font;
+using iText.Layout.Properties;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using Newtonsoft.Json;
+using static EnvelopeGenerator.Jobs.FinalizeDocument.FinalizeDocumentExceptions;
+using LayoutImage = iText.Layout.Element.Image;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class PDFBurner
+{
+    private static readonly FontProvider FontProvider = CreateFontProvider();
+    private readonly ILogger<PDFBurner> _logger;
+    private readonly PDFBurnerParams _pdfBurnerParams;
+
+    public PDFBurner() : this(NullLogger<PDFBurner>.Instance, new PDFBurnerParams())
+    {
+    }
+
+    public PDFBurner(ILogger<PDFBurner> logger, PDFBurnerParams? pdfBurnerParams = null)
+    {
+        _logger = logger;
+        _pdfBurnerParams = pdfBurnerParams ?? new PDFBurnerParams();
+    }
+
+    public byte[] BurnAnnotsToPDF(byte[] sourceBuffer, IList<string> instantJsonList, int envelopeId)
+    {
+        if (sourceBuffer is null || sourceBuffer.Length == 0)
+        {
+            throw new BurnAnnotationException("Source document is empty");
+        }
+
+        try
+        {
+            using var inputStream = new MemoryStream(sourceBuffer);
+            using var outputStream = new MemoryStream();
+            using var reader = new PdfReader(inputStream);
+            using var writer = new PdfWriter(outputStream);
+            using var pdf = new PdfDocument(reader, writer);
+
+            foreach (var json in instantJsonList ?? Enumerable.Empty<string>())
+            {
+                if (string.IsNullOrWhiteSpace(json))
+                {
+                    continue;
+                }
+
+                var annotationData = JsonConvert.DeserializeObject<AnnotationData>(json);
+                if (annotationData?.annotations is null)
+                {
+                    continue;
+                }
+
+                annotationData.annotations.Reverse();
+
+                foreach (var annotation in annotationData.annotations)
+                {
+                    try
+                    {
+                        switch (annotation.type)
+                        {
+                            case AnnotationType.Image:
+                                AddImageAnnotation(pdf, annotation, annotationData.attachments);
+                                break;
+                            case AnnotationType.Ink:
+                                AddInkAnnotation(pdf, annotation);
+                                break;
+                            case AnnotationType.Widget:
+                                var formFieldValue = annotationData.formFieldValues?.FirstOrDefault(fv => fv.name == annotation.id);
+                                if (formFieldValue is not null && !_pdfBurnerParams.IgnoredLabels.Contains(formFieldValue.value))
+                                {
+                                    AddFormFieldValue(pdf, annotation, formFieldValue.value);
+                                }
+                                break;
+                        }
+                    }
+                    catch (Exception ex)
+                    {
+                        _logger.LogWarning(ex, "Error applying annotation {AnnotationId} on envelope {EnvelopeId}", annotation.id, envelopeId);
+                        throw new BurnAnnotationException("Adding annotation failed", ex);
+                    }
+                }
+            }
+
+            pdf.Close();
+            return outputStream.ToArray();
+        }
+        catch (BurnAnnotationException)
+        {
+            throw;
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to burn annotations for envelope {EnvelopeId}", envelopeId);
+            throw new BurnAnnotationException("Annotations could not be burned", ex);
+        }
+    }
+
+    private void AddImageAnnotation(PdfDocument pdf, Annotation annotation, Dictionary<string, Attachment>? attachments)
+    {
+        if (attachments is null || string.IsNullOrWhiteSpace(annotation.imageAttachmentId) || !attachments.TryGetValue(annotation.imageAttachmentId, out var attachment))
+        {
+            return;
+        }
+
+        var page = pdf.GetPage(annotation.pageIndex + 1);
+        var bounds = annotation.bbox.Select(ToInches).ToList();
+        var x = (float)bounds[0];
+        var y = (float)bounds[1];
+        var width = (float)bounds[2];
+        var height = (float)bounds[3];
+
+        var imageBytes = Convert.FromBase64String(attachment.binary);
+        var imageData = ImageDataFactory.Create(imageBytes);
+        var image = new LayoutImage(imageData)
+            .ScaleAbsolute(width, height)
+            .SetFixedPosition(annotation.pageIndex + 1, x, y);
+
+        using var canvas = new Canvas(new PdfCanvas(page), page.GetPageSize());
+        canvas.Add(image);
+    }
+
+    private void AddInkAnnotation(PdfDocument pdf, Annotation annotation)
+    {
+        if (annotation.lines?.points is null)
+        {
+            return;
+        }
+
+        var page = pdf.GetPage(annotation.pageIndex + 1);
+        var canvas = new PdfCanvas(page);
+        var color = ParseColor(annotation.strokeColor);
+        canvas.SetStrokeColor(color);
+        canvas.SetLineWidth(1);
+
+        foreach (var segment in annotation.lines.points)
+        {
+            var first = true;
+            foreach (var point in segment)
+            {
+                var (px, py) = (ToInches(point[0]), ToInches(point[1]));
+                if (first)
+                {
+                    canvas.MoveTo(px, py);
+                    first = false;
+                }
+                else
+                {
+                    canvas.LineTo(px, py);
+                }
+            }
+            canvas.Stroke();
+        }
+    }
+
+    private static FontProvider CreateFontProvider()
+    {
+        var provider = new FontProvider();
+        provider.AddStandardPdfFonts();
+        provider.AddSystemFonts();
+        return provider;
+    }
+
+    private void AddFormFieldValue(PdfDocument pdf, Annotation annotation, string value)
+    {
+        var bounds = annotation.bbox.Select(ToInches).ToList();
+        var x = (float)bounds[0];
+        var y = (float)bounds[1];
+        var width = (float)bounds[2];
+        var height = (float)bounds[3];
+
+        var page = pdf.GetPage(annotation.pageIndex + 1);
+        var canvas = new Canvas(new PdfCanvas(page), page.GetPageSize());
+        canvas.SetProperty(Property.FONT_PROVIDER, FontProvider);
+        canvas.SetProperty(Property.FONT, FontProvider.GetFontSet());
+
+        var paragraph = new Paragraph(value)
+            .SetFontSize(_pdfBurnerParams.FontSize)
+            .SetFontColor(ColorConstants.BLACK)
+            .SetFontFamily(_pdfBurnerParams.FontName);
+
+        if (_pdfBurnerParams.FontStyle.HasFlag(FontStyle.Italic))
+        {
+            paragraph.SetItalic();
+        }
+
+        if (_pdfBurnerParams.FontStyle.HasFlag(FontStyle.Bold))
+        {
+            paragraph.SetBold();
+        }
+
+        canvas.ShowTextAligned(
+            paragraph,
+            x + (float)_pdfBurnerParams.TopMargin,
+            y + (float)_pdfBurnerParams.YOffset,
+            annotation.pageIndex + 1,
+            iText.Layout.Properties.TextAlignment.LEFT,
+            iText.Layout.Properties.VerticalAlignment.TOP,
+            0);
+    }
+
+    private static DeviceRgb ParseColor(string? color)
+    {
+        if (string.IsNullOrWhiteSpace(color))
+        {
+            return new DeviceRgb(0, 0, 0);
+        }
+
+        try
+        {
+            var drawingColor = ColorTranslator.FromHtml(color);
+            return new DeviceRgb(drawingColor.R, drawingColor.G, drawingColor.B);
+        }
+        catch
+        {
+            return new DeviceRgb(0, 0, 0);
+        }
+    }
+
+    private static double ToInches(double value) => value / 72d;
+    private static double ToInches(float value) => value / 72d;
+
+    #region Model
+    private static class AnnotationType
+    {
+        public const string Image = "pspdfkit/image";
+        public const string Ink = "pspdfkit/ink";
+        public const string Widget = "pspdfkit/widget";
+    }
+
+    private sealed class AnnotationData
+    {
+        public List<Annotation>? annotations { get; set; }
+        public Dictionary<string, Attachment>? attachments { get; set; }
+        public List<FormFieldValue>? formFieldValues { get; set; }
+    }
+
+    private sealed class Annotation
+    {
+        public string id { get; set; } = string.Empty;
+        public List<double> bbox { get; set; } = new();
+        public string type { get; set; } = string.Empty;
+        public string imageAttachmentId { get; set; } = string.Empty;
+        public Lines? lines { get; set; }
+        public int pageIndex { get; set; }
+        public string strokeColor { get; set; } = string.Empty;
+        public string egName { get; set; } = string.Empty;
+    }
+
+    private sealed class Lines
+    {
+        public List<List<List<float>>> points { get; set; } = new();
+    }
+
+    private sealed class Attachment
+    {
+        public string binary { get; set; } = string.Empty;
+        public string contentType { get; set; } = string.Empty;
+    }
+
+    private sealed class FormFieldValue
+    {
+        public string name { get; set; } = string.Empty;
+        public string value { get; set; } = string.Empty;
+    }
+    #endregion
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/PDFBurnerParams.cs

@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+using System.Drawing;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class PDFBurnerParams
+{
+    public List<string> IgnoredLabels { get; } = new() { "Date", "Datum", "ZIP", "PLZ", "Place", "Ort", "Position", "Stellung" };
+
+    public double TopMargin { get; set; } = 0.1;
+
+    public double YOffset { get; set; } = -0.3;
+
+    public string FontName { get; set; } = "Arial";
+
+    public int FontSize { get; set; } = 8;
+
+    public FontStyle FontStyle { get; set; } = FontStyle.Italic;
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/PDFMerger.cs

@@ -0,0 +1,46 @@
+using System.IO;
+using iText.Kernel.Pdf;
+using iText.Kernel.Utils;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using static EnvelopeGenerator.Jobs.FinalizeDocument.FinalizeDocumentExceptions;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class PDFMerger
+{
+    private readonly ILogger<PDFMerger> _logger;
+
+    public PDFMerger() : this(NullLogger<PDFMerger>.Instance)
+    {
+    }
+
+    public PDFMerger(ILogger<PDFMerger> logger)
+    {
+        _logger = logger;
+    }
+
+    public byte[] MergeDocuments(byte[] document, byte[] report)
+    {
+        try
+        {
+            using var finalStream = new MemoryStream();
+            using var documentReader = new PdfReader(new MemoryStream(document));
+            using var reportReader = new PdfReader(new MemoryStream(report));
+            using var writer = new PdfWriter(finalStream);
+            using var targetDoc = new PdfDocument(documentReader, writer);
+            using var reportDoc = new PdfDocument(reportReader);
+
+            var merger = new PdfMerger(targetDoc);
+            merger.Merge(reportDoc, 1, reportDoc.GetNumberOfPages());
+
+            targetDoc.Close();
+            return finalStream.ToArray();
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to merge PDF documents");
+            throw new MergeDocumentException("Documents could not be merged", ex);
+        }
+    }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/ReportCreator.cs

@@ -0,0 +1,91 @@
+using System.Data;
+using System.IO;
+using EnvelopeGenerator.Domain.Entities;
+using iText.Kernel.Pdf;
+using iText.Layout.Element;
+using Microsoft.Data.SqlClient;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using static EnvelopeGenerator.Jobs.FinalizeDocument.FinalizeDocumentExceptions;
+using LayoutDocument = iText.Layout.Document;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class ReportCreator
+{
+    private readonly ILogger<ReportCreator> _logger;
+
+    public ReportCreator() : this(NullLogger<ReportCreator>.Instance)
+    {
+    }
+
+    public ReportCreator(ILogger<ReportCreator> logger)
+    {
+        _logger = logger;
+    }
+
+    public byte[] CreateReport(SqlConnection connection, Envelope envelope)
+    {
+        try
+        {
+            var reportItems = LoadReportItems(connection, envelope.Id);
+            using var stream = new MemoryStream();
+            using var writer = new PdfWriter(stream);
+            using var pdf = new PdfDocument(writer);
+            using var document = new LayoutDocument(pdf);
+
+            document.Add(new Paragraph("Envelope Finalization Report").SetFontSize(16));
+            document.Add(new Paragraph($"Envelope Id: {envelope.Id}"));
+            document.Add(new Paragraph($"UUID: {envelope.Uuid}"));
+            document.Add(new Paragraph($"Title: {envelope.Title}"));
+            document.Add(new Paragraph($"Subject: {envelope.Comment}"));
+            document.Add(new Paragraph($"Generated: {DateTime.UtcNow:O}"));
+            document.Add(new Paragraph(" "));
+
+            var table = new Table(4).UseAllAvailableWidth();
+            table.AddHeaderCell("Date");
+            table.AddHeaderCell("Status");
+            table.AddHeaderCell("User");
+            table.AddHeaderCell("EnvelopeId");
+
+            foreach (var item in reportItems.OrderByDescending(r => r.ItemDate))
+            {
+                table.AddCell(item.ItemDate.ToString("u"));
+                table.AddCell(item.ItemStatus.ToString());
+                table.AddCell(item.ItemUserReference);
+                table.AddCell(item.EnvelopeId.ToString());
+            }
+
+            document.Add(table);
+            document.Close();
+            return stream.ToArray();
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Could not create report for envelope {EnvelopeId}", envelope.Id);
+            throw new CreateReportException("Could not prepare report data", ex);
+        }
+    }
+
+    private List<ReportItem> LoadReportItems(SqlConnection connection, int envelopeId)
+    {
+        const string sql = "SELECT ENVELOPE_ID, POS_WHEN, POS_STATUS, POS_WHO FROM VWSIG_ENVELOPE_REPORT WHERE ENVELOPE_ID = @EnvelopeId";
+        var result = new List<ReportItem>();
+
+        using var command = new SqlCommand(sql, connection);
+        command.Parameters.AddWithValue("@EnvelopeId", envelopeId);
+        using var reader = command.ExecuteReader();
+        while (reader.Read())
+        {
+            result.Add(new ReportItem
+            {
+                EnvelopeId = reader.GetInt32(0),
+                ItemDate = reader.IsDBNull(1) ? DateTime.MinValue : reader.GetDateTime(1),
+                ItemStatus = reader.IsDBNull(2) ? default : (EnvelopeGenerator.Domain.Constants.EnvelopeStatus)reader.GetInt32(2),
+                ItemUserReference = reader.IsDBNull(3) ? string.Empty : reader.GetString(3)
+            });
+        }
+
+        return result;
+    }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/ReportItem.cs

@@ -0,0 +1,19 @@
+using EnvelopeGenerator.Domain.Constants;
+using EnvelopeGenerator.Domain.Entities;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class ReportItem
+{
+    public Envelope? Envelope { get; set; }
+    public int EnvelopeId { get; set; }
+    public string EnvelopeTitle { get; set; } = string.Empty;
+    public string EnvelopeSubject { get; set; } = string.Empty;
+
+    public EnvelopeStatus ItemStatus { get; set; }
+
+    public string ItemStatusTranslated => ItemStatus.ToString();
+
+    public string ItemUserReference { get; set; } = string.Empty;
+    public DateTime ItemDate { get; set; }
+}

EnvelopeGenerator.Jobs/Jobs/FinalizeDocument/ReportSource.cs

@@ -0,0 +1,8 @@
+using System.Collections.Generic;
+
+namespace EnvelopeGenerator.Jobs.FinalizeDocument;
+
+public class ReportSource
+{
+    public List<ReportItem> Items { get; set; } = new();
+}

EnvelopeGenerator.Web/Controllers/Test/TestEnvelopeController.cs

@@ -1,32 +1,56 @@
-using Microsoft.AspNetCore.Mvc;
+using EnvelopeGenerator.Domain.Entities;
+using Microsoft.AspNetCore.Mvc;
+using EnvelopeGenerator.Application.Common.Dto;
 using EnvelopeGenerator.Application.Common.Extensions;
-using MediatR;
+using EnvelopeGenerator.Application.Common.Interfaces.Services;
-using EnvelopeGenerator.Application.Envelopes.Queries;
 
 namespace EnvelopeGenerator.Web.Controllers.Test;
 
 [Obsolete("Use MediatR")]
-public class TestEnvelopeController : ControllerBase
+public class TestEnvelopeController : TestControllerBase<IEnvelopeService, EnvelopeDto, Envelope, int>
 {
-    private readonly IMediator _mediator;
+    public TestEnvelopeController(ILogger<TestEnvelopeController> logger, IEnvelopeService service) : base(logger, service)
-
-    /// <summary>
-    /// 
-    /// </summary>
-    /// <param name="mediator"></param>
-    public TestEnvelopeController(IMediator mediator)
     {
-        _mediator = mediator;
     }
 
+    [NonAction]
+    public override Task<IActionResult> GetAll() => base.GetAll();
+
     [HttpGet]
-    public async Task<IActionResult> GetAll([FromQuery] ReadEnvelopeQuery query, CancellationToken cancel) => Ok(await _mediator.Send(query, cancel));
+    public async Task<IActionResult> GetAll([FromQuery] string? envelopeKey = default, [FromQuery] bool withDocuments = false, [FromQuery] bool withHistory = false, [FromQuery] bool withDocumentReceiverElement = false, [FromQuery] bool withUser = false, [FromQuery] bool withAll = true)
+    {
+        if (envelopeKey is not null)
+        {
+            (var uuid, var signature) = envelopeKey.DecodeEnvelopeReceiverId();
+            if (uuid is null)
+                return BadRequest("UUID is null");
+            var envlopeServiceResult = await _service.ReadByUuidAsync(
+                uuid: uuid,
+                withDocuments: withDocuments, withHistory: withHistory, withDocumentReceiverElement: withDocumentReceiverElement, withUser: withUser, withAll: withAll);
+
+            if (envlopeServiceResult.IsSuccess)
+            {
+                return Ok(envlopeServiceResult.Data);
+            }
+            return NotFound();
+        }
+
+        var result = await _service.ReadAllWithAsync(documents: withDocuments, history: withHistory);
+        if (result.IsSuccess)
+        {
+            return Ok(result);
+        }
+        return NotFound(result);
+    }
 
     [HttpGet("decode")]
-    public IActionResult DecodeEnvelopeReceiverId(string envelopeReceiverId, int type = 0) => type switch
+    public IActionResult DecodeEnvelopeReceiverId(string envelopeReceiverId, int type = 0)
     {
-        1 => Ok(envelopeReceiverId.GetEnvelopeUuid()),
+        return type switch
-        2 => Ok(envelopeReceiverId.GetReceiverSignature()),
+        {
-        _ => Ok(envelopeReceiverId.DecodeEnvelopeReceiverId()),
+            1 => Ok(envelopeReceiverId.GetEnvelopeUuid()),
-    };
+            2 => Ok(envelopeReceiverId.GetReceiverSignature()),
+            _ => Ok(envelopeReceiverId.DecodeEnvelopeReceiverId()),
+        };
+    }
 }

EnvelopeGenerator.WorkerService/Configuration/WorkerSettings.cs

@@ -0,0 +1,14 @@
+using EnvelopeGenerator.Jobs.FinalizeDocument;
+
+namespace EnvelopeGenerator.WorkerService.Configuration;
+
+public sealed class WorkerSettings
+{
+    public string ConnectionString { get; set; } = string.Empty;
+
+    public bool Debug { get; set; }
+
+    public int IntervalMinutes { get; set; } = 1;
+
+    public PDFBurnerParams PdfBurner { get; set; } = new();
+}

EnvelopeGenerator.WorkerService/EnvelopeGenerator.WorkerService.csproj

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk.Worker">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <UserSecretsId>dotnet-EnvelopeGenerator.WorkerService-0636abb8-6085-477d-9f56-1a9787e84dde</UserSecretsId>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="BouncyCastle.Cryptography" Version="2.6.2" />
+    <PackageReference Include="HtmlSanitizer" Version="9.0.892" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.1" />
+    <PackageReference Include="Microsoft.Identity.Client" Version="4.82.1" />
+    <PackageReference Include="Quartz.Extensions.Hosting" Version="3.9.0" />
+    <PackageReference Include="SixLabors.ImageSharp" Version="3.1.12" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\EnvelopeGenerator.Jobs\EnvelopeGenerator.Jobs.csproj" />
+  </ItemGroup>
+</Project>

EnvelopeGenerator.WorkerService/Program.cs

@@ -0,0 +1,67 @@
+using EnvelopeGenerator.Domain.Constants;
+using EnvelopeGenerator.Jobs.APIBackendJobs;
+using EnvelopeGenerator.Jobs.FinalizeDocument;
+using EnvelopeGenerator.WorkerService;
+using EnvelopeGenerator.WorkerService.Configuration;
+using EnvelopeGenerator.WorkerService.Services;
+using Quartz;
+
+var builder = Host.CreateApplicationBuilder(args);
+
+builder.Services.Configure<WorkerSettings>(builder.Configuration.GetSection("WorkerSettings"));
+
+builder.Services.AddSingleton<TempFileManager>();
+builder.Services.AddSingleton(provider =>
+{
+    var settings = provider.GetRequiredService<Microsoft.Extensions.Options.IOptions<WorkerSettings>>().Value;
+    var logger = provider.GetRequiredService<ILogger<PDFBurner>>();
+    return new PDFBurner(logger, settings.PdfBurner);
+});
+builder.Services.AddSingleton<PDFMerger>();
+builder.Services.AddSingleton<ReportCreator>();
+
+builder.Services.AddQuartz(q =>
+{
+    q.UseMicrosoftDependencyInjectionJobFactory();
+    q.UseDefaultThreadPool(tp => tp.MaxConcurrency = 5);
+
+    var settings = new WorkerSettings();
+    builder.Configuration.GetSection("WorkerSettings").Bind(settings);
+    var intervalMinutes = Math.Max(1, settings.IntervalMinutes);
+
+    var finalizeJobKey = new JobKey("FinalizeDocumentJob");
+    q.AddJob<FinalizeDocumentJob>(opts => opts
+        .WithIdentity(finalizeJobKey)
+        .UsingJobData(Value.DATABASE, settings.ConnectionString));
+
+    q.AddTrigger(opts => opts
+        .ForJob(finalizeJobKey)
+        .WithIdentity("FinalizeDocumentJob-trigger")
+        .StartNow()
+        .WithSimpleSchedule(x => x
+            .WithIntervalInMinutes(intervalMinutes)
+            .RepeatForever()));
+
+    var apiJobKey = new JobKey("APIEnvelopeJob");
+    q.AddJob<APIEnvelopeJob>(opts => opts
+        .WithIdentity(apiJobKey)
+        .UsingJobData(Value.DATABASE, settings.ConnectionString));
+
+    q.AddTrigger(opts => opts
+        .ForJob(apiJobKey)
+        .WithIdentity("APIEnvelopeJob-trigger")
+        .StartNow()
+        .WithSimpleSchedule(x => x
+            .WithIntervalInMinutes(intervalMinutes)
+            .RepeatForever()));
+});
+
+builder.Services.AddQuartzHostedService(options =>
+{
+    options.WaitForJobsToComplete = true;
+});
+
+builder.Services.AddHostedService<Worker>();
+
+var host = builder.Build();
+host.Run();

EnvelopeGenerator.WorkerService/Properties/launchSettings.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "EnvelopeGenerator.WorkerService": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "environmentVariables": {
+        "DOTNET_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

EnvelopeGenerator.WorkerService/Services/TempFileManager.cs

@@ -0,0 +1,74 @@
+using System.IO;
+using Microsoft.Extensions.Logging;
+
+namespace EnvelopeGenerator.WorkerService.Services;
+
+public sealed class TempFileManager
+{
+    private readonly ILogger<TempFileManager> _logger;
+
+    public TempFileManager(ILogger<TempFileManager> logger)
+    {
+        _logger = logger;
+        TempPath = Path.Combine(Path.GetTempPath(), "EnvelopeGenerator");
+    }
+
+    public string TempPath { get; }
+
+    public Task CreateAsync(CancellationToken cancellationToken = default)
+    {
+        try
+        {
+            if (!Directory.Exists(TempPath))
+            {
+                Directory.CreateDirectory(TempPath);
+                _logger.LogDebug("Created temp folder {TempPath}", TempPath);
+            }
+            else
+            {
+                CleanUpFiles();
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to create temp folder {TempPath}", TempPath);
+            throw;
+        }
+
+        return Task.CompletedTask;
+    }
+
+    public Task CleanupAsync(CancellationToken cancellationToken = default)
+    {
+        try
+        {
+            if (Directory.Exists(TempPath))
+            {
+                _logger.LogDebug("Deleting temp folder {TempPath}", TempPath);
+                Directory.Delete(TempPath, recursive: true);
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to clean up temp folder {TempPath}", TempPath);
+        }
+
+        return Task.CompletedTask;
+    }
+
+    private void CleanUpFiles()
+    {
+        foreach (var file in Directory.GetFiles(TempPath))
+        {
+            try
+            {
+                _logger.LogDebug("Deleting temp file {File}", file);
+                File.Delete(file);
+            }
+            catch (Exception ex)
+            {
+                _logger.LogWarning(ex, "Failed to delete temp file {File}", file);
+            }
+        }
+    }
+}

EnvelopeGenerator.WorkerService/Worker.cs

@@ -0,0 +1,71 @@
+using EnvelopeGenerator.WorkerService.Configuration;
+using EnvelopeGenerator.WorkerService.Services;
+using Microsoft.Data.SqlClient;
+using Microsoft.Extensions.Options;
+
+namespace EnvelopeGenerator.WorkerService;
+
+public class Worker : BackgroundService
+{
+    private readonly ILogger<Worker> _logger;
+    private readonly WorkerSettings _settings;
+    private readonly TempFileManager _tempFiles;
+
+    public Worker(
+        ILogger<Worker> logger,
+        IOptions<WorkerSettings> settings,
+        TempFileManager tempFiles)
+    {
+        _logger = logger;
+        _settings = settings.Value;
+        _tempFiles = tempFiles;
+    }
+
+    public override async Task StartAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Starting EnvelopeGenerator worker...");
+        _logger.LogInformation("Debug mode: {Debug}", _settings.Debug);
+
+        ValidateConfiguration();
+        await EnsureDatabaseConnectionAsync(cancellationToken);
+        await _tempFiles.CreateAsync(cancellationToken);
+
+        await base.StartAsync(cancellationToken);
+    }
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        _logger.LogInformation("EnvelopeGenerator worker is running. Jobs are scheduled every {Interval} minute(s).", Math.Max(1, _settings.IntervalMinutes));
+        await Task.Delay(Timeout.Infinite, stoppingToken);
+    }
+
+    public override async Task StopAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Stopping EnvelopeGenerator worker...");
+        await _tempFiles.CleanupAsync(cancellationToken);
+        await base.StopAsync(cancellationToken);
+    }
+
+    private void ValidateConfiguration()
+    {
+        if (string.IsNullOrWhiteSpace(_settings.ConnectionString))
+        {
+            throw new InvalidOperationException("Connection string cannot be empty. Configure 'WorkerSettings:ConnectionString'.");
+        }
+    }
+
+    private async Task EnsureDatabaseConnectionAsync(CancellationToken cancellationToken)
+    {
+        try
+        {
+            await using var connection = new SqlConnection(_settings.ConnectionString);
+            await connection.OpenAsync(cancellationToken);
+            _logger.LogInformation("Database connection established successfully.");
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Database connection could not be established.");
+            throw;
+        }
+    }
+}

EnvelopeGenerator.WorkerService/appsettings.Development.json

@@ -0,0 +1,30 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Debug",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "WorkerSettings": {
+    "ConnectionString": "Server=SDD-VMP04-SQL17\\DD_DEVELOP01;Database=DD_ECM;User Id=sa;Password=dd;Encrypt=false;TrustServerCertificate=True;",
+    "Debug": true,
+    "IntervalMinutes": 1,
+    "PdfBurner": {
+      "IgnoredLabels": [
+        "Date",
+        "Datum",
+        "ZIP",
+        "PLZ",
+        "Place",
+        "Ort",
+        "Position",
+        "Stellung"
+      ],
+      "TopMargin": 0.1,
+      "YOffset": -0.3,
+      "FontName": "Arial",
+      "FontSize": 8,
+      "FontStyle": "Italic"
+    }
+  }
+}

EnvelopeGenerator.WorkerService/appsettings.json

@@ -0,0 +1,21 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "WorkerSettings": {
+    "ConnectionString": "Server=SDD-VMP04-SQL17\\DD_DEVELOP01;Database=DD_ECM;User Id=sa;Password=dd;Encrypt=false;TrustServerCertificate=True;",
+    "Debug": false,
+    "IntervalMinutes": 1,
+    "PdfBurner": {
+      "IgnoredLabels": ["Date", "Datum", "ZIP", "PLZ", "Place", "Ort", "Position", "Stellung"],
+      "TopMargin": 0.1,
+      "YOffset": -0.3,
+      "FontName": "Arial",
+      "FontSize": 8,
+      "FontStyle": "Italic"
+    }
+  }
+}

EnvelopeGenerator.sln

@@ -33,8 +33,18 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.PdfEditor
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.Tests", "EnvelopeGenerator.Tests\EnvelopeGenerator.Tests.csproj", "{224C4845-1CDE-22B7-F3A9-1FF9297F70E8}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.Jobs", "EnvelopeGenerator.Jobs\EnvelopeGenerator.Jobs.csproj", "{3D0514EA-2681-4B13-AD71-35CC6363DBD7}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.WorkerService", "EnvelopeGenerator.WorkerService\EnvelopeGenerator.WorkerService.csproj", "{E3676510-7030-4E85-86E1-51E483E2A3B6}"
+EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.API", "EnvelopeGenerator.API\EnvelopeGenerator.API.csproj", "{EC768913-6270-14F4-1DD3-69C87A659462}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "receiverUI", "receiverUI", "{73D8F466-90AA-4F95-9BD1-7CDBB8565162}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.ReceiverUI.Web", "receiverUI\EnvelopeGenerator.ReceiverUI.Web\EnvelopeGenerator.ReceiverUI.Web\EnvelopeGenerator.ReceiverUI.Web.csproj", "{AAD4720E-D175-44B5-B431-DB0BA636CD20}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EnvelopeGenerator.ReceiverUI.Web.Client", "receiverUI\EnvelopeGenerator.ReceiverUI.Web\EnvelopeGenerator.ReceiverUI.Web.Client\EnvelopeGenerator.ReceiverUI.Web.Client.csproj", "{5D97B2C2-E19B-4958-81E1-38864EC88FEB}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -81,10 +91,26 @@ Global
 		{224C4845-1CDE-22B7-F3A9-1FF9297F70E8}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{224C4845-1CDE-22B7-F3A9-1FF9297F70E8}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{224C4845-1CDE-22B7-F3A9-1FF9297F70E8}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3D0514EA-2681-4B13-AD71-35CC6363DBD7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3D0514EA-2681-4B13-AD71-35CC6363DBD7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3D0514EA-2681-4B13-AD71-35CC6363DBD7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3D0514EA-2681-4B13-AD71-35CC6363DBD7}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E3676510-7030-4E85-86E1-51E483E2A3B6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E3676510-7030-4E85-86E1-51E483E2A3B6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E3676510-7030-4E85-86E1-51E483E2A3B6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E3676510-7030-4E85-86E1-51E483E2A3B6}.Release|Any CPU.Build.0 = Release|Any CPU
 		{EC768913-6270-14F4-1DD3-69C87A659462}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{EC768913-6270-14F4-1DD3-69C87A659462}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{EC768913-6270-14F4-1DD3-69C87A659462}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{EC768913-6270-14F4-1DD3-69C87A659462}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AAD4720E-D175-44B5-B431-DB0BA636CD20}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AAD4720E-D175-44B5-B431-DB0BA636CD20}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AAD4720E-D175-44B5-B431-DB0BA636CD20}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AAD4720E-D175-44B5-B431-DB0BA636CD20}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5D97B2C2-E19B-4958-81E1-38864EC88FEB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5D97B2C2-E19B-4958-81E1-38864EC88FEB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5D97B2C2-E19B-4958-81E1-38864EC88FEB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5D97B2C2-E19B-4958-81E1-38864EC88FEB}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -103,7 +129,12 @@ Global
 		{6D56C01F-D6CB-4D8A-BD3D-4FD34326998C} = {E3C758DC-914D-4B7E-8457-0813F1FDB0CB}
 		{211619F5-AE25-4BA5-A552-BACAFE0632D3} = {9943209E-1744-4944-B1BA-4F87FC1A0EEB}
 		{224C4845-1CDE-22B7-F3A9-1FF9297F70E8} = {0CBC2432-A561-4440-89BC-671B66A24146}
+		{3D0514EA-2681-4B13-AD71-35CC6363DBD7} = {9943209E-1744-4944-B1BA-4F87FC1A0EEB}
+		{E3676510-7030-4E85-86E1-51E483E2A3B6} = {9943209E-1744-4944-B1BA-4F87FC1A0EEB}
 		{EC768913-6270-14F4-1DD3-69C87A659462} = {E3C758DC-914D-4B7E-8457-0813F1FDB0CB}
+		{73D8F466-90AA-4F95-9BD1-7CDBB8565162} = {E3C758DC-914D-4B7E-8457-0813F1FDB0CB}
+		{AAD4720E-D175-44B5-B431-DB0BA636CD20} = {73D8F466-90AA-4F95-9BD1-7CDBB8565162}
+		{5D97B2C2-E19B-4958-81E1-38864EC88FEB} = {73D8F466-90AA-4F95-9BD1-7CDBB8565162}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {73E60370-756D-45AD-A19A-C40A02DACCC7}

receiverUI/.github/copilot-instructions.md

@@ -0,0 +1,22 @@
+---
+description: 'Answer questions about DevExpress UI Components and their APIs using the dxdocs server'
+---
+
+You are a .NET programmer and DevExpress products expert.
+
+You are tasked with answering questions about DevExpress components and their APIs using dxdocs MCP server tools.
+
+For **ANY** question about DevExpress components, use the dxdocs server to construct your answer.
+
+## Workflow:
+1. **Call devexpress_docs_search** to obtain help topics related to the user question
+2. **Call devexpress_docs_get_content** to fetch and read most relevant help topics
+3. **Reflect on obtained content** and how it relates to the question
+4. **Provide a comprehensive answer** based solely on retrieved information
+
+## Constraints:
+- **Use devexpress_docs_search only once per question** to avoid redundant queries
+- When answering questions, **use only information obtained from MCP server tools**
+- **Include code examples** when available in the documentation
+- **Reference specific DevExpress controls and properties** mentioned in the documentation
+- **Invoke version-specific MCP tools** (for example, dxdocs25_1) if a user specifies a version (for example, v25.1)

receiverUI/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "servers": {
+    "dxdocs": {
+      "url": "https://api.devexpress.com/mcp/docs",
+      "type": "http"
+    },
+    "dxdocs25_1": {
+      "url": "https://api.devexpress.com/mcp/docs?v=25.1",
+      "type": "http"
+    }
+  }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Api/Models/EnvelopeDtos.cs

@@ -0,0 +1,126 @@
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Api.Models;
+
+/// <summary>
+/// Client-side DTOs for envelope display. These mirror the server-side
+/// EnvelopeReceiverDto / EnvelopeDto / DocumentDto used by the existing
+/// API endpoints, but expose only the fields the receiver UI actually needs.
+/// JSON serialization is camelCase by default (System.Text.Json).
+/// </summary>
+public class EnvelopeReceiverDto
+{
+    public long EnvelopeId { get; set; }
+    public long ReceiverId { get; set; }
+    public string? Name { get; set; }
+    public bool HasPhoneNumber { get; set; }
+    public EnvelopeDto? Envelope { get; set; }
+    public ReceiverDto? Receiver { get; set; }
+}
+
+public class EnvelopeDto
+{
+    public long Id { get; set; }
+    public string? Uuid { get; set; }
+    public string? Title { get; set; }
+    public string? Message { get; set; }
+    public bool ReadOnly { get; set; }
+    public bool UseAccessCode { get; set; }
+    public bool TFAEnabled { get; set; }
+    public DateTime AddedWhen { get; set; }
+    public SenderUserDto? User { get; set; }
+    public List<DocumentDto>? Documents { get; set; }
+}
+
+public class SenderUserDto
+{
+    public string? Email { get; set; }
+    public string? Prename { get; set; }
+    public string? Name { get; set; }
+}
+
+public class ReceiverDto
+{
+    public long Id { get; set; }
+    public string? EmailAddress { get; set; }
+    public string? Signature { get; set; }
+    public string? Prename { get; set; }
+    public string? Name { get; set; }
+}
+
+public class DocumentDto
+{
+    public long Id { get; set; }
+    public string? Name { get; set; }
+    public List<DocumentElementDto>? Elements { get; set; }
+}
+
+/// <summary>
+/// Signature placement on a PDF document. Pixel/inch units follow the same
+/// convention as the legacy PSPDFKit pipeline.
+/// </summary>
+public class DocumentElementDto
+{
+    public int Id { get; set; }
+    public int Page { get; set; }
+    public double Left { get; set; }
+    public double Top { get; set; }
+}
+
+/// <summary>
+/// Body for <c>POST /api/readonly</c> (share read-only link with another e-mail).
+/// </summary>
+public class ReadOnlyShareRequest
+{
+    public string ReceiverMail { get; set; } = string.Empty;
+    public DateTime DateValid { get; set; }
+}
+
+/// <summary>
+/// Returned by <c>GET /api/annotation/elements</c>. Each item describes a
+/// signature placeholder the authenticated receiver must sign on the
+/// current envelope. Coordinates are in PDF points relative to the page.
+/// </summary>
+public class SignatureElementDto
+{
+    public int Id { get; set; }
+    public int Page { get; set; }
+    public double X { get; set; }
+    public double Y { get; set; }
+    public double Width { get; set; }
+    public double Height { get; set; }
+    public bool Required { get; set; }
+    public string? Tooltip { get; set; }
+}
+
+/// <summary>
+/// Body of <c>POST /api/annotation/blazor</c> — mirrors the API-side
+/// <c>BlazorSignaturePayload</c>.
+/// </summary>
+public class BlazorSignaturePayload
+{
+    public List<BlazorSignatureEntry> Signatures { get; set; } = new();
+}
+
+public class BlazorSignatureEntry
+{
+    public int ElementId { get; set; }
+    /// <summary>Image as data URL (e.g. <c>data:image/png;base64,...</c>).</summary>
+    public string SignatureDataUrl { get; set; } = string.Empty;
+    public string? Position { get; set; }
+    public string? City { get; set; }
+    public DateTime SignedAt { get; set; }
+}
+
+/// <summary>
+/// Response of <c>GET /api/tfa/{envelopeReceiverId}</c>. The API serializes
+/// the anonymous type in <c>TfaRegistrationController.RegisterAsync</c>; the
+/// shape mirrored here is the camelCased JSON that crosses the wire.
+/// </summary>
+public class TfaRegistrationResponse
+{
+    public int EnvelopeId { get; set; }
+    public string? Uuid { get; set; }
+    public string? Signature { get; set; }
+    public DateTime? TfaRegDeadline { get; set; }
+    /// <summary>Base64-encoded PNG suitable for <c>data:image/png;base64,...</c>.</summary>
+    public string? TotpQR64 { get; set; }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Api/Models/ReceiverAuthDtos.cs

@@ -0,0 +1,53 @@
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Api.Models;
+
+/// <summary>
+/// Mirrors <c>EnvelopeGenerator.API.Models.ReceiverAuthResponse</c>.
+/// The Status string determines which fields are relevant.
+/// Possible values:
+/// requires_access_code, requires_tfa, show_document,
+/// already_signed, rejected, not_found, expired, error.
+/// </summary>
+public class ReceiverAuthResponse
+{
+    public string Status { get; set; } = string.Empty;
+    public string? Title { get; set; }
+    public string? Message { get; set; }
+    public string? SenderEmail { get; set; }
+    public string? ReceiverName { get; set; }
+    public bool TfaEnabled { get; set; }
+    public bool HasPhoneNumber { get; set; }
+    public bool ReadOnly { get; set; }
+
+    /// <summary>"sms" or "authenticator" when Status == "requires_tfa".</summary>
+    public string? TfaType { get; set; }
+    public DateTime? TfaExpiration { get; set; }
+    public string? ErrorMessage { get; set; }
+}
+
+public class AccessCodeRequest
+{
+    public string AccessCode { get; set; } = string.Empty;
+    public bool PreferSms { get; set; }
+}
+
+public class TfaCodeRequest
+{
+    public string Code { get; set; } = string.Empty;
+    /// <summary>"sms" or "authenticator".</summary>
+    public string Type { get; set; } = "authenticator";
+}
+
+/// <summary>
+/// Status strings returned by <see cref="ReceiverAuthResponse.Status"/>.
+/// </summary>
+public static class ReceiverAuthStatus
+{
+    public const string RequiresAccessCode = "requires_access_code";
+    public const string RequiresTfa = "requires_tfa";
+    public const string ShowDocument = "show_document";
+    public const string AlreadySigned = "already_signed";
+    public const string Rejected = "rejected";
+    public const string NotFound = "not_found";
+    public const string Expired = "expired";
+    public const string Error = "error";
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Api/ReceiverApiClient.cs

@@ -0,0 +1,214 @@
+using System.Net;
+using System.Net.Http.Json;
+using EnvelopeGenerator.ReceiverUI.Web.Client.Api.Models;
+
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Api;
+
+/// <summary>
+/// Typed HTTP client for the EnvelopeGenerator receiver API.
+/// All endpoints are routed through the BFF (same origin), so the
+/// authentication cookie set by the API is automatically attached
+/// by the browser to every request issued by the injected HttpClient.
+/// </summary>
+public class ReceiverApiClient
+{
+    private readonly HttpClient _http;
+    private readonly ILogger<ReceiverApiClient> _logger;
+
+    public ReceiverApiClient(HttpClient http, ILogger<ReceiverApiClient> logger)
+    {
+        _http = http;
+        _logger = logger;
+    }
+
+    // ?? Receiver Auth ????????????????????????????????????????????????
+
+    public Task<ReceiverAuthResponse?> GetStatusAsync(string envelopeKey, CancellationToken ct = default)
+        => GetAuthAsync($"api/receiverauth/{Uri.EscapeDataString(envelopeKey)}/status", ct);
+
+    public Task<ReceiverAuthResponse?> SubmitAccessCodeAsync(string envelopeKey, AccessCodeRequest req, CancellationToken ct = default)
+        => PostAuthAsync($"api/receiverauth/{Uri.EscapeDataString(envelopeKey)}/access-code", req, ct);
+
+    public Task<ReceiverAuthResponse?> SubmitTfaCodeAsync(string envelopeKey, TfaCodeRequest req, CancellationToken ct = default)
+        => PostAuthAsync($"api/receiverauth/{Uri.EscapeDataString(envelopeKey)}/tfa", req, ct);
+
+    // ?? Envelope Receiver ????????????????????????????????????????????
+
+    public async Task<EnvelopeReceiverDto?> GetEnvelopeReceiverAsync(string envelopeKey, CancellationToken ct = default)
+    {
+        var res = await _http.GetAsync($"api/envelopereceiver/{Uri.EscapeDataString(envelopeKey)}", ct);
+        if (!res.IsSuccessStatusCode)
+            return null;
+        return await res.Content.ReadFromJsonAsync<EnvelopeReceiverDto>(cancellationToken: ct);
+    }
+
+    /// <summary>Downloads the document bytes for the receiver to display in a PDF viewer.</summary>
+    public async Task<byte[]?> GetDocumentAsync(string envelopeKey, CancellationToken ct = default)
+    {
+        var res = await _http.GetAsync($"api/document/{Uri.EscapeDataString(envelopeKey)}", ct);
+        if (!res.IsSuccessStatusCode)
+            return null;
+        return await res.Content.ReadAsByteArrayAsync(ct);
+    }
+
+    // ?? Annotation / Sign / Reject ???????????????????????????????????
+
+    /// <summary>
+    /// Returns the signature placeholders the authenticated receiver must sign.
+    /// </summary>
+    public async Task<List<SignatureElementDto>> GetSignatureElementsAsync(CancellationToken ct = default)
+    {
+        try
+        {
+            return await _http.GetFromJsonAsync<List<SignatureElementDto>>("api/annotation/elements", ct)
+                   ?? new List<SignatureElementDto>();
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Failed to fetch signature elements.");
+            return new List<SignatureElementDto>();
+        }
+    }
+
+    /// <summary>
+    /// Submits the signed envelope using the Blazor-friendly endpoint.
+    /// </summary>
+    public async Task<HttpStatusCode> SignBlazorAsync(BlazorSignaturePayload payload, CancellationToken ct = default)
+    {
+        var res = await _http.PostAsJsonAsync("api/annotation/blazor", payload, ct);
+        return res.StatusCode;
+    }
+
+    /// <summary>
+    /// Fetches the TOTP QR code + registration deadline for the given
+    /// envelope-receiver key (encoded uuid+signature). The API generates
+    /// a fresh secret on first call and persists it server-side.
+    /// </summary>
+    public async Task<(TfaRegistrationResponse? Data, HttpStatusCode Status)> GetTfaRegistrationAsync(string envelopeReceiverId, CancellationToken ct = default)
+    {
+        try
+        {
+            var res = await _http.GetAsync($"api/tfa/{Uri.EscapeDataString(envelopeReceiverId)}", ct);
+            if (!res.IsSuccessStatusCode)
+                return (null, res.StatusCode);
+            var data = await res.Content.ReadFromJsonAsync<TfaRegistrationResponse>(cancellationToken: ct);
+            return (data, res.StatusCode);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Failed to fetch TFA registration for {Key}", envelopeReceiverId);
+            return (null, HttpStatusCode.InternalServerError);
+        }
+    }
+
+    /// <summary>Submits the signed annotations payload. Returns the HTTP status code.</summary>
+    public async Task<HttpStatusCode> SignAsync<TPayload>(TPayload? payload, CancellationToken ct = default)
+    {
+        var res = payload is null
+            ? await _http.PostAsync("api/annotation", content: null, ct)
+            : await _http.PostAsJsonAsync("api/annotation", payload, ct);
+        return res.StatusCode;
+    }
+
+    public async Task<bool> RejectAsync(string reason, CancellationToken ct = default)
+    {
+        var res = await _http.PostAsJsonAsync("api/annotation/reject", reason, ct);
+        return res.IsSuccessStatusCode;
+    }
+
+    // ?? Read-only share ??????????????????????????????????????????????
+
+    public async Task<bool> ShareReadOnlyAsync(ReadOnlyShareRequest req, CancellationToken ct = default)
+    {
+        var res = await _http.PostAsJsonAsync("api/readonly", req, ct);
+        return res.IsSuccessStatusCode;
+    }
+
+    // ?? Auth (logout) ????????????????????????????????????????????????
+
+    public async Task<bool> LogoutAsync(CancellationToken ct = default)
+    {
+        var res = await _http.PostAsync("auth/logout", content: null, ct);
+        return res.IsSuccessStatusCode;
+    }
+
+    // ?? Localization ?????????????????????????????????????????????????
+
+    public async Task<Dictionary<string, string>?> GetLocalizationStringsAsync(CancellationToken ct = default)
+    {
+        try
+        {
+            return await _http.GetFromJsonAsync<Dictionary<string, string>>("api/Localization", ct);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Failed to fetch localization strings.");
+            return null;
+        }
+    }
+
+    public async Task SetLanguageAsync(string language, CancellationToken ct = default)
+    {
+        try
+        {
+            await _http.PostAsync($"api/Localization/lang?language={Uri.EscapeDataString(language)}", content: null, ct);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Failed to set language to {Lang}.", language);
+        }
+    }
+
+    /// <summary>
+    /// Returns the currently selected language code (e.g. "de", "en"), or
+    /// <c>null</c> if no language cookie has been set yet (the API answers
+    /// with HTTP 404 in that case).
+    /// </summary>
+    public async Task<string?> GetLanguageAsync(CancellationToken ct = default)
+    {
+        try
+        {
+            var res = await _http.GetAsync("api/Localization/lang", ct);
+            if (!res.IsSuccessStatusCode)
+                return null;
+            return (await res.Content.ReadAsStringAsync(ct))?.Trim('"');
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Failed to read current language.");
+            return null;
+        }
+    }
+
+    // ?? Helpers ??????????????????????????????????????????????????????
+
+    private async Task<ReceiverAuthResponse?> GetAuthAsync(string url, CancellationToken ct)
+    {
+        var res = await _http.GetAsync(url, ct);
+        return await ReadAuthAsync(res, ct);
+    }
+
+    private async Task<ReceiverAuthResponse?> PostAuthAsync<TReq>(string url, TReq body, CancellationToken ct)
+    {
+        var res = await _http.PostAsJsonAsync(url, body, ct);
+        return await ReadAuthAsync(res, ct);
+    }
+
+    private static async Task<ReceiverAuthResponse?> ReadAuthAsync(HttpResponseMessage res, CancellationToken ct)
+    {
+        // ReceiverAuthController returns a ReceiverAuthResponse body for both
+        // 2xx and known error statuses (401/404/500). We always try to deserialize.
+        try
+        {
+            return await res.Content.ReadFromJsonAsync<ReceiverAuthResponse>(cancellationToken: ct);
+        }
+        catch
+        {
+            return new ReceiverAuthResponse
+            {
+                Status = ReceiverAuthStatus.Error,
+                ErrorMessage = $"Unexpected response ({(int)res.StatusCode})."
+            };
+        }
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/EnvelopeGenerator.ReceiverUI.Web.Client.csproj

@@ -0,0 +1,37 @@
+<Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <NoDefaultLaunchSettingsFile>true</NoDefaultLaunchSettingsFile>
+    <StaticWebAssetProjectMode>Default</StaticWebAssetProjectMode>
+    <MSBuildWarningsAsMessages>$(MSBuildWarningsAsMessage);WASM0001</MSBuildWarningsAsMessages>
+    <!-- Required so that native assets (libSkiaSharp, libHarfBuzzSharp) from
+         SkiaSharp.NativeAssets.WebAssembly / HarfBuzzSharp.NativeAssets.WebAssembly
+         are statically linked into the WASM runtime. Without this the
+         DevExpress PDF SkiaRenderer throws DllNotFoundException: libSkiaSharp.
+         Requires the "wasm-tools" workload: dotnet workload install wasm-tools -->
+    <!--<WasmBuildNative>false</WasmBuildNative>-->
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DevExpress.Blazor" Version="25.2.*" />
+    <PackageReference Include="DevExpress.Blazor.PdfViewer" Version="25.2.*" />
+    <PackageReference Include="DevExpress.Pdf.SkiaRenderer" Version="25.2.*" />
+    <PackageReference Include="HarfBuzzSharp.NativeAssets.WebAssembly" Version="8.3.1.2" />
+    <PackageReference Include="SkiaSharp.NativeAssets.WebAssembly" Version="3.119.1" />
+    <PackageReference Include="DevExpress.AIIntegration.Blazor" Version="25.2.*" />
+    <PackageReference Include="DevExpress.AIIntegration.OpenAI" Version="25.2.*" />
+
+    <PackageReference Include="Azure.AI.OpenAI" Version="2.2.0-beta.5" />
+    <PackageReference Include="Microsoft.Extensions.AI" Version="9.7.1" />
+    <PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.7.1-preview.1.25365.4" />
+
+    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="8.0.20" />
+    <PackageReference Include="Microsoft.Extensions.Http" Version="8.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <EmbeddedResource Include="Documents\Invoice.pdf" />
+  </ItemGroup>
+</Project>

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/Drawer.razor

@@ -0,0 +1,38 @@
+@inherits DrawerStateComponentBase
+
+<div class="drawer-container">
+    <DxDrawer PanelWidth="@PanelWidth"
+              CssClass="@(CssClass + " mobile")"
+              Mode="DrawerMode.Overlap"
+              IsOpen="@ToggledDrawer"
+              BodyTemplate="BodyTemplate"
+              HeaderTemplate="HeaderTemplate"
+              FooterTemplate="FooterTemplate"
+              ApplyBackgroundShading="false"
+              ClosedCssClass="panel-closed">
+        <TargetContent>
+            <DxDrawer PanelWidth="@PanelWidth"
+                      CssClass="@CssClass"
+                      Mode="DrawerMode.Shrink"
+                      IsOpen="@(!ToggledDrawer)"
+                      BodyTemplate="BodyTemplate"
+                      HeaderTemplate="HeaderTemplate"
+                      FooterTemplate="FooterTemplate"
+                      OpenCssClass="panel-open">
+                <TargetContent>
+                    <div class="navigation-drawer-shading"></div>
+                    @TargetContent
+                </TargetContent>
+            </DxDrawer>
+        </TargetContent>
+    </DxDrawer>
+</div>
+
+@code {
+    [Parameter] public string? CssClass { get; set; }
+    [Parameter] public string? PanelWidth { get; set; }
+    [Parameter] public RenderFragment? TargetContent { get; set; }
+    [Parameter] public RenderFragment? BodyTemplate { get; set; }
+    [Parameter] public RenderFragment? HeaderTemplate { get; set; }
+    [Parameter] public RenderFragment? FooterTemplate { get; set; }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/Drawer.razor.css

@@ -0,0 +1,53 @@
+.drawer-container {
+    height: 100%;
+}
+
+.navigation-drawer-shading {
+    height: 100%;
+    position: absolute;
+    transition: ease 300ms;
+    transition-property: opacity, visibility;
+    visibility: visible;
+    width: 100%;
+    z-index: 99;
+    background-color: var(--dxds-color-surface-backdrop-default-rest);
+}
+
+.navigation-drawer.mobile.panel-closed .navigation-drawer-shading {
+    opacity: 0;
+    visibility: hidden;
+}
+
+::deep .navigation-drawer > .dxbl-drawer-panel {
+    display: flex;
+}
+
+::deep .navigation-drawer.mobile > .dxbl-drawer-panel {
+    display: none;
+}
+
+.navigation-drawer-shading {
+    display: none;
+}
+
+::deep .panel-open:not(.mobile) .nav-buttons-container .menu-button {
+    display: none;
+}
+
+@media (max-width: 768px) {
+    ::deep .navigation-drawer > .dxbl-drawer-panel {
+        display: none;
+    }
+
+    ::deep .navigation-drawer.mobile > .dxbl-drawer-panel {
+        display: flex;
+    }
+
+    .navigation-drawer-shading {
+        display: block;
+    }
+
+    ::deep .panel-open:not(.mobile) .nav-buttons-container .menu-button {
+        display: flex;
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/MainLayout.razor

@@ -0,0 +1,53 @@
+@inherits DrawerStateLayoutComponentBase
+@inject NavigationManager NavigationManager
+
+<div class="page">
+    <Drawer CssClass="navigation-drawer" PanelWidth="240px">
+        <HeaderTemplate>
+            <div class="navigation-drawer-header">
+                <NavLink href="@AddDrawerStateToUrl("/")">
+                    <img class="logo" src="images/logo.svg" alt="DevExpress logo" />
+                </NavLink>
+                <NavLink aria-label="Close menu" href="@AddDrawerStateToUrlToggled(LocalPath)">
+                    <DxButton aria-label="Close menu" RenderStyle="ButtonRenderStyle.Light" RenderStyleMode="ButtonRenderStyleMode.Text" CssClass="btn-icon-only" IconCssClass="@(ToggledDrawer ? "icon icon-close" : "icon icon-menu")"></DxButton>
+                </NavLink>
+            </div>
+        </HeaderTemplate>
+        <BodyTemplate>
+            <div class="w-100">
+                <NavMenu></NavMenu>
+            </div>
+        </BodyTemplate>
+        <FooterTemplate>
+            <div class="navigation-drawer-footer">
+                <NavLink href="https://docs.devexpress.com/Blazor/400725/blazor-components" class="button-link">
+                    <DxButton Text="Docs" RenderStyle="ButtonRenderStyle.Light" RenderStyleMode="ButtonRenderStyleMode.Text" IconCssClass="icon icon-docs"></DxButton>
+                </NavLink>
+                <NavLink href="https://demos.devexpress.com/blazor/" class="button-link">
+                    <DxButton Text="Demos" RenderStyle="ButtonRenderStyle.Light" RenderStyleMode="ButtonRenderStyleMode.Text" IconCssClass="icon icon-demos"></DxButton>
+                </NavLink>
+            </div>
+        </FooterTemplate>
+        <TargetContent>
+            <div class="drawer-content">
+                <div class="nav-buttons-container">
+                    <NavLink aria-label="Open menu" href="@AddDrawerStateToUrlToggled(LocalPath)" class="menu-button">
+                        <DxButton aria-label="Open menu" RenderStyle="ButtonRenderStyle.Secondary" RenderStyleMode="ButtonRenderStyleMode.Text" CssClass="btn-icon-only" IconCssClass="icon icon-menu"></DxButton>
+                    </NavLink>
+                    @if (LocalPath != "/") {
+                        <NavLink href="@AddDrawerStateToUrl("/")" class="button-link">
+                            <DxButton Text="Back to Home" RenderStyle="ButtonRenderStyle.Secondary" RenderStyleMode="ButtonRenderStyleMode.Text" CssClass="back-button" IconCssClass="icon icon-back"></DxButton>
+                        </NavLink>
+                    }
+                </div>
+                <div class="page-content-container">
+                    @Body
+                </div>
+            </div>
+        </TargetContent>
+    </Drawer>
+</div>
+
+@code {
+    string LocalPath => new Uri(NavigationManager.Uri).LocalPath;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/MainLayout.razor.css

@@ -0,0 +1,67 @@
+.page {
+    height: 100%;
+    min-height: 0;
+}
+
+::deep .navigation-drawer {
+    --dxbl-drawer-panel-body-padding-x: 0;
+    --dxbl-drawer-panel-body-padding-y: 1rem;
+    --dxbl-drawer-panel-footer-bg: none;
+    --dxbl-drawer-panel-header-bg: none;
+    --dxbl-drawer-separator-border-width: 0;
+}
+
+::deep .navigation-drawer > .dxbl-drawer-panel {
+    background-image: linear-gradient(180deg, var(--dxds-color-surface-primary-default-rest) 0%, var(--dxds-primary-170) 150%);
+}
+
+.navigation-drawer-header {
+    align-items: center;
+    display: flex;
+    justify-content: space-between;
+    padding: 1.375rem 0.375rem;
+    width: 100%;
+}
+
+.navigation-drawer-header .logo {
+    height: 1.5rem;
+    width: 9rem;
+}
+
+.navigation-drawer-footer {
+    display: flex;
+    justify-content: space-evenly;
+    padding-bottom: 0.875rem;
+    width: 100%;
+}
+
+.drawer-content {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: auto;
+    padding: 2rem 1.5rem 1.5rem 1.5rem;
+}
+
+.nav-buttons-container {
+    align-items: center;
+    display: flex;
+    gap: 0.625rem;
+    min-height: 2rem;
+}
+
+::deep .nav-buttons-container > a {
+    color: inherit;
+}
+
+::deep .nav-buttons-container .back-button {
+    padding-left: 0;
+    padding-right: 0.25rem;
+}
+
+.page-content-container {
+    display: flex;
+    flex-direction: column;
+    flex-grow: 1;
+    min-height: 0;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/NavMenu.razor

@@ -0,0 +1,35 @@
+@inject NavigationManager NavigationManager
+@implements IDisposable
+
+<div>
+    <DxMenu Orientation="@Orientation.Vertical" CssClass="menu">
+        <Items>
+            <DxMenuItem NavigateUrl="/samples" Text="Samples" CssClass="@MenuItemCssClass("/samples")" IconCssClass="icon icon-home"></DxMenuItem>
+            <DxMenuItem NavigateUrl="/counter" Text="Counter" CssClass="@MenuItemCssClass("/counter")" IconCssClass="icon icon-counter"></DxMenuItem>
+            <DxMenuItem NavigateUrl="/weather" Text="Weather" CssClass="@MenuItemCssClass("/weather")" IconCssClass="icon icon-weather"></DxMenuItem>
+            <DxMenuItem NavigateUrl="/pdfviewer" Text="PDF Viewer" CssClass="@MenuItemCssClass("/pdfviewer")" IconCssClass="icon icon-pdf-viewer"></DxMenuItem>
+        </Items>
+    </DxMenu>
+</div>
+
+@code {
+    private string? currentLocalPath;
+
+    protected override void OnInitialized() {
+        currentLocalPath = new Uri(NavigationManager.Uri).LocalPath;
+        NavigationManager.LocationChanged += OnLocationChanged;
+    }
+
+    private void OnLocationChanged(object? sender, LocationChangedEventArgs e) {
+        currentLocalPath = new Uri(NavigationManager.Uri).LocalPath;
+        InvokeAsync(StateHasChanged);
+    }
+
+    private string? MenuItemCssClass(string itemPath) {
+        return string.Equals(currentLocalPath, itemPath, StringComparison.OrdinalIgnoreCase) ? "menu-item-active" : null;
+    }
+
+    public void Dispose() {
+        NavigationManager.LocationChanged -= OnLocationChanged;
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/NavMenu.razor.css

@@ -0,0 +1,23 @@
+::deep .menu {
+    --dxbl-menu-bottom-left-border-radius: 0;
+    --dxbl-menu-bottom-right-border-radius: 0;
+    --dxbl-menu-top-left-border-radius: 0;
+    --dxbl-menu-top-right-border-radius: 0;
+    --dxbl-menu-item-padding-x: 1.125rem;
+    --dxbl-menu-item-padding-y: 0.5rem;
+    --dxbl-menu-item-color: var(--dxds-color-content-neutral-default-static-dark-rest);
+    --dxbl-menu-item-image-color: var(--dxds-color-content-neutral-default-static-dark-rest);
+    --dxbl-menu-item-hover-bg: rgb(from var(--dxds-color-surface-neutral-default-static-light-rest) r g b / 0.15);
+    --dxbl-menu-item-hover-color: var(--dxds-color-content-neutral-default-static-dark-hovered);
+    --dxbl-menu-item-hover-image-color: var(--dxds-color-content-neutral-default-static-dark-hovered);
+
+    background: none;
+}
+
+::deep .menu.display-mobile {
+    margin-bottom: 2rem;
+}
+
+::deep .menu-item-active {
+    background-color: rgb(from var(--dxds-color-surface-neutral-default-static-light-rest) r g b / 0.05);
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Layout/ReceiverLayout.razor

@@ -0,0 +1,116 @@
+@inherits LayoutComponentBase
+@implements IDisposable
+@inject LocalizationService Loc
+@inject NavigationManager Nav
+@inject IJSRuntime JS
+
+@*
+    Layout for the receiver-facing pages migrated from EnvelopeGenerator.Web.
+    Mirrors the legacy MVC <body> structure: page content + sticky footer
+    with copyright link, language switcher and privacy link.
+
+    Cookie consent is reimplemented in Blazor (localStorage-backed) because
+    ASP.NET Core's <ITrackingConsentFeature> only works on the server side
+    and is awkward to integrate with InteractiveAuto rendering.
+*@
+
+<div class="receiver-shell">
+
+    @* Main page content *@
+    <main role="main" class="flex-grow-1">
+        @Body
+    </main>
+
+    @* Cookie consent banner (Blazor counterpart of _CookieConsentPartial). *@
+    @if (_consentVisible)
+    {
+        <div class="receiver-cookie-banner" role="alertdialog" aria-live="polite">
+            <span>@Loc["CookieConsentMessage"]</span>
+            <DxButton Text="@Loc["Accept"]"
+                      RenderStyle="ButtonRenderStyle.Primary"
+                      Click="AcceptCookiesAsync" />
+        </div>
+    }
+
+    @* Footer (copyright + language switcher + privacy). *@
+    <footer class="receiver-footer">
+        <span>
+            &copy; SignFlow 2023-@DateTime.Now.Year
+            <a href="https://digitaldata.works" target="_blank" rel="noopener">Digital Data GmbH</a>
+        </span>
+
+        <div class="d-flex align-items-center gap-2">
+            <select class="language-switcher" value="@_currentLang" @onchange="OnLanguageChangedAsync">
+                @foreach (var (lang, native, _) in LocalizationService.SupportedLanguages)
+                {
+                    <option value="@lang" selected="@(lang == _currentLang)">@native</option>
+                }
+            </select>
+        </div>
+
+        <a href="@($"/privacy-policy.{_currentLang}.html")" target="_blank" rel="noopener">
+            @Loc["Privacy"]
+        </a>
+    </footer>
+</div>
+
+@code {
+    private string _currentLang = "de";
+    private bool _consentVisible;
+
+    protected override async Task OnInitializedAsync()
+    {
+        Loc.Changed += OnLocChanged;
+        await Loc.EnsureLoadedAsync();
+        _currentLang = Loc.CurrentLanguage ?? "de";
+    }
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (!firstRender) return;
+        // Probe localStorage on the client only — InteractiveAuto means
+        // the server prerender runs without a browser, so JS interop is
+        // unavailable until the first client render.
+        try
+        {
+            var accepted = await JS.InvokeAsync<string?>("localStorage.getItem", "receiver.cookie-consent");
+            _consentVisible = accepted != "1";
+            StateHasChanged();
+        }
+        catch
+        {
+            // No-op: server prerender (JS unavailable) keeps the banner hidden.
+        }
+    }
+
+    private async Task AcceptCookiesAsync()
+    {
+        try
+        {
+            await JS.InvokeVoidAsync("localStorage.setItem", "receiver.cookie-consent", "1");
+        }
+        catch { /* ignore */ }
+        _consentVisible = false;
+    }
+
+    private async Task OnLanguageChangedAsync(ChangeEventArgs e)
+    {
+        var code = e.Value?.ToString();
+        if (string.IsNullOrEmpty(code) || code == _currentLang)
+            return;
+
+        _currentLang = code;
+        await Loc.ChangeLanguageAsync(code);
+        // Force a full reload so ASP.NET Core localization middleware
+        // picks up the new culture for any subsequent SSR / API calls.
+        Nav.NavigateTo(Nav.Uri, forceLoad: true);
+    }
+
+    private void OnLocChanged()
+    {
+        _currentLang = Loc.CurrentLanguage ?? _currentLang;
+        InvokeAsync(StateHasChanged);
+    }
+
+    public void Dispose() => Loc.Changed -= OnLocChanged;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Counter.razor

@@ -0,0 +1,24 @@
+@page "/counter"
+
+<PageTitle>Counter</PageTitle>
+
+<h1>Counter</h1>
+
+<div class="counter-block">
+    <div class="counter-content">
+        <div class="counter-count">
+            @currentCount
+        </div>
+        current count
+    </div>
+    <DxButton Click="IncrementCount">Click me</DxButton>
+</div>
+
+@code {
+    private int currentCount;
+
+    private void IncrementCount()
+    {
+        currentCount++;
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Counter.razor.css

@@ -0,0 +1,25 @@
+.counter-block {
+    align-items: center;
+    border-radius: 1rem;
+    display: flex;
+    flex-direction: column;
+    gap: 1.5rem;
+    height: 17rem;
+    justify-content: center;
+    padding: 2.5rem 1.5rem 1.5rem;
+    width: 16.875rem;
+    border: 1px solid var(--dxds-color-border-neutral-default-rest);
+}
+
+.counter-block .counter-content {
+    align-items: center;
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+}
+
+.counter-block .counter-count {
+    font-size: 7.5rem;
+    font-weight: 400;
+    line-height: 7.75rem;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Index/Index.razor

@@ -0,0 +1,27 @@
+@page "/samples"
+
+<PageTitle>Welcome</PageTitle>
+
+<div class="main-content">
+    <DxGridLayout CssClass="index-gridlayout">
+        <Rows>
+            <DxGridLayoutRow Height="auto" Areas="header"></DxGridLayoutRow>
+            <DxGridLayoutRow Height="auto" Areas="tiles"></DxGridLayoutRow>
+        </Rows>
+        <Items>
+            <DxGridLayoutItem Area="header" CssClass="title">
+                <Template>
+                    <div class="title-header-text">Hello World!</div>
+                    <div class="title-content-text">Welcome to your new DevExpress Blazor Application</div>
+                </Template>
+            </DxGridLayoutItem>
+            <DxGridLayoutItem Area="tiles" CssClass="tiles">
+                <Template>
+                    <IndexTile NavigateUrl="/counter" Title="Counter" Description="Count mouse clicks and track the total." IconCssClass="icon-counter" />
+                    <IndexTile NavigateUrl="/weather" Title="Weather" Description="See a 5-day temperature and weather conditions forecast." IconCssClass="icon-weather" />
+                    <IndexTile NavigateUrl="/pdfviewer" Title="PDF Viewer" Description="Load PDF files and view them in the web browser." IconCssClass="icon-pdf-viewer" />
+                </Template>
+            </DxGridLayoutItem>
+        </Items>
+    </DxGridLayout>
+</div>

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Index/Index.razor.css

@@ -0,0 +1,31 @@
+::deep .index-gridlayout {
+    container-type: inline-size;
+    height: auto;
+    margin-top: auto;
+    margin-bottom: auto;
+    padding-bottom: 9rem;
+}
+
+::deep .title {
+    padding-bottom: 3rem;
+    text-align: center;
+}
+
+::deep .tiles {
+    --tile-column-count: 4;
+
+    display: grid;
+    gap: 1rem;
+    grid-template-columns: repeat(var(--tile-column-count), max-content);
+    justify-content: center;
+
+    @container (max-width: 60.5rem) {
+        --tile-column-count: 3;
+    }
+    @container (max-width: 45.125rem) {
+        --tile-column-count: 2;
+    }
+    @container (max-width: 29.75rem) {
+        --tile-column-count: 1;
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Index/IndexTile.razor

@@ -0,0 +1,40 @@
+@inherits DrawerStateComponentBase
+
+<div class="tile">
+    <NavLink href="@AddDrawerStateToUrl(NavigateUrl)">
+        <DxGridLayout CssClass="tile-content" ColumnSpacing="0.75rem" RowSpacing="0.75rem">
+            <Rows>
+                <DxGridLayoutRow Areas="icon title" Height="auto" />
+                <DxGridLayoutRow Areas="description description" Height="auto" />
+            </Rows>
+            <Columns>
+                <DxGridLayoutColumn Width="auto" />
+                <DxGridLayoutColumn />
+            </Columns>
+            <Items>
+                <DxGridLayoutItem Area="icon" CssClass="tile-icon">
+                    <Template>
+                        <div class="@("icon " + IconCssClass)" aria-hidden="true"></div>
+                    </Template>
+                </DxGridLayoutItem>
+                <DxGridLayoutItem Area="title" CssClass="tile-title">
+                    <Template>
+                        @Title
+                    </Template>
+                </DxGridLayoutItem>
+                <DxGridLayoutItem Area="description" CssClass="tile-description">
+                    <Template>
+                        @Description
+                    </Template>
+                </DxGridLayoutItem>
+            </Items>
+        </DxGridLayout>
+    </NavLink>
+</div>
+
+@code {
+    [Parameter] public string NavigateUrl { get; set; } = string.Empty;
+    [Parameter] public string? Title { get; set; }
+    [Parameter] public string? Description { get; set; }
+    [Parameter] public string? IconCssClass { get; set; }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Index/IndexTile.razor.css

@@ -0,0 +1,44 @@
+.tile {
+    border-radius: 0.75rem;
+    height: 7.5rem;
+    transition: box-shadow 0.2s;
+    width: 14.375rem;
+    border: 1px solid var(--dxds-color-border-neutral-default-rest);
+}
+
+.tile:hover {
+    box-shadow: 0 4px 8px 0 rgba(170, 170, 170, 0.24), 0 0 2px 0 rgba(170, 170, 170, 0.2);
+}
+
+.tile ::deep > a {
+    text-decoration: none;
+}
+
+::deep .tile-content {
+    padding: 1rem;
+}
+
+::deep .tile-icon {
+    border-radius: 0.375rem;
+    height: 2.75rem;
+    padding: 0.75rem;
+    width: 2.75rem;
+    border: 1px solid var(--dxds-color-border-neutral-default-rest);
+}
+
+::deep .tile-title {
+    align-self: center;
+    color: var(--dxds-color-content-neutral-default-rest);
+    font-size: var(--dxds-font-size-base-md);
+    font-weight: var(--dxds-font-weight-base-strong);
+    letter-spacing: var(--dxds-letter-spacing-base-md);
+    line-height: var(--dxds-line-height-base-md);
+}
+
+::deep .tile-description {
+    color: var(--dxds-color-content-neutral-subdued-rest);
+    font-size: var(--dxds-font-size-base-sm);
+    font-weight: var(--dxds-font-weight-base-default);
+    letter-spacing: var(--dxds-letter-spacing-base-sm);
+    line-height: var(--dxds-line-height-base-sm);
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/PdfViewer.razor

@@ -0,0 +1,22 @@
+@page "/pdfviewer"
+
+<PageTitle>PDF Viewer</PageTitle>
+
+<h1>PDF Viewer</h1>
+
+<DxPdfViewer CssClass="h-100 w-100" DocumentContent="DocumentContent" ZoomLevel="1" />
+
+@code {
+    byte[]? DocumentContent { get; set; }
+
+    protected override async Task OnInitializedAsync() {
+        await base.OnInitializedAsync();
+
+        await using Stream stream =
+            System.Reflection.Assembly.GetExecutingAssembly().GetManifestResourceStream("EnvelopeGenerator.ReceiverUI.Web.Client.Documents.Invoice.pdf")
+            ?? throw new InvalidOperationException("Resource not found.");
+        using MemoryStream ms = new();
+        await stream.CopyToAsync(ms);
+        DocumentContent = ms.ToArray();
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeExpired.razor

@@ -0,0 +1,24 @@
+@page "/envelope-expired"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject LocalizationService Loc
+
+@*
+    Counterpart of Views/Envelope/EnvelopeExpired.cshtml.
+*@
+
+<PageTitle>@Loc["Expired"]</PageTitle>
+
+<div class="page container p-5">
+    <header class="text-center">
+        <div class="icon expired"></div>
+        <h1>@Loc["Expired"]</h1>
+    </header>
+    <section class="text-center">
+        <p>@Loc["DocumentSharingPeriodExpired"]</p>
+    </section>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync() => await Loc.EnsureLoadedAsync();
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeKeyRedirect.razor

@@ -0,0 +1,20 @@
+@page "/envelopekey/{*Path}"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject NavigationManager Nav
+
+@*
+    Counterpart of EnvelopeKeyRedirController:
+    /EnvelopeKey/{*path} ? /envelope/{path}
+    Preserves backwards compatibility with links generated by older e-mails.
+*@
+
+@code {
+    [Parameter] public string? Path { get; set; }
+
+    protected override void OnInitialized()
+    {
+        var target = "/envelope/" + (Path ?? string.Empty).TrimStart('/');
+        Nav.NavigateTo(target, replace: true);
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeLockedView.razor

@@ -0,0 +1,229 @@
+@implements IDisposable
+@inject ReceiverApiClient Api
+@inject ReceiverAuthState State
+@inject LocalizationService Loc
+
+@*
+    Counterpart of EnvelopeGenerator.Web/Views/Envelope/EnvelopeLocked.cshtml.
+
+    Renders one of three input modes based on the current auth state:
+
+      • Status == requires_access_code
+          ? AccessCode input (+ optional "2FA per SMS" toggle)
+
+      • Status == requires_tfa, TfaType == "sms"
+          ? SMS code input + countdown until TfaExpiration
+
+      • Status == requires_tfa, TfaType == "authenticator"
+          ? Authenticator code input + "set up authenticator" link
+
+    On submit, the matching ReceiverApiClient method is invoked. The fresh
+    response replaces ReceiverAuthState.Current; the parent EnvelopePage
+    re-renders and either shows the document or navigates to a terminal page.
+*@
+
+<div class="page container py-4 px-4">
+
+    @* — Welcome banner (custom company image is added in Phase 6) — *@
+    <header class="text-center">
+        <div class="header-1 alert alert-secondary" role="alert">
+            <h3 class="text">@Loc["WelcomeToTheESignPortal"]</h3>
+        </div>
+
+        <div class="icon locked @(IsTfa ? "tfa" : "") mt-4 mb-1">
+            <svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" fill="currentColor"
+                 class="bi bi-shield-lock" viewBox="0 0 16 16">
+                <path d="M5.338 1.59a61 61 0 0 0-2.837.856.48.48 0 0 0-.328.39c-.554 4.157.726 7.19 2.253 9.188a10.7 10.7 0 0 0 2.287 2.233c.346.244.652.42.893.533q.18.085.293.118a1 1 0 0 0 .101.025 1 1 0 0 0 .1-.025q.114-.034.294-.118c.24-.113.547-.29.893-.533a10.7 10.7 0 0 0 2.287-2.233c1.527-1.997 2.807-5.031 2.253-9.188a.48.48 0 0 0-.328-.39c-.651-.213-1.75-.56-2.837-.855C9.552 1.29 8.531 1.067 8 1.067c-.53 0-1.552.223-2.662.524zM5.072.56C6.157.265 7.31 0 8 0s1.843.265 2.928.56c1.11.3 2.229.655 2.887.87a1.54 1.54 0 0 1 1.044 1.262c.596 4.477-.787 7.795-2.465 9.99a11.8 11.8 0 0 1-2.517 2.453 7 7 0 0 1-1.048.625c-.28.132-.581.24-.829.24s-.548-.108-.829-.24a7 7 0 0 1-1.048-.625 11.8 11.8 0 0 1-2.517-2.453C1.928 10.487.545 7.169 1.141 2.692A1.54 1.54 0 0 1 2.185 1.43 63 63 0 0 1 5.072.56" />
+                <path d="M9.5 6.5a1.5 1.5 0 0 1-1 1.415l.385 1.99a.5.5 0 0 1-.491.595h-.788a.5.5 0 0 1-.49-.595l.384-1.99a1.5 1.5 0 1 1 2-1.415" />
+            </svg>
+        </div>
+        <h1>@Loc[$"LockedTitle{CodeKey}"]</h1>
+    </header>
+
+    @* — "Set up authenticator" hint, shown only on the authenticator step — *@
+    @if (IsAuthenticator)
+    {
+        <section class="text-center">
+            <p class="m-0 p-0">
+                @Loc["AuthenticatorSetup_Prefix"]
+                <a class="icon-link m-0 p-0" href="@($"/tfa/{EnvelopeKey}")" target="_blank" style="text-decoration:none">
+                    @Loc["AuthenticatorSetup_Link"] <i class="bi bi-box-arrow-up-right"></i>
+                </a>
+                @Loc["AuthenticatorSetup_Suffix"]
+            </p>
+        </section>
+    }
+
+    <section class="text-center">
+        <p>@Loc[$"LockedBody{CodeKey}"]</p>
+    </section>
+
+    <div class="row m-0 p-0">
+        <div class="access-code-panel justify-content-center align-items-center p-0 m-0">
+            <EditForm Model="this" OnValidSubmit="HandleSubmit" Context="editContext"
+                      id="form-access-code" class="form form-floating mb-0">
+                <div class="form-floating access-code-form-floating">
+
+                    <input id="access_code" type="password" class="form-control"
+                           placeholder="@Loc[$"LockedCodeLabel{CodeKey}"]"
+                           @bind="Code" @bind:event="oninput"
+                           disabled="@_submitting" required />
+                    <label for="access_code">@Loc[$"LockedCodeLabel{CodeKey}"]</label>
+
+                    <DxButton SubmitFormOnClick="true" Enabled="@(!_submitting)"
+                              RenderStyle="ButtonRenderStyle.Primary"
+                              CssClass="btn btn-primary">
+                        <span class="material-symbols-outlined">login</span>
+                    </DxButton>
+
+                    @if (ShowSmsToggle)
+                    {
+                        <div class="form-check form-switch tfa-sms">
+                            <input class="form-check-input" type="checkbox" role="switch"
+                                   id="flexSwitchCheckChecked"
+                                   @bind="PreferSms"
+                                   disabled="@(!State.Current!.HasPhoneNumber)" />
+                            <label class="form-check-label" for="flexSwitchCheckChecked">2FA per SMS</label>
+                        </div>
+                    }
+
+                    @if (IsSms && _smsRemaining is not null)
+                    {
+                        <div id="sms-timer" class="alert alert-primary" role="alert">@_smsRemaining</div>
+                    }
+                </div>
+            </EditForm>
+        </div>
+    </div>
+
+    @if (!string.IsNullOrEmpty(State.Current?.ErrorMessage))
+    {
+        <div id="access-code-error-message" class="alert alert-danger row" role="alert">
+            @State.Current.ErrorMessage
+        </div>
+    }
+
+    <section class="no-receiver-explanation text-center">
+        <details>
+            <summary>@Loc[$"LockedFooterTitle{CodeKey}"]</summary>
+            <p>
+                @Loc.Format($"LockedFooterBody{CodeKey}",
+                    State.Current?.SenderEmail ?? string.Empty,
+                    $"Envelope - {State.Current?.Title}",
+                    string.Empty)
+            </p>
+        </details>
+    </section>
+</div>
+
+@code {
+    [Parameter] public string EnvelopeKey { get; set; } = string.Empty;
+
+    private string Code { get; set; } = string.Empty;
+    private bool PreferSms { get; set; }
+    private bool _submitting;
+    private System.Threading.Timer? _smsTimer;
+    private string? _smsRemaining;
+
+    // — Mode helpers ????????????????????????????????????????????????
+    private bool IsAccessCodeStep => State.Current?.Status == ReceiverAuthStatus.RequiresAccessCode;
+    private bool IsTfa            => State.Current?.Status == ReceiverAuthStatus.RequiresTfa;
+    private bool IsSms            => IsTfa && State.Current?.TfaType == "sms";
+    private bool IsAuthenticator  => IsTfa && State.Current?.TfaType == "authenticator";
+
+    /// <summary>
+    /// Mirrors the legacy view's "codeKeyName" suffix used to pick the right
+    /// resource string ("LockedTitleAccess", "LockedTitleSms", ...).
+    /// </summary>
+    private string CodeKey => IsSms ? "Sms" : IsAuthenticator ? "Authenticator" : "Access";
+
+    private bool ShowSmsToggle =>
+        IsAccessCodeStep
+        && (State.Current?.TfaEnabled ?? false);
+
+    protected override async Task OnInitializedAsync()
+    {
+        await Loc.EnsureLoadedAsync();
+        State.Changed += OnStateChanged;
+        ResetSmsTimer();
+    }
+
+    private void OnStateChanged()
+    {
+        ResetSmsTimer();
+        InvokeAsync(StateHasChanged);
+    }
+
+    private async Task HandleSubmit()
+    {
+        if (_submitting || string.IsNullOrWhiteSpace(Code))
+            return;
+
+        _submitting = true;
+        try
+        {
+            ReceiverAuthResponse? res;
+            if (IsAccessCodeStep)
+            {
+                res = await Api.SubmitAccessCodeAsync(EnvelopeKey, new AccessCodeRequest
+                {
+                    AccessCode = Code,
+                    PreferSms  = PreferSms
+                });
+            }
+            else // TFA step
+            {
+                res = await Api.SubmitTfaCodeAsync(EnvelopeKey, new TfaCodeRequest
+                {
+                    Code = Code,
+                    Type = State.Current?.TfaType ?? "authenticator"
+                });
+            }
+
+            Code = string.Empty;
+            State.Set(EnvelopeKey, res);
+        }
+        finally
+        {
+            _submitting = false;
+        }
+    }
+
+    // — SMS countdown ???????????????????????????????????????????????
+    private void ResetSmsTimer()
+    {
+        _smsTimer?.Dispose();
+        _smsTimer = null;
+        _smsRemaining = null;
+
+        if (!IsSms || State.Current?.TfaExpiration is not DateTime exp)
+            return;
+
+        UpdateRemaining(exp);
+        _smsTimer = new System.Threading.Timer(_ =>
+        {
+            UpdateRemaining(exp);
+            InvokeAsync(StateHasChanged);
+        }, null, 1000, 1000);
+    }
+
+    private void UpdateRemaining(DateTime expiration)
+    {
+        var diff = expiration - DateTime.Now;
+        if (diff <= TimeSpan.Zero)
+        {
+            _smsRemaining = "00:00";
+            _smsTimer?.Dispose();
+            _smsTimer = null;
+            return;
+        }
+        _smsRemaining = $"{(int)diff.TotalMinutes:00}:{diff.Seconds:00}";
+    }
+
+    public void Dispose()
+    {
+        State.Changed -= OnStateChanged;
+        _smsTimer?.Dispose();
+    }
+}
+

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeNotFound.razor

@@ -0,0 +1,24 @@
+@page "/envelope-not-found"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject LocalizationService Loc
+
+@*
+    Counterpart of the "EnvelopeNotFound" view (rendered by
+    EnvelopeGenerator.Web.Extensions.ViewExtensions.ViewEnvelopeNotFound()).
+*@
+
+<PageTitle>@Loc["EnvelopeNotFoundTitle"]</PageTitle>
+
+<div class="page container p-5">
+    <header class="text-center">
+        <h1>@Loc["EnvelopeNotFoundTitle"]</h1>
+    </header>
+    <section class="text-center">
+        <p>@Loc["EnvelopeNotFoundBody"]</p>
+    </section>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync() => await Loc.EnsureLoadedAsync();
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopePage.razor

@@ -0,0 +1,110 @@
+@page "/envelope/{Key}"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject ReceiverApiClient Api
+@inject ReceiverAuthState State
+@inject LocalizationService Loc
+@inject NavigationManager Nav
+
+@*
+    Counterpart of EnvelopeGenerator.Web/Controllers/EnvelopeController.Main.
+
+    Behavior:
+      1. Calls GET /api/receiverauth/{key}/status.
+      2. Routes to a sub-view based on the response Status:
+         - requires_access_code / requires_tfa ? EnvelopeLockedView (Phase 3)
+         - show_document                       ? ShowEnvelopeView    (Phase 4)
+         - already_signed                      ? /envelope-signed
+         - rejected                            ? /envelope-rejected
+         - not_found                           ? /envelope-not-found
+         - expired                             ? /envelope-expired
+         - error                               ? inline error banner
+
+    Sub-views are simple placeholders here; they are filled with real UI
+    in later phases. The routing skeleton just needs to compile and
+    transition correctly.
+*@
+
+<PageTitle>@(Auth?.Title ?? Loc["SignDoc"])</PageTitle>
+
+@if (_loading)
+{
+    <div class="page container p-5 text-center">
+        <DxLoadingPanel Visible="true" IsContentBlocked="false" ApplyBackgroundShading="false" />
+    </div>
+}
+else if (Auth is null)
+{
+    <div class="page container p-5 text-center">
+        <p class="alert alert-danger">@Loc["UnexpectedErrorTitle"]</p>
+    </div>
+}
+else
+{
+    switch (Auth.Status)
+    {
+        case ReceiverAuthStatus.RequiresAccessCode:
+        case ReceiverAuthStatus.RequiresTfa:
+            <EnvelopeLockedView EnvelopeKey="@Key" />
+            break;
+
+        case ReceiverAuthStatus.ShowDocument:
+            <ShowEnvelopeView EnvelopeKey="@Key" />
+            break;
+
+        default:
+            <div class="page container p-5 text-center">
+                <p class="alert alert-warning">@(Auth.ErrorMessage ?? Loc["UnexpectedErrorTitle"])</p>
+            </div>
+            break;
+    }
+}
+
+@code {
+    [Parameter] public string Key { get; set; } = string.Empty;
+
+    private bool _loading = true;
+    private ReceiverAuthResponse? Auth => State.Current;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await Loc.EnsureLoadedAsync();
+        State.Changed += OnStateChanged;
+    }
+
+    protected override async Task OnParametersSetAsync()
+    {
+        // Re-fetch status if the route key changed or no response loaded yet.
+        if (State.EnvelopeKey != Key || State.Current is null)
+        {
+            _loading = true;
+            var res = await Api.GetStatusAsync(Key);
+            State.Set(Key, res);
+            RedirectIfTerminal(res);
+            _loading = false;
+        }
+        else
+        {
+            _loading = false;
+        }
+    }
+
+    private void RedirectIfTerminal(ReceiverAuthResponse? res)
+    {
+        if (res is null) return;
+        var target = res.Status switch
+        {
+            ReceiverAuthStatus.AlreadySigned => "/envelope-signed",
+            ReceiverAuthStatus.Rejected      => "/envelope-rejected",
+            ReceiverAuthStatus.NotFound      => "/envelope-not-found",
+            ReceiverAuthStatus.Expired       => "/envelope-expired",
+            _ => null
+        };
+        if (target is not null)
+            Nav.NavigateTo(target, replace: true);
+    }
+
+    private void OnStateChanged() => InvokeAsync(StateHasChanged);
+
+    public void Dispose() => State.Changed -= OnStateChanged;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeRejected.razor

@@ -0,0 +1,39 @@
+@page "/envelope-rejected"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject ReceiverAuthState State
+@inject LocalizationService Loc
+
+@*
+    Counterpart of Views/Envelope/EnvelopeRejected.cshtml.
+    Reads envelope title / sender info from the cached auth response,
+    which is populated by EnvelopePage before navigation occurs.
+*@
+
+<PageTitle>@Loc["DocRejected"]</PageTitle>
+
+<div class="page container p-5">
+    <header class="text-center">
+        <div class="icon rejected"></div>
+        <h1>@Loc["RejectionInfo1"]</h1>
+    </header>
+    <section class="text-center">
+        <small class="text-body-secondary">
+            @(Loc["RejectionInfo2"])
+        </small>
+        @if (State.Current is not null)
+        {
+            <p class="mt-3">
+                <strong>@State.Current.Title</strong>
+                @if (!string.IsNullOrEmpty(State.Current.SenderEmail))
+                {
+                    <span> — <a href="mailto:@State.Current.SenderEmail">@State.Current.SenderEmail</a></span>
+                }
+            </p>
+        }
+    </section>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync() => await Loc.EnsureLoadedAsync();
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/EnvelopeSigned.razor

@@ -0,0 +1,31 @@
+@page "/envelope-signed"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject LocalizationService Loc
+
+@*
+    Counterpart of Views/Envelope/EnvelopeSigned.cshtml.
+    Full styling (icon + section card) is migrated in Phase 6.
+*@
+
+<PageTitle>@Loc["DocumentSuccessfullySigned"]</PageTitle>
+
+<div class="page container p-5">
+    <header class="text-center">
+        <div class="icon signed">
+            <svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" fill="currentColor"
+                 class="bi bi-check2-circle" viewBox="0 0 16 16">
+                <path d="M2.5 8a5.5 5.5 0 0 1 8.25-4.764.5.5 0 0 0 .5-.866A6.5 6.5 0 1 0 14.5 8a.5.5 0 0 0-1 0 5.5 5.5 0 1 1-11 0z" />
+                <path d="M15.354 3.354a.5.5 0 0 0-.708-.708L8 9.293 5.354 6.646a.5.5 0 1 0-.708.708l3 3a.5.5 0 0 0 .708 0l7-7z" />
+            </svg>
+        </div>
+        <h1>@Loc["DocumentSuccessfullySigned"]</h1>
+    </header>
+    <section class="text-center">
+        <p>@Loc["DocumentSignedConfirmationMessage"]</p>
+    </section>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync() => await Loc.EnsureLoadedAsync();
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/Error404.razor

@@ -0,0 +1,88 @@
+@page "/error404"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject LocalizationService Loc
+@inject NavigationManager Nav
+@inject IJSRuntime JS
+
+@*
+    Counterpart of HomeController.Error404 ? Views/Shared/_Error.cshtml.
+
+    The legacy view fully replaces the document with a black-space themed
+    layout. In Blazor we keep the receiver layout intact (so the user can
+    still reach the language switcher) and only scope error-space.css to
+    this page via <HeadContent>. JS animation (visor + cord) is initialized
+    once after the canvas elements are in the DOM.
+*@
+
+<HeadContent>
+    <link rel="stylesheet" href="/css/error-space.css" />
+</HeadContent>
+
+<PageTitle>404</PageTitle>
+
+<div class="error-space-stage" style="position:relative; height:80vh; overflow:hidden">
+    <div class="moon"></div>
+    <div class="moon__crater moon__crater1"></div>
+    <div class="moon__crater moon__crater2"></div>
+    <div class="moon__crater moon__crater3"></div>
+
+    <div class="star star1"></div>
+    <div class="star star2"></div>
+    <div class="star star3"></div>
+    <div class="star star4"></div>
+    <div class="star star5"></div>
+
+    <div class="error">
+        <div class="error__title">404</div>
+        <div class="error__subtitle">@Loc["PageNotFound"]</div>
+        <div class="error__description">@Loc["PageNotFoundDescription"]</div>
+        <a href="/" class="error__button error__button--active">@Loc["Home"]</a>
+    </div>
+
+    <div class="astronaut">
+        <div class="astronaut__backpack"></div>
+        <div class="astronaut__body"></div>
+        <div class="astronaut__body__chest"></div>
+        <div class="astronaut__arm-left1"></div>
+        <div class="astronaut__arm-left2"></div>
+        <div class="astronaut__arm-right1"></div>
+        <div class="astronaut__arm-right2"></div>
+        <div class="astronaut__arm-thumb-left"></div>
+        <div class="astronaut__arm-thumb-right"></div>
+        <div class="astronaut__leg-left"></div>
+        <div class="astronaut__leg-right"></div>
+        <div class="astronaut__foot-left"></div>
+        <div class="astronaut__foot-right"></div>
+        <div class="astronaut__wrist-left"></div>
+        <div class="astronaut__wrist-right"></div>
+
+        <div class="astronaut__cord">
+            <canvas id="cord" height="500" width="500"></canvas>
+        </div>
+
+        <div class="astronaut__head">
+            <canvas id="visor" width="60" height="60"></canvas>
+            <div class="astronaut__head-visor-flare1"></div>
+            <div class="astronaut__head-visor-flare2"></div>
+        </div>
+    </div>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync() => await Loc.EnsureLoadedAsync();
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (!firstRender) return;
+        try
+        {
+            const string js = "if (!window.__errSpaceLoaded) { window.__errSpaceLoaded = true; var s = document.createElement('script'); s.src = '/js/error-space.js'; document.body.appendChild(s); }";
+            await JS.InvokeVoidAsync("eval", js);
+        }
+        catch
+        {
+            // Animation is purely decorative — failing to load it is fine.
+        }
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/Home.razor

@@ -0,0 +1,42 @@
+@page "/"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject LocalizationService Loc
+
+<PageTitle>@Loc["Home"]</PageTitle>
+
+@*
+    Counterpart of EnvelopeGenerator.Web/Views/Home/Main.cshtml.
+
+    The legacy view animates the description with typed.js. The Blazor
+    version omits the typewriter effect because it adds another JS
+    dependency for marginal value; the static description is shown
+    instead. Custom company / app logos are loaded from /img/ if
+    available, otherwise gracefully hidden via onerror.
+*@
+
+<div class="page container py-4 px-4">
+    <header class="text-center">
+        <div class="header-1 alert alert-secondary" role="alert">
+            <h3 class="text">@Loc["WelcomeToTheESignPortal"]</h3>
+            <img class="dd-locked-logo" src="/img/company.svg"
+                 onerror="this.style.display='none'" alt="" />
+        </div>
+        <div class="icon mt-4 mb-1">
+            <img class="signFlow-logo" src="/img/sign_flow_horizontal.svg"
+                 onerror="this.style.display='none'" alt="signFLOW" />
+        </div>
+    </header>
+    <section class="text-center">
+        <div class="alert alert-light" role="alert">
+            <p class="home-description">@Loc["HomePageDescription"]</p>
+        </div>
+    </section>
+</div>
+
+@code {
+    protected override async Task OnInitializedAsync()
+    {
+        await Loc.EnsureLoadedAsync();
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/ShowEnvelopeView.razor

@@ -0,0 +1,461 @@
+@implements IDisposable
+@inject ReceiverApiClient Api
+@inject ReceiverAuthState State
+@inject LocalizationService Loc
+@inject NavigationManager Nav
+@inject ILogger<ShowEnvelopeView> Logger
+
+@*
+    Counterpart of EnvelopeGenerator.Web/Views/Envelope/ShowEnvelope.cshtml.
+
+    Sign flow (Phase 5):
+      • Document is rendered by DxPdfViewer for review.
+      • A side panel lists every signature placeholder the receiver has
+        to sign (GET /api/annotation/elements). Each entry opens
+        SignaturePadDialog to capture the signature image (+ optional
+        position / city) and stores the result locally.
+      • Complete validates that every placeholder is signed, then submits
+        the BlazorSignaturePayload (POST /api/annotation/blazor) and
+        navigates to /envelope-signed.
+      • Reset clears every captured signature locally (no server call).
+      • Reject and read-only share popups behave as in Phase 4.
+
+    Why a side-panel signing UX instead of overlaying widgets on the PDF?
+      • DevExpress DxPdfViewer does not expose a public surface for
+        programmatic widget annotations the way PSPDFKit did.
+      • A side panel is fully keyboard / screen-reader accessible, works
+        identically on mobile, and avoids fragile coordinate math against
+        DevExpress' internal DOM. The visual position on the PDF is still
+        communicated via the "Page P" badge per entry.
+*@
+
+<div class="envelope-view">
+
+    @* — Top toolbar / action buttons (desktop) — *@
+    @if (!IsReadOnly)
+    {
+        <div id="flex-action-panel" class="btn-group btn_group position-fixed bottom-0 end-0 d-flex align-items-center"
+             role="group">
+            <DxButton CssClass="btn_complete btn btn-success btn-desktop"
+                      Text="@Loc["Complete"]"
+                      Click="OnCompleteClick"
+                      Enabled="@(!_busy)" />
+            <DxButton CssClass="btn_reject btn btn-danger btn-desktop"
+                      Text="@Loc["Reject"]"
+                      Click="OnRejectClick"
+                      Enabled="@(!_busy)" />
+            <DxButton CssClass="btn_refresh btn btn-secondary btn-desktop"
+                      IconCssClass="bi bi-arrow-counterclockwise"
+                      Text="@Loc["Reset"]"
+                      Click="OnResetClick"
+                      Enabled="@(!_busy && _captured.Count > 0)" />
+        </div>
+    }
+
+    @* — Envelope info card — *@
+    <div class="dd-cards-container">
+        <div class="dd-card">
+            <div class="dd-card-preview">
+                <img src="/img/sign_flow_horizontal.svg" class="app-logo"
+                     onerror="this.style.display='none'" alt="signFLOW" />
+                @if (!IsReadOnly)
+                {
+                    <div class="progress-container">
+                        <div id="signed-count-bar" class="progress"></div>
+                        <span class="progress-text">
+                            <span id="signed-count">@SignedCount</span>/<span id="signature-count">@_elements.Count</span>
+                            @Loc["Signatures"]
+                        </span>
+                    </div>
+                }
+            </div>
+            <div class="dd-card-info">
+                <h2>@(State.Current?.Title)</h2>
+                @if (!string.IsNullOrEmpty(State.Current?.Message))
+                {
+                    <div class="markdown">@State.Current.Message</div>
+                }
+                @if (!string.IsNullOrEmpty(State.Current?.SenderEmail))
+                {
+                    <p>
+                        <small class="text-body-secondary">
+                            <a class="mail-link" href="mailto:@State.Current.SenderEmail">
+                                @State.Current.SenderEmail
+                            </a>
+                        </small>
+                    </p>
+                }
+            </div>
+        </div>
+    </div>
+
+    <div class="row g-3 m-0 envelope-content">
+
+        @* — PDF viewer — *@
+        <div class="col-12 col-lg-8 p-0">
+            <div id="pdfviewer-host" style="min-height:60vh; height:70vh;">
+                @if (_loadingDoc)
+                {
+                    <div class="d-flex align-items-center justify-content-center h-100">
+                        <DxLoadingPanel Visible="true" IsContentBlocked="false" ApplyBackgroundShading="false" />
+                    </div>
+                }
+                else if (_documentBytes is { Length: > 0 })
+                {
+                    <DxPdfViewer DocumentContent="_documentBytes"
+                                 CssClass="h-100 w-100"
+                                 ZoomLevel="1" />
+                }
+                else
+                {
+                    <div class="alert alert-warning m-3" role="alert">
+                        @Loc["DocumentNotFound"]
+                    </div>
+                }
+            </div>
+        </div>
+
+        @* — Side panel: signature placeholders to sign — *@
+        @if (!IsReadOnly)
+        {
+            <aside class="col-12 col-lg-4 p-3">
+                <h5>@Loc["SignaturePlaceholders"]</h5>
+                @if (_loadingElements)
+                {
+                    <DxLoadingPanel Visible="true" IsContentBlocked="false" ApplyBackgroundShading="false" />
+                }
+                else if (_elements.Count == 0)
+                {
+                    <p class="text-body-secondary">@Loc["NoSignatureRequired"]</p>
+                }
+                else
+                {
+                    <ol class="signature-list list-unstyled">
+                        @foreach (var (el, idx) in _elements.Select((e, i) => (e, i + 1)))
+                        {
+                            var signed = _captured.ContainsKey(el.Id);
+                            <li class="signature-item d-flex align-items-center justify-content-between gap-2 p-2 border rounded mb-2 @(signed ? "bg-success-subtle" : "")">
+                                <div>
+                                    <strong>#@idx</strong>
+                                    <span class="badge bg-secondary ms-1">@Loc["Page"] @el.Page</span>
+                                    @if (!string.IsNullOrEmpty(el.Tooltip))
+                                    {
+                                        <div class="small text-body-secondary">@el.Tooltip</div>
+                                    }
+                                    @if (signed)
+                                    {
+                                        <div class="small text-success">
+                                            <i class="bi bi-check2-circle"></i> @Loc["Signed"]
+                                        </div>
+                                    }
+                                </div>
+                                <DxButton Text="@(signed ? Loc["Change"] : Loc["Sign"])"
+                                          RenderStyle="@(signed ? ButtonRenderStyle.Secondary : ButtonRenderStyle.Primary)"
+                                          IconCssClass="bi bi-pen"
+                                          Click="@(() => OpenPadAsync(el))" />
+                            </li>
+                        }
+                    </ol>
+                }
+            </aside>
+        }
+    </div>
+
+    @* — Signature pad dialog — *@
+    <SignaturePadDialog @ref="_padDialog" Confirmed="OnSignatureConfirmed" />
+
+    @* — Confirm-complete popup — *@
+    <DxPopup @bind-Visible="_confirmCompleteVisible"
+             HeaderText="@Loc["ConfirmSigning"]"
+             ShowCloseButton="true"
+             Width="32rem">
+        <BodyContentTemplate Context="confirmCtx">
+            <p>@Loc["ConfirmSigningQ"]</p>
+        </BodyContentTemplate>
+        <FooterContentTemplate Context="confirmFootCtx">
+            <DxButton Text="@Loc["Confirm"]"
+                      RenderStyle="ButtonRenderStyle.Primary"
+                      Click="OnCompleteSubmit" Enabled="@(!_busy)" />
+            <DxButton Text="@Loc["Cancel"]"
+                      RenderStyle="ButtonRenderStyle.Secondary"
+                      Click="@(() => _confirmCompleteVisible = false)" />
+        </FooterContentTemplate>
+    </DxPopup>
+
+    @* — Read-only share popup — *@
+    @if (!IsReadOnly)
+    {
+        <DxPopup @bind-Visible="_shareVisible"
+                 HeaderText="@Loc["EnterRecipientToShareDocument"]"
+                 ShowCloseButton="true"
+                 Width="32rem">
+            <BodyContentTemplate Context="shareCtx">
+                <DxFormLayout>
+                    <DxFormLayoutItem Caption="@Loc["Email"]">
+                        <DxTextBox @bind-Text="_shareEmail" NullText="user@mail.com" />
+                    </DxFormLayoutItem>
+                    <DxFormLayoutItem Caption="@Loc["ValidUntil"]">
+                        <DxDateEdit @bind-Date="_shareValidUntil"
+                                    MinDate="DateTime.Today.AddDays(1)"
+                                    MaxDate="DateTime.Today.AddDays(90)" />
+                    </DxFormLayoutItem>
+                </DxFormLayout>
+                @if (!string.IsNullOrEmpty(_shareError))
+                {
+                    <div class="alert alert-danger mt-2">@_shareError</div>
+                }
+            </BodyContentTemplate>
+            <FooterContentTemplate Context="shareFootCtx">
+                <DxButton Text="@Loc["Send"]" RenderStyle="ButtonRenderStyle.Primary"
+                          IconCssClass="bi bi-send" Click="OnShareSubmit"
+                          Enabled="@(!_busy)" />
+            </FooterContentTemplate>
+        </DxPopup>
+
+        @* — Reject popup — *@
+        <DxPopup @bind-Visible="_rejectVisible"
+                 HeaderText="@Loc["Rejection"]"
+                 ShowCloseButton="true"
+                 Width="32rem">
+            <BodyContentTemplate Context="rejectCtx">
+                <p>@Loc["RejectionReasonQ"]</p>
+                <DxMemo @bind-Text="_rejectReason" Rows="4" />
+            </BodyContentTemplate>
+            <FooterContentTemplate Context="rejectFootCtx">
+                <DxButton Text="@Loc["Complete"]"
+                          RenderStyle="ButtonRenderStyle.Primary"
+                          Click="OnRejectSubmit" Enabled="@(!_busy)" />
+                <DxButton Text="@Loc["Back"]"
+                          RenderStyle="ButtonRenderStyle.Secondary"
+                          Click="@(() => _rejectVisible = false)" />
+            </FooterContentTemplate>
+        </DxPopup>
+    }
+
+    @if (!string.IsNullOrEmpty(_globalError))
+    {
+        <div class="alert alert-danger m-3" role="alert">@_globalError</div>
+    }
+</div>
+
+@code {
+    [Parameter] public string EnvelopeKey { get; set; } = string.Empty;
+
+    private byte[]? _documentBytes;
+    private bool _loadingDoc = true;
+    private bool _loadingElements = true;
+    private bool _busy;
+
+    private List<SignatureElementDto> _elements = new();
+    private readonly Dictionary<int, BlazorSignatureEntry> _captured = new();
+
+    private SignaturePadDialog? _padDialog;
+    private bool _confirmCompleteVisible;
+    private string? _globalError;
+
+    private bool _shareVisible;
+    private string _shareEmail = string.Empty;
+    private DateTime _shareValidUntil = DateTime.Today.AddDays(7);
+    private string? _shareError;
+
+    private bool _rejectVisible;
+    private string _rejectReason = string.Empty;
+
+    private bool IsReadOnly => State.Current?.ReadOnly ?? false;
+    private int SignedCount => _captured.Count;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await Loc.EnsureLoadedAsync();
+        State.Changed += OnStateChanged;
+    }
+
+    protected override async Task OnParametersSetAsync()
+    {
+        if (_documentBytes is null && !string.IsNullOrEmpty(EnvelopeKey))
+        {
+            await LoadDocumentAsync();
+            if (!IsReadOnly)
+                await LoadElementsAsync();
+        }
+    }
+
+    private async Task LoadDocumentAsync()
+    {
+        _loadingDoc = true;
+        try
+        {
+            _documentBytes = await Api.GetDocumentAsync(EnvelopeKey);
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load document for key {Key}", EnvelopeKey);
+        }
+        finally
+        {
+            _loadingDoc = false;
+        }
+    }
+
+    private async Task LoadElementsAsync()
+    {
+        _loadingElements = true;
+        try
+        {
+            _elements = await Api.GetSignatureElementsAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load signature elements.");
+            _elements = new();
+        }
+        finally
+        {
+            _loadingElements = false;
+        }
+    }
+
+    private void OnStateChanged() => InvokeAsync(StateHasChanged);
+
+    // — Signature pad ?????????????????????????????????????????????????
+
+    private async Task OpenPadAsync(SignatureElementDto el)
+    {
+        if (_padDialog is null) return;
+        _captured.TryGetValue(el.Id, out var existing);
+        await _padDialog.ShowAsync(el.Id, existing?.Position, existing?.City);
+    }
+
+    private void OnSignatureConfirmed(BlazorSignatureEntry entry)
+    {
+        _captured[entry.ElementId] = entry;
+        StateHasChanged();
+    }
+
+    // — Toolbar actions ????????????????????????????????????????????????
+
+    private Task OnCompleteClick()
+    {
+        _globalError = null;
+        var missing = _elements.Where(e => !_captured.ContainsKey(e.Id)).ToList();
+        if (missing.Count > 0)
+        {
+            _globalError = Loc.Format("MissingSignaturesFmt", missing.Count);
+            return Task.CompletedTask;
+        }
+        _confirmCompleteVisible = true;
+        return Task.CompletedTask;
+    }
+
+    private async Task OnCompleteSubmit()
+    {
+        if (_busy) return;
+        _busy = true;
+        try
+        {
+            var payload = new BlazorSignaturePayload
+            {
+                Signatures = _captured.Values.ToList()
+            };
+            var status = await Api.SignBlazorAsync(payload);
+            _confirmCompleteVisible = false;
+            if ((int)status >= 200 && (int)status < 300)
+            {
+                Nav.NavigateTo("/envelope-signed", replace: true);
+            }
+            else
+            {
+                _globalError = $"{Loc["UnexpectedErrorTitle"]} ({(int)status})";
+            }
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Sign submit failed.");
+            _globalError = Loc["UnexpectedErrorTitle"];
+        }
+        finally
+        {
+            _busy = false;
+        }
+    }
+
+    private Task OnRejectClick()
+    {
+        _rejectReason = string.Empty;
+        _rejectVisible = true;
+        return Task.CompletedTask;
+    }
+
+    private async Task OnRejectSubmit()
+    {
+        if (_busy) return;
+        _busy = true;
+        try
+        {
+            var ok = await Api.RejectAsync(_rejectReason ?? string.Empty);
+            _rejectVisible = false;
+            if (ok)
+                Nav.NavigateTo("/envelope-rejected", replace: true);
+        }
+        finally
+        {
+            _busy = false;
+        }
+    }
+
+    private void OnResetClick()
+    {
+        _captured.Clear();
+        _globalError = null;
+    }
+
+    // — Share read-only ?????????????????????????????????????????????????
+
+    private async Task OnShareSubmit()
+    {
+        _shareError = null;
+        if (string.IsNullOrWhiteSpace(_shareEmail) ||
+            !System.Text.RegularExpressions.Regex.IsMatch(_shareEmail, @"^\S+@\S+\.\S+$"))
+        {
+            _shareError = Loc["ShrEnvInvalidEmailText"];
+            return;
+        }
+        if (_shareValidUntil < DateTime.Today.AddDays(1))
+        {
+            _shareError = Loc["ShrEnvInvalidDateText"];
+            return;
+        }
+
+        _busy = true;
+        try
+        {
+            var ok = await Api.ShareReadOnlyAsync(new ReadOnlyShareRequest
+            {
+                ReceiverMail = _shareEmail,
+                DateValid = _shareValidUntil
+            });
+            if (ok)
+            {
+                _shareVisible = false;
+                _shareEmail = string.Empty;
+                _shareValidUntil = DateTime.Today.AddDays(7);
+            }
+            else
+            {
+                _shareError = Loc["ShrEnvOperationFailedText"];
+            }
+        }
+        catch
+        {
+            _shareError = Loc["UnexpectedErrorTitle"];
+        }
+        finally
+        {
+            _busy = false;
+        }
+    }
+
+    public void Dispose() => State.Changed -= OnStateChanged;
+}
+
+

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/SignaturePadDialog.razor

@@ -0,0 +1,150 @@
+@implements IAsyncDisposable
+@inject IJSRuntime JS
+@inject LocalizationService Loc
+
+@*
+    Modal dialog that captures one signature for a single placeholder.
+
+    The user is asked to:
+      • draw their signature (mouse / touch),
+      • optionally fill in "position" (job title) and "city",
+      • confirm — which produces a BlazorSignatureEntry and closes the dialog.
+
+    The drawing surface is a plain HTML5 canvas wired up by signature-pad.js
+    (loaded once in App.razor). All JS interop is encapsulated here so the
+    rest of the receiver UI is free of DOM concerns.
+*@
+
+<DxPopup @bind-Visible="_visible"
+         HeaderText="@Loc["YourSignature"]"
+         ShowCloseButton="true"
+         CloseOnEscape="true"
+         Width="36rem"
+         Closed="OnClosed">
+    <BodyContentTemplate Context="padCtx">
+        <div class="signature-pad-container">
+            <canvas id="@_canvasId"
+                    class="signature-pad-canvas"
+                    style="width:100%; height:200px; border:1px solid #cfd6dd; border-radius:.25rem; background:#fff; touch-action:none"></canvas>
+
+            <div class="d-flex gap-2 mt-2">
+                <DxButton Text="@Loc["Clear"]"
+                          RenderStyle="ButtonRenderStyle.Secondary"
+                          IconCssClass="bi bi-eraser"
+                          Click="ClearAsync" />
+            </div>
+
+            <div class="mt-3">
+                <DxFormLayout>
+                    <DxFormLayoutItem Caption="@Loc["Position"]">
+                        <DxTextBox @bind-Text="_position" NullText="@Loc["PositionPlaceholder"]" />
+                    </DxFormLayoutItem>
+                    <DxFormLayoutItem Caption="@Loc["City"]">
+                        <DxTextBox @bind-Text="_city" NullText="@Loc["CityPlaceholder"]" />
+                    </DxFormLayoutItem>
+                </DxFormLayout>
+            </div>
+
+            @if (!string.IsNullOrEmpty(_error))
+            {
+                <div class="alert alert-danger mt-2 mb-0">@_error</div>
+            }
+        </div>
+    </BodyContentTemplate>
+    <FooterContentTemplate Context="footCtx">
+        <DxButton Text="@Loc["Confirm"]"
+                  RenderStyle="ButtonRenderStyle.Primary"
+                  IconCssClass="bi bi-check2"
+                  Click="ConfirmAsync" />
+        <DxButton Text="@Loc["Cancel"]"
+                  RenderStyle="ButtonRenderStyle.Secondary"
+                  Click="@(() => Hide())" />
+    </FooterContentTemplate>
+</DxPopup>
+
+@code {
+    /// <summary>Fired when the user confirms a valid signature.</summary>
+    [Parameter] public EventCallback<BlazorSignatureEntry> Confirmed { get; set; }
+
+    private readonly string _canvasId = $"sigpad_{Guid.NewGuid():N}";
+    private bool _visible;
+    private bool _attached;
+    private int _elementId;
+    private string _position = string.Empty;
+    private string _city = string.Empty;
+    private string? _error;
+
+    /// <summary>Opens the dialog and binds JS interop on the canvas.</summary>
+    public async Task ShowAsync(int elementId, string? defaultPosition = null, string? defaultCity = null)
+    {
+        _elementId = elementId;
+        _position  = defaultPosition ?? string.Empty;
+        _city      = defaultCity     ?? string.Empty;
+        _error     = null;
+        _visible   = true;
+        StateHasChanged();
+
+        // The canvas only exists after the popup is rendered. Wait one
+        // render cycle, then attach the pad.
+        await Task.Yield();
+        try
+        {
+            _attached = await JS.InvokeAsync<bool>("signaturePad.attach", _canvasId);
+        }
+        catch (JSException ex)
+        {
+            _error = ex.Message;
+            _attached = false;
+        }
+    }
+
+    public void Hide()
+    {
+        _visible = false;
+    }
+
+    private async Task ClearAsync()
+    {
+        if (_attached)
+            await JS.InvokeVoidAsync("signaturePad.clear", _canvasId);
+    }
+
+    private async Task ConfirmAsync()
+    {
+        if (!_attached)
+        {
+            _error = Loc["SignaturePadNotReady"];
+            return;
+        }
+
+        var dataUrl = await JS.InvokeAsync<string?>("signaturePad.toDataUrl", _canvasId);
+        if (string.IsNullOrEmpty(dataUrl))
+        {
+            _error = Loc["SignatureRequired"];
+            return;
+        }
+
+        await Confirmed.InvokeAsync(new BlazorSignatureEntry
+        {
+            ElementId        = _elementId,
+            SignatureDataUrl = dataUrl,
+            Position         = string.IsNullOrWhiteSpace(_position) ? null : _position.Trim(),
+            City             = string.IsNullOrWhiteSpace(_city)     ? null : _city.Trim(),
+            SignedAt         = DateTime.Now,
+        });
+
+        await OnClosed();
+        _visible = false;
+    }
+
+    private async Task OnClosed()
+    {
+        if (_attached)
+        {
+            try { await JS.InvokeVoidAsync("signaturePad.detach", _canvasId); } catch { /* ignore */ }
+            _attached = false;
+        }
+    }
+
+    public async ValueTask DisposeAsync() => await OnClosed();
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Receiver/TfaRegistration.razor

@@ -0,0 +1,158 @@
+@page "/tfa/{Key}"
+@layout EnvelopeGenerator.ReceiverUI.Web.Client.Layout.ReceiverLayout
+@rendermode InteractiveAuto
+@inject ReceiverApiClient Api
+@inject LocalizationService Loc
+@inject NavigationManager Nav
+
+@*
+    Counterpart of TFARegController.Reg ? Views/TFAReg/Reg.cshtml.
+
+    The legacy view uses Bootstrap's collapse-based accordion to walk the
+    receiver through 3 steps:
+      1. Install an authenticator app
+      2. Scan the QR code
+      3. Verify the generated 6-digit code
+
+    The Blazor port keeps the exact same step structure but uses
+    DxAccordion so the visual / keyboard behavior matches the rest of
+    the receiver UI. The TOTP QR and registration deadline are fetched
+    from <c>GET /api/tfa/{key}</c> on first render.
+*@
+
+<PageTitle>@Loc["TfaRegistration"]</PageTitle>
+
+<div class="page container p-5">
+    <header class="text-center">
+        <div class="icon locked mt-4 mb-1">
+            <svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" fill="currentColor"
+                 class="bi bi-shield-lock" viewBox="0 0 16 16">
+                <path d="M5.338 1.59a61 61 0 0 0-2.837.856.48.48 0 0 0-.328.39c-.554 4.157.726 7.19 2.253 9.188a10.7 10.7 0 0 0 2.287 2.233c.346.244.652.42.893.533q.18.085.293.118a1 1 0 0 0 .101.025 1 1 0 0 0 .1-.025q.114-.034.294-.118c.24-.113.547-.29.893-.533a10.7 10.7 0 0 0 2.287-2.233c1.527-1.997 2.807-5.031 2.253-9.188a.48.48 0 0 0-.328-.39c-.651-.213-1.75-.56-2.837-.855C9.552 1.29 8.531 1.067 8 1.067c-.53 0-1.552.223-2.662.524zM5.072.56C6.157.265 7.31 0 8 0s1.843.265 2.928.56c1.11.3 2.229.655 2.887.87a1.54 1.54 0 0 1 1.044 1.262c.596 4.477-.787 7.795-2.465 9.99a11.8 11.8 0 0 1-2.517 2.453 7 7 0 0 1-1.048.625c-.28.132-.581.24-.829.24s-.548-.108-.829-.24a7 7 0 0 1-1.048-.625 11.8 11.8 0 0 1-2.517-2.453C1.928 10.487.545 7.169 1.141 2.692A1.54 1.54 0 0 1 2.185 1.43 63 63 0 0 1 5.072.56" />
+                <path d="M9.5 6.5a1.5 1.5 0 0 1-1 1.415l.385 1.99a.5.5 0 0 1-.491.595h-.788a.5.5 0 0 1-.49-.595l.384-1.99a1.5 1.5 0 1 1 2-1.415" />
+            </svg>
+        </div>
+        <h2 class="mb-0">2-Factor Authentication (2FA)</h2>
+        <h2>@Loc["Registration"]</h2>
+    </header>
+
+    @if (_loading)
+    {
+        <div class="text-center mt-4">
+            <DxLoadingPanel Visible="true" IsContentBlocked="false" ApplyBackgroundShading="false" />
+        </div>
+    }
+    else if (_error is not null)
+    {
+        <div class="alert alert-danger mt-4" role="alert">@_error</div>
+        <div class="text-center mt-3">
+            <DxButton Text="@Loc["Back"]"
+                      RenderStyle="ButtonRenderStyle.Secondary"
+                      Click="@(() => Nav.NavigateTo($"/envelope/{Key}"))" />
+        </div>
+    }
+    else if (_data is not null)
+    {
+        <section class="text-center">
+            <p class="p-0 m-0">
+                @if (_data.TfaRegDeadline is DateTime dl)
+                {
+                    @Loc.Format("PageVisibleUntil", dl.ToString("d. MMM, HH:mm", new System.Globalization.CultureInfo("de-DE")))
+                }
+            </p>
+        </section>
+
+        <section class="text-start mt-4">
+            <DxAccordion>
+                <Items>
+                    <DxAccordionItem Text="@Loc["Step1Download2faApplication"]" Expanded="true">
+                        <ContentTemplate>
+                            <p class="text-wrap fw-medium">@Loc["Download2faAppInstruction"]</p>
+                            <p class="text-wrap fw-light">@Loc["Recommended2faApplications"]</p>
+                            <ul class="list-group text-start">
+                                <li class="list-group-item">
+                                    <a href="https://support.google.com/accounts/answer/1066447?hl=de&co=GENIE.Platform%3DAndroid"
+                                       target="_blank" rel="noopener" style="text-decoration:none">
+                                        <samp>Google Authenticator</samp>
+                                    </a>
+                                </li>
+                                <li class="list-group-item">
+                                    <a href="https://support.microsoft.com/de-de/account-billing/microsoft-authenticator-herunterladen-351498fc-850a-45da-b7b6-27e523b8702a"
+                                       target="_blank" rel="noopener" style="text-decoration:none">
+                                        <samp>Microsoft Authenticator</samp>
+                                    </a>
+                                </li>
+                            </ul>
+                        </ContentTemplate>
+                    </DxAccordionItem>
+
+                    <DxAccordionItem Text="@Loc["Step2ScanQrCode"]">
+                        <ContentTemplate>
+                            <div class="text-center m-0 p-0">
+                                @if (!string.IsNullOrEmpty(_data.TotpQR64))
+                                {
+                                    <img class="tfaQrCode"
+                                         src="@($"data:image/png;base64,{_data.TotpQR64}")"
+                                         alt="TOTP QR" />
+                                }
+                            </div>
+                            <p class="text-wrap fw-medium">@Loc["ScanQrCodeInstruction"]</p>
+                        </ContentTemplate>
+                    </DxAccordionItem>
+
+                    <DxAccordionItem Text="@Loc["Step3VerifyTheCode"]">
+                        <ContentTemplate>
+                            <p class="text-wrap fw-medium">
+                                @Loc["VerifyCodeInstructionMain"]
+                                <samp>@Loc["VerifyCodeInstructionSubmit"]</samp>.
+                            </p>
+                            <div class="text-center mt-3">
+                                <DxButton Text="@Loc["BackToEnvelope"]"
+                                          RenderStyle="ButtonRenderStyle.Primary"
+                                          Click="@(() => Nav.NavigateTo($"/envelope/{Key}"))" />
+                            </div>
+                        </ContentTemplate>
+                    </DxAccordionItem>
+                </Items>
+            </DxAccordion>
+        </section>
+    }
+</div>
+
+@code {
+    [Parameter] public string Key { get; set; } = string.Empty;
+
+    private TfaRegistrationResponse? _data;
+    private string? _error;
+    private bool _loading = true;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await Loc.EnsureLoadedAsync();
+
+        _loading = true;
+        try
+        {
+            var (data, status) = await Api.GetTfaRegistrationAsync(Key);
+            if ((int)status >= 200 && (int)status < 300 && data is not null)
+            {
+                _data = data;
+            }
+            else if ((int)status == 410)
+            {
+                _error = Loc["TfaRegDeadlineExpired"];
+            }
+            else if ((int)status == 401)
+            {
+                _error = Loc["UnauthorizedTfaReg"];
+            }
+            else
+            {
+                _error = Loc["UnexpectedErrorTitle"];
+            }
+        }
+        finally
+        {
+            _loading = false;
+        }
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Pages/Weather.razor

@@ -0,0 +1,32 @@
+@page "/weather"
+
+<PageTitle>Weather</PageTitle>
+
+<h1>Weather</h1>
+
+<DxGrid Data="@forecasts">
+    <Columns>
+        <DxGridDataColumn Caption="Date" FieldName="Date" />
+        <DxGridDataColumn Caption="Temperature (C)" FieldName="TemperatureC" />
+        <DxGridDataColumn Caption="Temperature (F)" FieldName="TemperatureF" />
+        <DxGridDataColumn Caption="Summary" FieldName="Summary" />
+    </Columns>
+</DxGrid>
+
+@code {
+    private WeatherForecast[]? forecasts;
+
+    protected override async Task OnInitializedAsync() {
+        DateOnly startDate = DateOnly.FromDateTime(DateTime.Now);
+        string[] summaries = ["Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"];
+        forecasts = Enumerable.Range(1, 5).Select(index => new WeatherForecast(
+                Date: startDate.AddDays(index),
+                TemperatureC: Random.Shared.Next(-20, 55),
+                Summary: summaries[Random.Shared.Next(summaries.Length)]
+            )).ToArray();
+    }
+
+    private record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary) {
+        public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Program.cs

@@ -0,0 +1,31 @@
+using EnvelopeGenerator.ReceiverUI.Web.Client.Api;
+using EnvelopeGenerator.ReceiverUI.Web.Client.Services;
+using EnvelopeGenerator.ReceiverUI.Web.Client.Utils;
+using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
+
+var builder = WebAssemblyHostBuilder.CreateDefault(args);
+
+builder.Services.AddDevExpressBlazor(options =>
+{
+    options.SizeMode = DevExpress.Blazor.SizeMode.Medium;
+});
+
+builder.Services.AddChatClient(builder.HostEnvironment.BaseAddress + "api/chat", "proxykey", "proxychat");
+
+builder.Services.AddDevExpressWebAssemblyBlazorPdfViewer();
+
+DevExpress.XtraPrinting.PrintingOptions.Pdf.RenderingEngine = DevExpress.XtraPrinting.XRPdfRenderingEngine.Skia;
+
+// ── Receiver API + Auth + Localization ─────────────────────────────
+// Same-origin HttpClient: the BFF (EnvelopeGenerator.ReceiverUI.Web)
+// reverse-proxies /api/** to EnvelopeGenerator.API and forwards the
+// HttpOnly authentication cookie automatically.
+builder.Services.AddHttpClient<ReceiverApiClient>(client =>
+{
+    client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
+});
+builder.Services.AddScoped<LocalizationService>();
+builder.Services.AddScoped<ReceiverAuthState>();
+
+await builder.Build().RunAsync();
+

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Routes.razor

@@ -0,0 +1,14 @@
+<Router AppAssembly="typeof(Program).Assembly">
+    <Found Context="routeData">
+        <RouteView RouteData="routeData" DefaultLayout="typeof(Layout.MainLayout)" />
+    </Found>
+    <NotFound>
+        @*
+            Mirrors HomeController.Error404 from EnvelopeGenerator.Web,
+            which maps fallback requests to the Error404 view.
+        *@
+        <LayoutView Layout="@typeof(Layout.ReceiverLayout)">
+            <Pages.Receiver.Error404 />
+        </LayoutView>
+    </NotFound>
+</Router>

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Services/LocalizationService.cs

@@ -0,0 +1,119 @@
+using EnvelopeGenerator.ReceiverUI.Web.Client.Api;
+
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Services;
+
+/// <summary>
+/// Pulls all localized strings from the API once and exposes them
+/// via an indexer mimicking <c>IStringLocalizer&lt;Resource&gt;["Key"]</c>
+/// in the legacy MVC Web project.
+///
+/// Missing keys fall back to the key itself (matching the previous behavior
+/// where <c>_localizer["X"].Value</c> returned "X" if not found).
+///
+/// Components consume this service as a scoped dependency and may call
+/// <see cref="EnsureLoadedAsync"/> in <c>OnInitializedAsync</c>.
+/// </summary>
+public class LocalizationService
+{
+    private readonly ReceiverApiClient _api;
+    private readonly ILogger<LocalizationService> _logger;
+    private Dictionary<string, string> _strings = new();
+    private Task? _loadTask;
+    private readonly object _gate = new();
+
+    public LocalizationService(ReceiverApiClient api, ILogger<LocalizationService> logger)
+    {
+        _api = api;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// Languages exposed in the footer's language switcher. Kept as a
+    /// small in-memory list so the receiver UI does not need an extra
+    /// API roundtrip just to populate a dropdown. Mirrors the cultures
+    /// configured server-side (de-DE, en-US, tr-TR).
+    /// </summary>
+    public static readonly IReadOnlyList<(string Code, string Native, string Flag)> SupportedLanguages =
+        new[]
+        {
+            ("de", "Deutsch",  "fi-de"),
+            ("en", "English",  "fi-gb"),
+            ("tr", "Türkçe",   "fi-tr"),
+        };
+
+    /// <summary>Currently active language code (best effort, set after a switch).</summary>
+    public string? CurrentLanguage { get; private set; }
+
+    /// <summary>Fires whenever the language changes and strings are reloaded.</summary>
+    public event Action? Changed;
+
+    /// <summary>
+    /// Get a localized string by key. Returns the key itself if not found
+    /// (compatible with the legacy <c>_localizer["..."].Value</c> behavior).
+    /// </summary>
+    public string this[string key]
+    {
+        get => _strings.TryGetValue(key, out var v) ? v : key;
+    }
+
+    /// <summary>
+    /// Format a localized template with positional arguments (e.g. "{0}", "{1}").
+    /// </summary>
+    public string Format(string key, params object?[] args)
+    {
+        var template = this[key];
+        try
+        {
+            return string.Format(template, args);
+        }
+        catch (FormatException)
+        {
+            return template;
+        }
+    }
+
+    public IReadOnlyDictionary<string, string> All => _strings;
+
+    /// <summary>
+    /// Loads localization strings from the API. Safe to call multiple times;
+    /// concurrent callers share the same in-flight request.
+    /// </summary>
+    public Task EnsureLoadedAsync(CancellationToken ct = default)
+    {
+        lock (_gate)
+        {
+            return _loadTask ??= LoadCoreAsync(ct);
+        }
+    }
+
+    /// <summary>Forces a reload (e.g. after a language change).</summary>
+    public Task ReloadAsync(CancellationToken ct = default)
+    {
+        lock (_gate)
+        {
+            _loadTask = LoadCoreAsync(ct);
+            return _loadTask;
+        }
+    }
+
+    private async Task LoadCoreAsync(CancellationToken ct)
+    {
+        // Refresh the current language alongside the strings so the
+        // footer dropdown reflects the cookie value picked up by the API.
+        var langTask = _api.GetLanguageAsync(ct);
+        var dict = await _api.GetLocalizationStringsAsync(ct);
+        if (dict is not null)
+            _strings = new Dictionary<string, string>(dict, StringComparer.OrdinalIgnoreCase);
+        else
+            _logger.LogWarning("Localization strings could not be loaded; falling back to keys.");
+        CurrentLanguage = await langTask ?? CurrentLanguage;
+        Changed?.Invoke();
+    }
+
+    public async Task ChangeLanguageAsync(string language, CancellationToken ct = default)
+    {
+        await _api.SetLanguageAsync(language, ct);
+        CurrentLanguage = language;
+        await ReloadAsync(ct);
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Services/ReceiverAuthState.cs

@@ -0,0 +1,34 @@
+using EnvelopeGenerator.ReceiverUI.Web.Client.Api.Models;
+
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Services;
+
+/// <summary>
+/// Holds the current receiver authentication context for the active envelope.
+/// Scoped per circuit (Interactive Server) or per browser tab (Interactive WASM).
+///
+/// Pages observe <see cref="Changed"/> to re-render when the underlying
+/// auth response transitions (e.g. requires_access_code -> requires_tfa
+/// -> show_document).
+/// </summary>
+public class ReceiverAuthState
+{
+    private ReceiverAuthResponse? _current;
+    public string? EnvelopeKey { get; private set; }
+    public ReceiverAuthResponse? Current => _current;
+
+    public event Action? Changed;
+
+    public void Set(string envelopeKey, ReceiverAuthResponse? response)
+    {
+        EnvelopeKey = envelopeKey;
+        _current = response;
+        Changed?.Invoke();
+    }
+
+    public void Clear()
+    {
+        EnvelopeKey = null;
+        _current = null;
+        Changed?.Invoke();
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Services/ServiceExtensions.cs

@@ -0,0 +1,25 @@
+using Azure;
+using Azure.AI.OpenAI;
+using Microsoft.Extensions.AI;
+
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Utils
+{
+    public static class ServiceExtensions
+    {
+        // Demo AI services are rate limited and intended for demonstration purposes only.
+        // DevExpress does not offer a REST API and does not ship any built-in LLMs/SLMs.
+        // Use of demo credentials in production is strictly prohibited.
+        // Specify the Azure OpenAI endpoint, key, and deployment name in the 'appsettings.json' file.
+        public static void AddChatClient(this IServiceCollection services, string aiEndpoint, string aiKey, string deployment)
+        {
+            services.AddDevExpressAI();
+            services.AddScoped<IChatClient>(_ =>
+            {
+                var azureClient = new AzureOpenAIClient(new Uri(aiEndpoint), new AzureKeyCredential(aiKey));
+                return azureClient
+                    .GetChatClient(deployment)
+                    .AsIChatClient();
+            });
+        }
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/Shared/DrawerStateComponentBase.cs

@@ -0,0 +1,77 @@
+using Microsoft.AspNetCore.Components;
+
+namespace EnvelopeGenerator.ReceiverUI.Web.Client.Shared
+{
+    public abstract class DrawerStateComponentBase : ComponentBase
+    {
+        [SupplyParameterFromQuery(Name = DrawerStateUrlBuilder.DrawerStateQueryParameterName)]
+        public bool ToggledDrawer { get; set; }
+
+        [Inject] NavigationManager NavigationManager { get; set; } = null!;
+
+        protected string AddDrawerStateToUrl(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.AddStateToUrl(baseUrl, ToggledDrawer, NavigationManager);
+        }
+
+        protected string AddDrawerStateToUrlToggled(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.AddStateToUrl(baseUrl, !ToggledDrawer, NavigationManager);
+        }
+
+        protected string RemoveDrawerStateFromUrl(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.RemoveStateFromUrl(baseUrl, NavigationManager);
+        }
+    }
+
+    public abstract class DrawerStateLayoutComponentBase : LayoutComponentBase
+    {
+        [SupplyParameterFromQuery(Name = DrawerStateUrlBuilder.DrawerStateQueryParameterName)]
+        public bool ToggledDrawer { get; set; }
+
+        [Inject] NavigationManager NavigationManager { get; set; } = null!;
+
+        protected string AddDrawerStateToUrl(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.AddStateToUrl(baseUrl, ToggledDrawer, NavigationManager);
+        }
+
+        protected string AddDrawerStateToUrlToggled(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.AddStateToUrl(baseUrl, !ToggledDrawer, NavigationManager);
+        }
+
+        protected string RemoveDrawerStateFromUrl(string baseUrl)
+        {
+            return DrawerStateUrlBuilder.RemoveStateFromUrl(baseUrl, NavigationManager);
+        }
+    }
+
+    internal static class DrawerStateUrlBuilder
+    {
+        public const string DrawerStateQueryParameterName = "toggledSidebar";
+
+        public static string AddStateToUrl(string baseUrl, bool toggledDrawer, NavigationManager navigationManager)
+        {
+            return navigationManager.GetUriWithQueryParameters(
+                baseUrl,
+                new Dictionary<string, object?>
+                {
+                    [DrawerStateQueryParameterName] = toggledDrawer ? true : null
+                }
+            );
+        }
+
+        public static string RemoveStateFromUrl(string baseUrl, NavigationManager navigationManager)
+        {
+            return navigationManager.GetUriWithQueryParameters(
+                baseUrl,
+                new Dictionary<string, object?>
+                {
+                    [DrawerStateQueryParameterName] = null
+                }
+            );
+        }
+    }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/_Imports.razor

@@ -0,0 +1,19 @@
+@using System.Net.Http
+@using System.Net.Http.Json
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using static Microsoft.AspNetCore.Components.Web.RenderMode
+@using EnvelopeGenerator.ReceiverUI.Web.Client
+@using EnvelopeGenerator.ReceiverUI.Web.Client.Shared
+@using EnvelopeGenerator.ReceiverUI.Web.Client.Api
+@using EnvelopeGenerator.ReceiverUI.Web.Client.Api.Models
+@using EnvelopeGenerator.ReceiverUI.Web.Client.Services
+
+@using DevExpress.Blazor
+@using DevExpress.Blazor.PdfViewer
+@using DevExpress.Blazor.Reporting.Models
+@using DevExpress.AIIntegration.Blazor.Chat
+@using DevExpress.AIIntegration.Blazor.HtmlEditor

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/wwwroot/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.Client/wwwroot/appsettings.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.sln

@@ -0,0 +1,50 @@
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.0.0
+MinimumVisualStudioVersion = 16.0.0.0
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EnvelopeGenerator.ReceiverUI.Web", "EnvelopeGenerator.ReceiverUI.Web\EnvelopeGenerator.ReceiverUI.Web.csproj", "{650B3CE7-2E93-4CC4-9F46-466686815EAA}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EnvelopeGenerator.ReceiverUI.Web.Client", "EnvelopeGenerator.ReceiverUI.Web.Client\EnvelopeGenerator.ReceiverUI.Web.Client.csproj", "{5990939C-7E7B-4CFA-86FF-44CA5756498A}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|x64.Build.0 = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Debug|x86.Build.0 = Debug|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|x64.ActiveCfg = Release|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|x64.Build.0 = Release|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|x86.ActiveCfg = Release|Any CPU
+		{5990939C-7E7B-4CFA-86FF-44CA5756498A}.Release|x86.Build.0 = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|x64.Build.0 = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Debug|x86.Build.0 = Debug|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|x64.ActiveCfg = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|x64.Build.0 = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|x86.ActiveCfg = Release|Any CPU
+		{650B3CE7-2E93-4CC4-9F46-466686815EAA}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {4C26868E-5E7C-458D-82E3-040509D0C71F}
+	EndGlobalSection
+EndGlobal

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/Components/App.razor

@@ -0,0 +1,37 @@
+@using Microsoft.AspNetCore.Mvc.ViewFeatures
+@inject IFileVersionProvider FileVersionProvider
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <base href="/" />
+    @DxResourceManager.RegisterTheme(ActiveTheme)
+    @DxResourceManager.RegisterScripts()
+    <link href=@AppendVersion("_content/DevExpress.Blazor.Viewer/css/dx-blazor-viewer-components.fluent.css") rel="stylesheet" />
+    <link href=@AppendVersion("css/site.css") rel="stylesheet" />
+    <link href=@AppendVersion("css/receiver-site.css") rel="stylesheet" />
+    <link href=@AppendVersion("css/card.css") rel="stylesheet" />
+    <link href=@AppendVersion("css/logo.css") rel="stylesheet" />
+    <link href=@AppendVersion("css/receiver-extras.css") rel="stylesheet" />
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css" rel="stylesheet" />
+    <link href=@AppendVersion("EnvelopeGenerator.ReceiverUI.Web.styles.css") rel="stylesheet" />
+    <HeadOutlet @rendermode="InteractiveAuto" />
+</head>
+<body>
+    <Routes @rendermode="InteractiveAuto" />
+    <script src="_framework/blazor.web.js"></script>
+    <script src="js/signature-pad.js"></script>
+</body>
+</html>
+
+@code {
+    static readonly ITheme ActiveTheme = Themes.Fluent.Clone(properties => {
+        properties.Mode = ThemeMode.Light;
+        properties.UseBootstrapStyles = true;
+    });
+
+    private string AppendVersion(string path) => FileVersionProvider.AddFileVersionToPath("/", path);
+
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/Components/Pages/Error.razor

@@ -0,0 +1,36 @@
+@page "/Error"
+@using System.Diagnostics
+
+<PageTitle>Error</PageTitle>
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>
+
+@code{
+    [CascadingParameter]
+    private HttpContext? HttpContext { get; set; }
+
+    private string? RequestId { get; set; }
+    private bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+
+    protected override void OnInitialized() =>
+        RequestId = Activity.Current?.Id ?? HttpContext?.TraceIdentifier;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/Components/_Imports.razor

@@ -0,0 +1,18 @@
+@using System.Net.Http
+@using System.Net.Http.Json
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using static Microsoft.AspNetCore.Components.Web.RenderMode
+@using EnvelopeGenerator.ReceiverUI.Web
+@using EnvelopeGenerator.ReceiverUI.Web.Components
+@using EnvelopeGenerator.ReceiverUI.Web.Client
+@using EnvelopeGenerator.ReceiverUI.Web.Client.Shared
+
+@using DevExpress.Blazor
+@using DevExpress.Blazor.PdfViewer
+@using DevExpress.Blazor.Reporting.Models
+@using DevExpress.AIIntegration.Blazor.Chat
+@using DevExpress.AIIntegration.Blazor.HtmlEditor

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web.csproj

@@ -0,0 +1,28 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DevExpress.Blazor" Version="25.2.*" />
+    <PackageReference Include="DevExpress.Blazor.PdfViewer" Version="25.2.*" />
+    <PackageReference Include="DevExpress.Pdf.SkiaRenderer" Version="25.2.*" />
+    <PackageReference Include="SkiaSharp.NativeAssets.WebAssembly" Version="3.119.1" />
+    <PackageReference Include="HarfBuzzSharp.NativeAssets.WebAssembly" Version="8.3.1.2" />
+    <PackageReference Include="DevExpress.AIIntegration.Blazor" Version="25.2.*" />
+    <PackageReference Include="DevExpress.AIIntegration.OpenAI" Version="25.2.*" />
+    
+    <PackageReference Include="Azure.AI.OpenAI" Version="2.2.0-beta.5" />
+    <PackageReference Include="Microsoft.Extensions.AI" Version="9.7.1" />
+    <PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="9.7.1-preview.1.25365.4" />
+    
+    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.Server" Version="8.0.20" />
+    <PackageReference Include="Yarp.ReverseProxy" Version="2.2.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\EnvelopeGenerator.ReceiverUI.Web.Client\EnvelopeGenerator.ReceiverUI.Web.Client.csproj" />
+  </ItemGroup>
+</Project>

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/Program.cs

@@ -0,0 +1,106 @@
+using EnvelopeGenerator.ReceiverUI.Web.Client.Api;
+using EnvelopeGenerator.ReceiverUI.Web.Client.Services;
+using EnvelopeGenerator.ReceiverUI.Web.Client.Utils;
+using EnvelopeGenerator.ReceiverUI.Web.Components;
+using System.Text;
+
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddRazorComponents()
+    .AddInteractiveServerComponents()
+    .AddInteractiveWebAssemblyComponents();
+
+builder.Services.AddDevExpressBlazor(options =>
+{
+    options.SizeMode = DevExpress.Blazor.SizeMode.Medium;
+});
+
+var aiUri = builder.Configuration.GetSection("AzureOpenAISettings")["Endpoint"];
+var aiKey = builder.Configuration.GetSection("AzureOpenAISettings")["Key"];
+var aiModel = builder.Configuration.GetSection("AzureOpenAISettings")["DeploymentName"];
+
+if (string.IsNullOrEmpty(aiUri) || string.IsNullOrEmpty(aiKey) || string.IsNullOrEmpty(aiModel))
+    throw new InvalidOperationException("Specify the OpenAI endpoint, key, and deployment name in the 'appsettings.json' file.");
+builder.Services.AddChatClient(aiUri, aiKey, aiModel);
+builder.Services.AddHttpClient();
+
+builder.Services.AddMvc();
+
+builder.Services.AddDevExpressServerSideBlazorPdfViewer();
+
+// ── Receiver API + Auth + Localization (for prerender on the server) ─
+// During prerendering the components still need the same scoped services
+// as on the WASM side. Server-side calls go directly to the API
+// (configured via "Api:BaseUrl"); browser-side calls go through YARP.
+// Note: server-side prerender does NOT forward the user's auth cookie yet
+// (will be added in a later phase if interactive prerender is needed).
+var apiBaseUrl = builder.Configuration["Api:BaseUrl"]
+    ?? throw new InvalidOperationException("Api:BaseUrl is missing from configuration.");
+builder.Services.AddHttpClient<ReceiverApiClient>(client =>
+{
+    client.BaseAddress = new Uri(apiBaseUrl.TrimEnd('/') + "/");
+});
+builder.Services.AddScoped<LocalizationService>();
+builder.Services.AddScoped<ReceiverAuthState>();
+
+// ── YARP reverse proxy: forwards /api/** from the browser to the API
+// (same-origin from the browser's POV → HttpOnly auth cookie flows).
+builder.Services.AddReverseProxy()
+    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (app.Environment.IsDevelopment())
+{
+    app.UseWebAssemblyDebugging();
+}
+else
+{
+    app.UseExceptionHandler("/Error", createScopeForErrors: true);
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
+}
+
+app.MapPost("/api/chat/{*path}", async (string path, HttpContext context, CancellationToken ct) =>
+{
+    var httpClientFactory = context.RequestServices.GetRequiredService<IHttpClientFactory>();
+
+    var client = httpClientFactory.CreateClient();
+    client.BaseAddress = new(aiUri);
+    client.DefaultRequestHeaders.Authorization = new("Bearer", aiKey);
+
+    var newPath = path.Replace("proxychat", aiModel);
+    var endpointUri = new Uri(aiUri);
+    var uriBuilder = new UriBuilder(endpointUri)
+    {
+        Path = $"{endpointUri.AbsolutePath}/{newPath}",
+        Query = context.Request.QueryString.Value
+    };
+
+    var body = await new StreamReader(context.Request.Body).ReadToEndAsync(ct);
+
+    var response = await client.PostAsync(uriBuilder.Uri, new StringContent(body, Encoding.UTF8, "application/json"), ct);
+    context.Response.StatusCode = (int)response.StatusCode;
+    await response.Content.CopyToAsync(context.Response.Body, ct);
+});
+
+app.UseHttpsRedirection();
+
+app.UseStaticFiles();
+app.UseAntiforgery();
+
+// Forward all /api/** traffic (except /api/chat which is handled above)
+// to the EnvelopeGenerator.API backend.
+app.MapReverseProxy();
+
+app.MapRazorComponents<App>()
+    .AddInteractiveServerRenderMode()
+    .AddInteractiveWebAssemblyRenderMode()
+    .AddAdditionalAssemblies(typeof(EnvelopeGenerator.ReceiverUI.Web.Client._Imports).Assembly)
+    .AllowAnonymous();
+
+app.Run();
+

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/Properties/launchSettings.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+      "applicationUrl": "http://localhost:5000",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
+      "applicationUrl": "https://localhost:5001;http://localhost:5000",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/appsettings.json

@@ -0,0 +1,36 @@
+{
+  "AzureOpenAISettings": {
+    "Endpoint": "https://public-api.devexpress.com/demo-openai",
+    "Key": "DEMO",
+    "DeploymentName": "gpt-4.1"
+  },
+  "Api": {
+    "BaseUrl": "https://localhost:8088"
+  },
+  "ReverseProxy": {
+    "Routes": {
+      "envelope-api": {
+        "ClusterId": "envelope-api",
+        "Match": {
+          "Path": "/api/{**catch-all}"
+        }
+      }
+    },
+    "Clusters": {
+      "envelope-api": {
+        "Destinations": {
+          "default": {
+            "Address": "https://localhost:8088"
+          }
+        }
+      }
+    }
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/card.css

@@ -0,0 +1,126 @@
+@import url('https://fonts.googleapis.com/css?family=Muli&display=swap');
+
+* {
+	box-sizing: border-box;
+}
+
+.dd-cards-container {
+	font-family: 'Muli', sans-serif;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	flex-direction: column;
+
+}
+
+.dd-card {
+	background-color: #fff;
+	display: flex;
+	max-width: 100%;
+	margin: 0;
+	overflow: hidden;
+	width: 100%;
+}
+
+	.dd-card h6 {
+		opacity: 0.6;
+		margin: 0;
+		letter-spacing: 0.0625rem;
+		font-size: clamp(0.6rem, 1.33vw, 0.8rem);
+	}
+
+	.dd-card h2 {
+		letter-spacing: 0.0625rem;
+		margin: 0;
+		font-size: clamp(1rem, 2.67vw, 1.67rem);
+	}
+
+.uppercase {
+	text-transform: uppercase;
+}
+
+.dd-card-preview {
+	background-color: #2A265F;
+	color: #fff;
+	padding: 0.1rem 1rem 1rem 1rem;
+	margin:0;
+	display: flex;
+	flex-direction: column;
+	justify-content: center;
+	align-items: center;
+}
+
+	.dd-card-preview a {
+		color: #fff;
+		opacity: 0.6;
+	}
+
+	.dd-card-preview button {
+		border-width: 0;
+		align-items: center;
+		background-color: transparent;
+		color: white;
+		margin: 15% 0 0 0;
+		transition: color 0.25s ease;
+
+	}
+
+		.dd-card-preview button:hover {
+			color: #bebebe;
+		}
+
+		.dd-card-preview span {
+		}
+
+.dd-card-info {
+	padding: clamp(0.55rem, 2vw, .875rem) 0 0 clamp(0.55rem, 2.5vw, 1.7rem);
+	margin: 0;
+	position: relative;
+	width: 100%;
+}
+
+	.dd-card-info p, .dd-card-info a, .dd-card-info small, .dd-card-info span {
+		opacity: 0.65;
+		font-size: clamp(0.55rem, 1.23vw, 0.75rem);
+		margin: clamp(0.55rem, 2vw, .875rem) 0 clamp(0.55rem, 2vw, .875rem) 0;
+		text-decoration: none;
+		padding: 0;
+	}
+
+.app-logo {
+	width: clamp(4rem, 10vw, 5rem);
+	margin: 1rem 0 0 0;
+}
+
+.progress-container {
+	text-align: right;
+	width: 100%;
+	margin: clamp(0.8rem, 2vw, 1rem) 0 0 0;
+}
+
+.progress {
+	background-color: #ddd;
+	border-radius: 0.1875rem;
+	height: clamp(0.25rem, 1vw, 0.3125rem);
+	width: clamp(6rem, 20vw, 10rem);
+	position: relative;
+}
+
+	.progress::after {
+		background-color: #2A265F;
+		content: '';
+		position: absolute;
+		top: 0;
+		left: 0;
+		height: clamp(0.25rem, 1vw, 0.3125rem);
+		width: var(--progress-width, 1%);
+		transition: width 1s ease;
+		opacity: 0.85;
+	}
+
+.progress-text {
+	font-size: clamp(0.5rem, 1.5vw, 0.625rem);
+	opacity: 0.6;
+	letter-spacing: clamp(0.05rem, 0.5vw, 0.0625rem);
+	text-align: left;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/error-space.css

@@ -0,0 +1,391 @@
+html,
+body {
+    height: 100%;
+    width: 100%;
+    margin: 0px;
+    background: linear-gradient(90deg, rgba(47, 54, 64, 1) 23%, rgba(24, 27, 32, 1) 100%);
+}
+
+:root {
+    --moon-left-position: 0px;
+}
+
+
+.moon {
+    background: linear-gradient(90deg, rgba(208, 208, 208, 1) 48%, rgba(145, 145, 145, 1) 100%);
+    position: absolute;
+    top: -100px;
+    left: var(--moon-left-position);
+    width: 900px;
+    height: 900px;
+    content: '';
+    border-radius: 100%;
+    box-shadow: 0px 0px 30px -4px rgba(0, 0, 0, 0.5);
+}
+
+.moon__crater {
+    position: absolute;
+    content: '';
+    border-radius: 100%;
+    background: linear-gradient(90deg, rgba(122, 122, 122, 1) 38%, rgba(195, 195, 195, 1) 100%);
+    opacity: 0.6;
+}
+
+.moon__crater1 {
+    top: 250px;
+    left: calc(var(--moon-left-position) + 800px);
+    width: 60px;
+    height: 180px;
+}
+
+.moon__crater2 {
+    top: 650px;
+    left: calc(var(--moon-left-position) + 640px);
+    width: 40px;
+    height: 80px;
+    transform: rotate(55deg);
+}
+
+.moon__crater3 {
+    top: -20px;
+    left: calc(var(--moon-left-position) + 340px);
+    width: 65px;
+    height: 120px;
+    transform: rotate(250deg);
+}
+
+.star {
+    background: grey;
+    position: absolute;
+    width: 5px;
+    height: 5px;
+    content: '';
+    border-radius: 100%;
+    transform: rotate(250deg);
+    opacity: 0.4;
+    animation-name: shimmer;
+    animation-duration: 1.5s;
+    animation-iteration-count: infinite;
+    animation-direction: alternate;
+}
+
+@keyframes shimmer {
+    from {
+        opacity: 0;
+    }
+
+    to {
+        opacity: 0.7;
+    }
+}
+
+.star1 {
+    top: 40%;
+    left: 50%;
+    animation-delay: 1s;
+}
+
+.star2 {
+    top: 60%;
+    left: 90%;
+    animation-delay: 3s;
+}
+
+.star3 {
+    top: 10%;
+    left: 70%;
+    animation-delay: 2s;
+}
+
+.star4 {
+    top: 90%;
+    left: 40%;
+}
+
+.star5 {
+    top: 20%;
+    left: 30%;
+    animation-delay: 0.5s;
+}
+
+.error {
+    position: absolute;
+    left: 100px;
+    top: 400px;
+    transform: translateY(-60%);
+    font-family: 'Montserrat', sans-serif;
+    color: #363e49;
+}
+
+.error__title {
+    font-size: 10em;
+}
+
+.error__subtitle {
+    font-size: 2em;
+}
+
+.error__description {
+    opacity: 0.5;
+}
+
+.error__button  {
+    display: inline-block;
+    margin-top: 3em;
+    margin-right: 0.5em;
+    padding: 0.5em 2em;
+    outline: none;
+    border: 2px solid #2f3640;
+    background-color: transparent;
+    border-radius: 8em;
+    color: #576375;
+    cursor: pointer;
+    transition-duration: 0.2s;
+    font-size: 0.75em;
+    font-family: 'Montserrat', sans-serif;
+    text-decoration: none;
+}
+
+.error__button:hover {
+    color: #21252c;
+}
+
+.error__button--active {
+    background-color: #e67e22;
+    border: 2px solid #e67e22;
+    color: white;
+}
+
+.error__button--active:hover {
+    box-shadow: 0px 0px 8px 0px rgba(0, 0, 0, 0.5);
+    color: white;
+}
+
+.astronaut {
+    position: absolute;
+    width: 185px;
+    height: 300px;
+    left: 70%;
+    top: 50%;
+    transform: translate(-50%, -50%) rotate(20deg) scale(1.2);
+}
+
+.astronaut__head {
+    background-color: white;
+    position: absolute;
+    top: 60px;
+    left: 60px;
+    width: 60px;
+    height: 60px;
+    content: '';
+    border-radius: 2em;
+}
+
+.astronaut__head-visor-flare1 {
+    background-color: #7f8fa6;
+    position: absolute;
+    top: 28px;
+    left: 40px;
+    width: 10px;
+    height: 10px;
+    content: '';
+    border-radius: 2em;
+    opacity: 0.5;
+}
+
+.astronaut__head-visor-flare2 {
+    background-color: #718093;
+    position: absolute;
+    top: 40px;
+    left: 38px;
+    width: 5px;
+    height: 5px;
+    content: '';
+    border-radius: 2em;
+    opacity: 0.3;
+}
+
+.astronaut__backpack {
+    background-color: #bfbfbf;
+    position: absolute;
+    top: 90px;
+    left: 47px;
+    width: 86px;
+    height: 90px;
+    content: '';
+    border-radius: 8px;
+}
+
+.astronaut__body {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 115px;
+    left: 55px;
+    width: 70px;
+    height: 80px;
+    content: '';
+    border-radius: 8px;
+}
+
+.astronaut__body__chest {
+    background-color: #d9d9d9;
+    position: absolute;
+    top: 140px;
+    left: 68px;
+    width: 45px;
+    height: 25px;
+    content: '';
+    border-radius: 6px;
+}
+
+.astronaut__arm-left1 {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 127px;
+    left: 9px;
+    width: 65px;
+    height: 20px;
+    content: '';
+    border-radius: 8px;
+    transform: rotate(-30deg);
+}
+
+.astronaut__arm-left2 {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 102px;
+    left: 7px;
+    width: 20px;
+    height: 45px;
+    content: '';
+    border-radius: 8px;
+    transform: rotate(-12deg);
+    border-top-left-radius: 8em;
+    border-top-right-radius: 8em;
+}
+
+.astronaut__arm-right1 {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 113px;
+    left: 100px;
+    width: 65px;
+    height: 20px;
+    content: '';
+    border-radius: 8px;
+    transform: rotate(-10deg);
+}
+
+.astronaut__arm-right2 {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 78px;
+    left: 141px;
+    width: 20px;
+    height: 45px;
+    content: '';
+    border-radius: 8px;
+    transform: rotate(-10deg);
+    border-top-left-radius: 8em;
+    border-top-right-radius: 8em;
+}
+
+.astronaut__arm-thumb-left {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 110px;
+    left: 21px;
+    width: 10px;
+    height: 6px;
+    content: '';
+    border-radius: 8em;
+    transform: rotate(-35deg);
+}
+
+.astronaut__arm-thumb-right {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 90px;
+    left: 133px;
+    width: 10px;
+    height: 6px;
+    content: '';
+    border-radius: 8em;
+    transform: rotate(20deg);
+}
+
+.astronaut__wrist-left {
+    background-color: #e67e22;
+    position: absolute;
+    top: 122px;
+    left: 6.5px;
+    width: 21px;
+    height: 4px;
+    content: '';
+    border-radius: 8em;
+    transform: rotate(-15deg);
+}
+
+.astronaut__wrist-right {
+    background-color: #e67e22;
+    position: absolute;
+    top: 98px;
+    left: 141px;
+    width: 21px;
+    height: 4px;
+    content: '';
+    border-radius: 8em;
+    transform: rotate(-10deg);
+}
+
+.astronaut__leg-left {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 188px;
+    left: 50px;
+    width: 23px;
+    height: 75px;
+    content: '';
+    transform: rotate(10deg);
+}
+
+.astronaut__leg-right {
+    background-color: #e6e6e6;
+    position: absolute;
+    top: 188px;
+    left: 108px;
+    width: 23px;
+    height: 75px;
+    content: '';
+    transform: rotate(-10deg);
+}
+
+.astronaut__foot-left {
+    background-color: white;
+    position: absolute;
+    top: 240px;
+    left: 43px;
+    width: 28px;
+    height: 20px;
+    content: '';
+    transform: rotate(10deg);
+    border-radius: 3px;
+    border-top-left-radius: 8em;
+    border-top-right-radius: 8em;
+    border-bottom: 4px solid #e67e22;
+}
+
+.astronaut__foot-right {
+    background-color: white;
+    position: absolute;
+    top: 240px;
+    left: 111px;
+    width: 28px;
+    height: 20px;
+    content: '';
+    transform: rotate(-10deg);
+    border-radius: 3px;
+    border-top-left-radius: 8em;
+    border-top-right-radius: 8em;
+    border-bottom: 4px solid #e67e22;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/icons.css

@@ -0,0 +1,38 @@
+.icon {
+    width: 1.25rem;
+    height: 1.25rem;
+    background-color: currentcolor;
+    mask-image: var(--icon-mask-image);
+    mask-position: center;
+    mask-repeat: no-repeat;
+}
+
+.icon-back {
+    --icon-mask-image: url("/images/back.svg");
+}
+.icon-close {
+    --icon-mask-image: url("/images/close.svg");
+}
+.icon-demos {
+    --icon-mask-image: url("/images/demos.svg");
+}
+.icon-docs {
+    --icon-mask-image: url("/images/doc.svg");
+}
+.icon-menu {
+    --icon-mask-image: url("/images/menu.svg");
+}
+
+/* pages */
+.icon-counter {
+    --icon-mask-image: url("/images/pages/counter.svg");
+}
+.icon-home {
+    --icon-mask-image: url("/images/pages/home.svg");
+}
+.icon-pdf-viewer {
+    --icon-mask-image: url("/images/pages/document-pdf.svg");
+}
+.icon-weather {
+    --icon-mask-image: url("/images/pages/weather.svg");
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/logo.css

@@ -0,0 +1,37 @@
+.dd-locked-logo {
+    width: 13rem;
+    padding-top: 1rem;
+}
+
+.dd-show-logo {
+    width: 9rem;
+    position: absolute;
+    right: 0;
+    margin: 0 2rem 0 0;
+    padding: 0;
+    top:0;
+}
+
+.cursor-locked-logo {
+    width: 9rem;
+    padding-top: 1rem;
+}
+
+.cursor-show-logo {
+    width: 6rem;
+}
+
+@media (max-width: 767px) {
+    .dd-show-logo {
+        width: 5rem;
+        margin-right: 0rem;
+    }
+
+    .cursor-show-logo {
+        width: 3rem;
+    }
+}
+
+.signFlow-logo {
+    width: 9rem;
+}

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/open-iconic/README.md

@@ -0,0 +1,114 @@
+[Open Iconic v1.1.1](http://useiconic.com/open)
+===========
+
+### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint—ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
+
+
+
+## What's in Open Iconic?
+
+* 223 icons designed to be legible down to 8 pixels
+* Super-light SVG files - 61.8 for the entire set 
+* SVG sprite—the modern replacement for icon fonts
+* Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
+* Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
+* PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
+
+
+## Getting Started
+
+#### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
+
+### General Usage
+
+#### Using Open Iconic's SVGs
+
+We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
+
+```
+<img src="/open-iconic/svg/icon-name.svg" alt="icon name">
+```
+
+#### Using Open Iconic's SVG Sprite
+
+Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
+
+Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*  
+
+```
+<svg class="icon">
+  <use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
+</svg>
+```
+
+Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
+
+```
+.icon {
+  width: 16px;
+  height: 16px;
+}
+```
+
+Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
+
+```
+.icon-account-login {
+  fill: #f00;
+}
+```
+
+To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
+
+#### Using Open Iconic's Icon Font...
+
+
+##### …with Bootstrap
+
+You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
+
+
+```
+<link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
+```
+
+
+```
+<span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …with Foundation
+
+You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
+```
+
+
+```
+<span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …on its own
+
+You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
+```
+
+```
+<span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+
+## License
+
+### Icons
+
+All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
+
+### Fonts
+
+All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).

receiverUI/EnvelopeGenerator.ReceiverUI.Web/EnvelopeGenerator.ReceiverUI.Web/wwwroot/css/open-iconic/font-license.txt

@@ -0,0 +1,86 @@
+SIL OPEN FONT LICENSE Version 1.1
+
+Copyright (c) 2014 Waybury
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.