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_rateplans

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

← Zurück zu Datenbank

Buchung / PreiseNutzung: aktivKritikalität: hochTenant-Key: rp_hotel_nrGo-Live: hoch
12
Spalten
3
Dateibezüge
4
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

Ratenpläne und buchbare Preislogik

Die Tabelle `hcc_rateplans` verwaltet die Ratenpläne eines Hotels. Sie legt fest, unter welchen preislichen und fachlichen Modellen Zimmer später buchbar, berechnet, importiert oder angezeigt werden. Damit bildet sie eine wichtige Grundlage zwischen reinen Zimmer-Stammdaten und der eigentlichen Preissteuerung, weil sie definiert, in welchen buchbaren Preisvarianten ein Hotel überhaupt arbeitet.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_rateplans` verwaltet die Ratenpläne eines Hotels. Sie legt fest, unter welchen preislichen und fachlichen Modellen Zimmer später buchbar, berechnet, importiert oder angezeigt werden. Damit bildet sie eine wichtige Grundlage zwischen reinen Zimmer-Stammdaten und der eigentlichen Preissteuerung, weil sie definiert, in welchen buchbaren Preisvarianten ein Hotel überhaupt arbeitet.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, hotelbezogene Ratenpläne als eigenständige Objekte zu führen. Ein Ratenplan beschreibt dabei nicht nur irgendeinen Preis, sondern eine klar definierte Preis- und Buchungslogik, zum Beispiel Standardrate, flexible Rate, nicht stornierbare Rate, Firmenrate, Aktionsrate oder andere betriebliche Preisvarianten. `hcc_rateplans` hält diese Preisrahmen strukturiert fest, damit weitere Tabellen wie Zimmerpreise, Preisregeln, Saisons, Importe oder Angebotslogiken sauber an einen konkreten Ratenplan andocken können.

Warum es sie gibt

Diese Tabelle existiert, weil ein Hotel in der Praxis fast nie nur mit einem einzigen Preis pro Zimmer arbeitet. Stattdessen gibt es meist mehrere tarifliche Modelle, die sich in Preis, Konditionen, Flexibilität, Sichtbarkeit oder Zielgruppe unterscheiden. Ohne eine zentrale Tabelle für Ratenpläne müssten solche Unterschiede direkt in einzelnen Preisdatensätzen oder Sonderlogiken verstreut werden. `hcc_rateplans` löst dieses Problem, indem die übergeordneten Preisvarianten zuerst sauber definiert werden. Dadurch wird die eigentliche Preissteuerung verständlicher, stabiler und später deutlich einfacher erweiterbar.

Nutzen im Alltag

Aus geschäftlicher Sicht hilft diese Tabelle dabei, die Preisstrategie eines Hotels sauber und professionell im System abzubilden. Statt Preise ungeordnet oder nur als Einzelwerte zu verwalten, können verschiedene Tarifmodelle getrennt geführt und klar benannt werden. Das verbessert Pflege, Nachvollziehbarkeit und spätere Erweiterbarkeit. Für den operativen Betrieb bedeutet das weniger Chaos in der Preislogik und eine bessere Grundlage für Aktionen, flexible Konditionen, unterschiedliche Zielgruppen und saubere Buchungsprozesse.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist diese Tabelle das Verzeichnis der Preisarten eines Hotels. Sie beantwortet nicht direkt die Frage, wie teuer ein Zimmer an einem bestimmten Tag ist, sondern eher: In welchen Buchungs- oder Tarifmodellen verkauft das Hotel seine Zimmer überhaupt? Man kann sich `hcc_rateplans` wie eine geordnete Liste von Preisvarianten vorstellen. Ein Zimmer kann dann zum Beispiel als Standardrate, Frühbucher-Rate, flexible Rate oder Spezialtarif angeboten werden. Die genauen Preise liegen oft in anderen Tabellen, aber `hcc_rateplans` beschreibt den Rahmen, in dem diese Preise organisiert sind. Für nicht-technische Leser ist wichtig: Diese Tabelle ist also keine einfache Preisliste, sondern eher die Struktur hinter den verschiedenen buchbaren Tarifarten.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_rateplans` eine zentrale Referenz- und Steuerungstabelle innerhalb des Preis- und Buchungsmodells. Sie verbindet den Hotel-Scope mit einer tariflichen Preislogik und wird typischerweise von Tabellen wie `hcc_zimmer_preise`, `hcc_price_rules` oder saisonalen Preisstrukturen referenziert. In Import- und Verwaltungsprozessen dient der Ratenplan oft als fachlich sprechender Schlüssel, über den Preisdatensätze gruppiert, validiert oder überschrieben werden. Änderungen an Codes, Statuswerten, Aktivitätslogik oder Scope-relevanten Feldern dieser Tabelle können daher direkte Auswirkungen auf Preisimporte, Berechnungen, Buchungsdarstellung und regelbasierte Preissteuerung haben.

