Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
platform-admin-tips [2026/10/22 08:09] – adminwikiplatform-admin-tips [2026/10/22 08:28] (aktuell) – [Abonnements konfigurieren] adminwiki
Zeile 1: Zeile 1:
 ===== Plattform Admin-Tipps ===== ===== Plattform Admin-Tipps =====
  
 +{{INLINETOC 3}}
  
 ==== Abonnements konfigurieren ==== ==== Abonnements konfigurieren ====
  
-**Leitfaden: Produkt-Konfiguration im neuen Abo-System (Entitlements & Credits)**+**Leitfaden: Produkt-Konfiguration im Abo-System (Entitlements & Credits)**
  
 Mit dem "Credit & Entitlement"-Architektur konfigurieren wir Produkte im Backend so, dass sie unsere interne Business-Logik (Kosten, Gutschriften, Feature-Freischaltungen) direkt steuern. Das System unterstützt dabei nahtlose Wechsel zwischen verschiedenen Ausbaustufen (Upgrades und Downgrades). Mit dem "Credit & Entitlement"-Architektur konfigurieren wir Produkte im Backend so, dass sie unsere interne Business-Logik (Kosten, Gutschriften, Feature-Freischaltungen) direkt steuern. Das System unterstützt dabei nahtlose Wechsel zwischen verschiedenen Ausbaustufen (Upgrades und Downgrades).
Zeile 18: Zeile 19:
  
   * **''billingInterval'' (Zyklus)**: Optional. Gibt an, ob es sich um ein Abo handelt (z. B. ''"month"'' oder ''"year"'').   * **''billingInterval'' (Zyklus)**: Optional. Gibt an, ob es sich um ein Abo handelt (z. B. ''"month"'' oder ''"year"'').
-  * **''additionalProperties'' -> ''subscriptionInfo'' (Das Feature-Herzstück)**: Ein JSON-Objekt, das definiert, was das `Entitlement` (internes Abo) dem Nutzer exakt freischaltet.+  * **''additionalProperties'' -> ''subscriptionInfo'' (Das Feature-Herzstück)**: Ein JSON-Objekt, das definiert, was das ''Entitlement'' (internes Abo) dem Nutzer exakt freischaltet.
  
-=== 2. Aufbau der ''subscriptionInfo'' (JSON) ===+=== 2. Aufbau der subscriptionInfo (JSON) ===
  
 Die ''subscriptionInfo'' steuert direkt die Berechtigungen (''HostFeature'') des Nutzers. Die ''subscriptionInfo'' steuert direkt die Berechtigungen (''HostFeature'') des Nutzers.
Zeile 30: Zeile 31:
     * **Number (''Integer''):** Das Backend kombiniert den Key und die Number zu einem neuen Flag-String (z. B. ''"host.licences.visualizer": 3'' wird zu ''host.licences.visualizer3 = "true"'').     * **Number (''Integer''):** Das Backend kombiniert den Key und die Number zu einem neuen Flag-String (z. B. ''"host.licences.visualizer": 3'' wird zu ''host.licences.visualizer3 = "true"'').
  
---- 
  
-## 3. Konfigurations-Beispiele 
  
-### Fall A: Ein reguläres Feature-Abo (z. B. Visualizer Level 3)+=== 3. Konfigurations-Beispiele === 
 + 
 +== Fall A: Ein reguläres Feature-Abo (z. B. Visualizer Level 3) == 
  
 Ein typisches Produkt für den Neueinstieg oder für Level-Wechsel (Up- und Downgrades). Ein typisches Produkt für den Neueinstieg oder für Level-Wechsel (Up- und Downgrades).
  
-* **''creditPrice'':** ''50'' (Kosten bei Wallet-Zahlung / Äquivalent-Wert bei Stripe-Zahlung für Währungswechsel und spätere Refunds) +  * ''creditPrice'': ''50'' (Kosten bei Wallet-Zahlung / Äquivalent-Wert bei Stripe-Zahlung für Währungswechsel und spätere Refunds) 
-* **''billingInterval'':** ''"month"'' +  * ''billingInterval'': ''"month"'' 
-* **''subscriptionInfo'':** +  * ''subscriptionInfo'': 
-``` +
-{+
   "subscriptionInfo": {   "subscriptionInfo": {
     "type": "visualizer",     "type": "visualizer",
Zeile 51: Zeile 52:
     }     }
   }   }
-} 
  
-``` 
  
