Entwicklerhandbuch

Tabellen-Detail

Datenmodell

Tabellen-Detail

Tabellenprofile mit Zweck, Tenant-Key, Kritikalität, Beziehungen und technischer Spaltenstruktur.

DB-Tabellen: 333Views: 0Trigger: 0
Tabellen-Detail

hcc_module_subscriptions

Vertiefte Sicht auf fachlichen Zweck, Mandantenbezug, Nutzungsstatus, Datenverantwortung, Risiken und Spaltenstruktur dieser Tabelle.

← Zurück zu Datenbank

Core / HotelNutzung: aktivKritikalität: hochTenant-Key: ms_hotel_nrGo-Live: hoch
22
Spalten
5
Dateibezüge
5
Lese-/Schreibhinweise
1
ID-/Verknüpfungsfelder
Kritischer Bereich
Diese Datei oder Tabelle ist fachlich bzw. technisch besonders sensibel. Änderungen sollten immer mit Blick auf Abhängigkeiten, Scope und Seiteneffekte geprüft werden.
Go-Live-relevant
Dieser Bereich ist für sichtbare, operative oder produktive Abläufe besonders relevant.
Tenant-/Hotelbezug
Dieser Bereich arbeitet direkt mit hotel- bzw. mandantenbezogenem Scope. Änderungen sollten immer auf saubere Zuordnung und Scope-Logik geprüft werden.

Langbeschreibung

Modul-Abonnements und Freischaltungsstatus

Die Tabelle `hcc_module_subscriptions` hält fest, welche Booyage-Module ein Hotel gebucht, aktiviert, verifiziert oder abgerechnet hat. Sie ist damit eine der wichtigsten Steuerungstabellen für die Frage, welche Module einem Hotel tatsächlich zur Verfügung stehen und in welchem kaufmännischen oder vertraglichen Zustand sich diese befinden.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_module_subscriptions` hält fest, welche Booyage-Module ein Hotel gebucht, aktiviert, verifiziert oder abgerechnet hat. Sie ist damit eine der wichtigsten Steuerungstabellen für die Frage, welche Module einem Hotel tatsächlich zur Verfügung stehen und in welchem kaufmännischen oder vertraglichen Zustand sich diese befinden.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, pro Hotel und pro Modul einen nachvollziehbaren Abo- und Statusdatensatz zu speichern. Darin können unter anderem Modulschlüssel, Plan, Aktivstatus, Preis, Währung, Abrechnungsintervall, Laufzeit, verifizierte Gebührenzustände und weitere abonnementsrelevante Informationen festgehalten werden. So wird die Freischaltung von Modulen nicht lose an vielen Stellen im System verteilt, sondern zentral in einem klaren Vertrags- und Statusmodell verwaltet.

Warum es sie gibt

Diese Tabelle existiert, weil Booyage aus mehreren Modulen besteht, die nicht für jedes Hotel automatisch gleich verfügbar sind. Ein Hotel kann bestimmte Module gebucht haben, andere nicht, und einige Module können zusätzlich von Statusprüfungen, Verifikation, Rechnungslogik oder Vertragsdaten abhängen. `hcc_module_subscriptions` löst genau dieses Problem, indem sie die Buchungs- und Aktivierungsrealität pro Hotel und Modul als zentrale Quelle abbildet. Ohne diese Tabelle müssten Berechtigungen, Kosten, Aktivstatus und Laufzeiten an verschiedenen Stellen parallel gepflegt werden, was schnell unübersichtlich und fehleranfällig würde.

Nutzen im Alltag

Aus geschäftlicher Sicht sorgt diese Tabelle für Klarheit darüber, welche Leistungen ein Hotel gebucht hat und in welchem Zustand sich diese Leistungen befinden. Sie ist damit wichtig für Vertrieb, Freischaltung, Abrechnung, Support und Governance. Eine saubere Modul-Abo-Tabelle reduziert Missverständnisse, verhindert falsche Freischaltungen und schafft eine nachvollziehbare Grundlage für kostenpflichtige Zusatzmodule.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist diese Tabelle die Modul-Übersicht eines Hotels. Hier wird gespeichert, welche Zusatzmodule ein Hotel hat, in welchem Tarif oder Plan sie laufen und ob sie aktiv, verifiziert oder abrechnungsrelevant sind. Man kann sich die Tabelle wie eine Mischung aus Vertragsübersicht und Freischaltliste vorstellen. Wenn ein Hotel zum Beispiel StayGuide, HotelPass oder GreenSeal nutzt, dann hilft diese Tabelle dem System dabei zu entscheiden, ob das Modul überhaupt sichtbar sein darf, ob es bereits freigegeben ist und wie es kaufmännisch eingeordnet wird. Für nicht-technische Leser ist wichtig: Diese Tabelle ist nicht nur Technik im Hintergrund, sondern ein zentraler Baustein dafür, was ein Hotel tatsächlich nutzen kann.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_module_subscriptions` eine führende Core-Tabelle für modulbezogene Lizenz-, Status- und Abrechnungslogik auf Hotel-Ebene. Sie verbindet den Hotel-Scope mit einem Modulschlüssel und hält pro Kombination zentrale Steuerungsdaten wie Plan, Status, Preis, Billing Cycle, Laufzeit und Verifikationswerte. In vielen Oberflächen ist sie nicht die einzige Bedingung für Sichtbarkeit oder Nutzbarkeit, aber sie ist oft die primäre fachliche Grundlage, auf der weitere Gates, Terms-Acceptance-Prüfungen oder effektive Aktivierungsentscheidungen aufsetzen. Änderungen an Status- oder Preisfeldern dieser Tabelle können deshalb direkte Auswirkungen auf Modul-Dashboards, Abrechnungsabläufe, Go-Live-Logik und vertragliche Auswertungen haben.

