SMB — Sutady Moneybook

SMB (Sutady Moneybook) 2.4.1 ist ein Full-Stack-Personalbuchhaltungssystem auf Basis von SQLite und MCP (Model Context Protocol). Es unterstützt nativ den lokalen Einzelbetrieb und die Offline-Speicherung und ermöglicht über Cloudflare Tunnel auch einen sicheren netzwerkübergreifenden Zugriff. Die einzige Datenquelle des Kontobuchs ist das lokale SQLite; es ist keine externe Cloud-Datenbank erforderlich, die Daten liegen vollständig in eigener Hand.

Umgesetzt

• Schnelle Einnahmen-/Ausgabenbuchung, nur das Datum des Vorgangs wird erfasst, Beträge werden als ganze Zahl in „Cent" gespeichert.

• Vollständig anpassbare Kategorien, Deaktivierung, Migration oder dauerhaftes Löschen von Kategorien, Monats-/Jahresabrechnungen, Suchfilter, globaler 30-Tage-Papierkorb, CSV/JSON-Export.

• Wochen-, Monats- und Jahrestrends, Kategoriedetails, Kategoriezusammensetzung und Vergleich mit dem gleichen Zeitraum der Vorperiode.

• DeepSeek-Konsumübersicht, ungewöhnliches Wachstum, Spartipps, Kategoriestruktur und benutzerdefinierte Fragen; das Programm übernimmt die Zahlen, das Modell liefert nur die Erläuterungen. Derzeit werden keine Buchungsnotizen an externe Modelle gesendet.

• Standard-Streamable-HTTP-MCP; kann von der Webseite zwischen „Bestätigungsmodus" und „Direktübernahmemodus" umgeschaltet werden. Der Direktmodus kann Konten, Kategorien, Darlehen, Abonnements, KI, Backups und Zeitzonen verwalten und behält 30 Tage lang einen Rückgängig-Verlauf.

• SQLite WAL＋synchronous=FULL, Snapshots vor Migration, tägliche Integritäts-/Fremdschlüssel-Backups, age-Public-Key-Verschlüsselung und Google-Drive-Upload.

• Cloudflare-Access-Doppelschutz, PWA-Installation, Windows-Autostart bei Anmeldung und Hilfsskript für Neustart nach Fehlern.

• Vier Themes, vier integrierte Seitenhintergründe sowie persönliche Hintergrundbilder, die nur auf dem aktuellen Gerät gespeichert werden. Persönliche Bilder werden im Browser komprimiert und von Metadaten befreit; ein vorübergehender Wechsel zurück zum integrierten Hintergrund löscht sie nicht.

• Abfrageorientierte Übersichtsseite: Zeitraum und Einnahmen-/Ausgabentyp sind in der URL gespeichert; nach dem Aktualisieren oder der Rückkehr von der Kategorieabrechnung bleibt die ursprüngliche Ansichtsposition erhalten.

• Auf dem Handy: kompakte Zusammenfassung, Umschaltung Details/Zusammensetzung, unten fixierte Navigation und Filter-Drawer für Abrechnungen; während der Suche bleibt die alte Liste erhalten, um Inhaltsflackern zu vermeiden.

• Das gesamte Datum der Website richtet sich nach der Zeitzone des Kontobuchs aus den Einstellungen; wenn Computer und Android in unterschiedlichen Zeitzonen liegen, bleiben „Heute", Standardmonat und KI-Analysezeitraum konsistent.

• Eigenständiges Modul „Angelegenheiten" für Darlehen, die andere mir schulden, Teilrückzahlungen und CNY/USD-Abonnements. Angelegenheiten fließen standardmäßig nicht in die Konsumstatistik ein; nur aktiv verknüpfte oder gleichzeitig erstellte normale Buchungen beeinflussen die Diagramme.

• Darlehen unterstützen Deaktivierung des Kreditnehmers, Teilrückzahlung, automatischen Abschluss und 30-Tage-Papierkorb; Abonnements unterstützen Ersteinführungsrabatte, monatliche/jährliche/benutzerdefinierte Zeiträume, Bestätigung bei Fälligkeit, Zahlungshistorie und In-App-Erinnerungen.

• Monatlich können ein Gesamtbudget in RMB und Kategoriebudgets festgelegt werden; Budgets werden nicht übertragen und blockieren keine Buchungen. Die Übersichtsseite zeigt Verbrauch, Rest, Prognose und Kategorierisiken.

• Die „Kontobuch-Prüfung" weist mit deterministischen Regeln auf mutmaßliche Duplikate, hohe Ausgaben, Budgetrisiken, zu bestätigende Verlängerungen und Verknüpfungsanomalien hin; die Prüfung ändert keine Buchungen automatisch, die KI erklärt nur die vom Programm gefundenen Fakten.

• Nach der Installation auf Android/Windows bietet das App-Menü einen Schnellzugriff „Buchung erfassen"; OpenClaw unterstützt das atomare Schreiben von bis zu 20 Buchungen in einem Vorgang sowie das vollständige Rückgängigmachen in einem Rutsch.

