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_hotel_zusatzleistung

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

← Zurück zu Datenbank

Inventar / ZusatzleistungenNutzung: aktivKritikalität: hochTenant-Key: zz_hotel_nrGo-Live: mittel
19
Spalten
7
Dateibezüge
8
Lese-/Schreibhinweise
2
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.
Tenant-/Hotelbezug
Dieser Bereich arbeitet direkt mit hotel- bzw. mandantenbezogenem Scope. Änderungen sollten immer auf saubere Zuordnung und Scope-Logik geprüft werden.

Langbeschreibung

Hotel-Zusatzleistungen und buchbare Extras

Die Tabelle `hcc_hotel_zusatzleistung` speichert die Zusatzleistungen eines Hotels. Dazu gehören Leistungen oder Extras, die nicht das eigentliche Zimmer selbst sind, aber zusätzlich angeboten, verkauft, angezeigt oder mit Zimmern verknüpft werden können. Sie bildet damit die zentrale Stammdatenbasis für viele Upsell- und Service-Themen innerhalb des Hotelkontexts.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_hotel_zusatzleistung` speichert die Zusatzleistungen eines Hotels. Dazu gehören Leistungen oder Extras, die nicht das eigentliche Zimmer selbst sind, aber zusätzlich angeboten, verkauft, angezeigt oder mit Zimmern verknüpft werden können. Sie bildet damit die zentrale Stammdatenbasis für viele Upsell- und Service-Themen innerhalb des Hotelkontexts.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, Zusatzleistungen eines Hotels strukturiert zu führen. Gemeint sind Leistungen wie Frühstück, Parkplatz, Haustier-Zuschlag, Spa-Zugang, Late Check-out, Kinderbett, Wellness-Angebote oder andere hotelbezogene Extras. `hcc_hotel_zusatzleistung` hält diese Leistungen mit Preis, Kategorie, Einheit, Aktivstatus und weiteren Stammdaten so fest, dass sie in Backend, Buchungsstrecke, Mapping-Tabellen oder internen Verwaltungsprozessen wiederverwendet werden können.

Warum es sie gibt

Diese Tabelle existiert, weil Extras und Zusatzleistungen in Hotels eine eigene fachliche Ebene bilden. Sie gehören nicht direkt zu den reinen Zimmer-Stammdaten, sind aber trotzdem ein wichtiger Bestandteil des Angebots. Ohne eine eigene zentrale Tabelle müssten solche Leistungen in unterschiedlichen Bereichen mehrfach gepflegt oder sogar frei als Text eingetragen werden. `hcc_hotel_zusatzleistung` löst dieses Problem, indem Zusatzleistungen als sauber definierte Stammdatensätze geführt werden. Dadurch können sie wiederverwendet, kategorisiert, bepreist und später gezielt Zimmern, Angeboten oder Buchungsstrecken zugeordnet werden.

Nutzen im Alltag

Aus geschäftlicher Sicht ist diese Tabelle wichtig, weil Zusatzleistungen oft direkten Umsatz erzeugen und gleichzeitig ein zentraler Teil des Hotelangebots sind. Eine saubere Verwaltung von Extras verbessert nicht nur die Pflege im Backend, sondern auch die Klarheit für Buchungsstrecken, Upsell-Logik und interne Organisation. Wenn Zusatzleistungen konsistent geführt werden, können Hotels ihr Angebot strukturierter präsentieren, leichter erweitern und besser kontrollieren.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist diese Tabelle das offizielle Verzeichnis der Extras eines Hotels. Sie enthält also nicht die Zimmer selbst, sondern alles, was ein Gast zusätzlich buchen oder was das Hotel zusätzlich anbieten kann. Man kann sich `hcc_hotel_zusatzleistung` wie eine strukturierte Service-Liste vorstellen: Dort steht zum Beispiel, welche Zusatzleistungen es gibt, wie sie heißen, was sie kosten und ob sie aktuell aktiv sind. Andere Bereiche des Systems greifen dann auf genau diese Liste zu, statt jede Zusatzleistung immer wieder neu anzulegen. Für nicht-technische Leser ist wichtig: Diese Tabelle ist die zentrale Grundlage dafür, dass Zusatzleistungen im System nicht chaotisch, sondern sauber verwaltet werden.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_hotel_zusatzleistung` die führende Stammdatentabelle für klassische hotelbezogene Zusatzleistungen. Sie ist typischerweise Ausgangspunkt für room-bezogene Mappings, Angebotszuordnungen, Upsell-Darstellung, Importprozesse und weitere Zusatzleistungslogiken. Die Tabelle verbindet den Hotel-Scope mit fachlichen Leistungsobjekten und enthält in der Regel Preis-, Kategorie-, Status- und Ordnungsinformationen. Änderungen an Identifikatoren, Preislogik, Aktivstatus oder Kategorisierung wirken sich daher häufig unmittelbar auf Darstellung, Auswahl, Zuordnung und operative Pflegeprozesse aus.

