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_sp_offers

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

← Zurück zu Datenbank

Booyage HotelPassNutzung: aktivKritikalität: hochTenant-Key: hotel_nrGo-Live: hoch
41
Spalten
7
Dateibezüge
9
Lese-/Schreibhinweise
4
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

HotelPass-Angebote

Diese Tabelle enthält die eigentlichen Angebote des Booyage HotelPass. Sie beschreibt, welche Vorteile, Raten, Specials oder perks im HotelPass-Kontext verfügbar sind und bildet damit einen Kernbereich des Moduls.

Überblick
Kurzbeschreibung

Diese Tabelle enthält die eigentlichen Angebote des Booyage HotelPass. Sie beschreibt, welche Vorteile, Raten, Specials oder perks im HotelPass-Kontext verfügbar sind und bildet damit einen Kernbereich des Moduls.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Die Tabelle speichert HotelPass-Angebote und ihre fachlichen Grundeigenschaften, damit das System definieren kann, welche Vorteile Mitgliedern angezeigt, geprüft, gebucht oder eingelöst werden dürfen.

Warum es sie gibt

Ohne diese Tabelle gäbe es kein zentrales Objekt für HotelPass-Angebote. Kampagnen, Sichtbarkeit, Benefits, Preise und Regeln hätten dann keinen stabilen fachlichen Bezugspunkt.

Nutzen im Alltag

Die Tabelle ist direkt geschäftsrelevant, weil sie die Grundlage für sichtbare HotelPass-Vorteile und damit für Attraktivität, Nutzung und Vermarktung des Moduls bildet.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist dies die Haupttabelle für die Angebote im HotelPass. Hier steht, welche Vorteile oder Sonderangebote ein Hotel seinen berechtigten Gästen bzw. Mitgliedern geben möchte.

Technische Einordnung
Für Entwickler

Technisch ist dies eine zentrale Kern- bzw. Transaktionstabelle des HotelPass-Moduls. Viele weitere Tabellen wie Kampagnen, Offer-Media, Offer-Prices, Offer-Benefits oder Scope-/Rule-Tabellen bauen fachlich auf diesem Objekt auf.

Was Änderungen auslösen können

Änderungen an dieser Tabelle haben oft direkte Auswirkungen auf Sichtbarkeit, Nutzbarkeit und fachliche Gültigkeit von HotelPass-Angeboten. Deshalb sollten Änderungen immer mit kurzen Prüfungen der Ausspielungs- und Regel-Logik verbunden werden.

Typische Nutzung und Inhalte
Typische Nutzung
  • Anlage und Pflege von HotelPass-Angeboten im Dashboard
  • Verknüpfung mit Kampagnen, Preisen, Benefits und Medien
  • Prüfung, Ausspielung und spätere Einlösung von Vorteilen im HotelPass-Kontext
Hauptinhalte
  • Angebotsstammdaten und Angebotsart
  • Hotel- und Scope-Bezug des Angebots
  • Regel- und Sichtbarkeitsrelevante Grundinformationen
Beispiele
  • Ein Hotel erstellt eine exklusive Mitgliederrate mit Mindestvorteil gegenüber BAR
  • Ein spezielles HotelPass-Angebot wird einer Kampagne und passenden Medien zugeordnet und danach im Frontend ausgespielt
Beziehungen und Risiken
Wichtige Beziehungen
  • Verknüpft sich typischerweise mit Kampagnen, Preisen, Benefits, Highlights und Medien
  • Ist der zentrale Bezugspunkt für viele weitere HotelPass-Tabellen
Risiken
  • Fehlerhafte Angebotsdaten wirken sich direkt auf sichtbare HotelPass-Vorteile aus
  • Unsaubere Scope-, Aktiv- oder Regeldefinitionen können dazu führen, dass Angebote falsch ausgeliefert oder nicht nutzbar sind
