README.md aktualisiert

README.md

@@ -145,7 +145,7 @@ fly-abo:
 |--------|-------------|--------------|
 | `/flyabo` | Zeigt Abo-Status, Ablaufdatum und heutiges Tageslimit | `ingameshop.flyabo` |
 | `/flyabocancel [confirm]` | Kündigt das Abo zum Ablaufdatum (bleibt bis dahin aktiv) | `ingameshop.flyabocancel` |
-| `/flyabogive <Spieler> <Tage> [Label]` | Vergibt ein Fly-Abo manuell (Admin) | `ingameshop.flyabogive` (OP) |
+| `/flyabogive <Spieler> <Monatspreis> [Label]` | Vergibt ein Fly-Abo manuell (Admin) | `ingameshop.flyabogive` (OP) |
 
 ## Ränge
 
@@ -176,15 +176,17 @@ fly-abo:
 
 # ✈️ Fly-Abo-System
 
-Das Fly-Abo ermöglicht es Spielern, ein zeitbasiertes Abonnement im Shop zu kaufen, das ihnen täglich eine konfigurierbare Menge an Fly-Zeit gewährt.
+Das Fly-Abo ermöglicht es Spielern, ein monatlich abgebuchtes Abonnement im Shop zu kaufen, das ihnen täglich eine konfigurierbare Menge an Fly-Zeit gewährt.
 
 ## Funktionsweise
 
-- Spieler kaufen das Abo im Shop (WordPress-Frontend)
+- Spieler kaufen das Abo einmalig im Shop – der **Artikelpreis** ist gleichzeitig der monatliche Beitrag
-- Das Abo wird automatisch beim Login aktiviert
+- Das Abo ist sofort aktiv und gilt bis zum letzten Tag des laufenden Monats
 - Täglich stehen bis zu `max-daily-hours` Stunden Fly zur Verfügung (Standard: 6h)
-- Der Tagesverbrauch wird um Mitternacht zurückgesetzt
+- Der Tagesverbrauch wird täglich zurückgesetzt
-- Mehrfachkauf verlängert das bestehende Abo kumulativ (z.B. 2x 30 Tage = 60 Tage)
+- Am **1. jedes Monats** wird der Monatsbeitrag automatisch per Vault abgebucht und das Abo verlängert
+- Kann der Spieler nicht zahlen, wird das Abo **automatisch zum Monatsende gekündigt**
+- Kündigung jederzeit ingame möglich – das Abo läuft bis **Ende des laufenden Monats** weiter
 - Verwaltung und Kündigung erfolgen ausschließlich ingame
 
 ## BossBar
@@ -201,10 +203,20 @@ Warnungen bei: 1h, 30min, 10min, 5min, 1min, 30s, 10s verbleibend.
 
 1. **Ingame Shop → Items → Neu**
 2. Typ: **„✈ Fly-Abo (tägl. Limit)"** auswählen
-3. Laufzeit in Tagen eintragen (z.B. `30`)
+3. **Preis setzen** – dieser Betrag wird monatlich per Vault abgebucht
-4. Preis setzen, Name vergeben → Speichern
+4. Name vergeben → Speichern
 
-Die Item-ID wird automatisch als `fly_abo_30` gespeichert.
+Die Item-ID wird automatisch als `fly_abo` gespeichert.  
+> **Hinweis:** Es gibt nur einen Fly-Abo-Artikel. Der Preis im Shop = monatlicher Beitrag.
+
+## Billing-Übersicht
+
+| Zeitpunkt | Was passiert |
+|-----------|-------------|
+| Kauf im Shop | Vault-Abzug, Abo sofort aktiv bis Monatsende |
+| 1. des Monats | Automatische Vault-Abbuchung, Abo verlängert sich |
+| Zahlung fehlgeschlagen | Abo läuft bis Monatsende, danach automatisch beendet |
+| `/flyabocancel confirm` | Kündigung vorgemerkt, Abo läuft bis Monatsende weiter |
 
 ## Datenbanktabellen
 
@@ -595,8 +607,11 @@ Antwort:
 |------|-------------|
 | player_name | Minecraft Name |
 | label | Anzeigename des Pakets |
+| monthly_price | Monatlicher Beitrag (Vault) |
 | cancelled | 0 / 1 – Kündigung vorgemerkt? |
-| expires_at | Ablaufdatum |
+| cancellation_reason | `user` oder `payment_failed` |
+| next_billing_date | Datum der nächsten Abbuchung (immer 1. des Monats) |
+| period_end | Letzter Tag der aktuellen Abo-Periode (Monatsende) |
 | granted_at | Aktivierungszeitpunkt |
 
 ---