Was Änderungen auslösen können

Änderungen an `hcc_hotel_zusatzleistung` wirken häufig über die Tabelle selbst hinaus. Besonders betroffen sind Preisdarstellung, room-bezogene Leistungszuordnungen, Importprozesse, Angebotslogik und interne Verwaltungsoberflächen. Wer Struktur, Kennungen, Preisfelder oder Aktivlogik verändert, sollte deshalb mitdenken, welche abhängigen Bereiche diese Zusatzleistungen lesen oder weiterverarbeiten. Diese Tabelle ist kein bloßes Inhaltsverzeichnis, sondern eine operative Stammdatenquelle mit direkter Wirkung auf sichtbare Extras.

Typische Nutzung und Inhalte
Typische Nutzung
  • Ein Hotel legt neue Zusatzleistungen wie Frühstück, Parkplatz oder Spa-Zugang im Backend an.
  • Preise und Aktivstatus von Zusatzleistungen werden gepflegt und aktualisiert.
  • Zimmer- oder Angebotslogiken verknüpfen passende Zusatzleistungen mit den jeweiligen Objekten.
  • Importprozesse oder Verwaltungsseiten lesen die vorhandenen Zusatzleistungen als Stammdatenquelle aus.
  • Buchungsnahe Oberflächen nutzen diese Daten, um Extras sichtbar oder auswählbar zu machen.
Hauptinhalte
  • Hotelbezogene Zusatzleistungskennung und organisatorische Zuordnung.
  • Name und fachliche Beschreibung der Zusatzleistung.
  • Preis-, Währungs- oder Einheiteninformationen.
  • Kategorie- und Sortiermerkmale zur besseren Strukturierung.
  • Aktivitäts- und Sichtbarkeitsinformationen für die operative Nutzung.
Beispiele
  • Ein Hotel pflegt ein Frühstück als tägliche Zusatzleistung mit eigenem Preis und Aktivstatus.
  • Eine Parkleistung wird angelegt und später bestimmten Zimmern oder Buchungsstrecken zugeordnet.
  • Ein Wellness-Zugang wird vorübergehend deaktiviert, sodass er in angrenzenden Bereichen nicht mehr angeboten wird.
  • Ein Import aktualisiert Preis oder Sortierung bestehender Zusatzleistungen im Hotelkontext.
Beziehungen und Risiken
Wichtige Beziehungen
  • `hcc_hotel_zusatzleistung` steht in enger Beziehung zu Mapping-Tabellen wie room-bezogenen Zusatzleistungszuordnungen.
  • Die Tabelle kann von Importen, Backend-Seiten, Angebotslogiken und buchungsnahen Oberflächen gelesen werden.
  • Kategorien oder ergänzende Strukturierungstabellen helfen dabei, Zusatzleistungen fachlich sauber zu gruppieren.
  • Wenn Leistungen deaktiviert, umbenannt oder preislich geändert werden, kann das sichtbare Angebotslogik direkt beeinflussen.
Risiken
  • Falsche Preise oder Einheiten führen zu fehlerhafter Darstellung oder falschen buchbaren Zusatzkosten.
  • Uneinheitliche Kategorien oder doppelte Leistungsobjekte machen die Pflege unübersichtlich und erschweren spätere Zuordnungen.
  • Änderungen an aktiven Leistungen können room-bezogene Mappings oder sichtbare Upsell-Bereiche ungewollt beeinflussen.
  • Wenn historische und neue Zusatzleistungsmodelle parallel existieren, muss die fachliche Abgrenzung sauber dokumentiert werden.
Hinweise
  • Für nicht-technische Leser sollte diese Tabelle immer als zentrale Extra- oder Service-Liste des Hotels erklärt werden.
  • Fachlich lohnt sich eine klare Abgrenzung zwischen klassischen Zusatzleistungen und eventuell moderneren Extra-Katalogen wie `hcc_extras`.
  • Wenn Upsell und Buchungslogik im Projekt wichtig sind, gehört diese Tabelle zu den zentralen operativen Inhaltsquellen.

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 / BereichInventar / Zusatzleistungen
Status im Projektaktiv
Hotel- / Mandanten-Schlüsselzz_hotel_nr
Wichtigkeithoch
Relevanz im Betriebmittel
Datenbank-EngineInnoDB
Zweck und Aufgabe

Speichert hotelbezogene Zusatzleistungen inklusive Preis, Einheit, Kategorie und Aktivstatus.

Wichtige Beziehungen

Mandantenbezug läuft über zz_hotel_nr. | Wird im Code von 7 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Zentrale Stammtabelle für hotelbezogene Zusatzleistungen. | Wird über Mapping-Tabellen oder Ausgabekontexte einzelnen Zimmern, Angeboten oder Buchungsstrecken zugeordnet.

Risiken bei Änderungen

Preis-, Sortier- oder Aktivstatusfehler wirken direkt auf sichtbare Leistungen, Upsell-Angebote und Leistungszuordnungen.

Praktischer Hinweis

Produktiv relevante Stammdatenquelle für Zusatzleistungen im Hotelkontext.

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äneInventar
Datenklassecore
Lifecycledauerhaft
PIInein
Aufbewahrung und Historie

Produktionsrelevante Leistungsstammdaten nur mit fachlicher Archivierungsstrategie bereinigen.

Worauf bei Datenqualität zu achten ist

Tenant-Key, Kategoriebezug, Aktivstatus und Preis-/Währungskombination konsistent halten.

Risiko bei Umbauten

Änderungen mit kurzem Funktions-, Ausgabe- und Importtest absichern.

Führende Datenquelle

Fachlich führende Tabelle für klassische hotelbezogene Zusatzleistungen.

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 von7 Lese-Hinweise
hotel/aus_zusatzleistungen.phphotel/edit_zimmer.phphotel/modules/staypass/offer_edit.phphotel/modules/staypass/offer_extras.phphotel/modules/staypass/offer_preview.phphotel/zusatzleistungen_arrangement.phphotel/zusatzleistungen_zimmer.php
Wird beschrieben von1 Schreib-Hinweise
inventar_import_extras.php
Zusätzliche Hinweise10 Einträge
#hcc#hotel#zusatzleistung#used#tenant#status#extras#upsell#services#catalog

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
zz_id
Eindeutige Felder und Indizes
zz_idzz_hotel_nrzz_created_byzz_updated_by
Status-, Lösch- und Sichtbarkeitsfelder
zz_activezz_deleted_at
Zeitstempel, Audit und Verknüpfungen
zz_hotel_nrzz_category_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 öffnen19 Spalten
SpalteTypNullDefaultKeyExtraKommentar
zz_idint(11)NOPRIauto_increment
zz_hotel_nrint(11)NOMUL
zz_leistungvarchar(200)NO
zz_categoryvarchar(60)YESNULL
zz_category_idint(11)YESNULL
zz_preisdecimal(10,2)NO0.00
zz_currencychar(3)NO'EUR'
zz_billing_unitvarchar(30)NO'pauschal'
zz_tax_ratedecimal(5,2)YESNULL
zz_infovarchar(255)YESNULL
zz_activetinyint(1)NO1
zz_sortint(11)NO0
zz_created_byint(11)YESNULLMUL
zz_updated_byint(11)YESNULLMUL
zz_datumtimestampNOcurrent_timestamp()
zz_updatetimestampNOcurrent_timestamp()on update current_timestamp()
zz_deleted_attimestampYESNULL
zz_deleted_noncebigint(20) unsignedYESNULL
zz_leistung_active_keyvarchar(260)YESNULL