Was Änderungen auslösen können

Änderungen an `hcc_rateplans` haben meist direkte Auswirkungen auf angrenzende Preisprozesse. Das gilt insbesondere für Codes, Aktivstatus, Scope und andere Felder, die in Importen, Preiszuordnungen oder Regelwerken weiterverwendet werden. Wer diese Tabelle verändert, sollte immer prüfen, welche Preisimporte, Verwaltungsseiten, Regeln, saisonalen Abhängigkeiten und buchbaren Ausgabekanäle daran hängen. Ein Ratenplan ist im Datenmodell kein bloßes Label, sondern ein operativ relevanter Preisanker.

Typische Nutzung und Inhalte
Typische Nutzung
  • Ein Hotel legt verschiedene Ratenpläne an, etwa Standardrate, flexible Rate oder Sondertarife.
  • Preisimporte ordnen eingehende Preisdaten einem bestimmten Ratenplan zu.
  • Zimmerpreise werden pro Zimmer, Zeitraum und Ratenplan gespeichert oder berechnet.
  • Preisregeln und saisonale Logik referenzieren einen Ratenplan, um ihre Wirkung klar einzugrenzen.
  • Backend-Seiten zeigen dem Hotel, welche Preisarten aktiv sind und für welche Prozesse sie genutzt werden.
Hauptinhalte
  • Hotelbezogene Kennung des Ratenplans.
  • Technische und fachliche Identifikation, zum Beispiel Code oder interne Bezeichnung.
  • Status- und Aktivitätsinformationen für die operative Nutzung.
  • Strukturierende Felder, die für Importe, Preisverwaltung und Zuordnung wichtig sind.
  • Gegebenenfalls Sichtbarkeits-, Scope- oder Organisationsmerkmale des Tarifmodells.
Beispiele
  • Ein Hotel nutzt eine flexible Standardrate und zusätzlich eine günstigere nicht stornierbare Rate.
  • Ein Import schreibt Zimmerpreise für einen bestimmten Zeitraum gezielt in den passenden Ratenplan.
  • Eine Preisregel erhöht nur die flexible Rate in der Hochsaison, während andere Tarife unverändert bleiben.
  • Im Backend wird geprüft, welche Tarifmodelle aktiv sind, bevor weitere Preisdaten gepflegt oder angezeigt werden.
Beziehungen und Risiken
Wichtige Beziehungen
  • `hcc_rateplans` steht in enger Beziehung zu Zimmerpreisen, Preisregeln und saisonalen Preisstrukturen.
  • Importprozesse und Preisverwaltungsseiten nutzen den Ratenplan oft als zentrale Zuordnungsbasis.
  • Angebots- und Buchungslogik baut auf der tariflichen Struktur auf, die in dieser Tabelle definiert wird.
  • Wenn ein Ratenplan verändert oder deaktiviert wird, können viele abhängige Preisdatensätze und Regeln indirekt betroffen sein.
