Enhance access code guidance and resend functionality

Added new localized strings for improved user guidance in `Resource.*.resx` files, including instructions and messages for resending access codes. Updated `LoginReceiverPage.razor` to include detailed UI elements for access code guidance, such as step-by-step instructions and a resend button with dynamic feedback.

Introduced new state variables (`IsResending`, `ResendRequestFailed`, `ResendResult`) and implemented the `ResendAccessCodeAsync` method to handle resend logic. Modified `AuthService.RequestEnvelopeReceiverAccessCodeAsync` to support an `autoGenerated` flag, enabling differentiation between automatic and manual access code requests.

These changes improve the user experience by providing clearer instructions and a streamlined process for resending access codes.
This commit is contained in:
2026-11-16 13:41:50 +01:00
parent 6c9b8ad3a8
commit e13413c7fc
5 changed files with 88 additions and 6 deletions

View File

@@ -23,9 +23,11 @@
<div class="card-body p-4">
<p class="text-muted mb-4" style="font-size: 0.875rem; line-height: 1.5;">
@L("ReceiverLogin_Description", "Bitte geben Sie den Zugangscode ein, den Sie per E-Mail erhalten haben, um das Dokument sicher zu öffnen.")
</p>
<div class="text-muted mb-4" style="font-size: 0.875rem; line-height: 1.5;">
<p class="mb-2 fw-semibold text-dark">@L("ReceiverLogin_InfoTitle", "Sicherheit ist uns wichtig.")</p>
<p class="mb-2">@L("ReceiverLogin_InfoStep1", "Direkt nachdem Sie den Link zum Unterzeichnen geöffnet haben, haben wir Ihnen eine zweite E-Mail gesendet.")</p>
<p class="mb-0">@L("ReceiverLogin_InfoStep2", "Darin finden Sie den Zugangscode, den Sie hier eingeben müssen.")</p>
</div>
@if (LoginResult == EnvelopeLoginResult.NotFound)
{
@@ -110,6 +112,33 @@
</div>
</div>
<div class="mb-3">
<span class="text-muted" style="font-size:0.85rem;">@L("ReceiverLogin_ResendPrompt", "Zugangscode nicht bekommen?")</span>
<DxButton Text="@(IsResending ? L("ReceiverLogin_ResendInProgress", "Code wird gesendet ...") : L("ReceiverLogin_ResendAction", "Code erneut senden"))"
RenderStyle="ButtonRenderStyle.Link"
Click="ResendAccessCodeAsync"
Enabled="@(!IsLoading && !IsResending)" />
</div>
@if (ResendResult == SendAccessCodeResult.Sent)
{
<div class="alert alert-success py-2" role="alert" style="font-size:0.85rem;">
@L("ReceiverLogin_ResendSuccess", "Wir haben Ihnen soeben einen neuen Zugangscode per E-Mail gesendet.")
</div>
}
else if (ResendResult == SendAccessCodeResult.RequestLimitExceeded)
{
<div class="alert alert-warning py-2" role="alert" style="font-size:0.85rem;">
@L("ReceiverLogin_ResendRateLimit", "Sie haben soeben einen Code angefordert. Bitte warten Sie kurz und versuchen Sie es erneut.")
</div>
}
else if (ResendRequestFailed)
{
<div class="alert alert-secondary py-2" role="alert" style="font-size:0.85rem;">
@L("ReceiverLogin_ResendError", "Der Zugangscode konnte nicht erneut gesendet werden. Bitte versuchen Sie es später erneut.")
</div>
}
<button class="btn btn-primary w-100 py-2 fw-medium"
style="background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%); border: none;"
@onclick="SubmitAsync"
@@ -143,14 +172,17 @@
string AccessCode = string.Empty;
bool ShowCode;
bool IsLoading;
bool IsResending;
bool ResendRequestFailed;
EnvelopeLoginResult? LoginResult;
SendAccessCodeResult? ResendResult;
protected override async Task OnInitializedAsync()
{
if (string.IsNullOrWhiteSpace(EnvelopeKey))
return;
var requestResult = await AuthService.RequestEnvelopeReceiverAccessCodeAsync(EnvelopeKey);
var requestResult = await AuthService.RequestEnvelopeReceiverAccessCodeAsync(EnvelopeKey, autoGenerated: true);
if (requestResult == SendAccessCodeResult.AlreadySigned)
{
Navigation.NavigateTo("/envelope/signed-result", forceLoad: false);
@@ -185,6 +217,29 @@
await InvokeAsync(StateHasChanged);
}
async Task ResendAccessCodeAsync()
{
if (IsLoading || IsResending || string.IsNullOrWhiteSpace(EnvelopeKey))
return;
IsResending = true;
ResendRequestFailed = false;
ResendResult = null;
await InvokeAsync(StateHasChanged);
var result = await AuthService.RequestEnvelopeReceiverAccessCodeAsync(EnvelopeKey, autoGenerated: false);
if (result == SendAccessCodeResult.AlreadySigned)
{
Navigation.NavigateTo("/envelope/signed-result", forceLoad: false);
return;
}
ResendResult = result;
ResendRequestFailed = result is null;
IsResending = false;
await InvokeAsync(StateHasChanged);
}
string L(string key, string fallback)
{
var value = UiLocalizer[key];

View File

@@ -38,11 +38,11 @@ public class AuthService(IHttpClientFactory httpClientFactory)
/// Triggers access code e-mail request flow for the receiver login page.
/// Calls POST /api/Auth/envelope-receiver/{key}/request-access-code.
/// </summary>
public async Task<SendAccessCodeResult?> RequestEnvelopeReceiverAccessCodeAsync(string envelopeKey, CancellationToken cancel = default)
public async Task<SendAccessCodeResult?> RequestEnvelopeReceiverAccessCodeAsync(string envelopeKey, bool autoGenerated = true, CancellationToken cancel = default)
{
using var http = CreateDefaultClient();
var response = await http.PostAsync(
$"/api/Auth/envelope-receiver/{Uri.EscapeDataString(envelopeKey)}/request-access-code",
$"/api/Auth/envelope-receiver/{Uri.EscapeDataString(envelopeKey)}/request-access-code?autoGenerated={autoGenerated}",
null,
cancel);