Was Änderungen auslösen können

Änderungen an `hcc_module_subscriptions` haben meist eine größere Wirkung als eine reine Verwaltungsänderung. Besonders sensibel sind Status, Modulschlüssel, Preisfelder, Billing Cycle, Laufzeiten und verifizierte Aktivierungswerte. Wer diese Tabelle strukturell oder fachlich anpasst, sollte immer mitdenken, welche Dashboards, Vertragsprozesse, Freischaltentscheidungen und Go-Live-Prüfungen davon abhängen. Diese Tabelle ist ein Kernbaustein zwischen Produktlogik und kaufmännischer Realität.

Typische Nutzung und Inhalte
Typische Nutzung
  • Ein Hotel bucht oder aktiviert ein Zusatzmodul und der Datensatz wird als Modul-Abonnement angelegt oder aktualisiert.
  • Ein Dashboard prüft, ob ein bestimmtes Modul für das Hotel aktiv, gesperrt, verifiziert oder abrechnungsrelevant ist.
  • Abrechnungsnahe Prozesse lesen Preis, Währung und Billing Cycle aus, um Gebühren oder Laufzeiten korrekt einzuordnen.
  • Support oder interne Verwaltung prüfen, warum ein Modul sichtbar, unsichtbar, gesperrt oder nur teilweise aktiv ist.
  • Go-Live- oder Vertragslogik kombiniert diesen Datensatz mit weiteren Bedingungen wie Terms-Acceptance oder operativer Freischaltung.
Hauptinhalte
  • Hotelbezug und Modulschlüssel als zentrale Zuordnungsbasis.
  • Plan-, Status- und Aktivierungsinformationen pro Modul.
  • Preis-, Steuer-, Währungs- und Abrechnungsdaten.
  • Laufzeit-, Start- und Endinformationen für das Modul-Abonnement.
  • Verifizierte Gebühren- oder Vertragsfelder für kaufmännisch belastbare Zustände.
Beispiele
  • Ein Hotel aktiviert HotelPass und erhält einen Datensatz mit Modulschlüssel, Plan, Status und Preis.
  • Ein Modul ist zwar gebucht, aber noch nicht vollständig freigeschaltet, weil ergänzende Bedingungen noch nicht erfüllt sind.
  • Das Support-Team prüft anhand der Tabelle, ob ein Modul wirklich aktiv sein sollte oder ob ein Vertrags- oder Statusproblem vorliegt.
  • Ein Verwaltungsprozess liest das Abrechnungsintervall aus, um die Gebührenlogik korrekt zu interpretieren.
Beziehungen und Risiken
Wichtige Beziehungen
  • Steht in enger Beziehung zu `hcc_hotel`, weil jedes Modul-Abonnement einem konkreten Hotel zugeordnet ist.
  • Wirkt fachlich mit Terms-Acceptance- und Freischaltungslogik zusammen, wenn ein Modul nicht nur gebucht, sondern auch rechtskonform und operativ aktiviert sein muss.
  • Kann in Dashboards und Modul-Views als Basis für Sichtbarkeit, Nutzbarkeit und Statuskommunikation dienen.
  • Hat Berührungspunkte zu Rechnungs- und Vertragsprozessen, wenn Modulpreise oder Laufzeiten ausgewertet werden.
Risiken
  • Fehlerhafte Statuswerte können dazu führen, dass Module zu früh, zu spät oder gar nicht freigeschaltet werden.
  • Unklare oder inkonsistente Preis- und Billing-Felder können kaufmännische Auswertungen verfälschen.
  • Änderungen an Modulschlüsseln oder Scope-Feldern können Sichtbarkeits- und Verknüpfungslogik in mehreren Oberflächen gleichzeitig beeinflussen.
  • Wenn diese Tabelle ohne Berücksichtigung von Terms-, Gate- oder Freischaltlogik interpretiert wird, kann ein fachlich falsches Bild des tatsächlichen Modulstatus entstehen.
