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

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

← Zurück zu Datenbank

Core / HotelNutzung: aktivKritikalität: hochTenant-Key: ht_hotel_nrGo-Live: hoch
129
Spalten
31
Dateibezüge
36
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.
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

Hotel-Stammdaten und Mandantenbasis

Die Tabelle `hcc_hotel` ist die zentrale Grundtabelle eines Hotels im gesamten Booyage-System. Sie beschreibt das Hotel selbst als eigenständigen Mandanten und bildet damit die Basis, auf die sich viele weitere Tabellen, Module und Prozesse beziehen. Ohne diesen Datensatz können hotelbezogene Inhalte zwar technisch gespeichert werden, aber nicht sauber einem konkreten Hotel zugeordnet, verwaltet oder ausgewertet werden.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_hotel` ist die zentrale Grundtabelle eines Hotels im gesamten Booyage-System. Sie beschreibt das Hotel selbst als eigenständigen Mandanten und bildet damit die Basis, auf die sich viele weitere Tabellen, Module und Prozesse beziehen. Ohne diesen Datensatz können hotelbezogene Inhalte zwar technisch gespeichert werden, aber nicht sauber einem konkreten Hotel zugeordnet, verwaltet oder ausgewertet werden.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, ein Hotel mit seinen wichtigsten Stammdaten, Identifikationsmerkmalen und grundlegenden Systemeigenschaften zentral zu führen. Sie schafft eine gemeinsame Ausgangsbasis für alle Bereiche, die mit einem konkreten Hotel arbeiten, zum Beispiel Inventar, Buchung, Sichtbarkeit, Medien, Zusatzmodule, Rechte, Prüfungen oder Betriebslogik. Statt dieselben Basisinformationen in vielen unterschiedlichen Tabellen mehrfach zu pflegen, bündelt `hcc_hotel` diese Kerninformationen an einer zentralen Stelle.

Warum es sie gibt

Diese Tabelle existiert, weil das System ein klares Zentrum pro Hotel braucht. In einem modularen und mandantenfähigen System wie Booyage muss jederzeit eindeutig erkennbar sein, zu welchem Hotel Zimmer, Preise, Bilder, Module, Nutzer, Freischaltungen oder Inhalte gehören. `hcc_hotel` löst genau dieses Problem: Sie definiert das Hotel als organisatorische und technische Haupteinheit. Dadurch werden Zuordnung, Verwaltung, Erweiterbarkeit und spätere Auswertungen deutlich einfacher und stabiler.

Nutzen im Alltag

Aus geschäftlicher Sicht sorgt diese Tabelle dafür, dass jedes Hotel sauber, eindeutig und dauerhaft im System geführt werden kann. Das ist entscheidend für ein professionelles SaaS-Produkt, weil nur so Funktionen pro Hotel getrennt aktiviert, abgerechnet, dokumentiert und ausgewertet werden können. Gleichzeitig reduziert die zentrale Stammdatenhaltung Pflegeaufwand, vermeidet Inkonsistenzen und verbessert die Nachvollziehbarkeit für Support, Betrieb und Weiterentwicklung.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist diese Tabelle die digitale Hauptakte eines Hotels. Hier steht nicht jedes einzelne Detail des täglichen Betriebs, aber hier wird festgelegt, welches Hotel überhaupt im System existiert und unter welcher Kennung es geführt wird. Viele andere Bereiche bauen darauf auf. Wenn man es sich bildlich vorstellt, ist `hcc_hotel` wie der zentrale Ordner mit den wichtigsten Basisinformationen des Hotels. Zimmer, Bilder, Preise, Einstellungen und Zusatzmodule sind dann weitere Unterordner, die zu genau diesem Hotel gehören. Ohne diese Hauptakte wäre das System schnell unübersichtlich, weil Daten nicht mehr klar einem Hotel zugeordnet werden könnten.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_hotel` eine zentrale Mandanten- und Scope-Tabelle. Sie ist in vielen Bereichen die führende Referenz für hotelbezogene Datensätze und beeinflusst direkt, wie andere Tabellen ihren Geltungsbereich bestimmen. Typischerweise referenzieren nachgelagerte Tabellen das Hotel über eine Hotelnummer, Hotel-ID oder ein vergleichbares Scope-Feld. Dadurch fungiert `hcc_hotel` nicht nur als Stammdatenquelle, sondern auch als struktureller Anker für referenzielle Zuordnung, Modulfreischaltung, Prüflogik und konsistente Multi-Tenant-Verarbeitung. Änderungen an Schlüsselfeldern, Scope-relevanten Kennungen oder Basiszuständen dieser Tabelle sind deshalb architektonisch sensibel.

Was Änderungen auslösen können

