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_sg_dokument_i18n

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

← Zurück zu Datenbank

Booyage ConciergeNutzung: aktivKritikalität: mittelTenant-Key: hotel_nrGo-Live: hoch
6
Spalten
9
Dateibezüge
9
Lese-/Schreibhinweise
2
ID-/Verknüpfungsfelder
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

StayGuide – Dokument Mehrsprachigkeit

Die Tabelle `hcc_sg_dokument_i18n` verwaltet mehrsprachige Texte und Übersetzungen im Modul Booyage Concierge bzw. StayGuide. Sie sorgt dafür, dass dieser Teilbereich nicht lose im Code oder in Einzelkonfigurationen verteilt ist, sondern als eigener fachlicher Datenbaustein im StayGuide / Concierge-Kontext geführt werden kann.

Überblick
Kurzbeschreibung

Die Tabelle `hcc_sg_dokument_i18n` verwaltet mehrsprachige Texte und Übersetzungen im Modul Booyage Concierge bzw. StayGuide. Sie sorgt dafür, dass dieser Teilbereich nicht lose im Code oder in Einzelkonfigurationen verteilt ist, sondern als eigener fachlicher Datenbaustein im StayGuide / Concierge-Kontext geführt werden kann.

Fachlicher Zweck
Wofür diese Tabelle gebraucht wird

Der Hauptzweck dieser Tabelle besteht darin, mehrsprachige Texte für den zugrundeliegenden Basisdatensatz zu speichern. Dadurch können Inhalte, Labels oder redaktionelle Beschreibungen sprachabhängig gepflegt werden, ohne die technische Basistabelle zu duplizieren. Typische Felder in diesem Zusammenhang sind `dokument_i18n_id`, `dokument_id`, `hotel_nr`, `lang`, `titel`, `beschreibung`.

Warum es sie gibt

Diese Tabelle existiert, weil Inhalte in einem Hotel- und Gästeumfeld fast immer mehrsprachig benötigt werden. Ohne einen separaten Übersetzungsbaustein würden technische Strukturen und Sprachinhalte unübersichtlich vermischt oder jede Sprache müsste als eigene Haupttabelle modelliert werden.

Nutzen im Alltag

Die Tabelle erhöht den praktischen Nutzen des StayGuide-Moduls, weil sie einen klar abgegrenzten Funktionsbereich stabil und wartbar abbildet. Das verbessert sowohl die Gästeerfahrung als auch die interne Pflege im Hotel oder im Booyage-Backend.

Einfach erklärt
Für Nicht-Techniker

