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_zimmerbilder

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

← Zurück zu Datenbank

Sichtbarkeit / MedienNutzung: aktivKritikalität: mittelTenant-Key: zi_hotel_nrGo-Live: mittel
18
Spalten
15
Dateibezüge
17
Lese-/Schreibhinweise
2
ID-/Verknüpfungsfelder
Tenant-/Hotelbezug
Dieser Bereich arbeitet direkt mit hotel- bzw. mandantenbezogenem Scope. Änderungen sollten immer auf saubere Zuordnung und Scope-Logik geprüft werden.

Langbeschreibung

Zimmerbilder, Galerie und visuelle Raumdarstellung

Die Tabelle `hcc_zimmerbilder` speichert die Bilder einzelner Zimmer und regelt deren visuelle Zuordnung innerhalb des Hotelkontexts. Sie ist damit die zentrale Grundlage dafür, dass Zimmer im Backend, in Vorschauen, in Portalen oder in gastnahen Oberflächen mit den richtigen Bildern dargestellt werden können. Neben dem reinen Bildbezug spielen dabei auch Reihenfolge, Titelbild-Logik und saubere Zimmerzuordnung eine wichtige Rolle.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_zimmerbilder` speichert die Bilder einzelner Zimmer und regelt deren visuelle Zuordnung innerhalb des Hotelkontexts. Sie ist damit die zentrale Grundlage dafür, dass Zimmer im Backend, in Vorschauen, in Portalen oder in gastnahen Oberflächen mit den richtigen Bildern dargestellt werden können. Neben dem reinen Bildbezug spielen dabei auch Reihenfolge, Titelbild-Logik und saubere Zimmerzuordnung eine wichtige Rolle.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, Medienobjekte einem konkreten Zimmer zuzuordnen und ihre Darstellung zu steuern. `hcc_zimmerbilder` speichert also nicht nur, dass ein Bild existiert, sondern auch zu welchem Zimmer es gehört, in welcher Reihenfolge es erscheint und welches Bild eventuell als Haupt- oder Titelbild verwendet werden soll. Dadurch wird die Zimmerdarstellung nicht in freien Dateisammlungen oder unklaren Ordnerstrukturen organisiert, sondern in einer fachlich sauber verwalteten Medienbasis.

Warum es sie gibt

Diese Tabelle existiert, weil Hotelbilder im Allgemeinen und Zimmerbilder im Besonderen eine eigene fachliche Logik haben. Ein Zimmer braucht oft mehrere Bilder, manchmal mit einer klaren Reihenfolge und einem hervorgehobenen Hauptbild. Ohne eine eigene strukturierte Tabelle müssten Bildpfade lose gespeichert oder auf andere Weise unübersichtlich verwaltet werden. `hcc_zimmerbilder` löst dieses Problem, indem die Bilddaten direkt mit dem Hotel- und Zimmerkontext verbunden werden. So kann das System zuverlässig erkennen, welche Bilder zu welchem Zimmer gehören und wie sie ausgegeben werden sollen.

Nutzen im Alltag

Aus geschäftlicher Sicht ist diese Tabelle wichtig, weil Bilder maßgeblich beeinflussen, wie professionell und attraktiv Zimmer dargestellt werden. Gute und korrekt zugeordnete Bilder verbessern die Präsentation, reduzieren Pflegechaos und unterstützen Sichtbarkeit, Conversion und Informationsqualität. Wenn Zimmerbilder sauber strukturiert verwaltet werden, können Hotels Inhalte einfacher pflegen und gleichzeitig eine deutlich konsistentere Darstellung im Portal und in angrenzenden Modulen erreichen.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist diese Tabelle die Bildverwaltung für die einzelnen Zimmer. Hier wird festgelegt, welche Fotos zu welchem Zimmer gehören und in welcher Reihenfolge sie angezeigt werden. Man kann sich `hcc_zimmerbilder` wie eine geordnete Galerie pro Zimmer vorstellen. Nicht jedes Bild wird einfach nur abgelegt, sondern es wird auch festgehalten, welches Foto das Hauptbild ist, welche weiteren Bilder zur Galerie gehören und wie diese im System erscheinen sollen. Für nicht-technische Leser ist wichtig: Diese Tabelle sorgt dafür, dass ein Zimmer nicht nur vorhanden ist, sondern auch optisch richtig dargestellt wird. Ohne sie wären Zimmerfotos schwer sauber zuzuordnen und würden im Portal oder in der Vorschau schnell unübersichtlich wirken.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_zimmerbilder` die operative Medientabelle für zimmerbezogene Bildausgabe. Sie verbindet Hotelkontext, Zimmerreferenz beziehungsweise Zimmernummer und mediale Pfade mit Ordnungs- und Titelbildlogik. In vielen Projekten ist diese Tabelle eng mit Importprozessen, Vorschauansichten, Frontend-Galerien und gastnahen Datenausgaben verbunden. Änderungen an Dateipfaden, Referenzen, Sortierfeldern, Titelbild-Flags oder Bezügen zum Zimmer wirken daher direkt auf sichtbare Oberflächen. Zusätzlich ist bei gewachsenen Projekten häufig relevant, ob die Zuordnung über Zimmer-ID, Zimmernummer oder eine Mischlogik erfolgt.