• Die Darlehenserfassung verwendet einen durchsuchbaren Einzelauswahl-Dialog für Kreditnehmer; neue Kreditnehmer werden in derselben Transaktion wie das Darlehen gespeichert. Aktive Datensätze mit gleichem Namen werden wiederverwendet, deaktivierte Datensätze müssen zuerst wiederhergestellt werden.

• Wiederholungsversuche von OpenClaw-Vorschlägen erzeugen keine doppelten ausstehenden Einträge; das Aktionszentrum zeigt Feldänderungen und Fehlerstatus bei Bedarf an. Die Kontobuch-Prüfung kann auch schreibgeschützt über MCP abgefragt werden und gibt keine Notizen zurück.

• Optionales Modul „Geldmittel" für RMB-Konten, Kontostandsverläufe, Überweisungen zwischen Konten, Gebühren, Kontostandsabgleiche und vollständige Rückerstattungen; die Gesamtgeldmittel enthalten keine ausstehenden Darlehen, Investitionen oder zukünftige Einnahmen.

• Historische Buchungen vor Aktivierung der Geldmittelverfolgung werden nicht rückwirkend erfasst; nach der Aktivierung werden normale Einnahmen/Ausgaben an Konten gebunden, der Kontostand ergibt sich aus dem Anfangssaldo und den additiven Geldmittelbewegungen – es wird keine zweite Saldowahrheit gepflegt.

• OpenClaw kann Konten, Überweisungen, Abgleiche und Rückerstattungen präzise abfragen und verwalten; alle direkten Schreibvorgänge verwenden weiterhin die idempotente requestId, mehrdeutige Kontonamen werden abgelehnt.

Die tatsächliche Bedienung von „Angelegenheiten", die Verknüpfungsregeln vor/nach Aktivierung der Geldmittel und die OpenClaw-Berechtigungen finden Sie im Leitfaden zu Darlehen und Abonnements. Kontenaktivierung, Geldmittelauswirkungen, Rückerstattungen und Prüfungshinweise finden Sie im Leitfaden zu Geldmittelverfolgung und -wartung.

Related MCP server: ExpenseTracker MCP Server

Einblicke und Abrechnungen

• „Kategoriedetails" in den Einblicken dienen dem Vergleich von Kategorierang, Betrag und Veränderung gegenüber der Vorperiode; „Kategoriezusammensetzung" dient der Anzeige von Ringdiagramm, Betrag und Anteil. Beide werden nie gleichzeitig angezeigt.

• Die Kategoriezusammensetzung zeigt vollständig alle Kategorien mit Beträgen in der aktuellen Periode und fasst sie nicht mehr zu „Sonstiges" zusammen; jedes Segment und jede Legende kann bis zur entsprechenden Abrechnung durchgeklickt werden.

• Die Abrechnungsseite hat vier gleichrangige Einstiege: „Zuletzt erfasst", „Monatsabrechnung", „Jahresabrechnung", „Papierkorb". Der Papierkorb ist über alle Daten hinweg nach Löschzeitpunkt sortiert und übernimmt nicht den zuletzt angesehenen Monat.

• Alte URLs bleiben kompatibel: /bills öffnet „Zuletzt erfasst"; /bills?view=ledger&period=month&anchor=... öffnet die Monatsabrechnung; period auf year geändert öffnet die Jahresabrechnung; /bills?view=trash öffnet den globalen Papierkorb.

• Normales Löschen behält 30 Tage und erlaubt die Wiederherstellung. Buchungen im Papierkorb können dauerhaft gelöscht werden; die Kategorieverwaltung in den Einstellungen kann nach Anzeige des Auswirkungsbereichs und Bestätigung des Namens auch Kategorien samt aller Buchungen dauerhaft löschen. Dauerhaftes Löschen ist nicht rückgängig zu machen, aber verknüpfte Darlehens- oder Abonnement-Angelegenheiten bleiben erhalten und werden automatisch von der Kontobuch-Verknüpfung gelöst.

Seitenaktualisierung und persönlicher Hintergrund

• Bei geöffneter Seite werden die Kontobuchdaten der aktuellen Seite alle 30 Sekunden synchronisiert; beim erneuten Fokussieren des Fensters oder bei wiederhergestellter Netzwerkverbindung wird ebenfalls sofort synchronisiert.

• Die PWA prüft jede Minute auf eine neue Version; wird eine neue Version gefunden, aktualisiert sie automatisch, wenn kein Formular gerade bearbeitet wird. Alternativ kann unter „Einstellungen → Betriebsstatus" auf „Prüfen und aktualisieren" geklickt werden.

• Bei abgelaufenem Cloudflare-Login verwenden Sie „Erneut anmelden" auf der Seite; löschen Sie nicht die Website-Cookies oder die Websitedaten. „Erneut anmelden" und „Prüfen und aktualisieren" ersetzen nur den PWA-Programm-Cache und behalten Login-Cookies, Darstellungspräferenzen und den persönlichen Hintergrund in IndexedDB; erst das Löschen aller Websitedaten entfernt das persönliche Bild des aktuellen Geräts.

