entrytwo

docs / features / overview.md

Funktionsüberblick

entrytwo ist KI-native doppelte Buchführung mit Git-ähnlichem Datenmodell. Die KI bucht echte Journalbuchungen bei hoher Sicherheit. Vollständig unveränderliche Historie, Branches, Blame und geschlossene Perioden.

Die meiste Arbeit geht über UI-Panels oder per Gespräch mit der KI im Chat. Die KI respektiert dieselben Regeln und den aktuellen View (Branch + Zeitpunkt) wie die UI.


Kernbuchhaltung

Journalbuchungen

  • Einzelne oder Batch-Journalbuchungen.
  • Volle Doppelbuchung: Soll = Haben nach FX-Umrechnung.
  • Unterstützung für Steuer, Kontakte, Anhänge, FX-Kurse + Quellen.
  • KI kann Buchungen aus hochgeladenen Auszügen/Belegen autonom erstellen (oder vorschlagen).
  • Manuelle Erstellung über New-Journal-Entry-Modal (vorausgefüllt aus KI-Vorschlägen oder gestagten Belegen).
  • Jede Buchung ist ein unveränderlicher Commit mit vollen Audit-Metadaten.

Ledger

  • Jedes Konto über beliebigen Zeitraum, auf jedem Branch, zu jedem Zeitpunkt.
  • Anfangssaldo korrekt für den gewählten View.
  • Suche, Paginierung, Sortierung.
  • Zeilen als cleared/abgestimmt markieren.
  • Direkte Links aus Chat und anderen Panels.

Konten (Kontenplan)

  • Standardtypen: Asset, Liability, Equity, Revenue, Expense.
  • Dashboard und Berichte nach Konto filtern.
  • Blame und Historie pro Konto in den Git-Controls.

Berichte & Analyse

  • Gewinn- und Verlustrechnung (GuV) mit Branch-/as-of-Unterstützung.
  • Reports-Panel mit flexiblen Zeiträumen und Vergleich.
  • Summary-Leiste für schnellen Überblick.
  • Alle Berichte respektieren den aktuellen Git-View (Zahlen „as of“ Branch und Punkt, den du siehst).

Git-Modell für die Buchhaltung

Das ist das Fundament. Vollständige Philosophie: docs/concepts/git-model.md.

Schlüssel-Capabilities:

  • Branches: Auf main (offizielle Bücher) arbeiten oder parallele Branches für Experimente, KI-Arbeit oder Korrekturen.
  • Zeitpunkt-Views (asOf): Die ganze App auf einen bestimmten Commit oder ein Datum pinnen.
  • Restore: Branch-Head auf jeden früheren Zustand setzen. Erzeugt immer einen neuen ROLLBACK-Commit – Historie geht nie verloren.
  • Tags: Wichtige Zustände markieren (Monatsabschluss, Auditor-Snapshot, Steuer-Version).
  • Letzte Zustände: Letzte Commits und Tags in buchhalterfreundlichem Picker.
  • Merge: Nettoänderungen previewen, dann Arbeit von einem Branch in einen anderen übernehmen.
  • Diff & Blame: Genau sehen, was sich geändert hat und wer (oder welche KI) jede Zeile berührt hat.
  • Audit-Log: Vollständige unveränderliche Event-Historie.

Der aktuelle View (Branch + as-of) ist immer im persistenten Books View Indicator sichtbar und wird von Chat, Ledger, Berichten, Journal usw. respektiert.

Fast alles geht über die dedizierte History-Ansicht (?view=history) oder per Chat-Befehl.


KI und Chat

Der Chat (links) ist eine First-Class-Oberfläche.

  • Natürlichsprachliche Anweisungen („stimme 1100 für Juni ab“, „verarbeite diesen Auszug“).
  • PDFs, Bilder, CSVs hochladen – werden zu gestagten Belegen, die mehrere Turns überleben, bis sie an eine Buchung gehängt werden.
  • KI kann bei sicheren Aktionen und hoher Konfidenz autonom handeln (Journalbuchungen, Abstimmung, Kontakte, Entwürfe usw.).
  • Niedrigere Konfidenz, destruktive oder gesperrte-Chat-Aktionen werden zu Vorschlägen, die du bestätigen musst.
  • Volle Provenienz: autonome Aktionen als AI_AUTONOMOUS_ENTRY mit Modell, Konfidenz, Reasoning und Quellen.
  • Chat-Sperre-Toggle für „nur Vorschläge“-Modus.
  • KI arbeitet immer auf dem aktuellen Branch + as-of, den du siehst.

