docs(handoff): Dashboard-Plan, Qonto-API und Accountable-Export verifiziert
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wd9aeEvgYF6ZmZGc5PTULK
This commit is contained in:
parent
807eff7d88
commit
20cb434932
1 changed files with 26 additions and 0 deletions
26
handoffs/handoff-2026-11-16-dashboard.md
Normal file
26
handoffs/handoff-2026-11-16-dashboard.md
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
# 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.
|
||||
Loading…
Add table
Reference in a new issue