Skip to content

Belege: Kategorie per Suche wählen (#1379) - #1420

Merged
firsttris merged 10 commits into
firsttris:mainfrom
Schwendilator:kategorie-suche
Nov 18, 2026
Merged

firsttris merged 10 commits into
firsttris:mainfrom
Schwendilator:kategorie-suche

Conversation

@Schwendilator

@Schwendilator Schwendilator commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Umgesetzt #1379.

Die Kategorie am Beleg, in der Aufteilung auf mehrere Kategorien und im Dauerbeleg ist kein <select> mehr, sondern ein Suchfeld auf Basis der vorhandenen Combobox (CategoryCombobox):

  • Ein Klick zeigt die ganze Liste, Tippen grenzt sie ein, auch ohne Umlaute und mit mehreren Wörtern in beliebiger Reihenfolge („burobedarf“ findet Bürobedarf, „leasing kfz“ findet Kfz: Leasing). Pfeiltasten und Enter wählen, Tab übernimmt den markierten Treffer, Escape schließt.
  • Die Treffer stehen in den Gruppen und der Reihenfolge aus Oberfläche entschlacken: Klartext zuerst, Seltenes eingeklappt, klarer nächster Schritt #1253 und nennen ihre Gruppe unter dem Namen.
  • Wer die Eingabe stehen lässt, ohne zu wählen, oder mit Escape abbricht, behält die bisherige Kategorie; ein geleertes Feld nimmt sie beim Verlassen oder mit Enter weg, auch wenn Enter gleich speichert; ohne Treffer steht „Keine Treffer“ da.
  • Was die Wahl auslöst, bleibt: am Beleg das eigene Konto und die Vorgabe zum Privatanteil, in der Aufteilung das Konto der Zeile.

Konten, Werte und Buchung ändern sich nicht. Die Direktbuchung im Bankabgleich bleibt ein <select> (eigene Gruppen und Steuersatz). Die Doku steht in docs/belege.md und DESIGN.md, die E2E-Tests wählen die Kategorie über waehleKategorie (e2e/kategorie.ts), dazu ein neuer Test für die Suche.

Geprüft

  • bun run lint, bun run typecheck, bun run build und zensical build --strict: grün.

  • Vitest (ohne und mit Postgres): grün bis auf Tests, die auch auf main rot sind (packages/import/src/fints/sitzung.test.ts, apps/web/src/server/modules/bank/fints.test.ts, deploy/backup/backup-status.test.ts). Im Lauf mit Postgres liefen einzelne andere Dateien unter Last in Zeitüberschreitungen („Hook timed out“) und bestanden einzeln. Neu: Tests zu Gruppen, Reihenfolge und Suche in KategorieGruppen.test.ts und zur Privatanteil-Vorgabe in anteil.test.ts.

  • Playwright lokal: belege-steuern, gmbh und verrechnung: 135 Tests grün, auf dem letzten Commit dieses Pull Requests.

  • Nicht lokal gelaufen: app.spec.ts (der Ablauf scheitert lokal schon auf main beim Speichern der Firmendaten) und damit alle Specs, die auf ihn aufbauen, auch barrierefreiheit.spec.ts (axe-Prüfung des neuen Felds). Das macht die CI.

  • Nachprüfung und Ergänzungen des Maintainers (eigene Commits, frische Agenten):

    • Merge von main (3c3b8a2c), Konflikt in docs/belege.md mit Umsatzsteuer: USt-IdNr. nach dem Aufbau je Mitgliedstaat prüfen (#1413) #1422 gelöst.
    • fe0d8b7e, e6803c59, c08ddb43, cb030045, a3856644, d25767db: Ein geleertes Feld und sofort Enter speicherte die alte Kategorie (Beleg und Dauerbeleg); jetzt leert Enter bei geschlossener Liste und das Verlassen. Dieselbe Kategorie nach dem Leeren wieder gewählt behält Privatanteil und Konto, Escape nach neuem Suchbegriff behält die Kategorie, Enter auf einem per Pfeil markierten Treffer wählt ihn. Jeder Fall mit einem E2E-Test, der vorher rot war; Combobox ruft ein optionales onKeyDown nur für Tasten, die die Liste nicht selbst verbraucht.
    • Zwei unabhängige Reviews der Ergänzungen, das letzte ohne Befund. Lokal: lint, typecheck, Vitest components und lib (505), Playwright belege-steuern und barrierefreiheit gegen den gebauten Server (222 grün).

Vorher und nachher

Vorher ist main auf d121d383 (v0.11.0), mit denselben Testdaten.

Vorher Nachher
Hell, Desktop
Hell, Desktop, Liste offen
Dunkel, Desktop
Dunkel, Desktop, Liste offen
Hell, Handy
Dunkel, Handy

Generated by Claude Code

Schwendilator and others added 3 commits November 18, 2026 12:02
Die Kategorie am Beleg, in der Aufteilung auf mehrere Kategorien und im
Dauerbeleg ist kein `<select>` mehr, sondern ein Suchfeld auf Basis der
vorhandenen `Combobox`: Tippen grenzt die Liste ein (auch ohne Umlaute, mehrere
Wörter in beliebiger Reihenfolge), Pfeiltasten und Enter wählen, ein geleertes
Feld nimmt die Kategorie weg. Die Treffer folgen den Gruppen und der Reihenfolge
aus firsttris#1253 und nennen ihre Gruppe. Was die Wahl auslöst (eigenes Konto,
Privatanteil-Vorgabe), bleibt. Die Direktbuchung im Bankabgleich bleibt
unverändert.

Die E2E-Tests wählen die Kategorie über `waehleKategorie`, dazu ein neuer Test
für die Suche. Doku in `docs/belege.md`.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
- `DocumentForm` wächst nicht mehr: Die Vorgabe zum Privatanteil setzt
  `privatanteilVorgabe` (`lib/anteil.ts`), beide Stellen am Beleg nutzen sie.
- `gruppeVon` liegt bei `kategorieRang` in `KategorieGruppen.ts`, mit Tests für
  „Weitere“ und die Suche nach Namen und Gruppe.
- Doku: `docs/belege.md` (Suche nach Name und Gruppe, Klick, Tab, Escape, Gruppe
  am Treffer) und `DESIGN.md` (Kategorien am Beleg sind eine Combobox).
- E2E: Pfeiltasten, Escape und Tab im Suchtest, neuer Test für die
  Privatanteil-Vorgabe nach der Wahl.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Wer in das leere Kategoriefeld tippt, den Text wieder löscht und das Feld
verlässt, rief `onChoose("")` auf, auch wenn die Kategorie schon leer war: Der
Beleg galt als geändert und ein eingetragener Privatanteil ging verloren. Das
`<select>` löste bei gleichem Wert nie aus. Der E2E-Test deckt den Fall ab.

`DESIGN.md`: Die Aussage zu `<optgroup>` gilt nur für die Kategorien der
Direktbuchung, andere Auswahlen gruppieren weiter damit.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@Schwendilator

Copy link
Copy Markdown
Contributor Author

Selbstprüfung nach Skill beitrag-pruefen, in einem frischen Agenten, auf 989e5c32. Nachträge für die späteren Commits sind gekennzeichnet.

  1. Wollen wir das? Ja. Kategorie am Beleg per Suche wählen #1379 ist mit einstieg übernommen und zugewiesen, die Gruppen aus Oberfläche entschlacken: Klartext zuerst, Seltenes eingeklappt, klarer nächster Schritt #1253 sind mit Belege: Beleg prüfen mit weniger Feldern auf einmal (#1253) #1305 gemergt, es gibt keinen doppelten Pull Request und keine neue Abhängigkeit, Tabelle oder Migration. Alle Akzeptanzkriterien sind erfüllt, belegt durch Code und E2E. Nur die axe-Prüfung und Hell/Dunkel/Handy sind lokal nicht belegt (app.spec.ts scheitert lokal schon auf main), das macht die CI.
  2. Quellen und fachlich: betrifft nicht, reine Oberfläche; Konten, Werte und Buchung bleiben.
  3. Einfachste Lösung? Ja, sie baut auf Combobox und searchOptions. Hinweis: Die Gruppenlogik lag an zwei Stellen. Die Gruppe wird mitgesucht, das fordert das Issue nicht, es steht in docs/belege.md.
  4. Regeln: zwei Befunde: DocumentForm wuchs um eine Zeile (Funktionslänge) und DESIGN.md:210 nannte noch <optgroup> für die Kategorien.

Nachtrag fb34c988: Funktionslänge behoben (privatanteilVorgabe in lib/anteil.ts, DocumentForm wächst nicht mehr), gruppeVon zu kategorieRang in KategorieGruppen.ts, DESIGN.md und docs/belege.md angepasst.
Nachtrag 89cde5a8: DESIGN.md genauer (die Direktbuchung gruppiert ihre Kategorien weiter mit <optgroup>).

Offene Fragen an den Maintainer:

  • Tab übernimmt den ersten Treffer, wie bei Kontakt und Artikel. „Eingabe ohne Wahl behält die Kategorie“ gilt, wenn es keinen Treffer gibt oder man Escape drückt. Ist das so gewollt?
  • Soll die Gruppe mitgesucht werden („Fahrzeug“ findet alle sechs Kfz-Kategorien)?
  • Nicht gemessen, nur im Code gelesen: Ein geleertes Feld nimmt die Kategorie erst beim Verlassen weg, ein Enter davor speichert die alte.

🤖 Generated with Claude Code

@Schwendilator

Copy link
Copy Markdown
Contributor Author

TDD-Review nach Skill tdd-review, in einem frischen Agenten, auf fb34c988 (beide Commits des Pull Requests). Nachtrag zu 89cde5a8 unten.

Muss vor dem Merge: keine Befunde. Ein Komponententest ist im Repo nicht möglich (@testing-library fehlt), CategoryCombobox ist deshalb über E2E abgedeckt.

Akzeptanzkriterien: Suche ohne Umlaute und mit mehreren Wörtern, Tastatur und Klick, „Eingabe ohne Wahl behält die Kategorie / geleertes Feld nimmt sie weg / Keine Treffer“, Konto und Privatanteil-Vorgabe nach der Wahl: erfüllt, je mit Test oder E2E-Schritt. Nur axe und Hell/Dunkel/Handy sind lokal nicht belegt, die CI muss barrierefreiheit.spec.ts bestätigen. Regressionen gegenüber dem <select>: keine außer dem Hinweis unten; alle drei Stellen (Beleg, Aufteilung, Dauerbeleg) sind umgestellt.

Hinweis, behoben in 89cde5a8: onBlur rief onChoose("") auch auf, wenn die Kategorie schon leer war. Wer tippt, den Text löscht und das Feld verlässt, markierte den Beleg als geändert und überschrieb einen eingetragenen Privatanteil. Jetzt löst es nur aus, wenn die Kategorie nicht leer ist; der E2E-Test Die Wahl per Suche übernimmt die Privatanteil-Vorgabe deckt den Fall ab. Der Test lief vor der Korrektur nicht rot.

Weitere Hinweise: Aufteilung und Dauerbeleg haben keine eigene Prüfung für das Leeren (der Code gleicht dem am Beleg); die Gruppensuche liefert bei kurzen Eingaben viele Treffer („büro“ zeigt alle acht aus „Büro und IT“), das ist dokumentiert.

🤖 Generated with Claude Code

@Schwendilator

Copy link
Copy Markdown
Contributor Author

Doku-Prüfung nach Skill doku-pruefen, in einem frischen Agenten, auf fb34c988 (docs/belege.md und DESIGN.md).

Muss vor dem Merge: ein Fehler, DESIGN.md:210: „<optgroup>-Gruppen gibt es nur noch in der Direktbuchung“ stimmte nicht, auch bank.tsx, DatevCard.tsx und TextBlockField.tsx nutzen sie. Behoben in 89cde5a8: der Satz nennt nur noch die Kategorien der Direktbuchung (KategorieFelder).

Bestätigt: docs/belege.md Schritt 3 (Suche nach Name und Gruppe, Klick, Pfeiltasten, Enter, Tab, Escape, Verhalten beim Verlassen, „Buchen verlangt dann wieder eine“), der Abschnitt „Kategorien“, der Dauerbeleg-Satz und der Anker #kategorien stimmen mit dem Code überein. Keine andere Stelle in docs/, im README oder in den Skills beschreibt noch das alte Auswahlfeld.

Hinweise, nicht geändert:

  • Schritt 3 in docs/belege.md ist ein langer Absatz; die Bedienung der Suche könnte ein eigener Absatz sein.
  • Ob screenshot-belege.png noch das alte Feld zeigt, ist nicht belegt; die Bilder erneuert „Update screenshots“.
  • docs/entwicklung.md:361 ist schon auf main so und nicht Teil dieses Pull Requests.

🤖 Generated with Claude Code

@Schwendilator
Schwendilator marked this pull request as ready for review November 18, 2026 12:34
@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/components/Combobox.tsx: Funktion „Combobox“ wächst von 105 auf 106 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 d25767d. Dieser Kommentar ändert sich mit jedem Push.

firsttris commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

@Schwendilator Korrektur, entschuldige: Deine Prüfungen reichen bis zum letzten Commit. Selbstprüfung, TDD-Review und Doku-Prüfung haben je einen Nachtrag zu 89cde5a8; ich hatte nur die Kopfzeilen gelesen. Du musst nichts nachholen. Wir prüfen jetzt nach und melden uns.


Generated by Claude Code

Konflikt in docs/belege.md, Schritt 3: die Kategorie-Suche aus firsttris#1420 und
„ohne passende USt-IdNr.“ aus firsttris#1422 stehen beide im Absatz.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
Wer die Kategorie am Beleg oder am Dauerbeleg leert und mit Enter speichert,
ohne das Feld zu verlassen, speichert bisher die alte Kategorie: Am Beleg
steht nach dem Neuladen wieder „Telefon“, der Dauerbeleg wird mit „Miete für
Geschäftsräume“ angelegt. Beide Tests sind rot; der Fix folgt.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
Bisher nahm erst das Verlassen des Feldes die Kategorie weg. Ein Enter davor
speicherte am Beleg, in der Aufteilung und am Dauerbeleg die alte Kategorie,
obwohl das Feld leer war. Jetzt nimmt CategoryCombobox sie beim Leeren weg;
ein Feld, das schon leer war, bleibt wie bisher unberührt.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
…t den Privatanteil

Wer die Kategorie bis aufs leere Feld löscht und dieselbe wieder wählt,
verliert seinen eigenen Privatanteil: Er springt von 35 auf die Vorgabe 20.
Wer das Feld leert, etwas anderes sucht und mit Escape ohne Wahl geht,
verliert die Kategorie ganz; vor e6803c5 blieb sie stehen. Beide Teile
sind rot; der Fix folgt.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
…rlassen

e6803c5 nahm die Kategorie schon beim Leeren weg. Wer danach dieselbe
wieder wählte, verlor Privatanteil und eigenes Konto, und wer nach dem Leeren
etwas anderes suchte und mit Escape ging, verlor die Kategorie ganz. Jetzt
übernimmt CategoryCombobox ein leeres Feld erst bei Enter, vor dem Absenden
des Formulars, oder beim Verlassen. Dafür reicht Combobox Tastendrücke über
onKeyDown vor der eigenen Behandlung weiter.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
… Enter

Wer die Kategorie leert, mit den Pfeilen dieselbe wieder markiert und Enter
drückt, hat danach ein leeres Feld: Enter nimmt erst die Kategorie weg, dann
vergleicht die Wahl mit dem alten Wert und ändert nichts. Der Test ist rot;
der Fix folgt.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
…nach dem Leeren

Combobox reichte Tastendrücke an onKeyDown vor der eigenen Behandlung weiter.
Bei offener Liste nahm Enter so erst die Kategorie weg, und die Wahl derselben
Kategorie verglich danach mit dem alten Wert und änderte nichts; das traf
Beleg, Aufteilung und Dauerbeleg. Jetzt bekommt onKeyDown nur Tasten, die die
Liste nicht selbst verbraucht hat (kein preventDefault), etwa Enter bei
geschlossener Liste vor dem Absenden des Formulars.

Refs firsttris#1379

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL

Copy link
Copy Markdown
Owner

@Schwendilator Danke für den sauberen Erstbeitrag! Die Suche baut auf der vorhandenen Combobox, Tastatur und ARIA stimmen, und die Tests sind umgestellt statt gelockert. Selbstprüfung, TDD-Review und Doku-Prüfung reichten bis zu deinem letzten Commit; das hat das Nachprüfen leicht gemacht. Wir haben den PR übernommen und fertig gemacht, deine Commits bleiben unverändert.

Zu deinen offenen Fragen: Tab übernimmt den ersten Treffer, wie bei Kontakt und Artikel, und die Gruppe wird mitgesucht. Beides bleibt so.

Deine dritte Frage hat einen echten Fehler gefunden. Der Weg zum Fix brauchte mehrere Runden, weil jedes unabhängige Review einen neuen Randfall fand. Die Ergänzungen, jede mit einem E2E-Test, der vorher rot war:

  • Merge von main (3c3b8a2): Konflikt in docs/belege.md mit Umsatzsteuer: USt-IdNr. nach dem Aufbau je Mitgliedstaat prüfen (#1413) #1422 gelöst.
  • Leeren und speichern: Wer die Kategorie leert und gleich mit Enter speichert, ohne das Feld zu verlassen, speicherte bisher die alte (Beleg und Dauerbeleg). Jetzt nimmt ein geleertes Feld sie beim Verlassen oder mit Enter bei geschlossener Liste weg.
  • Dieselbe Kategorie wieder wählen: Wer nach dem Leeren dieselbe Kategorie wieder wählt, behält Privatanteil und Konto.
  • Escape: Wer einen neuen Suchbegriff tippt und mit Escape abbricht, behält die Kategorie.
  • Pfeil und Enter: Enter auf einem per Pfeil markierten Treffer wählt ihn auch nach dem Leeren.
  • Umsetzung: Combobox hat dafür ein optionales onKeyDown, das nur für Tasten läuft, die die Liste nicht selbst verbraucht. docs/belege.md ist nachgezogen.

Lokal liefen lint, typecheck, Vitest in components und lib sowie belege-steuern und barrierefreiheit gegen den gebauten Server (222 grün). Das letzte unabhängige Review war ohne Befund. Die Beschreibung ist nachgezogen. Wir mergen, wenn die CI auf d25767d grün ist.

Als eigenes Thema, nicht für diesen PR: Der Lieferant (ContactCombobox) nimmt den Wert ebenfalls erst beim Verlassen weg.


Generated by Claude Code

@firsttris
firsttris merged commit d56f892 into firsttris:main Nov 18, 2026
26 checks passed
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.

3 participants