Hinweise
  • Diese Tabelle gehört zu den wichtigsten Kernobjekten des HotelPass-Moduls
  • Sie ist fachlich deutlich näher an der Angebotslogik als an reinem Marketing-Content

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

Verwaltet Angebote, Member Rates, Specials oder Perks inklusive Rabattlogik, Sichtbarkeit und Vergleichsregeln.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 7 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Zentral für Vorteilslogik, Angebotssteuerung und Sichtbarkeit. | Kann mit Kampagnen, Scopes und Regeln kombiniert werden.

Risiken bei Änderungen

Fehlerhafte Rabatte, Fenster oder Aktivstatus wirken direkt auf sichtbare Member-Angebote.

Praktischer Hinweis

Operativ und sichtbar relevant für HotelPass-Angebote.

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äneHotelPass
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

Führende Angebotsquelle im HotelPass-Modul.

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 von8 Lese-Hinweise
hotel/modules/staypass/index.phphotel/modules/staypass/offers.phphotel/modules/staypass/offer_base.phphotel/modules/staypass/offer_new.phphotel/modules/staypass/offer_prices.phphotel/modules/staypass/offer_scope.phphotel/modules/staypass/offer_shared.phpmodules/staypass/dashboard.php
Wird beschrieben von1 Schreib-Hinweise
modules/staypass/dashboard.php
Zusätzliche Hinweise9 Einträge
Rabatt- und BAR-Vergleichslogik ist fachlich sensibel.#hcc#offers#used#tenant#status#hotelpass#discounts#memberrate

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
offer_id
Eindeutige Felder und Indizes
offer_idhotel_nr
Status-, Lösch- und Sichtbarkeitsfelder
active
Zeitstempel, Audit und Verknüpfungen
created_atupdated_athotel_nrupgrade_room_idupgrade_target_idpreview_room_id

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 öffnen41 Spalten
SpalteTypNullDefaultKeyExtraKommentar
offer_idbigint(20) unsignedNOPRIauto_increment
hotel_nrint(10) unsignedNOMUL
titlevarchar(140)NO
teaservarchar(160)YESNULL
descriptionlongtextYESNULL
redeem_notevarchar(400)YESNULL
kindenum('memberrate','special','perk')NO'special'
tierenum('Silver','Gold','Platinum')YESNULL
discount_typeenum('percent','amount')NO'percent'
discount_valuedecimal(10,2)NO0.00
min_discount_pctdecimal(5,2)YESNULL
bar_compare_requiredtinyint(1)NO1
booking_startdateYESNULL
booking_enddateYESNULL
stay_startdateYESNULL
stay_enddateYESNULL
activetinyint(1)NO1
upgrade_room_idint(11)YESNULL
upgrade_fee_typeenum('fixed','pct')YES'fixed'
upgrade_fee_valuedecimal(10,2)YESNULL
sort_priorityint(11)NO0
visibilityenum('staypass_only','public_teaser')NO'staypass_only'
notes_internalvarchar(255)YESNULL
created_atdatetimeNOcurrent_timestamp()
updated_atdatetimeNOcurrent_timestamp()on update current_timestamp()
archived_atdatetimeYESNULL
upgrade_target_typeenum('room','zimmerkategorie')YESNULL
upgrade_target_idint(11)YESNULL
pricing_modeenum('per_night','package')NO'per_night'
los_nightssmallint(6)YESNULL
discount_applies_toenum('room_only','room_plus_extras')NO'room_only'
default_personstinyint(4)YESNULL
preview_room_idint(11)YESNULL
price_teaser_modeenum('auto','manual')NO'auto'
price_teaser_centsint(11)YESNULL
price_teaser_currencychar(3)NO'EUR'
display_price_modevarchar(16)YES'manual'
display_price_fromdecimal(10,2)YESNULL
display_price_currencychar(3)YES'EUR'
display_price_unitvarchar(16)YES'pppn'
display_price_notevarchar(255)YESNULL