-**Was passiert?** Das Backend bucht das Entitlement auf Typ ''"visualizer"'' und schaltet in den HostFeatures atomar ''host.licences.visualizer3 = "true"'' sowie ''panorama.model3ds = "true"'' frei. Alte Visualizer-Keys eines vorherigen Levels (z.B. ''visualizer2'') werden dabei automatisch aufgeräumt. 
  
-### Fall B: Alternativ zum visualizer (Licence Level 2) 
  
-Wie das visualizer Feature-Abo, nur ein anderes levelbasiertes Abo.+**Was passiert?** Das Backend bucht das Entitlement auf Typ ''"visualizer"'' und schaltet in den HostFeatures ''host.licences.visualizer3 = "true"'' sowie ''panorama.model3ds = "true"'' frei. Alte Visualizer-Keys eines vorherigen Levels (z.B. ''visualizer2'') werden dabei automatisch aufgeräumt. 
 + 
 +== Fall B: Analog zum visualizer Abo (Licence Level 2) == 
 + 
 +Ein anderes levelbasiertes Abo mit jährlichem Abbuchungsinterval. 
 + 
 +  * ''creditPrice'': ''150'' 
 +  * ''billingInterval'': ''"year"'' 
 +  * ''subscriptionInfo'':
  
-* **''creditPrice'':** ''150'' 
-* **''billingInterval'':** ''"year"'' 
-* **''subscriptionInfo'':** 
-``` 
-{ 
   "subscriptionInfo": {   "subscriptionInfo": {
     "type": "licence",     "type": "licence",
Zeile 73: Zeile 73:
     }     }
   }   }
-} 
  
-``` 
  
-### Fall C: Das Credit-Auflade-Abo (Reines Stripe-Produkt)+== Fall C: Das Credit-Auflade-Abo (Reines Stripe-Produkt) ==
  
-Dieses Produkt existiert, um regelmäßig über Stripe bezahlt zu werden und dafür dem Nutzer frische Credits ins Wallet zu spülen.+Dieses Produkt existiert, um regelmäßig über Stripe bezahlt zu werden und dafür dem Nutzer Credits im Wallet gutzuschreiben. 
 + 
 +  * ''creditPrice'': ''100'' (Da es ein "credit" Typ ist, dient dies als reiner Auflade-Wert) 
 +  * ''billingInterval'': ''"month"'' 
 +  * ''subscriptionInfo'':
  
-* **''creditPrice'':** ''100'' (Da es ein "credit" Typ ist, dient dies als reiner Auflade-Wert) 
-* **''billingInterval'':** ''"month"'' 
-* **''subscriptionInfo'':** 
-``` 
-{ 
   "subscriptionInfo": {   "subscriptionInfo": {
     "type": "credit",     "type": "credit",
     "features": {}     "features": {}
   }   }
-} 
  
-``` 
  
 **Was passiert?** Der Nutzer bezahlt echtes Geld über Stripe. Der Webhook erkennt den Typ ''"credit"'' und überspringt die direkte Wiederabbuchung. Der ''creditPrice'' von ''100'' bleibt als ''WALLET_TOP_UP'' im Wallet des Nutzers liegen. Proration-Refunds sind für diesen Typ automatisch deaktiviert. **Was passiert?** Der Nutzer bezahlt echtes Geld über Stripe. Der Webhook erkennt den Typ ''"credit"'' und überspringt die direkte Wiederabbuchung. Der ''creditPrice'' von ''100'' bleibt als ''WALLET_TOP_UP'' im Wallet des Nutzers liegen. Proration-Refunds sind für diesen Typ automatisch deaktiviert.
 +
 +
 +
 +