Zum Hauptinhalt springen

Shopsystem

Diese Seite erklärt, wie der Shop aus betrieblichen Gesichtspunkten funktioniert: Was Spieler kaufen können, was Admins verwalten und wie Lieferung sowie Folgeaktionen ablaufen.

Für zielgruppenspezifische Anleitungen siehe auch:

Umfang und Verfügbarkeit​

  • Einige abobezugene Aktionen erfordern andere Berechtigungen als Kaufaktionen.

Wichtige Zugriffsrechte, die in Shop-Workflows verwendet werden:

  • Spielershop: shop.access, shop.checkout, optional shop.see_unavailable
  • Shop-Administration: itemsets.*, orders.*
  • Aboabläufe: subscriptions.use (Spieler), subscriptions.view_active / subscriptions.edit_active / subscriptions.view_available (Admin)

Hauptbestandteile​

  • Katalog und Kategorien
    • Spieler durchsuchen die Artikelkategorien und Artikelsätze.
    • Wenn ein Server keine Artikelkategorien hat, zeigt der Katalog eine flache Artikelsatzliste ohne Kategorienavigation.
    • Wenn Kategorien existieren, werden nicht kategorisierte Artikelsätze in einem Abschnitt Nicht kategorisiert gruppiert.
    • Die Verfügbarkeit und Kauflimits können je Spieler/Gruppe unterschiedlich ausfallen.
  • Bestellungen
    • Bestellungen werden beim Checkout erstellt und durchlaufen Statusänderungen (ausstehend, geliefert, erstattet, storniert).
  • Abonnements
    • Aboangebote können aktiviert und im Laufe der Zeit verwaltet werden.
    • Abos können Spielern oder Fraktionen gehören.

Lebenszyklus von Bestellungen​

  1. Spieler (oder Admin) erstellt eine Bestellung.
  2. Die Bestellung bleibt ausstehend bis zum nächsten von dzbot verwalteten Neustart.
  3. Während des Neustarts werden ausstehende Lieferungen verarbeitet.
  4. Nach erfolgreicher Verarbeitung werden ausstehende Bestellungen als geliefert markiert.
  5. Wenn die Verarbeitung fehlschlägt, wird die Bestellung nicht fälschlicherweise als geliefert markiert.

Wichtiges Verhalten:

  • Stornierte Bestellungen werden nicht geliefert.
  • Lieferungen sind an von dzbot verwaltete Neustarts gebunden, nicht an das Browsen oder den Checkout.

Lebenszyklus von Abonnements​

  1. Spieler oder Admins erstellen/aktualisieren Abonnements.
  2. Aktive Abos werden während Neustartzyklen angewendet.
  3. Bezahlte Abos werden gemäß der Serverkonfiguration abgerechnet.
  4. Wenn ein Anwendungszyklus fehlschlägt, verhindern Sicherheitsmechanismen inkonsistente Abrechnungs-/Lieferzustände.

Modell für Rückerstattungen und Neulieferungen​

  • Spielerabbruch (Selbstbedienung)
    • Nur vor der Lieferung erlaubt.
    • Der volle Bestellbetrag wird dem Spielerkonto gutgeschrieben.
  • Admin-Rückerstattung
    • Nur für gelieferte, nicht stornierte Bestellungen erlaubt.
    • Kann teilweise nach Artikelmenge erfolgen.
  • Admin-Neulieferung
    • Nur für gelieferte Bestellungen erlaubt.
    • Erstellt eine Folge-Lieferung für berechtigte Mengen.

Betriebsnotiz zu Neustarts​

Wenn deine Community auf Shop-Lieferungen angewiesen ist, sollten Neustartvorgänge über dzbot durchgeführt werden. Dies gewährleistet konsistente Lieferung und Abonnementverarbeitung.

Für konsistente Lieferungen und Aufräumarbeiten führe manuelle und geplante Neustarts über dzbot aus. Vermeide die Kombination von Neustart-Tools für shop-kritische Server.

Verwandte Dokumentation​