feat(offline): bundle local assets and add safe UI error recovery (U16)

docs/usability-umsetzung.md

@@ -79,3 +79,31 @@ Beide Seiten zeigen dieselbe Richtung Von → Nach und erklären das feste aktue
 ## U12 – Anfangsbestand und Bestandskorrektur
 
 Neue Konten erhalten einen erklärten Anfangsbestand ohne künstliche Einnahme. Spätere Korrektur zeigt Konto/Jahr, Formel, vorher/nachher für gewählten Bestand, gemeinsamen Anfangsbestand und Endstand sowie ausdrücklich die Auswirkungen auf frühere/spätere Jahre. Zustimmung ist erst nach Eingabe gültig, Abbrechen hat Anfangsfokus. Bestehende gemeinsame Semantik bleibt unverändert, keine Migration oder jahresbezogene neue Speicherregel. Dienst prüft den erwarteten Bestand in einer Transaktion und weist veraltete Vorschauen ab. Mehrjahrestest prüft die Verschiebung aller Jahre bei unveränderten Buchungen, Formularprüfung die notwendige Zustimmung.
+
+## U13 – Lesbarkeit und Fenstergröße
+
+Grundschrift 16 px, beschriftete Textgrößenwahl bis 200 % (lokal gemerkt), keine kleinen Großbuchstaben in Formular/Tabellenkopf. Lange Namen umbrechen, Dialoge passen ins Fenster und scrollen; bei schmaler Ansicht einspaltige Formulare und Buchungskarten. Licht-/Dunkelrollen für Text und Beträge getrennt; Gelöscht bleibt zusätzlich als Text erkennbar. Keine Änderung von Windows-DPI-Einstellungen und keine daraus abgeleitete vollständige Barrierefreiheitszusage. Kontrastmessung und Layout-Stichproben werden im Abschluss ergänzt.
+
+U13-Kontrastmessung: Text-, Hilfstext-, Einnahme-, Ausgabe- und Umbuchungsfarben gegen Hintergrund/Oberfläche jeweils mindestens 5.91:1 (hell) und 8.37:1 (dunkel); beschriftete primäre/Erfassen-/Umbuchungs-/Löschbuttons mindestens 6.47:1. Dies sind berechnete Rollen-Stichproben, keine vollständige Messung sämtlicher Zustände.
+
+## U14 – Lokale Hilfe und Einführung
+
+Hilfe steht in der Navigation und wird als Teil der Anwendung offline ausgeliefert. Sie beschreibt die aktuellen Abläufe einschließlich Anfangsbestand, Undo, Suche, Sicherungsumfang und Fehlerauswegen. Überspringbare Einführung mit Vereinsname, erstem Konto/erklärtem Anfangsbestand, echter erster Buchung und Sicherung; Fortschritt wird in den lokalen Einstellungen gespeichert, keine Registrierung und keine automatischen Beispielbuchungen. Der Integrationstest überspringt/öffnet erneut, legt ein selbst benanntes Konto mit Anfangsbestand an und bestätigt die leere Buchungsliste.
+
+## U15 – Suchen und Sortieren
+
+Suche über Beschreibung, Nummer, Datum, Gegenkonto und deutsche Betragsdarstellung; mehrere Suchwörter müssen gemeinsam passen. Auswahl für Datum, vorzeichenrichtigen Betrag und Beschreibung. Trefferzahl und eigene wirksame Treffermengensumme erklären ausdrücklich den unveränderten Kontostand des gewählten Zeitraums. Zurücksetzen zeigt dessen vollständige aktive Liste; Historie bleibt gesondert. Test sucht mit Umlaut und 12,50 aus 400 Einträgen, prüft Nummer, Leerzustand, Reset und unveränderte Originalbeträge.
+
+## U16 – Offline und Fehlerauswege
+
+Bootstrap 5.3.3 sowie Bootstrap Icons 1.11.3 einschließlich Schriftdateien und MIT-Lizenzen werden lokal ausgeliefert; Startseite lädt keine CDN-Dateien mehr. Ressourcenprüfung prüft CSS-/JS-/Schriftdateien. Fehlergrenze bietet sicheren Wiederholungs-/Übersichtsweg, behauptet keine Speicherung und gibt nur Referenz/Fehlertyp statt potenzieller Buchungsdaten aus; Angaben sind kopierbar. Nicht gefunden bietet Rückweg. Erwartbare Speicherfehler sind weiterhin mit erhaltenen Eingaben als Toast behandelt. Paket- und Offline-Layoutprüfung folgt im Abschluss.
+
+## Abschließende Prüfungen U08–U16
+
+Debug-Suite nach jeder Maßnahme bestanden: U08 44, U09 45, U10 46, U11 49, U12 51, U13 51, U14 52, U15 54, U16 57 Tests. Desktop jeweils ohne Warnungen/Fehler gebaut; abschließende Release-Suite 57/57 bestanden.
+
+Zusätzliche Headless-Chromium-Prüfung der tatsächlich gerenderten Konto-/Buchungs-Komponenten mit lokalen Produktionsressourcen: 16 Kombinationen bei 768 × 480 CSS-Pixeln, hell/dunkel und 100/125/150/200 % Textgröße. Browsernetz blockiert, keine externen Requests, lokale Symbole sichtbar. Kein horizontaler Seitenüberlauf; Dialog im Fenster, Speichern per Scrollen erreichbar. PNGs wurden exemplarisch kontrolliert. Dies prüft Textvergrößerung und Browserlayout, nicht sämtliche realen Windows-DPI-/Screenreader-Kombinationen.
+
+Computer Use wurde nach der Unterbrechung fortgesetzt. U08: semantische Kontolinks, sichtbarer Eingabefokus, modaler Accessibility-Baum ohne Hintergrund und Escape-Schließen geprüft. Nach behobener Fensterzuordnung: finale Anwendung mit lokalen Bootstrap-Ressourcen gestartet; beschriftetes Zeilenmenü geöffnet und empfangene Umbuchung mit korrekter Von→Nach-Richtung, festem/änderbarem Konto sowie Minus/Plus-Vorschau gelesen. Sämtliche Tätigkeiten fanden im künstlichen Debug-Datenordner statt. Kein tatsächlicher Bankvorgang und keine Änderung am Vereinsbestand. Native vollständige DPI-/Hilfstechnologie-/Zielgruppenabnahme bleibt offen.
+
+Abschlusskorrekturen aus der nativen Prüfung: Betragswert im Korrekturdialog und erklärter Leerzustand werden als Werte statt als Parametertexte gebunden; Regressionen prüfen beide Ausgangsanzeigen. Rückgängig aktualisiert auch den sichtbaren Löschstatus und verwendet nach Navigation weiterhin das ursprüngliche Konto. Eine zweite Escape-Anforderung im Verlustschutz rendert den Wechsel zurück zur Bearbeitung. Finale Prüfung: **58/58 Debug- und 58/58 Release-Tests**, Desktop Debug/Release ohne Warnungen/Fehler; alle 16 Offline-Layoutkombinationen erneut bestanden. Die native Prüfung der Bestandskorrektur bestätigte Konto/Jahr, Formel, Vorher/Nachher und Warnung für alle Jahre; es wurde keine Korrektur gespeichert. Der anschließend korrigierte Zahlenwert ist zusätzlich automatisiert geprüft.

src/Duempelkas.App/Components/Accounts/EntryRow.razor

@@ -2,7 +2,7 @@
     <td data-label="Nummer">@Entry.DisplayId</td>
     <td data-label="Datum">@Entry.Date.ToString("dd.MM.yyyy")</td>
     <td data-label="Beschreibung" class="entry-description">