Hinweise
  • Diese Tabelle ist fachlich sowohl für Produktfreischaltung als auch für kaufmännische Einordnung wichtig.
  • Nicht jeder aktive Datensatz bedeutet automatisch, dass ein Modul in jeder Oberfläche effektiv nutzbar ist; zusätzliche Gates können darüberliegen.
  • Für nicht-technische Leser lässt sich die Tabelle gut als zentrale Modul-Vertrags- und Statusübersicht erklären.

Steckbrief

Wofür diese Tabelle da ist

Dieser Bereich erklärt in kompakter Form, welche Aufgabe die Tabelle im Projekt hat und wie wichtig sie für Betrieb und Weiterentwicklung ist.

Projektkontext und Verantwortung
Modul / BereichCore / Hotel
Status im Projektaktiv
Hotel- / Mandanten-Schlüsselms_hotel_nr
Wichtigkeithoch
Relevanz im Betriebhoch
Datenbank-EngineInnoDB
Zweck und Aufgabe

Verwaltet Modul-Abonnements je Hotel inklusive Plan, Preis-, Billing- und Aktivierungsinformationen.

Wichtige Beziehungen

Wird im Code von 5 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Verknüpft Hotels mit gebuchten oder verifizierten Modulen. | Kann Status-, Billing- und Freischaltlogik für Module beeinflussen.

Risiken bei Änderungen

Fehlerhafte Abo- oder Preisdaten wirken auf Modulzugriff, Verrechnung und Statusanzeigen.

Praktischer Hinweis

Zentrale Vertrags-/Abo-Tabelle für modulare Produktfreischaltung.

Datenverantwortung

Datenart und Verantwortung

Hier siehst du, welche Art von Daten in der Tabelle liegt und worauf man bei Pflege, Historie und Umbauten achten sollte.

Art der gespeicherten Daten
DomäneCore
Datenklassetransactional
Lifecycledauerhaft
PIInein
Aufbewahrung und Historie

Vertrags- und Billingbezug bei Änderungen berücksichtigen; Historie nicht vorschnell verlieren.

Worauf bei Datenqualität zu achten ist

Hotelnummer, Modulschlüssel, Billing-Zyklus und Aktivstatus konsistent halten.

Risiko bei Umbauten

Änderungen mit Gates, Billing und Modul-Dashboards abstimmen.

Führende Datenquelle

Hotelbezogene Modul-Abonnements im dokumentierten System.

Nutzung

Wo die Tabelle verwendet wird

Dieser Bereich zeigt, in welchen Dateien oder Abläufen die Tabelle vorkommt. Das hilft beim Verstehen von Auswirkungen vor Änderungen.

Wird gelesen von5 Lese-Hinweise
module_settings.phpstaygreenseal_cancel.phpstaygreenseal_participation_manage.phpstaygreenseal_subscribe.phpstripe_webhook.php
Wird beschrieben von0 Schreib-Hinweise

Aktuell sind keine schreibenden Prozesse oder Hinweise dokumentiert.

Zusätzliche Hinweise9 Einträge
#hcc#module#subscriptions#used#status#subscription#modules#billing#hotel

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

Hier werden technische Merkmale der Tabelle zusammengefasst, zum Beispiel Schlüssel, Statusfelder und typische Verknüpfungsspalten.

Primärschlüssel
ms_id
Eindeutige Felder und Indizes
ms_idms_hotel_nrms_status
Status-, Lösch- und Sichtbarkeitsfelder
ms_verified_activems_status
Zeitstempel, Audit und Verknüpfungen
ms_created_atms_updated_atms_hotel_nr

Weiterarbeiten

Was noch dazugehört

Wenn du die Tabelle weiter untersuchen willst, findest du hier passende Dateien und fachlich verwandte Tabellen.

Spaltenstruktur

Spalten im Überblick

Hier siehst du die Felder der Tabelle mit Typ, Standardwerten und technischen Zusatzinformationen.

Spaltenstruktur öffnen22 Spalten
SpalteTypNullDefaultKeyExtraKommentar
ms_idbigint(20) unsignedNOPRIauto_increment
ms_hotel_nrint(11)NOMUL
ms_module_keyvarchar(32)NO
ms_planvarchar(32)NO
ms_verified_activetinyint(1)NO0
ms_verified_first_billed_atdatetimeYESNULL
ms_verified_fee_net_currentdecimal(10,2)NO0.00
ms_verified_fee_typevarchar(16)NO'none'
ms_price_netdecimal(10,2)NO0.00
ms_tax_ratedecimal(5,2)NO19.00
ms_currencychar(3)NO'EUR'
ms_billing_cyclevarchar(16)NO'yearly'
ms_statusvarchar(24)NO'active'MUL
ms_start_atdatetimeYESNULL
ms_end_atdatetimeYESNULL
ms_auto_renewtinyint(1)NO1
ms_cancel_at_period_endtinyint(1)NO0
ms_cancel_requested_atdatetimeYESNULL
ms_payment_methodvarchar(16)NO'invoice'
ms_created_by_useridint(11)YESNULL
ms_created_atdatetimeNOcurrent_timestamp()
ms_updated_atdatetimeNOcurrent_timestamp()on update current_timestamp()