entrytwo
kaufen

docs / getting-started / first-steps.md

Erste Schritte

Diese Anleitung führt dich durch die ersten Minuten mit einer frischen entrytwo-Installation.

1. Erster Besuch – Initialen Admin bootstrappen

Auf einer brandneuen Instanz:

  1. App öffnen (meist http://localhost:3000 oder deine Domain).
  2. Du wirst zur Anmeldeseite umgeleitet.
  3. Existiert noch kein Admin, siehst du „Ersten Admin anlegen“.
  4. E-Mail eingeben, Standardsprache wählen (UI + Standard-Kontenplan) und absenden.

In der lokalen Entwicklung entsteht die Admin-Session sofort (Sofort-E-Mail — kein SMTP nötig).

In der Produktion zuerst SMTP und/oder OAuth konfigurieren. Nach dem Bootstrap mit Magic Link oder Google/Microsoft anmelden. ADMIN-Benutzer müssen danach TOTP (2FA) einrichten, bevor die App nutzbar ist.

Danach bist du ADMIN und hast vollen Zugriff auf die Anwendung.

Wichtig: Der erste Admin bootstrapped nur das System. Weitere Benutzer kommen per Einladung (Admin → Benutzer) und müssen die genaue eingeladene E-Mail nutzen.

2. Initiales Onboarding (Firma + Kontenplan)

Direkt nach dem ersten Admin-Login kann die App ein Onboarding-/Bootstrap-Panel zeigen (im Admin-Bereich oder automatisch beim ersten Laden).

Typischerweise setzt du:

  • Firmenname
  • Basiswährung (z. B. EUR, USD)
  • Ein Standard-Kontenplan wird geseedet (1000 Kasse, 1010 Bank, 2000 Verbindlichkeiten, 3000 Gewinnvortrag, 4000 Erlöse, 5000 Aufwendungen, plus gängige Steuersätze).

Konten, Steuersätze und Einstellungen kannst du später unter Admin anpassen.

Danach lädt die Hauptoberfläche /app.

3. Der Hauptbildschirm

Layout:

  • Links: Chat (primärer Weg, mit der KI zu sprechen und Buchungen zu erzeugen).
  • Rechts / Hauptbereich: Dynamische Panels (Dashboard, Journal, Ledger, Konten, Berichte usw.).
  • Obere Leiste: View-Umschalter, Einstellungsmenü (Zahnrad) — Admin-Links, Lizenz, Abmelden — Trial-/Lizenzstatus; Chat-Sperre am Chat-Eingabefeld.

Standardansicht ist das Dashboard mit:

  • Persistentem „Books View“-Indikator (Branch + as-of-Zustand).
  • Letzten Journalbuchungen.
  • Summary-Leiste.
  • Weiteren Schlüssel-Panels.

Views wechselst du über die Top-Navigation oder per ?view=... in der URL.

4. Chat-Grundlagen

Der Chat ist das Herz von entrytwo.

Probiere:

  • „Lade einen Beleg oder Kontoauszug-PDF mit der Büroklammer hoch und sag: Erstelle Journalbuchungen dafür.“
  • „Stimme das Konto 1100 für letzten Monat ab und erkläre Abweichungen.“
  • „Erstelle einen Kontakt Acme Corp als CUSTOMER.“
  • „Warum ist das Kassenkonto nicht null?“

Anhänge (gestagte Belege):

  • PDFs, Bilder oder CSVs an Nachrichten anhängen.
  • Sie bleiben im „pending receipt“-Zustand, bis sie in einer Journalbuchung verwendet werden.
  • So kannst du ein Dokument über mehrere Turns besprechen und dann buchen.

Chat-Sperre (Schloss-Icon am Eingabefeld):

  • Entsperrt = KI darf sichere Aktionen bei hoher Konfidenz autonom ausführen.
  • Gesperrt = KI schlägt nur vor; du musst alles bestätigen.

Viele starten entsperrt, nachdem es mit ein paar echten Dokumenten funktioniert hat, und sperren für sensible Perioden.

Details: docs/ai/ai-autonomy.md.

5. Deine erste echte Arbeit

Empfohlener erster Ablauf:

  1. Kontoauszug oder Lieferantenrechnung-PDF über die Büroklammer im Chat oder den Upload-Button oben hochladen.
  2. Die KI bitten: „Erstelle die Journalbuchungen für diesen Auszug.“
  3. Vorschläge prüfen (wenn Konfidenz zu niedrig oder Sperre an).
  4. Journalbuchung bestätigen oder bearbeiten.
  5. Konten oder Ledger öffnen, um die Wirkung zu sehen.
  6. History-Ansicht (?view=history) für Branches, letzte Zustände, Abstimmen oder Taggen nutzen.

6. Frühe Schlüsselkonzepte

  • Aktueller View (Branch + asOf): Alles, was du siehst und tust, bezieht sich auf Branch und Zeitpunkt im Indikator. Die KI respektiert das.
  • main sind die offiziellen, geschützten Bücher.
  • Andere Branches sind sichere Experimentierflächen.
  • Historie ist unveränderlich. Restore erzeugt immer einen neuen ROLLBACK-Commit.
  • KI-Aktionen bei hoher Konfidenz erzeugen echte AI_AUTONOMOUS_ENTRY-Commits (vollständig auditierbar).

Lies bald docs/concepts/git-model.md – es erklärt die Philosophie, auf der alles basiert.

7. Häufige frühe Aktionen

  • Spezifisches Konten-Ledger öffnen: Kontocode klicken oder per Chat („öffne das Ledger für 1100“).
  • Dashboard auf ein Konto filtern.
  • Vollständiges Journal: ?view=journal.
  • Git-/History-Steuerung: ?view=history.
  • Weitere Belege später über Admin oder Receipts-Panel hochladen und an Buchungen hängen.
  • Spesenabrechnungen erstellen (Belege sammeln, einreichen, freigeben, buchen).

8. Nächste Schritte

  • SMTP (Magic Link + Einladungs-E-Mail) und/oder Google- / Microsoft-OAuth konfigurieren. Team per Admin → Benutzer einladen; Anmeldung mit der eingeladenen Adresse.
  • Jederzeit abmelden über das Einstellungsmenü (Zahnrad).
  • Echte Bank-Feeds einrichten (Admin → Bank Feeds), falls Stripe oder andere unterstützte Processor.
  • Wiederkehrende Journals oder Automation einrichten.
  • Updates und Lizenzierung lesen, wenn du produktiv fährst.
  • Admin-Bereich erkunden (Benutzer, Perioden, Steuern, KI-Einstellungen, Backup usw.).

Schnelle Fehlerbehebung

  • „No admin exists“ bleibt → Prüfen, ob der erste Bootstrap wirklich geklappt hat (Logs oder Datenbank).
  • Chat tut nichts oder Fehler → LLM-Key und erreichbaren Provider/Modell prüfen.
  • Keine aktuellen Buchungen → „Refresh all“ oder Hard-Refresh.
  • Datenbankverbindungsprobleme → DATABASE_URL und laufendes/healthy Postgres prüfen.

Mehr: docs/troubleshooting/common-issues.md und intern entrytwo_v1/docs/SETUP.md.

Du hast jetzt eine laufende entrytwo-Instanz. Der Rest der Dokumentation wird mit echten Daten und diesen Schritten deutlich klarer.