Risiken
  • Falsche Codes oder Statuswerte können dazu führen, dass Preise falsch importiert, zugeordnet oder dargestellt werden.
  • Unklare oder doppelte Tarifstrukturen machen die Preislogik für Hotel und Entwickler unnötig schwer nachvollziehbar.
  • Änderungen an aktiven Ratenplänen ohne Prüfung der Folgeprozesse können sich auf Preisregeln, Saisons oder Buchungsdarstellungen auswirken.
  • Historisch gewachsene Tarifmodelle können zu Verwirrung führen, wenn nicht klar dokumentiert ist, welche Ratenpläne noch aktiv produktiv genutzt werden.
Hinweise
  • Diese Tabelle ist fachlich sehr wichtig, auch wenn sie für Nicht-Techniker auf den ersten Blick abstrakter wirkt als Zimmer- oder Bildtabellen.
  • Für die Dokumentation sollte klar erklärt werden, dass ein Ratenplan nicht selbst der einzelne Preis ist, sondern das tarifliche Modell dahinter.
  • Wenn Preisimporte im Projekt eine große Rolle spielen, gehört `hcc_rateplans` zu den sensiblen Kernobjekten des Buchungsmoduls.

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 / BereichBuchung / Preise
Status im Projektaktiv
Hotel- / Mandanten-Schlüsselrp_hotel_nr
Wichtigkeithoch
Relevanz im Betriebhoch
Datenbank-EngineInnoDB
Zweck und Aufgabe

Verwaltet Ratenpläne pro Hotel inklusive Code, Status und preisbezogenem Scope für buchungsnahe Prozesse.

Wichtige Beziehungen

Mandantenbezug läuft über rp_hotel_nr. | Wird im Code von 3 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Wichtiger Baustein für Preislogik und buchungsnahe Konfiguration. | Relevanz für Import, Preisverwaltung und Rateplan-Zuordnung.

Risiken bei Änderungen

Fehlerhafte Änderungen können Preis- und Buchungslogik direkt beeinträchtigen.

Praktischer Hinweis

Produktiv relevante Tabelle innerhalb des dokumentierten Moduls.

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äneBuchung
Datenklassetransactional
Lifecycledauerhaft
PIInein
Aufbewahrung und Historie

Produktionsrelevante Daten nur mit fachlicher Archivierungsstrategie bereinigen.

Worauf bei Datenqualität zu achten ist

Tenant-Key, Primärschlüssel und Mapping-Bezüge konsistent halten.

Risiko bei Umbauten

Änderungen nur mit Blick auf Seiteneffekte, Scope und abhängige Prozesse durchführen.

Führende Datenquelle

Fachlich führende Tabelle innerhalb ihres Teilbereichs.

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 von3 Lese-Hinweise
hotel/modules/staypass/offer_preview.phphotel/modules/staypass/offer_scope.phphotel/portal_readiness_audit.php
Wird beschrieben von1 Schreib-Hinweise
buchung_import_preise_basis.php
Zusätzliche Hinweise9 Einträge
#hcc#rateplans#used#tenant#status#booking#pricing#rates#rateplan

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
rp_id
Eindeutige Felder und Indizes
rp_idrp_hotel_nr
Status-, Lösch- und Sichtbarkeitsfelder
rp_statusrp_deleted
Zeitstempel, Audit und Verknüpfungen
rp_created_atrp_updated_atrp_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 öffnen12 Spalten
SpalteTypNullDefaultKeyExtraKommentar
rp_idbigint(20) unsignedNOPRIauto_increment
rp_hotel_nrint(10) unsignedNOMUL
rp_namevarchar(160)NO
rp_codevarchar(80)NO
rp_statusenum('active','inactive')NO'active'
rp_deletedtinyint(1)NO0
rp_sortint(10) unsignedNO10
rp_notevarchar(255)YESNULL
rp_created_atdatetimeNOcurrent_timestamp()
rp_updated_atdatetimeNOcurrent_timestamp()on update current_timestamp()
rp_created_byint(10) unsignedYESNULL
rp_updated_byint(10) unsignedYESNULL