Wallets — Systembeschreibung

Datenmodell der Wallets und ihrer Einträge, Rolle des zentralen Wallet-Dienstes, Regeln der manuellen Korrektur, Inhaltsberechtigung und Berechtigungsschlüssel.

Überblick

Liste der Geldguthaben (Wallets): Saldo, reservierter Betrag und Einträge (Journal) der Wallet eines Mandanten oder Benutzers. Eine Wallet ist Geld, kein Kontingent. Die Einträge führt der zentrale Wallet-Dienst des Systems (Aufladung, Zahlung, Reservierung, Storno, Ablauf); dieses Modul zeigt sie an und erfasst manuelle Korrekturen.

Datenmodell

Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.

TabelleZweckHauptfelder
walletdie WalletInhabertyp (client oder user), Inhaber, Währung, Saldo, reservierter Betrag, Status
wallet_transactionWallet-Eintrag (Journal)Ereignis, Betrag, Währung, Quelltyp, Referenz, Zustand, Ablauf, Datum, ausführender Benutzer
companyName und Unternehmensgruppe eines Mandanten-InhabersFilter und Anzeige

Ablauf

  1. Liste: Filter nach Unternehmensgruppe, Inhabertyp, Inhaber, Währung, Status; Sortierung nach Inhaber, Saldo oder Währung; je Zeile Saldo, reserviert, Negativ-Kennzeichen, Anzahl der Einträge.
  2. Aufklappen der Einträge: nur für eine erlaubte Wallet.
  3. Manuelle Korrektur: Die Korrekturmethode des zentralen Dienstes schreibt mit Ereignis MANUAL_ADJUSTMENT, Quelle source_type = manual, der angegebenen Referenz und dem ausführenden Benutzer; ein negativer Betrag geht nur durch, wenn der Saldo ihn deckt.

Berechtigungen

  • Ebene 1: Die manuelle Korrektur prüft das Änderungsrecht des Pfads nicht.
  • Ebene 2: list, topup (manuelle Gutschrift und Belastung), debug. Der Menüpunkt erscheint, wenn die Funktion list zugewiesen ist. Keiner der Schlüssel steht im Funktionskatalog; praktisch erhält sie daher nur der Super-Admin.
  • Ebene 3: Ein Benutzer ohne Super-Admin-Rechte sieht nur client-Wallets erlaubter Firmen; Benutzer-Wallets sieht nur der Super-Admin; auch Einträge und Korrekturen laufen nur auf erlaubten Wallets.

Bekannte Einschränkungen

  • Der Endpunkt der manuellen Korrektur prüft Funktionsrecht und Inhaltsberechtigung, nicht aber das Änderungsrecht des Pfads.