duempelkas/docs/programmstand.md

Hinweise zum dokumentierten Programmstand

Stand: 1. November 2026. Diese Datei ergänzt die Bedienungsanleitung um Nachweise und Einschränkungen für deren Pflege.

Grundlage und Umfang

Die Anleitung wurde aus den Razor-Seiten, Dialogen, deren Ereignisbehandlung und den zugehörigen Diensten abgeleitet. Die sichtbaren Dialoge wurden zusätzlich in der bereits laufenden Windows-Debug-Anwendung, Version 26.305, geöffnet und aufgenommen. Die Anleitung beschreibt das vorhandene Verhalten; es wurden keine Funktionen implementiert oder Fehler behoben.

Geprüfte Bereiche:

• Startseite und Jahresauswahl, einschließlich Aktionen: Konten, Vereinsname, Gesamtsumme, Backup/Restore, PDF, Farbauswahl.
• Kontoansicht und Aktionen: Kontoname, Summen, Jahresauswahl, Übertrag, Buchungsaktionen und Export.
• Buchungsdialog und Verarbeitung.
• Umbuchungsdialog und Verarbeitung.
• Weitere Dialoge: Konto anlegen, Namen ändern, Übertrag ändern, Bestätigungen.
• Buchungszeilen, Liste und Sortierung, automatische Nummern, verbundene Umbuchungen, Löschen/Wiederherstellen.
• Kontenberechnung und Saldoberechnung.
• PDF-Erstellung, Dateidialoge und Öffnen.
• Sicherung und Wiederherstellung, Namenseinstellung, Datenspeicher und Fenstergröße.
• Einstellungen, Rahmen und Über-Dialog, Routen einschließlich Nicht-gefunden-Ansicht.
• Darstellungsspeicherung, einschließlich Systemvorgabe und Speicherung der manuellen Auswahl.

Die Nicht-gefunden-Ansicht zeigt lediglich „Seite nicht gefunden.“ Sie besitzt keine eigene Fachfunktion. Nicht eingebundene Hilfskomponenten und Dienstmethoden wurden nicht als erreichbare Benutzerfunktionen dargestellt. Insbesondere existiert zwar eine Dienstmethode zum Löschen ganzer Konten, aber kein entsprechender sichtbarer Bedienweg. Ebenso ist keine Jahresabschluss- oder Jahressperrfunktion in die dokumentierten Seiten eingebunden.

Einschränkungen mit Auswirkung auf die Anleitung

Backup und Restore verwenden einen abweichenden Datenpfad

Program.cs verbindet die Anwendung mit %APPDATA%\Duempelkas\duempelkas.db. BackupService.DbPath verweist dagegen auf duempelkas.db neben dem Prozessprogramm. Sicherung und Wiederherstellung können deshalb eine andere Datei verwenden oder beim Backup keine Datei finden. Dies ist ein aus dem Quellcode abgeleiteter Befund; eine Wiederherstellung wurde für die Dokumentation nicht ausgeführt.

Die Sicherung kopiert nur die Datenbankdatei. settings.json mit dem Vereinsnamen, window.json und die gespeicherte Farbauswahl sind nicht enthalten. Zudem wird beim Backup eine rohe Dateikopie verwendet; die Konsistenz einer Sicherung bei gleichzeitig aktiven Schreibvorgängen wurde hier nicht überprüft.

Die Startseite zeigt bei Backup nur Rückgaben an, die „fehlgeschlagen“ enthalten. „Keine Datenbankdatei gefunden.“, Abbruch und Erfolg erscheinen dort nicht als Meldung. Die Anleitung vermeidet deshalb die Zusage einer Erfolgsmeldung.

Einzelkonto-PDF enthält gelöschte Zeilen ohne Kennzeichnung

GenerateStatementAsync übernimmt die Liste aus GetEntriesAsync und gibt jede Zeile aus. Diese Liste enthält auch IsDeleted-Einträge. Die Ausgabe kennzeichnet diese nicht als gelöscht, während BalanceQueryService sie für die Summen ausschließt. Die gemeinsame PDF filtert hingegen ausdrücklich !e.IsDeleted. Die Anleitung nennt diese Abweichung und empfiehlt für eine Übersicht ohne gelöschte Zeilen die gemeinsame PDF.

