Skip to content

Bank: Zahlung und Gebühr eines Zahlungsdienstleisters in einer Zeile anzeigen (#1417) - #1431

Open
JB1985 wants to merge 1 commit into
firsttris:mainfrom
JB1985:zahlung-gebuehr-zeile-1417
Open

JB1985 wants to merge 1 commit into
firsttris:mainfrom
JB1985:zahlung-gebuehr-zeile-1417

Conversation

@JB1985

@JB1985 JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Refs #1417

Bei Zahlungsdienstleistern (PayPal, Stripe, Shopify Payments, eBay) legt der Import aus einer Zeile mit Brutto und Gebühr zwei Umsätze an. Die Bankliste zeigt sie bisher getrennt, die Gebühr steht oft weit von der Zahlung entfernt.

  • Die Gebühr trägt die Referenz der Zahlung mit Anhang (-gebuehr, bei Shopify |gebuehr). Daran fasst die Liste beide zu einer Zeile zusammen (gruppiereGebuehren in @haben/core): unter dem Betrag der Zahlung steht „Gebühr −1,09 €“.
  • Gruppiert wird nur, solange beide ganz offen sind, die Zahlung ein Eingang und die Gebühr ein Abzug ist und die Referenz im Konto genau eine Zahlung und eine Gebühr trifft. Sonst (eine Hälfte schon zugeordnet, Erstattung mit gutgeschriebener Gebühr, mehrdeutige Referenz, anderes Konto, Gegenstück nicht in der Liste) bleiben beide eigene Zeilen, jede mit ihrer Zuordnung. Etsy hat keine solche Kennung und bleibt wie bisher.
  • Keine Migration, keine eigene Spalte: Umsätze, Kennungen und Altbestand bleiben unverändert (Entscheidung aus Bank: Zahlung und Gebühr eines Zahlungsdienstleisters zusammen anzeigen und zuordnen; Name und Verwendungszweck bei Stripe übernehmen #1417).
  • Tastatur (J/K) und „nächster offener Umsatz“ springen über die sichtbaren Zeilen. Die Zahl am Reiter „Offen“ zählt die Zeilen wie die Liste (Server, mit derselben Gruppierung; getestet in zahlung-gebuehr-liste.test.ts).
  • Doku: docs/bank-zahlungsdienstleister.md.

Die Regel-Prüfung meldet nur den Hinweis, dass BankPage um eine Zeile wächst.

Vorher (Stripe-Export, Zahlung und Gebühr getrennt, Screenshot aus #1417): vorher

Nachher, hell und dunkel:

Liste hell
Liste dunkel

Das Zuordnen von Zahlung und Gebühr in einem Schritt folgt im nächsten Pull Request zu #1417. Bis dahin ist die Gebühr einer offenen Zahlung in der Liste nicht einzeln anwählbar; sie erscheint als eigene Zeile, sobald die Zahlung zugeordnet ist.

Geprüft: bun run lint, bun run typecheck, bun run test packages/core apps/web/src/server/modules/bank; im Browser mit einer Demo-Instanz (Stripe-Konto mit drei Zahlungen samt Gebühr und einer Auszahlung) durchgeklickt. Nicht gelaufen: Build, E2E. Ein unabhängiges Review und eine Selbstprüfung (jeweils frischer Agent) haben Befunde geliefert, sie sind eingearbeitet (u. a. ein rohes NUL-Zeichen im Schlüssel der Gruppierung, jetzt JSON.stringify).

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

PR-Regeln

Hinweise (der Check bleibt grün, bitte trotzdem ansehen):

  • apps/web/src/routes/_app/bank.tsx: Funktion „BankPage“ wächst von 86 auf 88 Zeilen (Grenze 80): das Neue vor dem Merge in eine eigene Funktion legen (docs/entwicklung.md, Konventionen).
  • Vor dem Merge: Selbstprüfung mit beitrag-pruefen als Kommentar im Pull Request, dann ein unabhängiges Review mit tdd-review für den Code und parallel doku-pruefen für die Markdown-Dateien durch jemand anderen oder einen frischen Agenten. Die Skills liegen in .claude/skills/; fehlt eins davon, prüfen wir den Pull Request nicht (docs/mitwirken.md, Beiträge annehmen).

Was bei jeder Meldung zu tun ist: Wenn eine Prüfung anschlägt. Agenten arbeiten sie nach Skill beitrag, Schritt 6, ab.

Stand feba75e. Dieser Kommentar ändert sich mit jedem Push.

@JB1985

JB1985 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor Author

Selbstprüfung

Stand: f2cc40c. Geprüft von einem frischen Agenten ohne den Verlauf der Entstehung, nach Skill beitrag-pruefen; die Befunde sind eingearbeitet, offene stehen unten.

Wollen wir das? Ja, es ist Schritt 2 der in #1417 mit dem Maintainer abgestimmten Skizze: Gruppe aus den vorhandenen Kennungen, keine eigene Spalte, keine Migration. Ein anderer Pull Request zum Thema besteht nicht. Neu sind keine Einstellung, Abhängigkeit oder Tabelle. Bestehende Daten bleiben unverändert und gruppieren sich ohne Änderung.

Nach den Quellen gebaut, fachlich richtig? Betrifft keine Buchung, nur die Darstellung. Die Referenz-Anhänge stammen aus dem eigenen Import: PayPal und Stripe psp.ts (-gebuehr), Shopify (|gebuehr), eBay ebay.ts; Etsy hat keine und bleibt außen vor.

Einfachste Lösung? Die Gruppierung steht einmal in @haben/core (gruppiereGebuehren); Liste, Zähler und Navigation benutzen sie.

Nach unseren Regeln? Titel, Refs #1417, KI-Kennzeichnung, Doku mitgezogen, Screenshots hell und dunkel in der Beschreibung. Tests für Kern und Zähler. Lint, Typecheck und die Tests im Bankmodul grün bis auf 3 FinTS-Tests, die auch auf main fehlschlagen.

Eingearbeitet aus dem Review: ein rohes NUL-Zeichen im Schlüssel der Gruppierung (Git hielt die Datei für binär, GitHub zeigte keinen Diff), jetzt JSON.stringify; Gruppierung nur bei ganz offenen Umsätzen, damit jede Zuordnung einzeln erreichbar bleibt; keine Gruppe bei Erstattungen, mehrdeutigen Referenzen und anderen Konten; der Zähler „Offen“ zählt Zeilen.

Offen:

  1. Zwischenstand: Bis Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem Schritt zuordnen (#1417) #1432 gemergt ist, lässt sich die Gebühr einer offenen Zahlung nicht einzeln buchen (sie erscheint, sobald die Zahlung zugeordnet ist). Daher am besten zusammen mit Bank: Zahlung eines Zahlungsdienstleisters mit ihrer Gebühr in einem Schritt zuordnen (#1417) #1432 mergen.
  2. Die Regel-Prüfung meldet BankPage um eine Zeile länger; bank.tsx hat über 1800 Zeilen und wäre ein eigenes Issue wert (Liste und Panel in eigene Dateien).
  3. Der Zähler gruppiert nur Zahlungsdienstleister-Konten, die Liste jedes Konto; bei Bankkonten tritt eine Referenz mit -gebuehr praktisch nicht auf.

Erzeugt mit Claude Code.

Nachtrag, Stand feba75e: Gruppierung und Zähler nur für Konten des Zahlungsdienstleisters, Schritt 5 der Doku als Unterliste. Die Befunde der Reviews (tdd-review, doku-pruefen) stehen in den Kommentaren darunter.

Copy link
Copy Markdown
Owner

@JB1985 Wie in #1430: Die Selbstprüfung liegt vor, bis f2cc40c6. Es fehlen noch tdd-review für den Code und doku-pruefen für die Markdown-Dateien, je in einem frischen Agenten bis zu deinem letzten Commit und als Kommentar (Skill beitrag, Schritt 6). Danach prüfen wir; dieser PR kommt vor #1432.


Generated by Claude Code

@JB1985
JB1985 force-pushed the zahlung-gebuehr-zeile-1417 branch from f2cc40c to 3fb5acb Compare November 18, 2026 14:50
…anzeigen (firsttris#1417)

Der Import legt aus einer Zeile mit Brutto und Gebühr zwei Umsätze an; die
Gebühr trägt die Referenz der Zahlung mit Anhang (`-gebuehr`, bei Shopify
`|gebuehr`). Daran fasst die Bankliste beide zu einer Zeile zusammen
(`gruppiereGebuehren` in @haben/core): unter dem Betrag der Zahlung steht die
Gebühr. Das gilt, solange Zahlung (Eingang) und Gebühr (Abzug) ganz offen sind
und die Referenz im Konto genau eine Zahlung und eine Gebühr trifft; sonst
bleiben beide eigene Zeilen, damit jede Zuordnung einzeln erreichbar ist. Die
Umsätze, ihre Kennungen und die Datenbank bleiben unverändert, es gibt keine
Migration. Die Zahl am Reiter „Offen“ zählt die Zeilen wie die Liste. Das Zuordnen in einem Schritt folgt
in einem eigenen Pull Request.

Refs firsttris#1417

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@JB1985
JB1985 force-pushed the zahlung-gebuehr-zeile-1417 branch from 3fb5acb to feba75e Compare November 18, 2026 14:53
@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Code-Review (tdd-review)

Stand: 3fb5acb (frischer Agent, eigener Worktree und eigene Datenbank). Keine Findings. Kein Verdacht wurde durch einen auf diesem Stand roten Test belegt.

Geprüft: Gruppierung nur auf Konten mit Zweck zahlungsdienstleister, je Konto, nur ganz offene Umsätze, Zahlung > 0 und Gebühr < 0, mehrfache Referenzen bilden keine Gruppe; die Anhänge passen zu allen Importern (Stripe, PayPal, eBay -gebuehr, Shopify |gebuehr), Etsy bleibt unverändert. Der Zähler „Offen“ stimmt mit der Liste überein (Wegwerf-Test gegen Postgres mit Stripe-Konto, alles offen und gemischte Zustände, keine Abweichung). J/K und „nächster offener Umsatz“ laufen über die sichtbaren Zeilen.

Nicht belegt (nur mit Playwright oder sehr großen Beständen zu beweisen): eine direkt per Link geöffnete, in die Zahlungszeile eingeklappte Gebühr hat in der Liste keine markierte Zeile (J springt zur ersten); die Liste ist auf 500 Umsätze begrenzt, der Zähler nicht; openCount steht auch auf dem Dashboard und in MCP, dort zählt jetzt ebenfalls eine Zeile je Bewegung.

@JB1985

JB1985 commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

Doku-Prüfung (doku-pruefen)

Stand: 3fb5acb (frischer Agent). Keine Befunde. Schritt 5 stimmt mit dem Code überein (Anhänge -gebuehr/|gebuehr in psp.ts und ebay.ts, nur ganz offene Umsätze, Erstattungen einzeln, nur Konten des Zahlungsdienstleisters, Etsy außen vor); die früheren Befunde (Etsy-Aussage, Sammelrechnung) sind erledigt. Hinweis zur Lesbarkeit: Schritt 5 mit mehreren Fällen in einem Absatz; seitdem als Unterliste umgeschrieben (feba75e).

Copy link
Copy Markdown
Owner

@JB1985 Danke, das ist sauber gebaut und so, wie es in #1417 abgestimmt ist:

  • Die Gruppierung steht einmal in @haben/core.
  • Sie greift nur auf Konten des Zahlungsdienstleisters und nur bei ganz offenen Umsätzen.
  • Es gibt keine Migration.

Deine Selbstprüfung, tdd-review und doku-pruefen reichen bis zum Code von feba75e9; nach dem Force-Push kam nur die Unterliste in der Doku dazu. Den Text haben wir gelesen, er passt. Lokal liefen lint, typecheck und die Postgres-Tests (zahlung-gebuehr, zahlung-gebuehr-liste, bank). Die CI ist grün.

Vor dem Merge bitte noch:

  • Länge: BankPage wächst von 86 auf 88 Zeilen (Konventionen, Funktionen über ~80 Zeilen werden geteilt). Ein Weg, den wir lokal ausprobiert haben: useGebuehrZeilen bestimmt die Konten der Zahlungsdienstleister und den Index selbst, und der Betrag samt Gebühr kommt in eine kleine Komponente UmsatzBetrag in BankGebuehr.tsx. Danach meldet bun scripts/pr-regeln/pruefen.ts nichts mehr. Bitte als eigenen Commit obendrauf, nicht per Force-Push. Force-Push nur nach einem Merge von main (Mitwirken), dann bleibt Red → Green sichtbar.

Vorschläge, gern hier oder als eigenes Issue:

Gemergt wird #1431 zusammen mit #1432, weil allein die Gebühr einer offenen Zahlung nicht einzeln anwählbar ist. Zu #1432 kommt gleich ein eigener Kommentar.


Generated by Claude Code

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants