c-stone-invoice-check/handoffs/handoff-2026-11-16-dashboard.md
2026-11-16 12:09:04 +01:00

3 KiB

Handoff 16.11.2026 — Finanz-Dashboard (Plan freigegeben)

Auftrag (Markus, freigegeben 16.11.)

Dashboard mit frei wählbarem Zeitraum: Einnahmen je Kunde, Ausgaben je Kategorie, Überschuss, Belegprüfung (Buchungen ohne Beleg, ausgenommen Miete + Bankgebühren) mit Liste. Abgleich Bank (Qonto) ↔ Buchhaltung (Accountable). Ablauf: Markus loggt sich zu Beginn in Accountable ein, App zieht Daten selbst. KI für Belege/Unklares: Claude Haiku über Bedrock eu-central-1 (Fallback DeepSeek über hostyourai).

Architektur (Plan)

  • tools/abruf.py (Mac): Qonto per API; Accountable per Playwright headed — Markus loggt selbst ein, Skript setzt Filter, klickt Export (Excel) für Ausgaben + Einnahmen, lädt Ergebnis ins Backend. KEIN Abgreifen von Tokens/Headern (Auto-Mode blockt das, zu Recht).
  • backend/routers/dashboard.py + Tabelle buchung (Alembic-Migration), backend/ki_abgleich.py (Haiku).
  • frontend/src/Dashboard.tsx + Menüpunkt in App.tsx.
  • Nicht anfassen: Picker, Grabber, Mail-Abruf, bestehende Tabellen. Kein claude.ai-Artifact (Kundennamen → US).

Verifiziert

  • Qonto-API: Secrets QONTO_LOGIN, QONTO_SECRET_KEY im Vault invoice-check (Markus eingetragen). with-secrets.sh invoice-check …, Header Authorization: $QONTO_LOGIN:$QONTO_SECRET_KEY, GET https://thirdparty.qonto.com/v2/organization (Konto „Hauptkonto“ aktiv), GET /v2/transactions?bank_account_id=…&per_page=100&settled_at_from/to (paginiert, meta.total_pages). Felder u. a. amount, local_amount, local_currency (USD bei Whop), label, clean_counterparty_name, settled_at, side, category, attachment_ids.
  • Accountable-Export: Ausgaben → Zeilen auswählen (oder „Gefilterte Ergebnisse“) → Export → „Excel-Export“ → ZIP mit Daten.xlsx.
    • Blatt „Ausgaben“: Buchungsdatum, Name Des Lieferanten, Gesamtbetrag, Währung, Buchungscode, Codebeschreibung (=Kategorie), Storno-Rechnung, Kontobewegungen (Bankverknüpfung als Text „Datum | Name | Betrag“), Bezahlt, Dokument Vorhanden (Ja/Nein), Überprüft u. a.
    • Blatt „Kontobewegungen“: Datum, Kontonummer, Verwendungszweck, Betrag, Name, Beleg Oder Rechnung Zugeordnet? — enthält auch privates Girokonto → nach Kontonummer filtern.
    • Blatt „Kunden“: Kundenstamm (personenbezogen, nur lokal/NucBox).
    • Einnahmen-Export noch nicht getestet (gleiches Muster auf /incomes erwartet).
  • Vorsicht UI: Klick neben Kopfzeile kann Zeilen auswählen → Leiste mit „Löschen“ erscheint. Immer Auswahl wieder aufheben.

Auffällig (Markus fragen)

  • Neue Ausgabe „Lufthansa Group“ 16.11.2026, 8.621,40 €, Kategorie Flüge, Status „Überprüfen“.
  • USt-Status in Accountable = Kleinunternehmer.

Offen Belege (Stand 16.11. mittags)

Whop 16,75 /15,74 Verknüpfung neu ordnen; Amazon 30.10 8,99 € (D01-9711889-7842249) braucht Ausgabe+Beleg; IONOS-Rechnungen Juli/Aug (10,47/14,39, als „Deepl Se“ gebucht → Lieferant ändern); Udemy 117 €; Contabo 24,40 vs 25,19; Coursera; Meta; Rest s. handoff-2026-11-15-2230.md.