-        @Entry.Title
+        <span class="entry-title">@Entry.Title</span>
         @if (Entry.IsDeleted)
         {
             <p class="deleted-status">Gelöscht – zählt nicht zum Kontostand</p>

src/Duempelkas.App/Components/Accounts/EntryTable.razor

@@ -1,3 +1,19 @@
+<div class="entry-filters">
+    <div><label for="entry-search">Buchungen suchen</label>
+        <input id="entry-search" type="search" class="form-control" @bind="searchText" @bind:event="oninput" placeholder="Beschreibung, Nummer, Datum oder Betrag" /></div>
+    <div><label for="entry-sort">Sortierung</label>
+        <select id="entry-sort" @bind="sort">
+            <option value="date-asc">Datum: älteste zuerst</option><option value="date-desc">Datum: neueste zuerst</option>
+            <option value="amount-asc">Betrag: aufsteigend</option><option value="amount-desc">Betrag: absteigend</option>
+            <option value="title">Beschreibung: A–Z</option>
+        </select></div>
+    <button type="button" class="btn btn-outline-secondary filter-reset" @onclick="ResetFilters">Filter zurücksetzen</button>
+</div>
+@if (!string.IsNullOrWhiteSpace(searchText))
+{
+    <p class="search-summary" role="status">@VisibleEntries.Count Treffer. Summe der wirksamen Treffer: @ResultSum.ToString("N2", System.Globalization.CultureInfo.GetCultureInfo("de-DE")) €.
+        Der Kontostand des gewählten Zeitraums oben bleibt unverändert.</p>
+}
 @if (Entries.Any(e => e.IsDeleted))
 {
     <label class="history-toggle"><input type="checkbox" @bind="showDeleted" /> Gelöschte Buchungen anzeigen (@Entries.Count(e => e.IsDeleted))</label>
@@ -24,6 +40,6 @@
 
 @if (!VisibleEntries.Any())
 {
-    <div class="text-center py-3 text-muted">@EmptyMessage</div>
+    <div class="text-center py-3 text-muted">@(string.IsNullOrWhiteSpace(searchText) ? EmptyMessage : "Keine Treffer. Filter zurücksetzen zeigt wieder die Buchungen des gewählten Zeitraums.")</div>
 }
 

src/Duempelkas.App/Components/Accounts/EntryTable.razor.cs

@@ -6,7 +6,11 @@ namespace Duempelkas.App.Components.Accounts;
 public partial class EntryTable
 {
     private bool showDeleted;
-    private IEnumerable<EntryDto> VisibleEntries => Entries.Where(e => !e.IsDeleted || showDeleted);
+    private string searchText = string.Empty;
+    private string sort = "date-asc";
+    private List<EntryDto> VisibleEntries => Duempelkas.App.Services.EntryListQuery.Apply(Entries, searchText, showDeleted, sort);
+    private decimal ResultSum => VisibleEntries.Where(e => !e.IsDeleted).Sum(Duempelkas.App.Services.EntryListQuery.SignedAmount);
+    private void ResetFilters() { searchText = string.Empty; sort = "date-asc"; showDeleted = false; }
     [Parameter] public int? HighlightedEntryId { get; set; }
     [Parameter] public string EmptyMessage { get; set; } = "Keine Buchungen vorhanden.";
     #region Parameters

src/Duempelkas.App/Components/AppErrorBoundary.razor

@@ -0,0 +1,37 @@
+@inherits ErrorBoundary
+@inject IJSRuntime JS
+@inject ToastService Toasts
+
+@if (CurrentException == null)
+{
+    @ChildContent
+}
+else
+{
+    <section class="error-recovery" role="alert">
+        <h1>Diese Ansicht konnte nicht angezeigt werden</h1>
+        <p>Ein unerwarteter Fehler ist aufgetreten. Eine Speicherung ist dadurch nicht bestätigt. Bitte vor einer erneuten Buchung zuerst die Liste prüfen.</p>
+        <p>Ungespeicherte Eingaben dieser Ansicht können verloren sein. Bei erwartbaren Speicherfehlern im Formular bleiben sie erhalten.</p>
+        <button type="button" class="btn btn-primary" @onclick="Recover">Ansicht erneut versuchen</button>
+        <a class="btn btn-outline-secondary" href="/">Zur Kontenübersicht</a>
+        <details><summary>Technische Angaben zur Fehlermeldung</summary>
+            <p>@diagnostic</p><button type="button" class="btn btn-outline-secondary" @onclick="Copy">Angaben kopieren</button>
+        </details>
+    </section>
+}
+
+@code {
+    private string diagnostic = string.Empty;
+    protected override Task OnErrorAsync(Exception exception)
+    {
+        diagnostic = $"Dümpelkas; Fehlerreferenz {Guid.NewGuid():N}; Typ {exception.GetType().Name}";
+        // Deliberately exclude exception messages/stack traces that may contain booking data.
+        System.Diagnostics.Trace.TraceError(diagnostic);
+        return Task.CompletedTask;
+    }
+    private async Task Copy()
+    {
+        try { await JS.InvokeVoidAsync("navigator.clipboard.writeText", diagnostic); Toasts.Show("Technische Angaben kopiert.", ToastKind.Success); }
+        catch (JSException) { Toasts.Show("Kopieren ist nicht möglich. Bitte die technischen Angaben markieren und manuell kopieren.", ToastKind.Error); }
+    }
+}

src/Duempelkas.App/Components/Dialogs/EditCarryoverDialog.razor

@@ -1,11 +1,11 @@
 @inject ToastService Toasts
-<ModalDialog @ref="modal" Title="Bestandskorrektur" OnCancel="OnCancel" Dirty="@(amount != CurrentAmount)" Busy="saving">
+<ModalDialog @ref="modal" Title="Bestandskorrektur" OnCancel="OnCancel" Dirty="@(amountText != CurrentAmount.ToString("0.00", System.Globalization.CultureInfo.GetCultureInfo("de-DE")))" Busy="saving">
     <h5>Bestandskorrektur – @AccountName</h5>
     <p>@(Year.HasValue ? $"Übertrag zum 01.01.{Year}" : "Gemeinsamer Anfangsbestand – alle Jahre")</p>
     <p>Anfangsbestand + Einnahmen − Ausgaben = Kontostand</p>
     <p>Dies ist eine spätere Korrektur, keine zusätzliche Einnahme oder Ausgabe.</p>
     <label for="carryover">@(Year.HasValue ? "Neuer Übertrag (€)" : "Neuer Anfangsbestand (€)")</label>
-    <AmountInput Id="carryover" Value="amountText" ValueChanged="ChangeAmount" AllowNegative="true" Disabled="saving" />
+    <AmountInput Id="carryover" Value="@amountText" ValueChanged="ChangeAmount" AllowNegative="true" Disabled="saving" />
     <div class="correction-preview">
         <p>Gewählter Bestand: @Money(CurrentAmount) → @Money(amount)</p>
         <p>Gemeinsamer Anfangsbestand: @Money(InitialBalance) → @Money(InitialBalance + Delta)</p>

src/Duempelkas.App/Components/Dialogs/ModalDialog.razor

@@ -55,7 +55,11 @@
             focusPrompt = true;
             await InvokeAsync(StateHasChanged);
         }
-        else if (discardPrompt) await ContinueEditing();
+        else if (discardPrompt)
+        {
+            await ContinueEditing();
+            await InvokeAsync(StateHasChanged);
+        }
         else await OnCancel.InvokeAsync();
     }
 

src/Duempelkas.App/Components/Layout/MainLayout.razor

@@ -1,20 +1,30 @@
+@inject NavigationManager Navigation
 @inherits LayoutComponentBase
+@inject IJSRuntime JS
 
 <ToastHost />
 
-<div class="d-flex flex-column vh-100">
+<div class="app-shell">
     <nav class="app-navbar d-flex justify-content-between align-items-center">
         <a class="navbar-brand" href="">
             <strong>Dümpelkas</strong> <small class="text-muted">Kassenbuch</small>
         </a>
+        <div class="reading-controls">
+            <a class="btn btn-outline-secondary" href="hilfe">Hilfe</a>
+            <label for="text-scale">Textgröße</label>
+            <select id="text-scale" @bind="fontScale" @bind:after="ApplyTextScale">
+                <option value="100">Normal</option><option value="125">Groß (125 %)</option>
+                <option value="150">Sehr groß (150 %)</option><option value="200">200 %</option>
+            </select>
+        </div>
     </nav>
 
     <main class="flex-grow-1 overflow-auto p-3">
-        @Body
+        <AppErrorBoundary @key="Navigation.Uri">@Body</AppErrorBoundary>
     </main>
 
     <footer class="app-footer d-flex align-items-center justify-content-center gap-2">
-        <span>Dümpelkas &copy; @DateTime.Now.Year &middot; Version @AppVersion</span> &middot;<a class="app-footer-about" @onclick="OpenAboutDialog">Über</a>
+        <span>Dümpelkas &copy; @DateTime.Now.Year &middot; Version @AppVersion</span> &middot;<button type="button" class="app-footer-about btn btn-link" @onclick="OpenAboutDialog">Über</button>
     </footer>
 </div>
 

src/Duempelkas.App/Components/Layout/MainLayout.razor.cs

@@ -1,9 +1,21 @@
+using Microsoft.JSInterop;
 using System.Reflection;
 
 namespace Duempelkas.App.Components.Layout;
 
 public partial class MainLayout
 {
+    private int fontScale = 100;
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (firstRender)
+        {
+            var value = await JS.InvokeAsync<int>("duempelkasReading.get");
+            fontScale = value is 125 or 150 or 200 ? value : 100;
+            StateHasChanged();
+        }
+    }
+    private async Task ApplyTextScale() => await JS.InvokeVoidAsync("duempelkasReading.set", fontScale);
     #region Fields
 
     private bool showAboutDialog;

src/Duempelkas.App/Components/Routes.razor

@@ -4,7 +4,8 @@
     </Found>
     <NotFound>
         <LayoutView Layout="@typeof(MainLayout)">
-            <p>Seite nicht gefunden.</p>
+            <h1>Diese Seite wurde nicht gefunden</h1>
+            <a class="btn btn-primary" href="/">Zur Kontenübersicht</a>
         </LayoutView>
     </NotFound>
 </Router>

src/Duempelkas.App/Pages/Accounts/AccountDetail.razor

@@ -1,4 +1,5 @@
 @inject ToastService Toasts
+@implements IDisposable
 @inject ReportingPeriod Period
 @page "/accounts/{AccountId:int}"
 @inject IAccountService AccountService
@@ -21,7 +22,7 @@
     {
         <div class="d-flex align-items-center gap-2">
             <div class="d-flex align-items-center flex-grow-1" style="min-width: 0;">
-                <h1 class="mb-0 mt-0" style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">
+                <h1 class="mb-0 mt-0 page-heading">
                     @account.Name
                     <button class="btn-edit-pen" @onclick="() => showEditName = true" title="Name bearbeiten"><i class="bi bi-pencil"></i></button>
                 </h1>
@@ -96,7 +97,7 @@
         @if (entries != null)
         {
             <div class="entries-scroll-wrapper">
-                <EntryTable HighlightedEntryId="lastSaved?.EntryId" Entries="entries" EmptyMessage="emptyEntriesMessage" OnDeleteEntry="RequestDeleteEntry" OnRestoreEntry="RequestRestoreEntry" OnEditEntry="RequestEditEntry" />
+                <EntryTable HighlightedEntryId="lastSaved?.EntryId" Entries="entries" EmptyMessage="@emptyEntriesMessage" OnDeleteEntry="RequestDeleteEntry" OnRestoreEntry="RequestRestoreEntry" OnEditEntry="RequestEditEntry" />
             </div>
         }
     }

src/Duempelkas.App/Pages/Accounts/AccountDetail.razor.cs

@@ -6,6 +6,8 @@ namespace Duempelkas.App.Pages.Accounts;
 
 public partial class AccountDetail
 {
+    private bool disposed;
+    public void Dispose() => disposed = true;
     #region Parameters
 
     [Parameter]
@@ -164,7 +166,7 @@ public partial class AccountDetail
             await LoadAll();
             if (undoToastId.HasValue) Toasts.Dismiss(undoToastId.Value);
             undoToastId = Toasts.Show("Buchung gelöscht.", ToastKind.Success,
-                actionLabel: "Rückgängig", action: () => UndoEntryChange(id, true));
+                actionLabel: "Rückgängig", action: CreateUndoAction(AccountId, id, true));
         }
         catch (Exception ex) { Toasts.Show("Die Buchung konnte nicht geändert werden. Bitte erneut versuchen.", ToastKind.Error, ex.Message); }
         finally { entryActionBusy = false; }
