Buch III — Sachbearbeiter:in (Backoffice)

Quelle: source-of-truth/handbooks/appliance/backoffice.md.

Dieses Buch ist der Arbeitsfaden für das Shopware-Backoffice: KYC, Produkt- und Media-Redaktion, Auktion, Listing, Bids, Award, Records, Mailarchiv und Fulfillment.

Einstieg

1. Shopware Admin öffnen: lokal https://shop.officina-del-caffe.ddev.site/admin.
2. Mit Backoffice- oder Admin-Seed-User anmelden.
3. Ggf. Officina-Verkaufskanal im ShopId-/Sales-Channel-Dialog wählen.
4. Navigation prüfen: Produkte, Kunden/KYC, Auktionen, Records/Akten, Mailarchiv.

Redaktioneller Komplettlauf

1. Import über Maschinennummer oder Inventarnummer suchen.
2. Produktdaten, Beschreibung, Kategorie und technische Daten ergänzen.
3. Hero-Bild, Detailbilder und Akten-Dokumente hochladen; Thumbnails in der Produktliste prüfen.
4. Listing mit Startpreis, Mindestgebot, Increment, Standort und Veröffentlichung prüfen.
5. Auktion mit Zeitfenster und verknüpften Listings erstellen.
6. Auktion und Listing live schalten, danach Storefront öffnen.
7. Record/Event-Historie prüfen.

KYC und E-Mails

Schritt	Aktion	Mail
Registrierung	Käufer:in registriert sich	REGISTRATION_PENDING_BUYER
Backoffice-Task	Neue Prüfung sichtbar	REGISTRATION_PENDING_BACKOFFICE
Freigabe	KYC akzeptieren	REGISTRATION_APPROVED
Ablehnung	KYC ablehnen	REGISTRATION_REJECTED

Bids, Award und Negativpfade

Aktion	Ergebnis
Zuschlag erteilen	Gewinner-Mail, Loser-Mails, Listing SOLD, Order-Erzeugung.
Auktion abbrechen	Betroffene Gebote invalidiert, AUCTION_CANCELLED.
Inserat zurückziehen	Gebote auf Listing invalidiert, LISTING_WITHDRAWN.
Gebot invalidieren	Bieter-Mail BID_INVALIDATED, Höchstgebotslage prüfen.
Award widerrufen	BID_AWARD_REVOKED, Order-/Fulfillment-Folge manuell klären.

Disabled Actions sind Schutzlogik. Tooltip oder Fehlermeldung muss erklären, ob Zeitfenster, Listing-Status, fehlendes führendes Gebot, ACL oder ein abgeschlossener Zustand blockiert.

Fulfillment und Mailarchiv

Nach Award erzeugt das Contracting-Plugin eine Shopware-Order. Das Backoffice disponiert Lieferung oder Abholung und führt Delivery-State-Änderungen bis zum Abschluss. Der ERP-Outbound muss in der ERP-Inbox sichtbar sein.

Für SCD-Abnahmen immer zwei Belege prüfen: EmailDispatchRecord mit Entity-Bezug und gerenderter Inhalt im Frosh-Mail-Archiv.

Admin-Readiness-Gates

Gate	Risiko	Vor SCD prüfen
Document-Type-Routing	Records/Akten öffnen ggf. falsche Route.	Produkt- und Listing-Akte öffnen.
Backoffice-ACL	Sachbearbeiterrolle sieht Records/Akten ggf. nicht.	Mit Backoffice-Seed-User prüfen, nicht nur Superadmin.
KYC-Route	Detailroute muss ACL-Guard respektieren.	Route-Pattern /customer/kyc/{id} mit eingeschränkter Rolle öffnen; erwartet ist Login/403, nicht leere Detailseite.
Auction-Detail-Fehler	Ladefehler dürfen nicht als Create-Mode erscheinen.	Ungültige ID darf nicht als Create-Mode erscheinen.
Action-Button-UX	Disabled/Tooltip-Verhalten ist kritisch.	k07-admin-action-disabled-tooltip ausführen und Disabled Reason gegen Live-UI prüfen.