diff --git a/docs/usability-umsetzung.md b/docs/usability-umsetzung.md index 5cef3c6..ccf09d4 100644 --- a/docs/usability-umsetzung.md +++ b/docs/usability-umsetzung.md @@ -85,3 +85,7 @@ Neue Konten erhalten einen erklärten Anfangsbestand ohne künstliche Einnahme. 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. diff --git a/src/Duempelkas.App/Components/Layout/MainLayout.razor b/src/Duempelkas.App/Components/Layout/MainLayout.razor index dd4f9b8..3663a90 100644 --- a/src/Duempelkas.App/Components/Layout/MainLayout.razor +++ b/src/Duempelkas.App/Components/Layout/MainLayout.razor @@ -9,6 +9,7 @@ Dümpelkas Kassenbuch
+ Hilfe + + } + else if (step == 1) + { +

Dein erstes Konto

+

Zum Beispiel Barkasse oder Girokonto. Der Anfangsbestand ist das bereits vorhandene Geld, keine neue Einnahme.

+ + @if (accounts.Count > 0) + { +

Ein Konto ist bereits eingerichtet.

+ } + } + else if (step == 2) + { +

Die erste Buchung

+

Wähle ein Konto und erfasse einen tatsächlichen Mitgliedsbeitrag oder eine Ausgabe, etwa Porto. Es werden keine Beispielbuchungen erzeugt.

+ @foreach (var account in accounts) {

@account.Name öffnen und buchen

} + + } + else if (step == 3) + { +

Deine Daten sichern

+

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.

+ + + + } + else + { +

Bereit für das Kassenbuch

Die Hilfe bleibt jederzeit erreichbar. Prüfe regelmäßig Kontostände und Sicherungen.

+ Zur Kontenübersicht + + } +

Zur Hilfe

+} +@if (showAccount) +{ + +} + +@code { + private int step; + private bool loading = true, busy, showAccount; + private string clubName = string.Empty; + private List 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() { step = Math.Min(step + 1, 4); await Settings.SetSetupStepAsync(step); } + 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); } +} diff --git a/src/Duempelkas.App/Pages/Help.razor b/src/Duempelkas.App/Pages/Help.razor new file mode 100644 index 0000000..d1fb405 --- /dev/null +++ b/src/Duempelkas.App/Pages/Help.razor @@ -0,0 +1,35 @@ +@page "/hilfe" +

Hilfe für Dümpelkas

+

Passend zu dieser Programmversion. Diese Hilfe ist auch ohne Internet verfügbar.

+

Erste Schritte öffnen oder fortsetzen Zur Kontenübersicht

+
Konten einrichten +

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.

+
+
Einnahme oder Ausgabe erfassen +

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.

+

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.

+
+
Jahr, Kontostand und Anfangsbestand verstehen +

„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.

+

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.

+
+
Geld zwischen Konten verschieben +

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.

+
+
Bearbeiten, Löschen und Wiederherstellen +

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“.

+
+
Buchungen finden +

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.

+
+
Als PDF speichern +

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“.

+
+
Sichern und zurückspielen +

„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.

+

„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.

+
+
Tastatur, Darstellung und Fehler +

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.

+

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.

+
diff --git a/src/Duempelkas.App/Services/ISettingsService.cs b/src/Duempelkas.App/Services/ISettingsService.cs index 38ca199..821d814 100644 --- a/src/Duempelkas.App/Services/ISettingsService.cs +++ b/src/Duempelkas.App/Services/ISettingsService.cs @@ -2,6 +2,8 @@ namespace Duempelkas.App.Services; public interface ISettingsService { + Task GetSetupStepAsync() => Task.FromResult(0); + Task SetSetupStepAsync(int step) => Task.CompletedTask; Task GetClubNameAsync(); Task SetClubNameAsync(string? clubName); } diff --git a/src/Duempelkas.Infrastructure/Services/SettingsService.cs b/src/Duempelkas.Infrastructure/Services/SettingsService.cs index 3c1f852..2e26f54 100644 --- a/src/Duempelkas.Infrastructure/Services/SettingsService.cs +++ b/src/Duempelkas.Infrastructure/Services/SettingsService.cs @@ -25,6 +25,14 @@ public class SettingsService : ISettingsService await SaveAsync(settings); } + public async Task 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 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; } } } diff --git a/tests/Duempelkas.Tests/GettingStartedTests.cs b/tests/Duempelkas.Tests/GettingStartedTests.cs new file mode 100644 index 0000000..6c8b208 --- /dev/null +++ b/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(); + navigation.NavigateTo("/einstieg"); + var page = f.Context.Render(); + 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().GetAllAccountsAsync()); + Assert.Equal(25m, account.TotalBalance); + Assert.Empty(await f.Service().GetEntriesAsync(account.Id, (int?)null)); + Assert.Equal(2, await f.Service().GetSetupStepAsync()); + navigation.NavigateTo("/hilfe"); + page.WaitForAssertion(() => Assert.Contains("auch ohne Internet", page.Markup)); + } +}