Was Änderungen auslösen können

Änderungen an `hcc_zimmerbilder` wirken fast immer direkt sichtbar nach außen. Besonders sensibel sind deshalb Bildpfade, Zimmerbezüge, Sortierfelder und Titelbild-Logik. Wer diese Tabelle strukturell verändert, sollte prüfen, welche Importprozesse, Vorschau-Renderings, Galeriekomponenten und gastnahen Datenausgaben darauf aufbauen. Diese Tabelle ist nicht nur eine technische Dateiliste, sondern die operative Grundlage für die visuelle Zimmerdarstellung.

Typische Nutzung und Inhalte
Typische Nutzung
  • Ein Hotel oder ein Importprozess lädt mehrere Bilder für ein bestimmtes Zimmer hoch und ordnet sie korrekt zu.
  • Die Reihenfolge der Zimmerbilder wird gepflegt, damit die Galerie sinnvoll dargestellt wird.
  • Ein Bild wird als Titel- oder Hauptbild markiert, damit es zuerst angezeigt wird.
  • Frontend- oder Vorschauansichten lesen die zugeordneten Zimmerbilder für Galerien und Karten aus.
  • Gastnahe Oberflächen nutzen die Bilddaten, um Räume visuell verständlich zu präsentieren.
Hauptinhalte
  • Hotelbezogener Medienbezug im Kontext eines Zimmers.
  • Zimmerzuordnung über Zimmernummer, Zimmerreferenz oder vergleichbare Kennungen.
  • Bildpfade, Dateiinformationen oder technische Medienreferenzen.
  • Sortierung und Reihenfolge der Bilder innerhalb einer Galerie.
  • Titelbild- oder Hauptbild-Status für die priorisierte Darstellung.
Beispiele
  • Für Zimmer 204 werden fünf Bilder hochgeladen; eines davon wird als Hauptbild markiert.
  • Ein Import ordnet Bilder anhand der Zimmernummer korrekt dem jeweiligen Raum zu.
  • Eine Vorschauseite liest die sortierte Zimmergalerie aus und zeigt zuerst das Titelbild an.
  • Ein altes Bild wird ersetzt, ohne dass die restliche Reihenfolge der Galerie verloren geht.
Beziehungen und Risiken
Wichtige Beziehungen
  • `hcc_zimmerbilder` steht in direkter Beziehung zu `hcc_zimmer`, weil die Bilder einem konkreten Raum zugeordnet werden müssen.
  • Importseiten und Medienverwaltungsprozesse schreiben oder aktualisieren Datensätze dieser Tabelle.
  • Vorschau-, Portal- und Gastansichten lesen die Bilddaten, um Zimmer optisch darzustellen.
  • Die Cover- beziehungsweise Titelbildlogik hat direkte Auswirkungen darauf, welches Bild in Übersichten zuerst erscheint.