@@ -195,19 +197,21 @@ public partial class AccountDetail
             await LoadAll();
             if (undoToastId.HasValue) Toasts.Dismiss(undoToastId.Value);
             undoToastId = Toasts.Show("Buchung wiederhergestellt.", ToastKind.Success,
-                actionLabel: "Rückgängig", action: () => UndoEntryChange(id, false));
+                actionLabel: "Rückgängig", action: CreateUndoAction(AccountId, id, false));
         }
         catch (Exception ex) { Toasts.Show("Die Buchung konnte nicht geändert werden. Bitte erneut versuchen.", ToastKind.Error, ex.Message); }
         finally { entryActionBusy = false; }
     }
 
-    private async Task UndoEntryChange(int id, bool restore)
+    private Func<Task> CreateUndoAction(int accountId, int id, bool restore) => () => UndoEntryChange(accountId, id, restore);
+
+    private async Task UndoEntryChange(int accountId, int id, bool restore)
     {
         if (entryActionBusy) return;
         entryActionBusy = true;
         try
         {
-            var current = (await EntryService.GetEntriesAsync(AccountId, (int?)null)).FirstOrDefault(e => e.Id == id);
+            var current = (await EntryService.GetEntriesAsync(accountId, (int?)null)).FirstOrDefault(e => e.Id == id);
             if (current == null || current.IsDeleted != restore)
             {
                 Toasts.Show("Die Buchung wurde inzwischen geändert. Bitte die aktuelle Liste prüfen.");
@@ -215,7 +219,12 @@ public partial class AccountDetail
             }
             if (restore) await EntryService.RestoreEntryAsync(id); else await EntryService.DeleteEntryAsync(id);
             if (undoToastId.HasValue) Toasts.Dismiss(undoToastId.Value);
+            if (!disposed)
+            {
                 await LoadAll();
+                await InvokeAsync(StateHasChanged);
+            }
+            else Navigation.NavigateTo($"/accounts/{accountId}");
             Toasts.Show("Änderung rückgängig gemacht.", ToastKind.Success);
         }
         finally { entryActionBusy = false; }

src/Duempelkas.App/Pages/Dashboard.razor

@@ -15,7 +15,7 @@
 
     <div class="d-flex justify-content-between align-items-center">
         <div class="d-flex align-items-center flex-grow-1" style="min-width: 0;">
-            <h1 class="mb-0 mt-0" style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">
+            <h1 class="mb-0 mt-0 page-heading">
                 @DisplayClubName
                 <button class="btn-edit-pen" @onclick="() => showEditClubName = true" title="Vereinsname bearbeiten">
                     <i class="bi bi-pencil"></i>
@@ -71,6 +71,7 @@
         <div class="text-center py-5 text-muted">
             <h4>Noch keine Konten vorhanden</h4>
             <p>Erstelle dein erstes Konto, um loszulegen.</p>
+            <a class="btn btn-primary" href="einstieg">Kurze Einführung starten oder fortsetzen</a>
         </div>
     }
     else

