From 0fdfe991eac4f76a8f3c951fb7199fade0da67ff Mon Sep 17 00:00:00 2001
From: TekH <h.tek@digitaldata.works>
Date: Thu, 3 Sep 2026 14:57:21 +0200
Subject: [PATCH] =?UTF-8?q?SF-74:=20Domain/Application=20=E2=80=94=20UserP?=
 =?UTF-8?q?references=20DTO,=20interface,=20Sender=20role=20constant?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Common/Dto/UserPreferencesDto.cs              | 15 ++++++++++++++-
 .../Services/IUserPreferencesService.cs           |  8 ++++----
 EnvelopeGenerator.Domain/Constants/Role.cs        |  5 +++++
 3 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/EnvelopeGenerator.Application/Common/Dto/UserPreferencesDto.cs b/EnvelopeGenerator.Application/Common/Dto/UserPreferencesDto.cs
index ffc794f6..3be96c21 100644
--- a/EnvelopeGenerator.Application/Common/Dto/UserPreferencesDto.cs
+++ b/EnvelopeGenerator.Application/Common/Dto/UserPreferencesDto.cs
@@ -3,7 +3,7 @@ namespace EnvelopeGenerator.Application.Common.Dto;
 /// <summary>
 /// Represents a user's UI preferences stored in the distributed cache (dbo.TBDD_CACHE).
 /// </summary>
-public sealed class UserPreferencesDto
+public sealed record UserPreferencesDto
 {
     /// <summary>
     /// The active DevExpress theme name.
@@ -23,4 +23,17 @@ public sealed class UserPreferencesDto
     /// Values are opaque JSON strings produced by DxGrid.SaveLayoutAsync().
     /// </summary>
     public Dictionary<string, string> GridLayouts { get; set; } = new();
+
+    /// <summary>
+    /// The authenticated user's display name ("{GivenName} {Surname}").
+    /// Populated by the server on GET responses from JWT claims.
+    /// NOT persisted in cache — injected at read time by UserPreferencesController.
+    /// Ignored on PUT requests.
+    /// </summary>
+    public string? DisplayName { get; set; }
+
+    /// <summary>
+    /// 
+    /// </summary>
+    public static UserPreferencesDto Default { get; } = new UserPreferencesDto();
 }
diff --git a/EnvelopeGenerator.Application/Common/Interfaces/Services/IUserPreferencesService.cs b/EnvelopeGenerator.Application/Common/Interfaces/Services/IUserPreferencesService.cs
index 015e6670..9103886e 100644
--- a/EnvelopeGenerator.Application/Common/Interfaces/Services/IUserPreferencesService.cs
+++ b/EnvelopeGenerator.Application/Common/Interfaces/Services/IUserPreferencesService.cs
@@ -14,16 +14,16 @@ public interface IUserPreferencesService
     /// Always returns a valid object — never throws, never returns null.
     /// Returns defaults if no entry exists in cache.
     /// </summary>
-    /// <param name="username">The sender's username (ClaimTypes.Name from JWT).</param>
+    /// <param name="id"></param>
     /// <param name="ct">Cancellation token.</param>
-    Task<UserPreferencesDto> GetAsync(string username, CancellationToken ct = default);
+    Task<UserPreferencesDto> GetOrCreateAsync(string id, CancellationToken ct = default);
 
     /// <summary>
     /// Persists the given preferences for the user in the distributed cache.
     /// Failures are non-fatal and silently ignored.
     /// </summary>
-    /// <param name="username">The sender's username (ClaimTypes.Name from JWT).</param>
+    /// <param name="id"></param>
     /// <param name="preferences">The preferences to persist.</param>
     /// <param name="ct">Cancellation token.</param>
-    Task SaveAsync(string username, UserPreferencesDto preferences, CancellationToken ct = default);
+    Task SaveAsync(string id, UserPreferencesDto preferences, CancellationToken ct = default);
 }
diff --git a/EnvelopeGenerator.Domain/Constants/Role.cs b/EnvelopeGenerator.Domain/Constants/Role.cs
index 0a85a9bc..b6347dee 100644
--- a/EnvelopeGenerator.Domain/Constants/Role.cs
+++ b/EnvelopeGenerator.Domain/Constants/Role.cs
@@ -1,5 +1,6 @@
 #if NETFRAMEWORK
 using System;
+using System.Collections.Generic;
 #endif
 
 namespace EnvelopeGenerator.Domain.Constants
@@ -15,7 +16,11 @@ namespace EnvelopeGenerator.Domain.Constants
         public static class Receiver
         {
             public const string TFA = "EGReceiverTFA";
+
+            [Obsolete("Use Receiver.Authorized")]
             public const string Full = "EGReceiver";
+
+            public static readonly IReadOnlyList<string> Authorized = new[] { "receiver", "EGReceiver" };
         }
 
         public const string Sender = "EGSender";