Siehe:

  • docs/ai/ai-autonomy.md (Regeln und Entscheidungstabelle)
  • docs/ai/using-the-ai.md (praktisches Prompting und Workflows)

Rechnungsstellung

  • Rechnungen erstellen und verwalten.
  • Entwürfe, Positionen, Steuer, Kontakte.
  • PDF-Erzeugung und Download.
  • E-Mail-Versand (wenn SMTP oder E-Mail-Provider konfiguriert).
  • Wiederkehrende Rechnungen unterstützt.
  • Rechnungen auch im Journal/Ledger sichtbar und filterbar.

Spesenabrechnungen (Expense Claims)

  • Belege in Claims sammeln.
  • Einreichen → prüfen (freigeben / Änderungen anfordern / ablehnen) → ins Ledger buchen.
  • Mehrzeilige Claims mit Beleg pro Zeile, Währungen, Steuer.
  • Workflow-Status und volles Activity-Log.
  • Nützlich für Mitarbeitende oder Eigentümer bei erstattungsfähigen Ausgaben.

Kontakte

  • Kunden und Lieferanten.
  • Genutzt für Rechnungen, Journalzeilen, Claims und Abstimmungsnotizen.
  • Manuell oder per Chat (CREATE_CONTACT) anlegbar.

Belege & Anhänge

  • PDFs, Bilder, CSVs über Chat, TopBar, Receipts-Panel oder Claim-Editor hochladen.
  • Verknüpft mit Journalbuchungen oder Claims.
  • „Staged receipts“-Muster: zuerst anhängen, besprechen, dann Buchung (KI oder manuell), die den Anhang verbraucht.
  • Anhänge werden sicher gespeichert und ausgeliefert.

Vorlagen & Wiederkehrendes

  • Journal-Vorlagen für wiederholte Muster.
  • Wiederkehrende Journalbuchungen (manuell oder per Hintergrundjob erzeugen).
  • Wiederkehrende Rechnungen.

Historie, Audit & Compliance

  • Volles Event-Log (jeder Commit, Branch, Merge, Tag, Rollback, KI-Aktion).
  • Blame pro Konto/Zeile.
  • Diff zwischen zwei beliebigen Punkten.
  • Tags für formelle Snapshots.
  • Nichts wird still mutiert – auch Korrekturen erzeugen neue Commits.

Dieses Design zielt auf strenge Audit- und Steueranforderungen und bleibt im Alltag nutzbar.


Wie Git + KI überall integriert sind

  • Dashboard, Ledger, Berichte, GuV, Journal – alle akzeptieren ?branch=...&asOf=....
  • Chat übergibt den aktuellen View bei jedem Turn.
  • Autonome KI-Buchungen landen auf dem betrachteten Branch.
  • Restore-/Merge-/Tag-Operationen aktualisieren den URL-View.
  • Der Books View Indicator macht es unmöglich zu vergessen: „welche Realität schaue ich gerade an?“

Siehe docs/concepts/git-model.md.


Administration & Betrieb

Mehr Details in der Admin-Dokumentation:

  • Benutzerverwaltung (Rollen ADMIN, ACCOUNTANT, VIEWER)
  • Einladungen
  • Buchhaltungsperioden (öffnen / schließen)
  • Bank-Feeds und Processor-Integration (Stripe usw.)
  • Steuerkonfiguration
  • Backup & Restore (voll portable System-Backups)
  • Self-hosted Updates (signierte Images, Updater-Sidecar)
  • Lizenzierung / Trial (30-Tage-Trial, unbefristete Lizenz nach Aktivierung)

Siehe Admin-Abschnitt sowie tiefere technische Docs in entrytwo_v1/docs/.


Was entrytwo anders macht

  • Das Git-Modell ist kein Anbau – es ist das Kern-Datenmodell.
  • Die KI soll echte Arbeit leisten (hochkonfidente autonome Commits), nicht nur vorschlagen.
  • Historie ist heilig und immer wiederherstellbar.
  • „Du besitzt deine Daten“ ist real: self-hosted, portable Backups, nach Lizenzierung nie abgeschaltet.
  • Updates sind optional und kontrolliert (unbefristete Lizenz + optionale Wartung).

Die Dokumentation ist bewusst so geschrieben, dass Menschen und KI-Assistenten diese Prinzipien und die aktuelle Implementierung verstehen können.


Wohin als Nächstes

Starte mit Installation, erstem Admin, einem echten Auszug und lass die KI ihn verarbeiten. Dann das Git-Modell-Dokument lesen – alles andere wird klarer.