From bf23e88cf8f552c192f3da90b776489116ceee61 Mon Sep 17 00:00:00 2001
From: TekH <h.tek@digitaldata.works>
Date: Mon, 5 Oct 2026 15:58:58 +0200
Subject: [PATCH] Add plan for recent receiver suggestions feature

Added a detailed plan document outlining the development of a "recent receiver suggestions" feature for step 3 of the sender wizard. The plan defines team working rules, objectives, functional requirements, and architecture direction across application, server, and client layers.

The implementation is divided into six phases, covering MediatR query creation, API endpoint addition, client integration, UI updates, regression testing, and technical debt tracking. Each phase includes black-box test suggestions to ensure quality and robustness. The plan emphasizes incremental development, user approval, and quality-focused processes.
---
 .../Controllers/EnvelopeReceiverController.cs    | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/EnvelopeGenerator.Server/EnvelopeGenerator.Server/Controllers/EnvelopeReceiverController.cs b/EnvelopeGenerator.Server/EnvelopeGenerator.Server/Controllers/EnvelopeReceiverController.cs
index 1ca838aa..07a6dcfa 100644
--- a/EnvelopeGenerator.Server/EnvelopeGenerator.Server/Controllers/EnvelopeReceiverController.cs
+++ b/EnvelopeGenerator.Server/EnvelopeGenerator.Server/Controllers/EnvelopeReceiverController.cs
@@ -112,6 +112,20 @@ public class EnvelopeReceiverController : ControllerBase
         return name is null ? NotFound() : Ok(name);
     }
 
+    /// <summary>
+    /// Returns recent receiver suggestions for the authenticated sender.
+    /// </summary>
+    /// <param name="query">Suggestion query options (take 3..5 is applied in handler).</param>
+    /// <param name="cancel">Cancellation token.</param>
+    /// <returns>List of recent distinct receiver suggestions.</returns>
+    [Authorize(AuthenticationSchemes = AuthScheme.Sender)]
+    [HttpGet("recent-suggestions")]
+    public async Task<IActionResult> GetRecentSuggestions([FromQuery] ReadRecentReceiverSuggestionsQuery query, CancellationToken cancel)
+    {
+        var result = await _mediator.Send(query.ForSender(User.GetUsername()), cancel);
+        return Ok(result);
+    }
+
     /// <summary>
     /// Datenübertragungsobjekt mit Informationen zu Umschlägen, Empfängern und Unterschriften.
     /// </summary>
@@ -278,4 +292,4 @@ public class EnvelopeReceiverController : ControllerBase
         }
     }
 
-}
\ No newline at end of file
+}