From c1e81c546f5cd799fcba5895cf15da03bfe5aec7 Mon Sep 17 00:00:00 2001
From: Developer 02 <developer02@didaloghe.onmicrosoft.com>
Date: Fri, 11 Apr 2025 19:39:58 +0200
Subject: [PATCH] Add OnlyLast parameter to history query records

Updated `EnvelopeHistoryQuery` and `ReadEnvelopeHistoryQuery` to include a new optional `OnlyLast` parameter, removing the `Status` parameter. Documentation comments have been revised to reflect these changes, including updates in the `HistoryController` class.
---
 .../EnvelopeHistories/EnvelopeHistoryQuery.cs               | 4 ++--
 .../Queries/Read/ReadEnvelopeHistoryQuery.cs                | 6 +++---
 .../Controllers/HistoryController.cs                        | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/EnvelopeGenerator.Application/EnvelopeHistories/EnvelopeHistoryQuery.cs b/EnvelopeGenerator.Application/EnvelopeHistories/EnvelopeHistoryQuery.cs
index 3d917027..70513435 100644
--- a/EnvelopeGenerator.Application/EnvelopeHistories/EnvelopeHistoryQuery.cs
+++ b/EnvelopeGenerator.Application/EnvelopeHistories/EnvelopeHistoryQuery.cs
@@ -10,8 +10,8 @@ namespace EnvelopeGenerator.Application.EnvelopeHistories;
 /// <param name="EnvelopeId">Die eindeutige Kennung des Umschlags.</param>
 /// <param name="Envelope">Die Abfrage, die den Umschlag beschreibt.</param>
 /// <param name="Receiver">Die Abfrage, die den Empfänger beschreibt.</param>
-/// <param name="Status">Die Abfrage, die den Status des Umschlags beschreibt.</param>
-public record EnvelopeHistoryQuery<TEnvelopeQuery, TReceiverQuery>(int EnvelopeId, TEnvelopeQuery? Envelope, TReceiverQuery? Receiver = null, StatusQuery? Status = null)
+/// <param name="OnlyLast">Abfrage zur Steuerung, ob nur der aktuelle Status oder der gesamte Datensatz zurückgegeben wird.</param>
+public record EnvelopeHistoryQuery<TEnvelopeQuery, TReceiverQuery>(int EnvelopeId, TEnvelopeQuery? Envelope, TReceiverQuery? Receiver = null, bool? OnlyLast = null)
     where TEnvelopeQuery : EnvelopeQuery
     where TReceiverQuery : ReceiverQuery
 {
diff --git a/EnvelopeGenerator.Application/EnvelopeHistories/Queries/Read/ReadEnvelopeHistoryQuery.cs b/EnvelopeGenerator.Application/EnvelopeHistories/Queries/Read/ReadEnvelopeHistoryQuery.cs
index be1854de..298ca76c 100644
--- a/EnvelopeGenerator.Application/EnvelopeHistories/Queries/Read/ReadEnvelopeHistoryQuery.cs
+++ b/EnvelopeGenerator.Application/EnvelopeHistories/Queries/Read/ReadEnvelopeHistoryQuery.cs
@@ -9,10 +9,10 @@ namespace EnvelopeGenerator.Application.EnvelopeHistories.Queries.Read;
 /// <param name="EnvelopeId">Die eindeutige Kennung des Umschlags.</param>
 /// <param name="Envelope">Die Abfrage, die den Umschlag beschreibt.</param>
 /// <param name="Receiver">Die Abfrage, die den Empfänger beschreibt.</param>
-/// <param name="Status">Die Abfrage, die den Status des Umschlags beschreibt.</param>
+/// <param name="OnlyLast">Abfrage zur Steuerung, ob nur der aktuelle Status oder der gesamte Datensatz zurückgegeben wird.</param>
 public record ReadEnvelopeHistoryQuery(
     int EnvelopeId,
     ReadEnvelopeQuery? Envelope = null,
     ReadReceiverQuery? Receiver = null,
-    StatusQuery? Status = null)
-    : EnvelopeHistoryQuery<ReadEnvelopeQuery, ReadReceiverQuery>(EnvelopeId, Envelope, Receiver, Status);
+    bool? OnlyLast = true)
+    : EnvelopeHistoryQuery<ReadEnvelopeQuery, ReadReceiverQuery>(EnvelopeId, Envelope, Receiver, OnlyLast);
diff --git a/EnvelopeGenerator.GeneratorAPI/Controllers/HistoryController.cs b/EnvelopeGenerator.GeneratorAPI/Controllers/HistoryController.cs
index d6eee03e..844b7f7e 100644
--- a/EnvelopeGenerator.GeneratorAPI/Controllers/HistoryController.cs
+++ b/EnvelopeGenerator.GeneratorAPI/Controllers/HistoryController.cs
@@ -60,7 +60,7 @@ public class HistoryController : ControllerBase
     /// Ruft die gesamte Umschlaghistorie basierend auf den angegebenen Abfrageparametern ab.
     /// </summary>
     /// <param name="history">Die Abfrageparameter, die die Filterkriterien für die Umschlaghistorie definieren.</param>
-    /// <returns>Eine Liste von Historieneinträgen, die den angegebenen Kriterien entsprechen.</returns>
+    /// <returns>Eine Liste von Historieneinträgen, die den angegebenen Kriterien entsprechen, oder nur der letzte Eintrag.</returns>
     /// <response code="200">Die Anfrage war erfolgreich, und die Umschlaghistorie wird zurückgegeben.</response>
     /// <response code="400">Die Anfrage war ungültig oder unvollständig.</response>
     /// <response code="401">Der Benutzer ist nicht authentifiziert.</response>