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 — oder, wenn der Spieler sie vorbestellt hat, bis zum ersten Neustart ab dem gewählten Zeitpunkt.
  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.
  • Shop-Artikel überleben keinen Neustart. Spieler können eine Bestellung deshalb für einen späteren Neustart vorbestellen und ihre Artikel abholen, während sie online sind. Beim Checkout wählen sie entweder einen der kommenden Neustarts oder tragen Datum und Uhrzeit selbst ein, bis zu sieben Tage voraus. Der gewählte Zeitpunkt ist eine Untergrenze, kein exakter Termin: ausgeliefert wird beim ersten Neustart ab diesem Zeitpunkt. Pro Server abschaltbar über Spieler dürfen Bestellungen vorbestellen unter Einstellungen → Wirtschaft.
  • Aus demselben Grund gehört ein Fahrzeug nicht in ein Artikelset: Man kann es nicht aufheben, also ist es nach dem nächsten Neustart weg. Fahrzeuge werden als Spawn-Abo verkauft – siehe Fahrzeuge gehören in Abos.
  • Vorbestellungen werden weiterhin beim Checkout bezahlt und zählen sofort auf Kauflimits; stornieren lassen sie sich wie jede andere ausstehende Bestellung.

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​