Risiken
  • Falsche Zimmerzuordnungen führen dazu, dass Bilder beim falschen Zimmer erscheinen.
  • Fehlerhafte Dateipfade oder Medienreferenzen erzeugen leere Bildflächen oder kaputte Galerien.
  • Unsaubere Sortierung oder mehrere konkurrierende Titelbilder machen die Darstellung unruhig oder widersprüchlich.
  • Änderungen an Zuordnungslogik ohne Prüfung angrenzender Ausgaben können Vorschau, Frontend und Gastansichten gleichzeitig beeinflussen.
Hinweise
  • Für nicht-technische Leser sollte diese Tabelle als geordnete Zimmergalerie mit Hauptbildlogik beschrieben werden.
  • Wenn es im Projekt unterschiedliche Referenzmodelle für Zimmer gibt, sollte die Medienzuordnung besonders sorgfältig dokumentiert werden.
  • Diese Tabelle ist technisch relativ einfach zu verstehen, aber operativ sehr sichtbar und deshalb qualitativ besonders wichtig.

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 / BereichSichtbarkeit / Medien
Status im Projektaktiv
Hotel- / Mandanten-Schlüsselzi_hotel_nr
Wichtigkeitmittel
Relevanz im Betriebmittel
Datenbank-EngineInnoDB
Zweck und Aufgabe

Speichert Zimmerbilder, Sortierung, Titelbild-Logik und mediale Zuordnung innerhalb des Hotel- und Zimmerkontexts.

Wichtige Beziehungen

Mandantenbezug läuft über zi_hotel_nr. | Wird im Code von 15 Datei(en) direkt referenziert. | Verknüpft Hotelbezug, Zimmernummer und sichtbare Medien. | Wirkt direkt auf Frontend- und Vorschau-Ausgaben.

Risiken bei Änderungen

Fehlerhafte Zuordnung, Sortierung oder Dateipfade wirken sich direkt auf sichtbare Ausgaben und Galerie-Logik aus.

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äneSichtbarkeit
Datenklassecontent
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 mit kurzem Funktions- und Ausgabetest absichern.

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 von16 Lese-Hinweise
hotel/edit_zimmer.phphotel/edit_zimmer2.phphotel/hotel_bildergalerie.phphotel/list_imageszimmer-neu.phphotel/list_imageszimmer.phphotel/modules/staypass/offer_media_rooms.phphotel/preis_zimmer.phphotel/sichtbarkeit_import_zimmerbilder.phphotel/upload-zimmer.phphotel/upload_zimmer.phphotel/upload_zimmerfoto.phphotel/zimmer.phphotel/zimmer2.phphotel/zimmerfotos.phphotel/zimmer_vorschau.phpmodules/stayguide/api/guestmap/guestmap_data.php
Wird beschrieben von1 Schreib-Hinweise
sichtbarkeit_import_zimmerbilder.php
Zusätzliche Hinweise9 Einträge
Besonders relevant für Cover-/Titelbild-Logik.#hcc#zimmerbilder#used#tenant#media#rooms#visibility#gallery

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
zi_id
Eindeutige Felder und Indizes
zi_idzi_hotel_nrzi_zimmer_nr
Status-, Lösch- und Sichtbarkeitsfelder

Es wurden keine typischen Status-, Lösch- oder Sichtbarkeitsfelder erkannt.

Zeitstempel, Audit und Verknüpfungen
zi_created_atzi_updated_atzi_hotel_nrzi_zimmer_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 öffnen18 Spalten
SpalteTypNullDefaultKeyExtraKommentar
zi_idint(11)NOPRIauto_increment
zi_hotel_nrint(11)YESNULLMUL
zi_zimmer_nrint(11)YESNULLMUL
zi_bild_namevarchar(45)YESNULL
zi_bild_pathvarchar(255)YESNULL
zi_bild_thumbnailvarchar(255)YESNULL
zi_bild_geprueftint(1)YESNULL
zi_bild_zeigenint(1)YESNULL
zi_titelbildint(1)YESNULL
zi_created_attimestampYEScurrent_timestamp()
zi_updated_atdatetimeYESNULLon update current_timestamp()
zi_bild_gesperrtint(1)YESNULL
zi_bild_gesperrt_datumdateYESNULL
zi_checksumchar(40)YESNULL
zi_original_namevarchar(200)YESNULL
zi_filesizeint(11)YESNULL
zi_mimevarchar(50)YESNULL
zi_sortint(11)NO0