src/Duempelkas.App/Pages/GettingStarted.razor

@@ -0,0 +1,103 @@
+@page "/einstieg"
+@inject ISettingsService Settings
+@inject IAccountService Accounts
+@inject IBackupService Backups
+@inject ToastService Toasts
+@inject NavigationManager Navigation
+
+<h1>Erste Schritte</h1>
+<p>Schritt @(step + 1) von 5. Du kannst die Einführung jederzeit überspringen und über Hilfe fortsetzen.</p>
+@if (loading) { <p role="status">Einführung wird geladen …</p> }
+else
+{
+    @if (step == 0)
+    {
+        <h2>Dein Verein</h2>
+        <label for="setup-club">Vereinsname</label><input id="setup-club" class="form-control" @bind="clubName" @bind:event="oninput" />
+        <button class="btn btn-primary setup-next" disabled="@(busy || string.IsNullOrWhiteSpace(clubName))" @onclick="SaveClub">Speichern und weiter</button>
+    }
+    else if (step == 1)
+    {
+        <h2>Dein erstes Konto</h2>
+        <p>Zum Beispiel Barkasse oder Girokonto. Der Anfangsbestand ist das bereits vorhandene Geld, keine neue Einnahme.</p>
+        <button class="btn btn-primary" @onclick="() => showAccount = true">Konto anlegen</button>
+        @if (accounts.Count > 0)
+        {
+            <p>Ein Konto ist bereits eingerichtet.</p><button class="btn btn-outline-secondary setup-next" @onclick="Next">Vorhandenes Konto verwenden</button>
+        }
+    }
+    else if (step == 2)
+    {
+        <h2>Die erste Buchung</h2>
+        <p>Wähle ein Konto und erfasse einen tatsächlichen Mitgliedsbeitrag oder eine Ausgabe, etwa Porto. Es werden keine Beispielbuchungen erzeugt.</p>
+        @foreach (var account in accounts) { <p><a href="@($"accounts/{account.Id}")">@account.Name öffnen und buchen</a></p> }
+        <button class="btn btn-primary setup-next" @onclick="Next">Weiter zur Sicherung</button>
+    }
+    else if (step == 3)
+    {
+        <h2>Deine Daten sichern</h2>
+        <p>Sichere die Buchungen zusätzlich auf einem unabhängigen Datenträger. Vereinsname und Darstellung sind nicht enthalten. Zur Einrichtung muss keine Sicherung zurückgespielt werden.</p>
+        <button class="btn btn-primary" disabled="@busy" @onclick="Backup">Sicherung erstellen</button>
+        <OperationNotice Result="backupResult" />
+        <button class="btn btn-outline-secondary setup-next" @onclick="Next">Weiter</button>
+    }
+    else
+    {
+        <h2>Bereit für das Kassenbuch</h2><p>Die Hilfe bleibt jederzeit erreichbar. Prüfe regelmäßig Kontostände und Sicherungen.</p>
+        <a class="btn btn-primary" href="/">Zur Kontenübersicht</a>
+        <button class="btn btn-outline-secondary" @onclick="Restart">Einführung erneut durchgehen</button>
+    }
+    <p><button class="btn btn-outline-secondary" disabled="@busy" @onclick="Skip">Einführung später fortsetzen</button> <a href="hilfe">Zur Hilfe</a></p>
+}
+@if (showAccount)
+{
+    <AddAccountDialog OnSave="CreateAccount" OnCancel="() => showAccount = false" />
+}
+
+@code {
+    private int step;
+    private bool loading = true, busy, showAccount, advancing;
+    private string clubName = string.Empty;
+    private List<AccountSummaryDto> accounts = [];
+    private FileOperationResult? backupResult;
+    protected override async Task OnInitializedAsync()
+    {
+        step = Math.Clamp(await Settings.GetSetupStepAsync(), 0, 4);
+        clubName = await Settings.GetClubNameAsync() ?? string.Empty;
+        accounts = await Accounts.GetAllAccountsAsync();
+        loading = false;
+    }
+    private async Task Next()
+    {
+        if (advancing) return;
+        advancing = true;
+        try { var next = Math.Min(step + 1, 4); await Settings.SetSetupStepAsync(next); step = next; }
+        catch (Exception ex) { Toasts.Show("Der Fortschritt konnte nicht gespeichert werden. Bitte erneut versuchen.", ToastKind.Error, ex.Message); }
+        finally { advancing = false; }
+    }
+    private async Task SaveClub()
+    {
+        if (busy || string.IsNullOrWhiteSpace(clubName)) return;
+        busy = true;
+        try { await Settings.SetClubNameAsync(clubName); await Next(); }
+        catch (Exception ex) { Toasts.Show("Der Schritt konnte nicht gespeichert werden. Bitte erneut versuchen.", ToastKind.Error, ex.Message); }
+        finally { busy = false; }
+    }
+    private async Task CreateAccount(AccountSetup setup)
+    {
+        await Accounts.CreateAccountAsync(setup.Name, setup.InitialBalance);
+        showAccount = false;
+        accounts = await Accounts.GetAllAccountsAsync();
+        await Next();
+    }
+    private async Task Backup()
+    {
+        if (busy) return;
+        busy = true;
+        try { backupResult = await Backups.CreateBackupAsync(); }
+        catch (Exception ex) { backupResult = FileOperationResult.Error(ex); }
+        finally { busy = false; }
+    }
+    private Task Skip() { Navigation.NavigateTo("/"); return Task.CompletedTask; }
+    private async Task Restart() { step = 0; await Settings.SetSetupStepAsync(0); }
+}

src/Duempelkas.App/Pages/Help.razor