Änderungen an dieser Tabelle haben häufig eine größere Reichweite als bei gewöhnlichen Fachtabellen. Das gilt besonders für Kennungen, Scope-Felder, Aktivitätszustände oder andere Stammdaten, die in Modulen und Renderprozessen weiterverwendet werden. Wer hier strukturelle Änderungen vornimmt, sollte deshalb immer prüfen, welche Tabellen, Views, Import-/Export-Prozesse, Renderlogiken und Prüfmechanismen direkt oder indirekt an `hcc_hotel` hängen. Diese Tabelle ist kein isoliertes Randobjekt, sondern ein zentrales Fundament des Systems.

Typische Nutzung und Inhalte
Typische Nutzung
  • Ein neues Hotel wird im System angelegt und erhält damit seine zentrale Mandantenbasis.
  • Backend-Ansichten laden Hotel-Stammdaten, um Kopfbereiche, Verwaltungsseiten oder Dashboards zu befüllen.
  • Weitere Tabellen nutzen die Hotelkennung aus `hcc_hotel`, um Zimmer, Preise, Bilder, Nutzer oder Inhalte korrekt zuzuordnen.
  • Module und Prüfprozesse greifen auf den Hotelkontext zu, um Freischaltungen, Status oder betriebliche Regeln je Hotel zu ermitteln.
  • Auswertungen, Exporte oder Synchronisationsprozesse verwenden das Hotel als zentrale organisatorische Einheit.
Hauptinhalte
  • Zentrale Identifikation des Hotels, zum Beispiel Hotelnummer oder interne Schlüsselwerte.
  • Basis-Stammdaten wie Name, Kontaktinformationen und allgemeine Kerndaten.
  • Systemrelevante Eigenschaften, die bestimmen, wie das Hotel im Portal oder in Modulen geführt wird.
  • Grundlagen für Mandantenbezug, Sichtbarkeit, Betriebsstatus oder weitere Verwaltungslogik.
Beispiele
  • Ein Hotel wird neu angelegt; danach können Zimmer, Bilder, Ratenpläne und Zusatzmodule diesem Hotel sauber zugeordnet werden.
  • Ein Dashboard liest Hotel-Stammdaten, um Titel, Basisinformationen und den aktuellen betrieblichen Kontext anzuzeigen.
  • Ein Modul prüft anhand des Hotelkontexts, ob bestimmte Bereiche freigeschaltet, vollständig eingerichtet oder noch im Setup sind.
  • Ein Import ordnet eingehende Daten dem richtigen Hotel zu, weil dieses Hotel bereits als zentrale Einheit in `hcc_hotel` existiert.
Beziehungen und Risiken
Wichtige Beziehungen
  • Viele hotelbezogene Tabellen referenzieren `hcc_hotel` direkt oder indirekt über Hotelnummer, Hotel-ID oder vergleichbare Scope-Felder.
  • `hcc_hotel` ist die zentrale Ausgangsbasis für Inventar, Buchung, Sichtbarkeit, Zusatzleistungen und modulbezogene Erweiterungen.
  • Nutzer-, Freischaltungs-, Prüf- und Statuslogik orientieren sich häufig am Hotelkontext aus dieser Tabelle.
  • Wenn sich zentrale Hotelkennungen ändern, müssen abhängige Tabellen und Prozesse diese Änderung konsistent mittragen.
Risiken
  • Fehlerhafte Änderungen an Schlüssel- oder Scope-Feldern können mehrere Module gleichzeitig beeinträchtigen.
  • Inkonsistente Hotelkennungen führen schnell zu fehlerhaften Zuordnungen in angrenzenden Tabellen.
  • Unklare oder uneinheitliche Stammdaten erschweren Support, Auswertung und Automatisierung.
  • Direkte Änderungen ohne Berücksichtigung abhängiger Prozesse können Seiteneffekte in Freischaltung, Darstellung oder Betriebslogik auslösen.
Hinweise
  • Diese Tabelle gehört zu den wichtigsten Kernobjekten des gesamten Systems und sollte besonders sorgfältig dokumentiert werden.
  • Für technische Änderungen an `hcc_hotel` ist eine Prüfung der abhängigen Module und Datenflüsse sinnvoll, bevor produktive Anpassungen erfolgen.
  • Für nicht-technische Leser sollte diese Tabelle immer als Hauptakte oder zentrale Basis des Hotels erklärt werden, weil das ihren Stellenwert am verständlichsten beschreibt.

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üsselht_hotel_nr
Wichtigkeithoch
Relevanz im Betriebhoch
Datenbank-EngineInnoDB
Zweck und Aufgabe

Zentrale Stammdatentabelle für Hotels. Sie bildet in vielen Bereichen die fachliche Mandantenbasis und ist Referenzpunkt für hotelbezogene Prozesse, Einstellungen und Modulzuordnungen.

