OpportunitiesEntities
Docs
    Ring Platform

    Dezentralisierte selbstbauende Zukunft

    Anmelden
    Entities
    Opportunities
    Store
    Docs
    Plattformkonzepte
    RING ÖkonomieSonoratek LLCGlobaler ImpactKI trifft Web3
    Loslegen
    SchnellstartKalkulatorRoadmap
    Datenschutz|Kontakt
    v1.106.29|Sonoratek LLC

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content


    title: Mitgliedschaft & Guthaben description: Ring-Mitgliedschaftsstufen und Guthaben: die sechsstufige Rollenleiter, Upgrade-Preise im RING-Token mit dem Desk-Oracle, PaymentConductor-Zahlungswege und das Abo-Ledger last_modified: "2026-10-26" audience: both

    Mitgliedschaft & Guthaben

    Nutze die Tabs Founder / Developer in der Seitenleiste, um diese Seite zu filtern. Die Nutzerabläufe werden unter /membership gerendert; dieser Artikel dokumentiert Stufen, Preise und Zahlungswege.

    Mitgliedschaft ist der Weg, wie ein Ring-Klon Community-Stufen unterscheidet und Zugang monetarisiert. Die Rollenleiter ist die SSOT (features/auth/user-role.ts), Upgrade-Preise sind konfigurationsgesteuert (lib/membership/pricing.ts), und jede Zahlung, ob Karte, Guthaben, PayPal oder nativer Token, läuft über PaymentConductor.

    Rollenleiter (SSOT)

    RolleBedeutung
    visitorNicht angemeldet, nur lesen
    subscriberBezahlter Basis-Abonnent: Basiszugang zur Community
    memberErhöhter Status mit breiterem Zugang
    confidentialZugang zu vertraulichen Ressourcen
    adminPlattform-Admin
    superadminPlattform-Admin der höchsten Stufe

    Upgrades bringen einen Nutzer von subscriber zu member. Die Stufenkonfiguration confidential verlangt ausdrücklich die Rolle confidential.

    Warum das für deinen Klon wichtig ist

    • Monetarisiere Zugang mit einer bezahlten member-Stufe, während visitors und subscribers Basiszugang behalten.
    • Ein Checkout, viele Zahlungswege. PaymentConductor vereint Karte, Guthaben, PayPal und nativen Token: dieselbe Checkout-Engine wie im Shop.
    • Planbare RING-Preise. Das monatliche Upgrade kostet standardmäßig 1 RING (membership.ring.memberUpgradeAmount), jährlich gibt es 20% Rabatt auf monatlich × 12, und Live-Kurse laufen über das Desk-Oracle, damit der abgerechnete Betrag zum Kurs passt.
    • Guthaben ist die Hauptwährung. Ab 10 Guthabeneinheiten (MEMBERSHIP_DESK_CREDIT_HINT_MIN) schlägt die UI einen Tausch am Token Desk statt eines Guthabenkaufs vor.

    Checkliste für Betreiber

    1. Bestätige deine Zahlungsanbieter in PaymentConductor (WayForPay / Stripe / PayPal je Klon).
    2. Prüfe die Beträge in membership.ring und die Stufenkonfiguration member und memberAnnual in ring-config.json. Um einen festen Fiat-Preis statt eines aus RING abgeleiteten zu berechnen, setze "pricedInNativeToken": false in dieser Stufe.
    3. Führe vor dem Go-live in einem Staging-Klon pro Zahlungsweg (Karte, Guthaben, Token) ein echtes Upgrade durch.

    Preismodule (verifiziert)

    ModulAufgabe
    lib/membership/pricing.tsSynchrone Helfer: RING-Beträge pro Zeitraum, 20% Jahresrabatt, Credit-Desk-Hinweis
    lib/membership/pricing-live.tsNur serverseitige Live-Desk-Kurse über getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsVerarbeitung des Upgrade-Zwecks
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsAnbieterspezifische Upgrade-Wege
    lib/payments/payment.config.tsZweck membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Stufen mit Fiat-Preis (seit 2026-10-17)

    MemberTierConfig in lib/ring-config-types.ts hat pricedInNativeToken erhalten. Ist es false, nutzt lib/membership/pricing.ts amount und currency der Stufe als Fiat-Preis. Fehlt es oder ist es (Standard der Vorlage), wird der Betrag weiterhin aus der Gebühr im nativen Token abgeleitet.

    Verwandte Dokumentation

    Related documentation

    WalletConductor

    Vertiefung: das Guthaben-Ledger und die Zwei-Kurs-SSOT, in die Mitgliedschaftszahlungen abgerechnet werden.

    PaymentConductor

    Abhängigkeit: Karten-, PayPal- und Token-Wege laufen alle über PaymentConductor.

    SubscriptionConductor

    Gleicher Ablauf: Verlängerungszyklus und Kündigungen.

    Data Model

    Siehe auch: wie credit_balance und das Abo-Ledger im JSONB-Schema liegen.

    1. Docs
    2. /Funktionen
    3. /Membership

    4 Min. Anhören


    title: Mitgliedschaft & Guthaben description: Ring-Mitgliedschaftsstufen und Guthaben: die sechsstufige Rollenleiter, Upgrade-Preise im RING-Token mit dem Desk-Oracle, PaymentConductor-Zahlungswege und das Abo-Ledger last_modified: "2026-10-26" audience: both

    Mitgliedschaft & Guthaben

    Nutze die Tabs Founder / Developer in der Seitenleiste, um diese Seite zu filtern. Die Nutzerabläufe werden unter /membership gerendert; dieser Artikel dokumentiert Stufen, Preise und Zahlungswege.

    Mitgliedschaft ist der Weg, wie ein Ring-Klon Community-Stufen unterscheidet und Zugang monetarisiert. Die Rollenleiter ist die SSOT (features/auth/user-role.ts), Upgrade-Preise sind konfigurationsgesteuert (lib/membership/pricing.ts), und jede Zahlung, ob Karte, Guthaben, PayPal oder nativer Token, läuft über PaymentConductor.

    Rollenleiter (SSOT)

    RolleBedeutung
    visitorNicht angemeldet, nur lesen
    subscriberBezahlter Basis-Abonnent: Basiszugang zur Community
    memberErhöhter Status mit breiterem Zugang
    confidentialZugang zu vertraulichen Ressourcen
    adminPlattform-Admin
    superadminPlattform-Admin der höchsten Stufe

    Upgrades bringen einen Nutzer von subscriber zu member. Die Stufenkonfiguration confidential verlangt ausdrücklich die Rolle confidential.

    Warum das für deinen Klon wichtig ist

    • Monetarisiere Zugang mit einer bezahlten member-Stufe, während visitors und subscribers Basiszugang behalten.
    • Ein Checkout, viele Zahlungswege. PaymentConductor vereint Karte, Guthaben, PayPal und nativen Token: dieselbe Checkout-Engine wie im Shop.
    • Planbare RING-Preise. Das monatliche Upgrade kostet standardmäßig 1 RING (membership.ring.memberUpgradeAmount), jährlich gibt es 20% Rabatt auf monatlich × 12, und Live-Kurse laufen über das Desk-Oracle, damit der abgerechnete Betrag zum Kurs passt.
    • Guthaben ist die Hauptwährung. Ab 10 Guthabeneinheiten (MEMBERSHIP_DESK_CREDIT_HINT_MIN) schlägt die UI einen Tausch am Token Desk statt eines Guthabenkaufs vor.

    Checkliste für Betreiber

    1. Bestätige deine Zahlungsanbieter in PaymentConductor (WayForPay / Stripe / PayPal je Klon).
    2. Prüfe die Beträge in membership.ring und die Stufenkonfiguration member und memberAnnual in ring-config.json. Um einen festen Fiat-Preis statt eines aus RING abgeleiteten zu berechnen, setze "pricedInNativeToken": false in dieser Stufe.
    3. Führe vor dem Go-live in einem Staging-Klon pro Zahlungsweg (Karte, Guthaben, Token) ein echtes Upgrade durch.

    Preismodule (verifiziert)

    ModulAufgabe
    lib/membership/pricing.tsSynchrone Helfer: RING-Beträge pro Zeitraum, 20% Jahresrabatt, Credit-Desk-Hinweis
    lib/membership/pricing-live.tsNur serverseitige Live-Desk-Kurse über getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsVerarbeitung des Upgrade-Zwecks
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsAnbieterspezifische Upgrade-Wege
    lib/payments/payment.config.tsZweck membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Stufen mit Fiat-Preis (seit 2026-10-17)

    MemberTierConfig in lib/ring-config-types.ts hat pricedInNativeToken erhalten. Ist es false, nutzt lib/membership/pricing.ts amount und currency der Stufe als Fiat-Preis. Fehlt es oder ist es (Standard der Vorlage), wird der Betrag weiterhin aus der Gebühr im nativen Token abgeleitet.

    Verwandte Dokumentation

    Related documentation

    WalletConductor

    Vertiefung: das Guthaben-Ledger und die Zwei-Kurs-SSOT, in die Mitgliedschaftszahlungen abgerechnet werden.

    PaymentConductor

    Abhängigkeit: Karten-, PayPal- und Token-Wege laufen alle über PaymentConductor.

    SubscriptionConductor

    Gleicher Ablauf: Verlängerungszyklus und Kündigungen.

    Data Model

    Siehe auch: wie credit_balance und das Abo-Ledger im JSONB-Schema liegen.

    1. Docs
    2. /Funktionen
    3. /Membership

    4 Min. Anhören


    title: Mitgliedschaft & Guthaben description: Ring-Mitgliedschaftsstufen und Guthaben: die sechsstufige Rollenleiter, Upgrade-Preise im RING-Token mit dem Desk-Oracle, PaymentConductor-Zahlungswege und das Abo-Ledger last_modified: "2026-10-26" audience: both

    Mitgliedschaft & Guthaben

    Nutze die Tabs Founder / Developer in der Seitenleiste, um diese Seite zu filtern. Die Nutzerabläufe werden unter /membership gerendert; dieser Artikel dokumentiert Stufen, Preise und Zahlungswege.

    Mitgliedschaft ist der Weg, wie ein Ring-Klon Community-Stufen unterscheidet und Zugang monetarisiert. Die Rollenleiter ist die SSOT (features/auth/user-role.ts), Upgrade-Preise sind konfigurationsgesteuert (lib/membership/pricing.ts), und jede Zahlung, ob Karte, Guthaben, PayPal oder nativer Token, läuft über PaymentConductor.

    Rollenleiter (SSOT)

    RolleBedeutung
    visitorNicht angemeldet, nur lesen
    subscriberBezahlter Basis-Abonnent: Basiszugang zur Community
    memberErhöhter Status mit breiterem Zugang
    confidentialZugang zu vertraulichen Ressourcen
    adminPlattform-Admin
    superadminPlattform-Admin der höchsten Stufe

    Upgrades bringen einen Nutzer von subscriber zu member. Die Stufenkonfiguration confidential verlangt ausdrücklich die Rolle confidential.

    Warum das für deinen Klon wichtig ist

    • Monetarisiere Zugang mit einer bezahlten member-Stufe, während visitors und subscribers Basiszugang behalten.
    • Ein Checkout, viele Zahlungswege. PaymentConductor vereint Karte, Guthaben, PayPal und nativen Token: dieselbe Checkout-Engine wie im Shop.
    • Planbare RING-Preise. Das monatliche Upgrade kostet standardmäßig 1 RING (membership.ring.memberUpgradeAmount), jährlich gibt es 20% Rabatt auf monatlich × 12, und Live-Kurse laufen über das Desk-Oracle, damit der abgerechnete Betrag zum Kurs passt.
    • Guthaben ist die Hauptwährung. Ab 10 Guthabeneinheiten (MEMBERSHIP_DESK_CREDIT_HINT_MIN) schlägt die UI einen Tausch am Token Desk statt eines Guthabenkaufs vor.

    Checkliste für Betreiber

    1. Bestätige deine Zahlungsanbieter in PaymentConductor (WayForPay / Stripe / PayPal je Klon).
    2. Prüfe die Beträge in membership.ring und die Stufenkonfiguration member und memberAnnual in ring-config.json. Um einen festen Fiat-Preis statt eines aus RING abgeleiteten zu berechnen, setze "pricedInNativeToken": false in dieser Stufe.
    3. Führe vor dem Go-live in einem Staging-Klon pro Zahlungsweg (Karte, Guthaben, Token) ein echtes Upgrade durch.

    Preismodule (verifiziert)

    ModulAufgabe
    lib/membership/pricing.tsSynchrone Helfer: RING-Beträge pro Zeitraum, 20% Jahresrabatt, Credit-Desk-Hinweis
    lib/membership/pricing-live.tsNur serverseitige Live-Desk-Kurse über getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsVerarbeitung des Upgrade-Zwecks
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsAnbieterspezifische Upgrade-Wege
    lib/payments/payment.config.tsZweck membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Stufen mit Fiat-Preis (seit 2026-10-17)

    MemberTierConfig in lib/ring-config-types.ts hat pricedInNativeToken erhalten. Ist es false, nutzt lib/membership/pricing.ts amount und currency der Stufe als Fiat-Preis. Fehlt es oder ist es (Standard der Vorlage), wird der Betrag weiterhin aus der Gebühr im nativen Token abgeleitet.

    Verwandte Dokumentation

    Related documentation

    WalletConductor

    Vertiefung: das Guthaben-Ledger und die Zwei-Kurs-SSOT, in die Mitgliedschaftszahlungen abgerechnet werden.

    PaymentConductor

    Abhängigkeit: Karten-, PayPal- und Token-Wege laufen alle über PaymentConductor.

    SubscriptionConductor

    Gleicher Ablauf: Verlängerungszyklus und Kündigungen.

    Data Model

    Siehe auch: wie credit_balance und das Abo-Ledger im JSONB-Schema liegen.

    1. Docs
    2. /Funktionen
    3. /Membership

    4 Min. Anhören

    true

    POST /api/membership/subscription/create akzeptiert billingPeriod (monthly als Standard oder yearly) und bepreist es mit getMemberMainCurrencyTierForPeriod. Der Stripe-Anbieter erstellt entsprechend einen jährlichen oder monatlichen Preis, sendet den Betrag in Cent und liefert client_secret, wenn das Abo noch eine Zahlungsbestätigung braucht (bis dahin Ledger-Status pending).

    API-Oberfläche

    RouteMethodenZweck
    /api/membership/payment/cardPOST, GETKarten-Checkout für die Mitgliedschaft
    /api/membership/payment/creditPOST, GETZahlung mit Guthaben
    /api/membership/payment/paypalPOST, GETPayPal-Checkout
    /api/membership/payment/tokenPOST, GETZahlung mit nativem Token
    /api/membership/subscription/createPOSTEin Abo anlegen. Der Body enthält provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETAbo-Status lesen
    /api/membership/subscription/cancelPOST, GETEin Abo kündigen

    Was im Ledger steht

    1. 1

      Wo das Geld landet

      Bezahlte Upgrades werden in das Abo-Ledger (subscription_ledger) geschrieben: Der Anbieter credit_balance kennzeichnet mit Guthaben bezahlte Verlängerungen (next_payment_due ist in data/schema.sql indiziert). Das Guthaben selbst liegt im Nutzerdatensatz (users.data.credit_balance), Wallet-Transaktionen dienen als Prüfpfad (features/wallet/services/credit-balance-service.ts).

    2. 2

      Abrechnungszeiträume

      MembershipBillingPeriod = 'monthly' | 'yearly'. Jahreskosten = annualUpgradeAmount, wenn gesetzt, sonst monatlich × 12 × 0.8 (20% Rabatt). Form der Stufe: MemberTierConfig { amount, currency, description, duration }.

    true

    POST /api/membership/subscription/create akzeptiert billingPeriod (monthly als Standard oder yearly) und bepreist es mit getMemberMainCurrencyTierForPeriod. Der Stripe-Anbieter erstellt entsprechend einen jährlichen oder monatlichen Preis, sendet den Betrag in Cent und liefert client_secret, wenn das Abo noch eine Zahlungsbestätigung braucht (bis dahin Ledger-Status pending).

    API-Oberfläche

    RouteMethodenZweck
    /api/membership/payment/cardPOST, GETKarten-Checkout für die Mitgliedschaft
    /api/membership/payment/creditPOST, GETZahlung mit Guthaben
    /api/membership/payment/paypalPOST, GETPayPal-Checkout
    /api/membership/payment/tokenPOST, GETZahlung mit nativem Token
    /api/membership/subscription/createPOSTEin Abo anlegen. Der Body enthält provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETAbo-Status lesen
    /api/membership/subscription/cancelPOST, GETEin Abo kündigen

    Was im Ledger steht

    1. 1

      Wo das Geld landet

      Bezahlte Upgrades werden in das Abo-Ledger (subscription_ledger) geschrieben: Der Anbieter credit_balance kennzeichnet mit Guthaben bezahlte Verlängerungen (next_payment_due ist in data/schema.sql indiziert). Das Guthaben selbst liegt im Nutzerdatensatz (users.data.credit_balance), Wallet-Transaktionen dienen als Prüfpfad (features/wallet/services/credit-balance-service.ts).

    2. 2

      Abrechnungszeiträume

      MembershipBillingPeriod = 'monthly' | 'yearly'. Jahreskosten = annualUpgradeAmount, wenn gesetzt, sonst monatlich × 12 × 0.8 (20% Rabatt). Form der Stufe: MemberTierConfig { amount, currency, description, duration }.

    true

    POST /api/membership/subscription/create akzeptiert billingPeriod (monthly als Standard oder yearly) und bepreist es mit getMemberMainCurrencyTierForPeriod. Der Stripe-Anbieter erstellt entsprechend einen jährlichen oder monatlichen Preis, sendet den Betrag in Cent und liefert client_secret, wenn das Abo noch eine Zahlungsbestätigung braucht (bis dahin Ledger-Status pending).

    API-Oberfläche

    RouteMethodenZweck
    /api/membership/payment/cardPOST, GETKarten-Checkout für die Mitgliedschaft
    /api/membership/payment/creditPOST, GETZahlung mit Guthaben
    /api/membership/payment/paypalPOST, GETPayPal-Checkout
    /api/membership/payment/tokenPOST, GETZahlung mit nativem Token
    /api/membership/subscription/createPOSTEin Abo anlegen. Der Body enthält provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETAbo-Status lesen
    /api/membership/subscription/cancelPOST, GETEin Abo kündigen

    Was im Ledger steht

    1. 1

      Wo das Geld landet

      Bezahlte Upgrades werden in das Abo-Ledger (subscription_ledger) geschrieben: Der Anbieter credit_balance kennzeichnet mit Guthaben bezahlte Verlängerungen (next_payment_due ist in data/schema.sql indiziert). Das Guthaben selbst liegt im Nutzerdatensatz (users.data.credit_balance), Wallet-Transaktionen dienen als Prüfpfad (features/wallet/services/credit-balance-service.ts).

    2. 2

      Abrechnungszeiträume

      MembershipBillingPeriod = 'monthly' | 'yearly'. Jahreskosten = annualUpgradeAmount, wenn gesetzt, sonst monatlich × 12 × 0.8 (20% Rabatt). Form der Stufe: MemberTierConfig { amount, currency, description, duration }.