Skip to content

feat(categories): Farbe als Feld, Haupt- und Unterkategorien, Fahrradbörse nach Leitfaden (#300) - #307

Merged
Garaz08 merged 6 commits into
developmentfrom
feat/categories-300
Nov 18, 2026
Merged

Garaz08 merged 6 commits into
developmentfrom
feat/categories-300

Conversation

@Garaz08

@Garaz08 Garaz08 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Closes #300

Farbe als Feld

  • Neues Kategorie-Feld color („Farbe“) für Fahrräder, Kleidung und Sport, in Rust und TS gespiegelt, Übersetzungen de/en
  • Über requiredFields als Pflicht wählbar; erscheint automatisch im Nachweis (PDF/CSV), bei der Annahme und auf dem Verkäuferausdruck (alle nutzen describeAttributes)

Haupt- und Unterkategorien

Damit die Listen kurz bleiben, gibt es eine Ebene Unterkategorien (parent_id gab es schon, war aber nirgends setzbar). Standard-Baum: 12 Hauptkategorien mit 60 Unterkategorien:

Hauptkategorie Unterkategorien
Kleidung Babykleidung, Kinderkleidung, Damenkleidung, Herrenkleidung, Umstandsmode
Schuhe Kinderschuhe, Damenschuhe, Herrenschuhe, Sportschuhe
Sport Ski & Snowboard, Skischuhe, Sportbekleidung, Helme & Protektoren, Ballsport, Fitness, Camping & Outdoor
Fahrräder Kinderfahrräder, Lastenräder, E-Bikes & Pedelecs, Fahrradanhänger, Fahrrad-Kindersitze, Fahrradzubehör
Kinderfahrzeuge (neu) Laufräder, Roller & Scooter, Einräder, Bobbycars & Rutschfahrzeuge, Kinderwagen & Buggys
Elektronik Handys & Smartphones, Computer & Tablets, Foto & Kamera, Konsolen & Videospiele, Audio & HiFi
Bücher Kinderbücher, Romane, Sachbücher, Kochbücher, Comics
Spielzeug Babyspielzeug, Puppen & Plüsch, Lego & Bausteine, Brett- & Kartenspiele, Outdoor-Spielzeug
Möbel Kindermöbel, Wohnzimmermöbel, Schlafzimmermöbel, Büromöbel, Gartenmöbel
Haushalt Küche & Kochen, Dekoration, Heimtextilien, Werkzeug & Garten
Accessoires Taschen & Rucksäcke, Schmuck & Uhren, Mützen & Schals, Sonnenbrillen, Gürtel
Sonstiges Musikinstrumente, Filme & Musik, Basteln & Handarbeit, Sammeln
  • DEFAULT_CATEGORIES als Baum; Seed legt Hauptkategorien vor ihren Unterkategorien an und in fester Reihenfolge (alle Seeds teilen sich sonst ein now(), die Listen sortieren nach created_at)
  • Migration 0032_more_categories.sql: nur auf Instanzen mit den Standard-Kategorien („Fahrräder“ existiert). Legt nur die neuen an (gelöschte Standard-Kategorien bleiben gelöscht), hängt Standard-Unterkategorien unter ihre Hauptkategorie (nur wenn sie oben stehen und selbst keine Unterkategorien haben) und ordnet die Standard-Kategorien. Mit PGlite geprüft: Instanz mit Standard-Kategorien, eigener Unterkategorie und gelöschter Kategorie, sowie leere Instanz
  • Admin, Hauptkategorie: im Dialog wählbar (anlegen und bearbeiten). Das Backend hält es bei einer Ebene: category.parentNotMain, category.hasSubcategories
  • Listen: Im Basar-Formular nur Hauptkategorien mit Zähler (z. B. 4/6); ein Klick wählt die Gruppe ganz an oder ab, über den Pfeil einzeln. Artikel-Auswahl und Filter rücken Unterkategorien ein; der Filter auf eine Hauptkategorie zeigt auch ihre Unterkategorien. Basarseite, Übersicht und Vorschau nennen eine ganz gewählte Hauptkategorie statt aller Unterkategorien
  • Vorauswahl der Vorlagen: Eine passende Hauptkategorie bringt ihre Unterkategorien mit, außer was die Vorlage ausschließt (categoryExclude: z. B. Damen-/Herrenkleidung und Romane beim Kinderbasar, Kinderwagen bei der Fahrradbörse)

Zusatzfelder selbst wählen (Admin)

  • Neue Spalte categories.fields text[] (Migration 0033). NULL = wie bisher nach dem Namen; sonst die gewählten Felder aus einem festen Katalog (SELECTABLE / SELECTABLE_FIELDS): Rahmennummer, Rahmengröße, Laufradgröße, Marke, Farbe, Größe (Kleidung / Schuhe EU / Sport), Modell. Höchstens eine Größe, weil alle denselben Schlüssel haben
  • Backend prüft die Auswahl (category.unknownField, category.oneSize) und speichert sie in Katalog-Reihenfolge. Alle Stellen, die Felder auflösen (Anlegen, Nachweis, Quittung, Annahme …), nutzen sie; Unterkategorien ohne eigene Auswahl und ohne passenden Namen erben
  • Admin-Dialog: Schalter „Zusatzfelder selbst wählen“, startet mit den Feldern des Namens; Tabelle markiert „Selbst gewählt“. Warnung, wenn sich die Felder einer benutzten Kategorie ändern
  • Ein Name, den eine Regel bewusst ausschließt, hat keine Felder statt zu erben, sonst bekäme „Fahrradanhänger“ unter „Fahrräder“ die Rahmennummer

Vorlage Fahrradbörse nach Leitfaden

Wie besprochen bleibt es bei einer Vorlage; die Doku wird angepasst: BazarPro/docs#18

Leitfaden Vorlage bikeExchange
Fotos Pflicht ✓
Verhandlungsbasis, Preisvorschläge, Fragen an ✓
Preis auf dem Etikett an ✓
Rahmennummer als Pflichtangabe neu requiredFields: ['frameNumber']
Annahmegebühr z. B. 3 € pro Rad neu intakeFee: 3
Rad-Kategorien vorausgewählt ✓, jetzt auch Kinderfahrzeuge
Markt mit Nachweis keine eigene Vorlage mehr: Doku beschreibt „Nur Privatverkäufer“, „Feste Daten“ und Artikel pro Verkäufer als Schalter

Highlight der Vorlage: „Große Etiketten“ → „Rahmennummer Pflicht“.

Überarbeitung: Felder als Daten, Artikel in Unterkategorien, erlaubte Kategorien

  • Zusatzfelder selbst festlegen: neue Tabelle category_field_definitions (Migration 0034) mit den bisherigen Feldern. Admins legen Felder an und bearbeiten sie im Reiter „Zusatzfelder“: Name, Beispiel und Hinweis, jeweils auf Deutsch und Englisch, dazu „Kurzer Wert“ (höchstens 7 Zeichen, passt aufs Etikett). Kategorien wählen daraus; Unterkategorien übernehmen „Wie Hauptkategorie“ oder wählen selbst. Die alten Namensregeln überträgt 0034 einmalig auf die bestehenden Kategorien (auf einer Instanz mit den alten Kategorien geprüft); danach gibt es keine Namensregeln mehr
  • Mehr Fahrradarten: Cityräder & Hollandräder, Trekkingräder, Mountainbikes (MTB), Rennräder & Gravelbikes, BMX & Dirtbikes, Falträder & Klappräder, Kinder- & Jugendräder. Außerdem „Baby & Kind“, „Freizeit & Hobby“ und in jeder Hauptkategorie ein „Weitere …“, weil Artikel jetzt in Unterkategorien gehören
  • Hauptkategorien nicht wählbar: Hat eine Kategorie Unterkategorien, nimmt sie keine Artikel auf (product.chooseSubcategory). Im Artikelformular zeigt die Auswahl erst die Hauptkategorien; ein Klick klappt die Unterkategorien auf
  • Erlaubte Kategorien: Ein Basar nimmt nur Artikel aus den Kategorien, die er erlaubt, oder aus deren Unterkategorien (product.categoryNotAllowed). Das gilt beim Anmelden zum Basar, für Artikel von Spontan-Verkäufern und wenn ein angemeldeter Artikel seine Kategorie wechselt. Im Artikelformular bietet die Auswahl nur an, was die gewählten Basare nehmen. Beim „Artikel zum Basar hinzufügen“ sind die übrigen gesperrt
  • Basar-Einstellungen: eine Zeile pro Hauptkategorie mit Checkbox (alle, teilweise, keine), aufklappbar für einzelne Unterkategorien, dazu „Alle“ und „Keine“. Ist eine Hauptkategorie ganz gewählt, wird nur sie gespeichert; später ergänzte Unterkategorien sind dann mit erlaubt
  • Admin-Seite: Hauptkategorien zum Aufklappen; „+ Unterkategorie“ legt direkt darunter an
  • Demo: Artikel bekommen passende Unterkategorien, die Demo-Basare erlauben, was sie verkaufen

Tests

  • vitest: 776 grün (Tests der alten Namensregeln ersetzt), neue Tests für Kategorie-Auswahl, Basar-Auswahl, Admin-Seite und Zusatzfelder
  • cargo test --lib, cargo clippy -D warnings, cargo fmt --check, tsc, eslint, prettier: grün
  • Lokal mit Postgres 17: cargo test (331 API-Tests, neu: Felder verwalten, Unterkategorie Pflicht, erlaubte Kategorien) und Playwright Chromium (42) grün

🤖 Generated with Claude Code

…ke template per guide (#300)

- New category field "color" for bikes, clothing and sports gear; it can be
  made required and shows in the record (PDF/CSV) and at intake
- Default categories for bike sales and children's bazaars: children's bikes,
  balance bikes, scooters, unicycles, ride-on toys, cargo bikes, e-bikes,
  bike trailers, child bike seats, bike accessories; migration 0032 adds them
  where the default categories are in use
- Unicycles and child seats no longer get the bike fields (no frame number)
- Children's vehicles are preselected for the children's bazaar and the bike
  sale; the bike sale template requires the frame number and has a €3 intake
  fee, as in the guide "Fahrradbörse organisieren"

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

🚀 Review-App

https://review-307.bazarpro.de

Modus: platform (wie bazarpro.de). Self-Hosting testen: Label review:single setzen.

Stand: 31ae891 · Demo-Daten aus dem Seed, alle Konten mit Passwort 123456:

Rolle Konto
Admin admin@bazarpro.de
Veranstalter user1@bazarpro.de
Verkäufer seller@bazarpro.de
Käufer kaeufer1@bazarpro.de, kaeufer2@bazarpro.de

Laufendes Event mit allen Funktionen: Fahrradbörse Bürgerhalle (alle Funktionen).

📬 Alle Mails der Review-App: https://review-307-mail.bazarpro.de (Benutzer review, Passwort aus dem Secret REVIEW_MAIL_PASSWORD)

Die Review-App wird beim Schließen des Pull Requests entfernt.

)

- Default tree: "Fahrräder" with children's and cargo bikes, e-bikes,
  trailers, child seats and accessories; new main category
  "Kinderfahrzeuge" with balance bikes, scooters, unicycles, ride-on toys.
  Migration 0032 builds it on instances with the default categories and
  fixes their order (seeded categories shared one creation time)
- Admins pick the main category when creating or editing; the backend keeps
  it one level deep (category.parentNotMain, category.hasSubcategories)
- A label a field rule excludes on purpose has no fields, so "Fahrradanhänger"
  below "Fahrräder" does not inherit the frame number
- Grouped lists: the bazaar form shows main categories that select their
  sub-categories and open to pick them one by one; item form and filters
  indent sub-categories; a filter on a main category includes them; bazaar
  pages name a fully chosen main category instead of all its children

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Garaz08 Garaz08 changed the title feat(categories): Farbe als Feld, Kategorien für Kinderfahrzeuge, Fahrradbörse nach Leitfaden (#300) feat(categories): Farbe als Feld, Haupt- und Unterkategorien, Fahrradbörse nach Leitfaden (#300) Nov 18, 2026
@Garaz08 Garaz08 closed this Nov 18, 2026
@Garaz08 Garaz08 reopened this Nov 18, 2026
@Garaz08 Garaz08 closed this Nov 18, 2026
@Garaz08 Garaz08 reopened this Nov 18, 2026
… extra fields (#300)

- Default tree with 12 main and 60 sub-categories, e.g. baby, children's,
  women's and men's clothes, ski and ball sports, phones and consoles,
  novels and children's books, Lego and board games, prams; migration 0032
  adds them where the default categories are in use
- Admins choose the extra fields of a category from a fixed list (frame
  number, frame and wheel size, brand, color, one kind of size, model) or
  leave them to the name as before; stored in categories.fields (0033),
  checked by the backend (category.unknownField, category.oneSize) and used
  everywhere fields are resolved, sub-categories inherit them
- Kinds of bazaars preselect a matching main category with its
  sub-categories, minus what they exclude (women's clothes at a children's
  bazaar, prams at a bike sale)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The demo seed deletes the categories of a fresh instance and created only its
eleven flat main categories, so review apps showed no sub-categories. It now
adds the whole default tree in the language of the demo, the same way the
first start of the server does (categories::insert_default_tree).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Garaz08 Garaz08 closed this Nov 18, 2026
With the sub-categories in the demo data, "Sport" also matched "Sportschuhe"
and "Ballsport", "Fahrräder" also "Kinderfahrräder".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…owed categories enforced (#300)

- Extra fields are data: admins add and edit them (name, example, hint, each
  in German and English, short values for labels) in a new "Extra fields"
  tab; categories pick from them, sub-categories take their main category's.
  Migration 0034 creates category_field_definitions with the fields so far
  and turns the old name rules into each category's own choice
- Default tree: more kinds of bikes (city, trekking, MTB, road & gravel,
  BMX, folding, children's & youth), "Baby & Kind", "Freizeit & Hobby" and a
  "Weitere …" in every main category; items go into sub-categories, a main
  category with sub-categories only groups them (product.chooseSubcategory)
- Bazaars only take items of the categories they allow, or of a sub-category
  of one (product.categoryNotAllowed): when announcing, for walk-in items and
  when the category of an announced item changes
- Item form: the category picker opens a main category to its
  sub-categories and only offers what the chosen bazaars take; adding items
  to a bazaar locks those it does not take
- Bazaar settings: one row per main category with a checkbox for all of it,
  opened to pick single sub-categories; a fully chosen main category is
  stored as itself, so sub-categories added later are allowed too
- Admin page: main categories open to their sub-categories, a sub-category
  is added right below its main category
- Demo items get fitting sub-categories, demo bazaars allow what they sell

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Garaz08
Garaz08 merged commit 8c5769e into development Nov 18, 2026
14 checks passed

This branch was previously deployed

1 inactive deployment
review — 31ae8912 Deployed Nov 18, 2026 by Garaz08 via deploy-review #735
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.

1 participant