Add GetDocResultAsync method to EnvelopeController

Implemented a new asynchronous method `GetDocResultAsync` in the `EnvelopeController` class to retrieve document results by ID. Added XML documentation for clarity on parameters and responses. Enhanced user authorization handling and error logging for improved reliability.

EnvelopeGenerator.GeneratorAPI/Controllers/EnvelopeController.cs

@@ -96,6 +96,59 @@ public class EnvelopeController : ControllerBase
         }
     }
 
+    /// <summary>
+    /// Ruft das Ergebnis eines Dokuments basierend auf der ID ab.
+    /// </summary>
+    /// <param name="id">Die eindeutige ID des Umschlags.</param>
+    /// <param name="view">Gibt an, ob das Dokument inline angezeigt werden soll (true) oder als Download bereitgestellt wird (false).</param>
+    /// <returns>Eine IActionResult-Instanz, die das Dokument oder einen Fehlerstatus enthält.</returns>
+    /// <response code="200">Das Dokument wurde erfolgreich abgerufen.</response>
+    /// <response code="404">Das Dokument wurde nicht gefunden oder ist nicht verfügbar.</response>
+    /// <response code="500">Ein unerwarteter Fehler ist aufgetreten.</response>
+    [HttpGet("doc-result")]
+    public async Task<IActionResult> GetDocResultAsync([FromQuery] int id, [FromQuery] bool view = false)
+    {
+        try
+        {
+            if (User.GetId() is int intId)
+                return await _envelopeService.ReadByUserAsync(intId).ThenAsync(
+                    Success: envelopes =>
+                    {
+                        var envelope = envelopes.Where(e => e.Id == id).FirstOrDefault();
+
+                        if (envelope is null)
+                            return NotFound("Envelope not available.");
+                        else if (envelope?.DocResult is null)
+                            return NotFound("The document has not been fully signed or the result has not yet been released.");
+                        else
+                        {
+                            if (view)
+                            {
+                                Response.Headers.Append("Content-Disposition", "inline; filename=\"" + envelope.Uuid + ".pdf\"");
+                                return File(envelope.DocResult, "application/pdf");
+                            }
+                            else
+                                return File(envelope.DocResult, "application/pdf", $"{envelope.Uuid}.pdf");
+                        }
+                    },
+                    Fail: IActionResult (msg, ntc) =>
+                    {
+                        _logger.LogNotice(ntc);
+                        return StatusCode(StatusCodes.Status500InternalServerError);
+                    });
+            else
+            {
+                _logger.LogError("Trotz erfolgreicher Autorisierung wurde die Benutzer-ID nicht als Ganzzahl erkannt. Dies könnte auf eine fehlerhafte Erstellung der Anspruchsliste zurückzuführen sein.");
+                return StatusCode(StatusCodes.Status500InternalServerError);
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "{Message}", ex.Message);
+            return StatusCode(StatusCodes.Status500InternalServerError);
+        }
+    }
+
     /// <summary>
     /// 
     /// </summary>