Wichtige Beziehungen

Mandantenbezug läuft über ht_hotel_nr. | Wird im Code von 31 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Grundlage für Mandantenbezug in mehreren Modulen. | Wird von hotelbezogenen Tabellen und Oberflächen indirekt oder direkt referenziert.

Risiken bei Änderungen

Änderungen an Schlüsselstruktur, Hotelbezug oder zentralen Stammdaten wirken breit auf Module, Sichtbarkeit, APIs und Datenzuordnungen.

Praktischer Hinweis

Mandantenbasis mit hoher Querverwendung in mehreren Modulen.

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
Datenklassecore
Lifecycledauerhaft
PIIja
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 Stammdatenquelle für Hotel-Mandanten.

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.

Verwendet in Dateien36 Dateien
Wird gelesen von34 Lese-Hinweise
hotel/arrangement-detail.phphotel/ausstattungen.phphotel/aus_barrierefrei.phphotel/aus_freizeit.phphotel/aus_gastronomie.phphotel/aus_hotelausstattung.phphotel/aus_hotelthemen.phphotel/aus_sprachen.phphotel/aus_zahlungsmittel.phphotel/beschreibung_arrangement.phphotel/edit_arrangement.phphotel/konto.phphotel/leistung_arrangement.phphotel/list_imageszimmer-neu.phphotel/modules/stayguide/api/guestmap/guestmap_data.phphotel/modules/user-gästemappe/stayguide.phphotel/portal_readiness_audit.phphotel/preis_arrangement.phphotel/settings.phphotel/sichtbarkeit_seo_snippets.phphotel/stammdaten.phphotel/update_ausstattung.phphotel/update_barrierefrei.phphotel/update_freizeit.phphotel/update_gastronomie.phphotel/update_sprachen.phphotel/update_zahlungsmittel.phphotel/zimmer_arrangement.phphotel/zusatzleistungen_arrangement.phphotel/zusatzleistungen_zimmer.phpstammdaten.phpindex.phpphp/hotelformularfuellen.phpmodules/stayguide/api/guestmap/guestmap_data.php
Wird beschrieben von2 Schreib-Hinweise
aus_hotelausstattung.phpaus_gastronomie.php
Zusätzliche Hinweise9 Einträge
Zentrale Basistabelle des Systems.Besonders vorsichtig bei Schlüssel- und Scope-Änderungen.#hcc#hotel#used#tenant#status#core#stammdaten

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
ht_hotel_nr
Eindeutige Felder und Indizes
ht_hotel_nrht_ort
Status-, Lösch- und Sichtbarkeitsfelder
ht_aktiv
Zeitstempel, Audit und Verknüpfungen
ht_bewertungs_idht_vermittler_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 öffnen129 Spalten
SpalteTypNullDefaultKeyExtraKommentar
ht_hotel_nrint(11)NOPRIauto_increment
ht_service_pinvarchar(80)NO
ht_bewertungs_idvarchar(80)NO
ht_aktivint(1)NO
ht_sterneint(11)YESNULL
ht_doppeltint(1)NO
ht_booyageint(1)NO
ht_freeint(1)YESNULL
ht_free_bisdatetimeYESNULL
ht_bettenchar(15)YESNULL
ht_stockwerkechar(7)YESNULL
ht_hotelartvarchar(50)YESNULL
ht_hotel_logovarchar(150)YESNULL
ht_freischaltenint(2)YESNULL
ht_kostenlosint(1)NO
ht_namevarchar(80)YESNULL
ht_artvarchar(30)YESNULL
ht_strassevarchar(80)YESNULL
ht_plzvarchar(6)YESNULL
ht_ortvarchar(50)YESNULLMUL
ht_landvarchar(50)YESNULL
ht_regionvarchar(35)YESNULL
ht_bundeslandvarchar(50)YESNULL
ht_kategorievarchar(50)YESNULL
ht_telefonvarchar(50)YESNULL
ht_faxvarchar(50)YESNULL
ht_emailvarchar(80)YESNULL
ht_urlvarchar(80)YESNULL
ht_bemerkungtextYESNULL
ht_titel_beschreibungvarchar(150)YESNULL
ht_beschreibungtextYESNULL
ht_an_anredevarchar(15)YESNULL
ht_an_vornamevarchar(50)YESNULL
ht_an_nachnamevarchar(50)YESNULL
ht_an_positionvarchar(50)YESNULL
ht_an_abteilungvarchar(50)YESNULL
ht_an_telefonvarchar(40)YESNULL
ht_an_faxvarchar(30)YESNULL
ht_an_emailvarchar(80)YESNULL
ht_an_bemerkungvarchar(255)YESNULL
ht_aktivitaetenvarchar(400)YESNULL
ht_hinweistextYESNULL
ht_datum_updatevarchar(12)YESNULL
ht_zeit_updatevarchar(6)YESNULL
ht_datumtimestampYEScurrent_timestamp()
ht_checkbox_ausstattungvarchar(100)YESNULL
ht_ausstattungtextYESNULL
ht_checkbox_freizeitvarchar(50)YESNULL
ht_freizeittextYESNULL
ht_checkbox_zimmerausstattungvarchar(100)YESNULL
ht_zimmerausstattungtextYESNULL
ht_checkbox_gastronomievarchar(60)YESNULL
ht_gastronomietextYESNULL
ht_checkbox_zahlungsmittelvarchar(30)YESNULL
ht_zahlungsmitteltextYESNULL
ht_checkbox_themenvarchar(50)YESNULL
ht_hotelthementextYESNULL
ht_photelthementextYESNULL
ht_pcheckbox_themenvarchar(50)YESNULL
ht_business_card_1int(11)YESNULL
ht_business_card_2int(11)YESNULL
ht_gefundenvarchar(250)YESNULL
ht_gefunden_auswahlvarchar(35)YESNULL
ht_superiorvarchar(10)YESNULL
ht_check_intimeYESNULL
ht_check_in2timeYESNULL
ht_check_outtimeYESNULL
ht_rezeption_anfangtimeYESNULL
ht_rezeption_endetimeYESNULL
ht_rezeption_24int(1)YESNULL
ht_rezeption_anfang_wotimeYESNULL
ht_rezeption_ende_wotimeYESNULL
ht_rezeption_24_woint(1)YESNULL
ht_zentrumvarchar(5)YESNULL
ht_zentrum_mvarchar(5)YESNULL
ht_verkehrsmittelvarchar(5)YESNULL
ht_verkehrsmittel_mvarchar(5)YESNULL
ht_bahnhofvarchar(5)YESNULL
ht_bahnhof_mvarchar(5)YESNULL
ht_flughafenvarchar(5)YESNULL
ht_flughafen_mvarchar(5)YESNULL
ht_messevarchar(5)YESNULL
ht_messe_mvarchar(5)YESNULL
ht_autobahnvarchar(5)YESNULL
ht_autobahn_mvarchar(5)YESNULL
ht_bild_titelvarchar(255)YESNULL
ht_bild_titel_okint(1)YESNULL
ht_checkbox_rollstuhlvarchar(80)YESNULL
ht_rollstuhltextYESNULL
ht_checkbox_gehoerlosvarchar(80)YESNULL
ht_gehoerlostextYESNULL
ht_checkbox_sehbehinderungvarchar(80)YESNULL
ht_sehbehinderungtextYESNULL
ht_checkbox_kognitivvarchar(80)YESNULL
ht_kognitivtextYESNULL
ht_checkbox_sprachenvarchar(80)YESNULL
ht_sprachentextYESNULL
ht_checkbox_topausstattungvarchar(80)YESNULL
ht_topausstattungtextYESNULL
ht_vermittler_nrint(11)YESNULL
ht_unterkunft_artchar(50)YESNULL
ht_zimmerint(3)YESNULL
ht_hotelgruppechar(50)YESNULL
ht_pcheckbox_topausstattungvarchar(100)YESNULL
ht_ptopausstattungtextYESNULL
ht_pcheckbox_gastronomievarchar(100)YESNULL
ht_pgastronomietextYESNULL
ht_pcheckbox_freizeitvarchar(100)YESNULL
ht_pfreizeittextYESNULL
ht_pcheckbox_zahlungsmittelvarchar(100)YESNULL
ht_pzahlungsmitteltextYESNULL
ht_pcheckbox_zimmerausstattungvarchar(100)YESNULL
ht_pzimmerausstattungtextYESNULL
ht_pcheckbox_rollstuhlvarchar(100)YESNULL
ht_prollstuhltextYESNULL
ht_pcheckbox_gehoerlosvarchar(100)YESNULL
ht_pgehoerlostextYESNULL
ht_pcheckbox_sehbehinderungvarchar(100)YESNULL
ht_psehbehinderungtextYESNULL
ht_pcheckbox_kognitivvarchar(100)YESNULL
ht_pkognitivtextYESNULL
ht_pcheckbox_sprachenvarchar(50)YESNULL
ht_psprachentextYESNULL
ht_pcheckbox_ausstattungvarchar(100)YESNULL
ht_pausstattungtextYESNULL
ht_pbarrierefreitextYESNULL
ht_barrierefreitextYESNULL
ht_vertretungsberechtigtevarchar(255)YESNULL
ht_ust_idnrvarchar(64)YESNULL