• Die Auswahl von „Rein, Papier, Struktur, Nebel" deaktiviert vorübergehend das persönliche Bild, das Bild bleibt jedoch auf dem aktuellen Gerät erhalten und kann jederzeit über „Bild verwenden" wiederhergestellt werden.

• Beim ersten Kaltstart jeder Browsersitzung wird kurz einmal der SMB-Branding-Startbildschirm angezeigt; Datenaktualisierungen und Seitenwechsel spielen ihn nicht erneut ab, und bei aktivierter Systemeinstellung „Bewegung reduzieren" wird er direkt übersprungen.

Schnellstart und lokaler Betrieb

Erforderlich ist Node.js 22 oder höher.

Variante 1: Windows-Ein-Klick-Start (am meisten empfohlen)

Doppelklicken Sie direkt auf 打开 SMB.cmd im Projektstammverzeichnis.

• Beim ersten Start werden automatisch Abhängigkeiten geprüft, die .env-Standardkonfiguration automatisch aus der Vorlage generiert und der Build abgeschlossen;

• anschließend wird der Dienst automatisch gestartet und die Buchhaltungs-Startseite im Standardbrowser geöffnet (Standardzugriff unter http://127.0.0.1:8788, Einzelbetrieb ohne Anmeldung).

Variante 2: Manueller Start über die Befehlszeile (plattformübergreifend: Windows / Linux / macOS)

Öffnen Sie ein Terminal im Projektstammverzeichnis:

# 1. 安装项目依赖
npm install

# 2. 初始化本地配置（默认开启免登录单机模式）
cp .env.example .env

# 3. 运行开发模式（推荐本地体验，支持代码热重载）
npm run dev
# 浏览器访问 http://127.0.0.1:5173

# 或者编译并启动正式生产服务：
npm run build
npm start
# 浏览器访问 http://127.0.0.1:8788

Qualitätsprüfung

npm test
npm run typecheck
npm run build

Vor einem offiziellen Update kann zusätzlich ein Snapshot mit Integritätsprüfung erstellt werden:

npm.cmd run backup:snapshot -- manual-update
npm.cmd run backup:verify-restore

Erweiterte Funktionen und Bereitstellungsleitfaden

Wenn Sie nur auf Ihrem persönlichen Computer lokal Buchhaltung betreiben, ist keine Konfiguration externer Dienste erforderlich – es funktioniert sofort einsatzbereit.

Für die folgenden erweiterten Funktionen können Sie die entsprechenden Leitfäden nach Bedarf konfigurieren:

• Fernbuchhaltung über das Handy im Netz: Über Cloudflare Tunnel ohne öffentliche IP und mit Access-Identitätsprüfung, siehe Bereitstellungsleitfaden.

• KI-gestützte Konsumanalyse: Doppelklick auf 配置DeepSeek密钥.cmd im Stammverzeichnis oder Eintragen des DeepSeek-API-Keys in .env aktiviert Konsumeinblicke und Spartipps.

• Verschlüsselte automatische Cloud-Backups von unterwegs: Konfigurieren Sie Google Drive und den age-Verschlüsselungsschlüssel für tägliche automatische Snapshot-Uploads, siehe Wiederherstellungsleitfaden.

• Geldmittel- und Kontoverwaltung: Vermögensverläufe über mehrere Konten, Überweisungen und Kontostandsabgleiche, siehe Leitfaden zur Geldmittelverfolgung.

• Darlehens- und Abonnementverwaltung: Verfolgung externer Schulden, Teilrückzahlungen und periodischer Abonnementabbuchungen, siehe Leitfaden zu Angelegenheiten.

Verzeichnis

• src/: Die für Handy und Computer gemeinsame React-PWA.

• server/: Node-API, MCP, DeepSeek, Geldmittel, Finanzangelegenheiten und Backup-Dienste.

• db/: SQLite-Tabellenstrukturen und Migrationen.

• tests/: Tests für Beträge, Daten, Angelegenheiten, Oberfläche, KI und MCP.

• scripts/: Skripte für Initialisierung, Autostart, Backup-Schlüssel und Wiederherstellung.

• deploy/: Schlüssellose Konfigurationsvorlagen für Cloudflare und OpenClaw.

Die privaten Dateien .env, die offizielle Datenbank, Backups, Logs und Build-Artefakte sind von der Versionskontrolle ausgeschlossen.

Die Versionsnummer wird ausschließlich in package.json gepflegt. Fehlerkorrekturen und visuelle Verfeinerungen erhöhen die Patch-Version, abwärtskompatible neue Funktionen die Minor-Version, Produktidentität oder inkompatible Vertragsänderungen die Major-Version; Versionshinweise finden Sie in CHANGELOG.md. Logo-Spezifikationen und bearbeitbare Quelldateien finden Sie im Markenleitfaden.

Bewusst aufgeschobene Funktionen wie Abrechnungsimport, Synchronisierung von Drittanbieter-Salden und erweiterte Kontofunktionen finden Sie in ROADMAP.md.