@@ -0,0 +1,35 @@
+@page "/hilfe"
+<h1>Hilfe für Dümpelkas</h1>
+<p>Passend zu dieser Programmversion. Diese Hilfe ist auch ohne Internet verfügbar.</p>
+<p><a class="btn btn-primary" href="einstieg">Erste Schritte öffnen oder fortsetzen</a> <a href="/">Zur Kontenübersicht</a></p>
+<details open><summary>Konten einrichten</summary>
+    <p>Auf der Übersicht „Neues Konto“ wählen. Beispiele: Barkasse, Girokonto, Sparbuch. Den tatsächlich vorhandenen Anfangsbestand vor der ersten erfassten Buchung eingeben; 0 oder ein negativer Bestand sind möglich. Es werden keine Beispielbuchungen angelegt.</p>
+</details>
+<details><summary>Einnahme oder Ausgabe erfassen</summary>
+    <p>Konto öffnen, „Einnahme oder Ausgabe erfassen“ wählen, Art, echtes Datum, Beschreibung und Betrag eingeben. Beispiele sind Mitgliedsbeitrag und Porto. Komma und Punkt sind als Dezimaltrenner möglich; das Control verhindert zusätzliche Dezimalstellen und übernimmt ungültige Einfügungen nicht. Beträge ohne Minuszeichen erfassen; die Art legt die Richtung fest.</p>
+    <p>Beim Speichern kurz warten. Ein Toast bestätigt Art und Betrag. Bei Fehlern bleiben Eingaben erhalten. Beim Bearbeiten bleibt die Art fest; eine falsche Art durch Löschen und erneutes Erfassen korrigieren.</p>
+</details>
+<details><summary>Jahr, Kontostand und Anfangsbestand verstehen</summary>
+    <p>„Jahr“ begrenzt Liste und Summen; „Alle Jahre“ zeigt den gesamten Zeitraum. Die Auswahl bleibt beim Navigieren erhalten. Ein abweichendes Buchungsdatum bleibt unverändert und wird vor dem Speichern erklärt. Die Meldung bietet den Aufruf des gespeicherten Jahres.</p>
+    <p>Anfangsbestand + Einnahmen − Ausgaben = Kontostand. Der Übertrag ist der Bestand vor Beginn des gewählten Jahres. Spätere Bestandskorrekturen ändern den gemeinsamen Anfangsbestand und damit auch frühere und spätere Jahresstände. Vorher/nachher prüfen und erst dann bestätigen; eine fehlende Buchung gewöhnlich als Buchung erfassen.</p>
+</details>
+<details><summary>Geld zwischen Konten verschieben</summary>
+    <p>Die Richtung wird immer als Von → Nach gezeigt, auch beim Öffnen der empfangenen Seite. Das aktuelle Konto ist fest, das Gegenkonto änderbar. Beispiel: Barkasse −50,00 €, Girokonto +50,00 €; die Vereinssumme bleibt gleich. Es wird nur die Buchung erfasst, keine Banküberweisung ausgeführt.</p>
+</details>
+<details><summary>Bearbeiten, Löschen und Wiederherstellen</summary>
+    <p>Das Aktionsmenü der richtigen Zeile öffnen. Bestätigungen nennen Datum, Betrag und Konto; bei Umbuchungen wirken Löschen und Wiederherstellen gemeinsam auf beide Konten. Gelöschte Zeilen sind zunächst ausgeblendet und zählen nicht zum Kontostand. „Gelöschte Buchungen anzeigen“ öffnet die Historie. Der Erfolgstoast bietet für die letzte Änderung „Rückgängig“.</p>
+</details>
+<details><summary>Buchungen finden</summary>
+    <p>Jahr auswählen und die Suche über der Liste verwenden. Sie findet Beschreibung und Buchungsnummer, zusätzlich Datum und Betrag. Die Sortierung kann geändert werden. „Filter zurücksetzen“ zeigt die vollständige Liste des gewählten Jahres. Der Kontostand bleibt unverändert; eine Treffermengensumme ist gesondert beschriftet.</p>
+</details>
+<details><summary>Als PDF speichern</summary>
+    <p>Auf der Kontoansicht wird ein Einzelkonto, auf der Übersicht werden alle Konten exportiert. Der gewählte Zeitraum wird übernommen. Normale PDFs enthalten nur wirksame Buchungen. Umbuchungen sind im Einzelkonto Zu-/Abgänge und in der Gesamtübersicht eine Zeile mit beiden Konten. Der Toast nennt den Speicherort und bietet „Ordner öffnen“.</p>
+</details>
+<details><summary>Sichern und zurückspielen</summary>
+    <p>„Sicherung erstellen“ speichert Konten und Buchungen einschließlich Historie. Vereinsname, Textgröße, Farbdarstellung und Fenstergröße sind nicht enthalten. Eine Kopie auf derselben Festplatte schützt nicht vor Geräteausfall; eine weitere Kopie auf einem unabhängigen Datenträger aufbewahren.</p>
+    <p>„Weitere Aktionen → Sicherung zurückspielen“ ersetzt die aktuellen Konten und Buchungen. Nur passende geprüfte Sicherungen werden angenommen. Vorher legt Dümpelkas eine Rückfallsicherung neben der aktiven Datenbank an; diese wird nicht automatisch gelöscht. Eine alte Sicherung enthält spätere Buchungen nicht. Rückspielen nicht zum Ausprobieren auf dem Vereinsbestand verwenden.</p>
+</details>
+<details><summary>Tastatur, Darstellung und Fehler</summary>
+    <p>Tab und Umschalt-Tab wechseln zwischen Bedienelementen. Enter öffnet Links oder speichert passende Formulare. Escape schließt Dialoge; geänderte Eingaben werden vorher abgefangen. Unsichere Bestätigungen beginnen auf Abbrechen.</p>
+    <p>Textgröße steht oben, der Farbmodus in der Übersicht. Meldungen erscheinen oben, verschwinden zeitgesteuert und pausieren bei Maus/Fokus. Bei erwartbaren Speicherfehlern bleibt die Eingabe erhalten. Technische Details sind bei Bedarf aufklappbar. Ein unerwarteter Fehler bestätigt keine Speicherung: vor einem erneuten Eintrag zuerst die Liste prüfen.</p>
+</details>

src/Duempelkas.App/Services/EntryListQuery.cs