Einfach erklärt ist dies die Sprach-Erweiterung der eigentlichen Basistabelle. Hier stehen nicht neue fachliche Objekte im Mittelpunkt, sondern dieselben Inhalte noch einmal in anderen Sprachen, damit Gäste und Mitarbeitende passende Texte je nach Sprache sehen können.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_sg_dokument_i18n` eine sprachabhängige Ergänzungstabelle. Sie referenziert typischerweise einen Basissatz und ergänzt ihn um lokalisierte Werte. Typische Spalten sind `dokument_i18n_id`, `dokument_id`, `hotel_nr`, `lang`, `titel`, `beschreibung`. In der Anwendung wird sie meist gemeinsam mit der Haupttabelle geladen, damit Fallbacks, Standardsprachen und übersetzte Ausgaben sauber umgesetzt werden können.

Was Änderungen auslösen können

Änderungen an Struktur oder Schlüsseln wirken sich vor allem auf Übersetzungslogik, Fallbacks und Frontend-Ausgaben aus. Besonders kritisch sind Änderungen an Referenzen zur Basistabelle oder an Sprachkennungen.

Typische Nutzung und Inhalte
Typische Nutzung
  • Pflege und Ausspielung sprachabhängiger Inhalte
  • Laden der passenden Sprachversion im Frontend oder Backend
  • Fallback auf Standardsprache, wenn keine Übersetzung vorhanden ist
Hauptinhalte
  • Felder wie `dokument_i18n_id`, `dokument_id`, `hotel_nr`, `lang`
  • Felder wie `titel`, `beschreibung`
Beispiele
  • Ein Artikel wird auf Deutsch und Englisch gepflegt, wobei die Basistabelle gleich bleibt und nur die Texte je Sprache variieren
Beziehungen und Risiken
Wichtige Beziehungen
  • Bezieht sich fachlich auf ein Hotel und erbt oft dessen Mandanten-Scope
  • Steht fachlich in Beziehung zu `hcc_sg_settings`
  • Kann mit Medien, Covern oder Dateiobjekten verbunden sein
Risiken
  • Fehlende Übersetzungen führen schnell zu uneinheitlichen oder unverständlichen Oberflächen
  • Unsaubere Status- oder Scope-Daten können direkt in der Gästemappe sichtbar werden
  • Mehrdeutige Zustände oder fehlende Referenzen erschweren Support und Fehlersuche
  • Historisch gewachsene Felder sollten vor größeren Umstellungen geprüft werden
Hinweise
  • Die Tabelle ist hotelbezogen und sollte in Mehrmandanten-Szenarien immer mit sauberem Hotel-Scope betrachtet werden.
  • Mehrsprachigkeit ist hier Teil des Designs und kein nachträglicher Sonderfall.
  • Die Tabelle gehört fachlich zum StayGuide-/Concierge-Kontext, auch wenn einzelne Inhalte von anderen Modulen mitgenutzt werden können.

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

Speichert sprachabhängige Titel und Beschreibungen für Concierge-Dokumente.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 9 Datei(en) direkt referenziert. | Erweitert den Basissatz um sprachabhängige Inhalte. | Muss konsistent mit Primärdatensatz, hotel_nr und lang gepflegt werden.

Risiken bei Änderungen

Fehlerhafte Übersetzungs- oder Slug-Daten führen zu inkonsistenter Ausgabe, falscher Sprache oder kaputten Deep-Links.

Praktischer Hinweis

Direkter Einfluss auf sichtbare Concierge-Inhalte oder produktive Modulsteuerung.

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äneConcierge
Datenklassemapping
Lifecycledauerhaft
PIInein
Aufbewahrung und Historie

Produktionsrelevante Daten nur mit fachlicher Archivierungsstrategie bereinigen.

Worauf bei Datenqualität zu achten ist

hotel_nr, Primärschlüssel und abhängige Zuordnungen müssen konsistent bleiben. Kombination aus Basissatz, hotel_nr und lang sauber eindeutig halten.

Risiko bei Umbauten

Änderungen mit kurzem Funktions- und Ausgabetest absichern.

Führende Datenquelle

Führende Sprach- und Übersetzungsquelle innerhalb des Concierge-Moduls.

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 von9 Lese-Hinweise
hotel/modules/stayguide/api/guestmap/guestmap_data.phphotel/modules/stayguide/documents.phphotel/modules/stayguide/document_edit.phphotel/modules/stayguide/facilities.phphotel/modules/stayguide/gaestemappe.phphotel/modules/stayguide/guest_preview.phphotel/modules/stayguide/legal.phphotel/modules/stayguide/media.phphotel/modules/stayguide/tabellen.sql
Wird beschrieben von0 Schreib-Hinweise

Aktuell sind keine schreibenden Prozesse oder Hinweise dokumentiert.

Zusätzliche Hinweise8 Einträge
Typische Paarung mit Basistabelle und lang-Spalte.#hcc#dokument#i18n#used#tenant#concierge#stayguide

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

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

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

Zeitstempel, Audit und Verknüpfungen
dokument_idhotel_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 öffnen6 Spalten
SpalteTypNullDefaultKeyExtraKommentar
dokument_i18n_idbigint(20)NOPRIauto_increment
dokument_idbigint(20)NOMUL
hotel_nrint(11)NOMUL
langvarchar(12)NO
titelvarchar(255)NO
beschreibungtextYESNULL