Die PDF-Inhalte und die Abläufe der Speicherdialoge sind anhand des Codes beschrieben. Für diese Dokumentationsarbeit wurde keine neue PDF exportiert; es gibt daher keinen Screenshot eines erzeugten PDF-Dokuments oder des PDF-öffnen-Dialogs.

Übertrag wirkt über den gemeinsamen Anfangsbestand

UpdateCarryoverAsync(accountId, amount, year) berechnet den gemeinsamen CarryoverBalance aus dem gewünschten Jahresübertrag abzüglich der Bewegungen vor diesem Jahr. Der Wert wird nicht als isolierte Jahreskorrektur gespeichert. Die Anleitung weist deshalb auf mögliche Auswirkungen auf andere Jahre hin.

Jahresfilter und Buchungsdatum

Startseite und Kontoansicht halten ihren Filter jeweils lokal mit DateTime.Now.Year als Ausgangswert. Die Jahresauswahl wird aus vorhandenen Buchungsdaten gebildet, auch aus gelöschten Einträgen. Die Eingabedialoge starten unabhängig davon mit DateTime.Today. Beim Bearbeiten bleibt die laufende Nummer erhalten, selbst wenn das Datum in ein anderes Jahr verschoben wird.

Umbuchungsbearbeitung auf der empfangenden Seite

Der Dialog verwendet auch dort die Beschriftung „Zielkonto“. Tatsächlich wird EditEntry.LinkedAccountId angezeigt und bei Änderung die Gegenbuchung verschoben. Die Anleitung empfiehlt die Bearbeitung vom ursprünglichen Ausgangskonto und erläutert die Bedeutung dieses Feldes auf der anderen Seite.

Einstellungsseite ohne sichtbaren Navigationslink

Die Route /settings enthält ein Feld für den Vereinsnamen, Speichern mit Rückmeldung und Zurück. Im aktuellen Layout gibt es keinen Link dorthin. Sie wurde aus dem Code beschrieben und ausdrücklich als nicht über die normale Desktop-Navigation erreichbar gekennzeichnet. Der reguläre Bedienweg für dieselbe Einstellung ist der Stift auf der Startseite. Es wurde kein Screenshot dieser Seite nachgestellt.

Screenshots

Alle 16 JPEG-Dateien unter screenshots stammen unverändert aus Fensteraufnahmen der laufenden Anwendung über den Computer-use-Skill. Sie zeigen das Anwendungsfenster ohne andere Desktop-Fenster. Die Aufnahmen wurden unmittelbar nach dem Speichern visuell geprüft und im jeweiligen Kapitel eingebunden.

• 01: Startseite mit Konten und Gesamtsumme.
• 02–05: Konto anlegen, Vereinsname, Jahresauswahl, Restore-Rückfrage.
• 06–10: Kontoansicht, neue Buchung, neue Umbuchung, Übertrag, Buchung bearbeiten.
• 11–14: Löschrückfrage, Über-Dialog, Kontoname, Umbuchung bearbeiten.
• 15–16: Gelöschte Buchungen und Rückfrage zum Wiederherstellen.

Die Aufnahmen verwenden die vorhandenen Namen und Buchungen. In den Bildern 15 und 16 sind die bereits zuvor angelegten und gelöschten Debug-Testbuchungen zu sehen; sie wurden für diese Dokumentationsarbeit nicht wiederhergestellt. Alle geöffneten Änderungs-, Lösch- und Wiederherstellungsdialoge wurden abgebrochen. Keine Buchungsdaten wurden für die Aufnahmen geändert. Die Anwendung blieb in der dunklen Darstellung.

Die Abbildungen sind Beispiele des aufgenommenen Datenstands, keine mitgelieferten Vorgabedaten. Nicht jeder identisch aufgebaute Bestätigungsdialog wird mehrfach abgebildet. Der allgemeine Windows-Dateidialog, die helle Darstellung, die leere Startseite und die Nicht-gefunden-Ansicht werden im Text beziehungsweise hier beschrieben und nicht durch nachgestellte Bilder ersetzt.