@@ -0,0 +1,28 @@
+using System.Globalization;
+using Duempelkas.App.Services.Models;
+using Duempelkas.Domain.Enums;
+
+namespace Duempelkas.App.Services;
+
+public static class EntryListQuery
+{
+    public static decimal SignedAmount(EntryDto entry) => entry.Type == EntryType.Income ? entry.Amount : -entry.Amount;
+    public static List<EntryDto> Apply(IEnumerable<EntryDto> entries, string search, bool showDeleted, string sort)
+    {
+        var terms = search.Split(' ', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+        var de = CultureInfo.GetCultureInfo("de-DE");
+        var matches = entries.Where(e => !e.IsDeleted || showDeleted).Where(e =>
+        {
+            var text = $"{e.Title} {e.DisplayId} {e.Date:dd.MM.yyyy} {e.Amount.ToString("N2", de)} {SignedAmount(e).ToString("0.00", de)} {e.LinkedAccountName}";
+            return terms.All(term => text.Contains(term, StringComparison.OrdinalIgnoreCase));
+        });
+        return (sort switch
+        {
+            "date-desc" => matches.OrderByDescending(e => e.Date).ThenByDescending(e => e.Id),
+            "amount-asc" => matches.OrderBy(SignedAmount).ThenBy(e => e.Id),
+            "amount-desc" => matches.OrderByDescending(SignedAmount).ThenBy(e => e.Id),
+            "title" => matches.OrderBy(e => e.Title, StringComparer.Create(de, true)).ThenBy(e => e.Id),
+            _ => matches.OrderBy(e => e.Date).ThenBy(e => e.Id)
+        }).ToList();
+    }
+}

src/Duempelkas.App/Services/ISettingsService.cs

@@ -2,6 +2,8 @@ namespace Duempelkas.App.Services;
 
 public interface ISettingsService
 {
+    Task<int> GetSetupStepAsync() => Task.FromResult(0);
+    Task SetSetupStepAsync(int step) => Task.CompletedTask;
     Task<string?> GetClubNameAsync();
     Task SetClubNameAsync(string? clubName);
 }

src/Duempelkas.Desktop/Program.cs

@@ -120,7 +120,7 @@ class Program
 
         AppDomain.CurrentDomain.UnhandledException += (sender, error) =>
         {
-            app.MainWindow.ShowMessage("Schwerwiegender Fehler", error.ExceptionObject.ToString());
+            app.MainWindow.ShowMessage("Dümpelkas konnte nicht fortgesetzt werden", "Bitte das Programm schließen und neu öffnen. Eine Speicherung ist nicht bestätigt; vor erneutem Buchen die Liste prüfen. Fehlerart: " + error.ExceptionObject.GetType().Name);
         };
 
         app.Run();

src/Duempelkas.Desktop/wwwroot/css/app.css

@@ -658,3 +658,53 @@ body:has(dialog[open]) .toast-stack:not(.modal-toasts) { display: none; }
 .history-toggle { display: block; padding: .75rem 0; }
 .entry-deleted { opacity: 1 !important; }
 .deleted-status { text-decoration: none; color: var(--color-text-muted); margin: .3rem 0; }
+
+/* Readable theme roles, also used when external styles are unavailable. */
+:root { --color-bg: #f1f5f9; --color-income: #166534; --color-expense: #b91c1c; --color-transfer: #1d4ed8; --color-text-muted: #475569; --color-border: #94a3b8; }
+html[data-ui-theme="dark"] { --color-income: #4ade80; --color-expense: #fca5a5; --color-transfer: #93c5fd; --color-text-muted: #cbd5e1; --color-border: #64748b; }
+html { font-size: var(--app-font-size, 16px); }
+body { line-height: 1.5; }
+h1,h2,h3,h4,h5,h6 { font-family: inherit; }
+small, .text-muted { color: var(--color-text-muted) !important; }
+small { font-size: .9rem; }
+.form-label, .table thead th { text-transform: none; letter-spacing: normal; font-size: 1rem; }
+.app-shell { height: 100dvh; display: grid; grid-template-rows: auto minmax(0, 1fr) auto; }
+.app-navbar, .app-footer { flex-wrap: wrap; gap: .5rem; height: auto; min-height: 2.5rem; }
+.app-footer { font-size: .9rem; }
+.reading-controls { display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; }
+.reading-controls select { padding: .35rem; color: var(--color-text); background: var(--color-surface); border: 1px solid var(--color-border); }
+.page-heading, .card-title { overflow-wrap: anywhere; white-space: normal; }
+.app-modal { box-sizing: border-box; width: min(38rem, calc(100vw - 2rem)); min-width: 0; max-width: calc(100vw - 2rem); max-height: calc(100dvh - 2rem); }
+.app-modal p, .app-modal label { overflow-wrap: anywhere; }
+.app-modal .dialog-actions, .app-modal form > .d-flex { flex-wrap: wrap; position: sticky; bottom: -1rem; background: var(--color-surface); padding: .75rem 0; }
+.form-container { max-width: none; }
+.btn-primary { background: #4338ca; border-color: #4338ca; color: #fff; }
+.btn-success { background: #166534; border-color: #166534; color: #fff; }
+.btn-info { background: #1e40af; border-color: #1e40af; color: #fff; }
+.btn-danger { background: #b91c1c; border-color: #b91c1c; color: #fff; }
+.btn-warning { background: #fbbf24; border-color: #fbbf24; color: #111827; }
+.btn-secondary { background: var(--color-surface-hover); color: var(--color-text); border-color: var(--color-border); }
+.btn:hover { filter: brightness(.92); }
+input,select,textarea,button { font: inherit; }
+button,summary { touch-action: manipulation; }
+@media (max-width: 1000px) {
+    .form-container { grid-template-columns: minmax(0, 1fr); gap: .5rem; }
+    .form-container label,.form-container input,.form-container select,.form-container textarea { grid-column: auto; }
+    .action-toolbar { gap: .5rem; }
+}
+
+.btn-primary:hover { background: #4338ca; border-color: #4338ca; color: #fff; }
+.btn-success:hover { background: #166534; border-color: #166534; color: #fff; }
+.btn-info:hover { background: #1e40af; border-color: #1e40af; color: #fff; }
+.btn-danger:hover { background: #b91c1c; border-color: #b91c1c; color: #fff; }
+
+.entry-filters { display: flex; flex-wrap: wrap; align-items: flex-end; gap: .75rem; padding: .75rem 0; }
+.entry-filters > div { flex: 1 1 14rem; min-width: 0; }
+.entry-filters input,.entry-filters select { width: 100%; box-sizing: border-box; padding: .5rem; color: var(--color-text); background: var(--color-surface); border: 1px solid var(--color-border); }
+.search-summary { padding: .6rem; border-left: 3px solid var(--color-accent); }
+
+.text-danger { color: var(--color-expense) !important; }
+.text-success { color: var(--color-income) !important; }
+
+.entry-deleted td { text-decoration: none; }
+.entry-deleted .entry-title, .entry-deleted td[data-label="Betrag"] { text-decoration: line-through; }

src/Duempelkas.Desktop/wwwroot/index.html

@@ -109,21 +109,17 @@
         })();
     </script>
     <title>Dümpelkas – Kassenbuch</title>
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" 
-          rel="stylesheet" 
-          integrity="sha384-QWTKZyjpPEjISv5WaRU9OFeRpok6YcnS/1nDaGm7AT/+aIi56blBBJoSpcBx5Hn" 
-          crossorigin="anonymous" />
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css"
-          rel="stylesheet" />
+    <link href="vendor/bootstrap/bootstrap.min.css" rel="stylesheet" />
+    <link href="vendor/bootstrap-icons/bootstrap-icons.min.css" rel="stylesheet" />
     <link href="css/app.css" rel="stylesheet" />
 </head>
 <body>
     <app>Laden...</app>
 
     <div id="blazor-error-ui">
-        Ein unbehandelter Fehler ist aufgetreten.
-        <a href="" class="reload">Neu laden</a>
-        <a class="dismiss">×</a>
+        Die Ansicht konnte wegen eines unerwarteten Fehlers nicht fortgesetzt werden. Eine Speicherung ist nicht bestätigt; bitte vor erneutem Buchen die Liste prüfen.
+        <a href="" class="reload">Ansicht neu laden</a>
+        <button type="button" class="dismiss" aria-label="Fehlerhinweis schließen">×</button>
     </div>
 
     <script src="js/app.js"></script>

src/Duempelkas.Desktop/wwwroot/js/app.js

@@ -30,3 +30,14 @@ window.duempelkasDialog = {
     close(dialog) { if (dialog?.open) dialog.close(); },
     focus(dialog, selector) { dialog.querySelector(selector)?.focus(); }
 };
+
+window.duempelkasReading = {
+    get() { let value = 100; try { value = Number(localStorage.getItem('duempelkas-text-scale')) || 100; } catch (_) {} return this.set(value, false); },
+    set(value, persist = true) {
+        const scale = [100,125,150,200].includes(Number(value)) ? Number(value) : 100;
+        document.documentElement.style.setProperty('--app-font-size', (16 * scale / 100) + 'px');
+        if (persist) { try { localStorage.setItem('duempelkas-text-scale', String(scale)); } catch (_) {} }
+        return scale;
+    }
+};
+window.duempelkasReading.get();

src/Duempelkas.Desktop/wwwroot/vendor/README.md

@@ -0,0 +1,8 @@
+Bootstrap 5.3.3 and Bootstrap Icons 1.11.3, MIT-licensed. Vendored from the corresponding npm releases via cdn.jsdelivr.net; original licenses are in each directory. Font query hashes were removed for local WebView paths.
+
+bootstrap\bootstrap.min.css SHA256 3c8f27e6009ccfd710a905e6dcf12d0ee3c6f2ac7da05b0572d3e0d12e736fc8
+bootstrap\LICENSE SHA256 8c14611ae41ac6fd543c13349f22188eb12c69b3e59105c5eca3925a8e4eca3e
+bootstrap-icons\bootstrap-icons.min.css SHA256 ea5f11e3455e7ec8cdfec5a46a6f0905308979d60cb2777c9246bc04cd37cff7
+bootstrap-icons\LICENSE SHA256 0fb3e11bd57e896c5a512afd64864d28a37de45d19835016c87ca1ad19ead969
+bootstrap-icons\fonts\bootstrap-icons.woff SHA256 bb1de989b83970f6f4e54de1cd974c5cba55b73582da5e1b225a6d0edf029483
+bootstrap-icons\fonts\bootstrap-icons.woff2 SHA256 476adf42b40325098fcfa8b36ab3e769186bb4f6ce6a249753e2e1a9c22bf99e

src/Duempelkas.Desktop/wwwroot/vendor/bootstrap-icons/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019-2024 The Bootstrap Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

src/Duempelkas.Desktop/wwwroot/vendor/bootstrap/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2011-2024 The Bootstrap Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

src/Duempelkas.Infrastructure/Services/SettingsService.cs

@@ -25,6 +25,14 @@ public class SettingsService : ISettingsService
         await SaveAsync(settings);
     }
 
+    public async Task<int> GetSetupStepAsync() => (await LoadAsync()).SetupStep;
+    public async Task SetSetupStepAsync(int step)
+    {
+        var settings = await LoadAsync();
+        settings.SetupStep = Math.Clamp(step, 0, 4);
+        await SaveAsync(settings);
+    }
+
     private async Task<AppSettings> LoadAsync()
     {
         if (!File.Exists(SettingsPath))
@@ -52,5 +60,6 @@ public class SettingsService : ISettingsService
     private class AppSettings
     {
         public string? ClubName { get; set; }
+        public int SetupStep { get; set; }
     }
 }

tests/Duempelkas.Tests/CarryoverCorrectionTests.cs

@@ -37,7 +37,9 @@ public class CarryoverCorrectionTests
         var dialog = f.Context.Render<EditCarryoverDialog>(p => p.Add(x => x.CurrentAmount, 110m)
             .Add(x => x.InitialBalance, 100m).Add(x => x.Year, 2026).Add(x => x.AccountName, "Barkasse")
             .Add(x => x.OnSave, value => saved = value));
+        Assert.Equal("110,00", dialog.Find("#carryover").GetAttribute("value"));
         dialog.Find("#carryover").Input("120,00");
+        Assert.Equal("120,00", dialog.Find("#carryover").GetAttribute("value"));
         Assert.Contains("frühere und spätere Jahre", dialog.Markup);
         Assert.Contains("110,00", dialog.Find(".correction-preview").TextContent);
         Assert.True(dialog.Find("button.btn-success").HasAttribute("disabled"));

tests/Duempelkas.Tests/DesktopResourceTests.cs

@@ -0,0 +1,29 @@
+using System.Text.RegularExpressions;
+using Xunit;
+
+namespace Duempelkas.Tests;
+
+public class DesktopResourceTests
+{
+    [Fact]
+    public void StartupStylesAndFonts_AreDeliveredLocally()
+    {
+        var root = new DirectoryInfo(AppContext.BaseDirectory);
+        while (root != null && !File.Exists(Path.Combine(root.FullName, "Duempelkas.slnx"))) root = root.Parent;
+        Assert.NotNull(root);
+        var web = Path.Combine(root.FullName, "src", "Duempelkas.Desktop", "wwwroot");
+        var html = File.ReadAllText(Path.Combine(web, "index.html"));
+        Assert.DoesNotContain("https://", html);
+        foreach (Match match in Regex.Matches(html, "(?:href|src)=\"([^\"]+)\""))
+        {
+            var path = match.Groups[1].Value;
+            if (path.Length == 0 || path == "/" || path.StartsWith("_framework")) continue;
+            Assert.True(File.Exists(Path.Combine(web, path)), path);
+        }
+        var icons = Path.Combine(web, "vendor", "bootstrap-icons");
+        var css = File.ReadAllText(Path.Combine(icons, "bootstrap-icons.min.css"));
+        foreach (Match match in Regex.Matches(css, "url\\([\"']?([^\"')]+)"))
+            Assert.True(File.Exists(Path.Combine(icons, match.Groups[1].Value.Split('?')[0])));
+        Assert.True(File.Exists(Path.Combine(icons, "LICENSE")));
+    }
+}

tests/Duempelkas.Tests/EntryLifecycleUiTests.cs

@@ -27,6 +27,7 @@ public class EntryLifecycleUiTests
         Assert.Contains("zählt nicht zum Kontostand", page.Markup);
         page.Find(".toast-success .btn").Click();
         page.WaitForAssertion(() => Assert.Single(page.FindAll("tbody tr")));
+        page.WaitForAssertion(() => Assert.Empty(page.FindAll(".deleted-status")));
         Assert.All(await entries.GetEntriesAsync(2, (int?)null), e => Assert.False(e.IsDeleted));
     }
 }

tests/Duempelkas.Tests/EntryPresentationTests.cs

@@ -8,6 +8,15 @@ namespace Duempelkas.Tests;
 
 public class EntryPresentationTests
 {
+    [Fact]
+    public void EmptyAccount_ShowsExplanationRatherThanParameterName()
+    {
+        using var f = new LedgerUiFixture();
+        f.Service<Microsoft.AspNetCore.Components.NavigationManager>().NavigateTo("/accounts/2");
+        var page = f.Context.Render<Duempelkas.App.Components.Routes>();
+        page.WaitForAssertion(() => Assert.Contains("Noch keine Buchungen vorhanden.", page.Markup));
+        Assert.DoesNotContain("emptyEntriesMessage", page.Markup);
+    }
     [Fact]
     public void Actions_HaveVisibleTextAndBookingSpecificNames()
     {

tests/Duempelkas.Tests/EntrySearchTests.cs

@@ -0,0 +1,45 @@
+using Bunit;
+using Duempelkas.App.Components.Accounts;
+using Duempelkas.App.Services;
+using Duempelkas.App.Services.Models;
+using Duempelkas.Domain.Enums;
+using Xunit;
+
+namespace Duempelkas.Tests;
+
+public class EntrySearchTests
+{
+    [Fact]
+    public void Search_FindsKnownBookingInLargeList_AndResetsWithoutChangingAmounts()
+    {
+        using var context = new BunitContext();
+        var entries = Enumerable.Range(1, 400).Select(i => new EntryDto(i, 1, $"2026-{i:D3}", EntryType.Income,
+            new(2026, 1, 1), i == 321 ? "Älteres Jubiläum" : $"Beitrag {i}", i == 321 ? 12.50m : i, false, false, null, null, null)).ToList();
+        var original = entries.Sum(e => e.Amount);
+        var table = context.Render<EntryTable>(p => p.Add(x => x.Entries, entries));
+        table.Find("#entry-search").Input("Älteres 12,50");
+        Assert.Single(table.FindAll("tbody tr"));
+        Assert.Contains("12,50", table.Find(".search-summary").TextContent);
+        Assert.Contains("unverändert", table.Find(".search-summary").TextContent);
+        table.Find("#entry-search").Input("nicht vorhanden");
+        Assert.Empty(table.FindAll("tbody tr"));
+        Assert.Contains("Keine Treffer", table.Markup);
+        table.Find(".filter-reset").Click();
+        Assert.Equal(400, table.FindAll("tbody tr").Count);
+        Assert.Equal(original, entries.Sum(e => e.Amount));
+        table.Find("#entry-search").Input("2026-321");
+        Assert.Single(table.FindAll("tbody tr"));
+    }
+
+    [Fact]
+    public void Sort_UsesSignedAmounts_AndDeletedHistoryDoesNotAffectResultSum()
+    {
+        var entries = new List<EntryDto> {
+            new(1,1,"2026-001",EntryType.Expense,DateTime.Today,"Porto",20m,false,false,null,null,null),
+            new(2,1,"2026-002",EntryType.Income,DateTime.Today,"Beitrag",10m,false,false,null,null,null),
+            new(3,1,"2026-003",EntryType.Income,DateTime.Today,"Gelöscht",99m,true,false,null,null,null) };
+        Assert.Equal(new[] { 2, 1 }, EntryListQuery.Apply(entries, "", false, "amount-desc").Select(e => e.Id));
+        Assert.Single(EntryListQuery.Apply(entries, "-20,00", false, "date-asc"));
+        Assert.Equal(3, EntryListQuery.Apply(entries, "", true, "date-asc").Count);
+    }
+}

tests/Duempelkas.Tests/ErrorRecoveryTests.cs

@@ -0,0 +1,28 @@
+using Bunit;
+using Duempelkas.App.Components;
+using Duempelkas.App.Services;
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Rendering;
+using Microsoft.Extensions.DependencyInjection;
+using Xunit;
+
+namespace Duempelkas.Tests;
+
+public class ErrorRecoveryTests
+{
+    [Fact]
+    public void UnexpectedError_OffersRecoveryWithoutLeakingBookingData()
+    {
+        using var context = new BunitContext();
+        context.Services.AddSingleton<ToastService>();
+        var boundary = context.Render<AppErrorBoundary>(p => p.AddChildContent<Throws>());
+        boundary.WaitForAssertion(() => Assert.Contains("nicht bestätigt", boundary.Markup));
+        Assert.Contains("Zur Kontenübersicht", boundary.Markup);
+        Assert.Contains("InvalidOperationException", boundary.Markup);
+        Assert.DoesNotContain("SECRET_BOOKING_DATA", boundary.Markup);
+    }
+    private sealed class Throws : ComponentBase
+    {
+        protected override void BuildRenderTree(RenderTreeBuilder builder) => throw new InvalidOperationException("SECRET_BOOKING_DATA");
+    }
+}

tests/Duempelkas.Tests/GettingStartedTests.cs

@@ -0,0 +1,36 @@
+using Bunit;
+using Duempelkas.App.Components;
+using Duempelkas.App.Services;
+using Microsoft.AspNetCore.Components;
+using Xunit;
+
+namespace Duempelkas.Tests;
+
+public class GettingStartedTests
+{
+    [Fact]
+    public async Task Introduction_CanBeSkippedAndResumed_AndCreatesNoSampleBookings()
+    {
+        using var f = new LedgerUiFixture(false);
+        var navigation = f.Service<NavigationManager>();
+        navigation.NavigateTo("/einstieg");
+        var page = f.Context.Render<Routes>();
+        page.WaitForElement("#setup-club").Input("Mein Testverein");
+        page.Find(".setup-next").Click();
+        page.WaitForAssertion(() => Assert.Contains("Dein erstes Konto", page.Markup));
+        page.FindAll("button").Single(b => b.TextContent.Contains("später fortsetzen")).Click();
+        navigation.NavigateTo("/einstieg");
+        page.WaitForAssertion(() => Assert.Contains("Dein erstes Konto", page.Markup));
+        page.FindAll("button").Single(b => b.TextContent.Trim() == "Konto anlegen").Click();
+        page.Find("#account-name").Input("Barkasse");
+        page.Find("#account-initial").Input("25,00");
+        page.Find("dialog form").Submit();
+        page.WaitForAssertion(() => Assert.Contains("Die erste Buchung", page.Markup));
+        var account = Assert.Single(await f.Service<IAccountService>().GetAllAccountsAsync());
+        Assert.Equal(25m, account.TotalBalance);
+        Assert.Empty(await f.Service<IEntryService>().GetEntriesAsync(account.Id, (int?)null));
+        Assert.Equal(2, await f.Service<ISettingsService>().GetSetupStepAsync());
+        navigation.NavigateTo("/hilfe");
+        page.WaitForAssertion(() => Assert.Contains("auch ohne Internet", page.Markup));
+    }
+}

tests/Duempelkas.Tests/LayoutControlTests.cs

@@ -0,0 +1,42 @@
+using Bunit;
+using Duempelkas.App.Components;
+using Duempelkas.App.Services;
+using Duempelkas.Domain.Enums;
+using Microsoft.AspNetCore.Components;
+using Xunit;
+
+namespace Duempelkas.Tests;
+
+public class LayoutControlTests
+{
+    [Fact]
+    public async Task TextScaleControl_ChangesPresentationWithoutChangingLedger()
+    {
+        using var f = new LedgerUiFixture();
+        var entries = f.Service<IEntryService>();
+        await entries.CreateEntryAsync(1, EntryType.Expense, DateTime.Today, "Porto mit sehr langer Beschreibung und Umlauten äöü", 4.20m);
+        f.Service<NavigationManager>().NavigateTo("/accounts/1");
+        var page = f.Context.Render<Routes>();
+        page.WaitForElement("#text-scale").Change("200");
+        Assert.Contains(f.Context.JSInterop.Invocations, i => i.Identifier == "duempelkasReading.set" && Equals(i.Arguments[0], 200));
+        Assert.Equal(95.80m, (await f.Service<IBalanceQueryService>().GetAccountBalanceAsync(1)).TotalBalance);
+        Capture("account", page.Markup);
+        page.FindAll("button").Single(b => b.TextContent.Contains("Einnahme oder Ausgabe")).Click();
+        page.WaitForElement("#entry-title");
+        Capture("booking", page.Markup);
+    }
+
+    private static void Capture(string name, string markup)
+    {
+        var output = Environment.GetEnvironmentVariable("DUEMPELKAS_LAYOUT_EVIDENCE");
+        if (output == null) return;
+        Directory.CreateDirectory(output);
+        var root = new DirectoryInfo(AppContext.BaseDirectory);
+        while (root != null && !File.Exists(Path.Combine(root.FullName, "Duempelkas.slnx"))) root = root.Parent;
+        var web = new Uri(Path.Combine(root!.FullName, "src", "Duempelkas.Desktop", "wwwroot") + Path.DirectorySeparatorChar).AbsoluteUri;
+        File.WriteAllText(Path.Combine(output, name + ".html"), "<!doctype html><html lang='de'><head><meta charset='utf-8'><meta name='viewport' content='width=device-width, initial-scale=1'>" +
+            $"<link rel='stylesheet' href='{web}vendor/bootstrap/bootstrap.min.css'><link rel='stylesheet' href='{web}vendor/bootstrap-icons/bootstrap-icons.min.css'><link rel='stylesheet' href='{web}css/app.css'>" +
+            "</head><body>" + markup + $"<script src='{web}js/app.js'></script>" +
+            "<script>document.querySelectorAll('dialog').forEach(d=>d.showModal());</script></body></html>");
+    }
+}

tests/Duempelkas.Tests/ModalDialogTests.cs

@@ -23,6 +23,9 @@ public class ModalDialogTests
         await modal.InvokeAsync(() => modal.Instance.RequestCloseAsync());
         Assert.Equal(1, cancelled);
         Assert.Contains("Ungespeicherte Eingaben", modal.Markup);
+        await modal.InvokeAsync(() => modal.Instance.RequestCloseAsync());
+        Assert.Empty(modal.FindAll("[role=alertdialog]"));
+        await modal.InvokeAsync(() => modal.Instance.RequestCloseAsync());
         modal.Find("[data-discard-continue]").Click();
         Assert.Empty(modal.FindAll("[role=alertdialog]"));
         await modal.InvokeAsync(() => modal.Instance.RequestCloseAsync());