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_service_request

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

← Zurück zu Datenbank

Booyage ConciergeNutzung: aktivKritikalität: niedrigTenant-Key: hotel_nrGo-Live: mittel
19
Spalten
2
Dateibezüge
2
Lese-/Schreibhinweise
4
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

StayGuide – Service Request

Die Tabelle `hcc_sg_service_request` verwaltet Serviceanfragen 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_service_request` verwaltet Serviceanfragen 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, Serviceanfragen im StayGuide-Modul strukturiert zu speichern und pro Hotel oder Funktionsbereich verfügbar zu machen. Sie hält dafür fachlich relevante Informationen zusammen, zum Beispiel über `request_id`, `hotel_nr`, `gast_id`, `session_id`, `guest_ref`, `booking_ref`, und macht diese Informationen für Backend, Gästeoberfläche, Kommunikation oder Automationslogik nutzbar.

Warum es sie gibt

Diese Tabelle existiert, weil StayGuide aus vielen klar getrennten Funktionsbereichen besteht: Inhalte, Gäste, Kommunikation, Service, Branding, Rechtstexte, Push-Nachrichten und weitere modulnahe Prozesse. Ohne eine eigene Tabelle für diesen Bereich würden Daten in JSON-Feldern, Einzellogiken oder UI-Sonderfällen verschwinden und wären deutlich schwerer pflegbar.

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 diese Tabelle der Bereich, in dem StayGuide Serviceanfragen organisiert. Für nicht-technische Leser kann man sich das wie einen sauber abgegrenzten Verwaltungsordner vorstellen: Statt Informationen lose in einer Oberfläche zusammenzuklicken, gibt es hier einen festen Platz, an dem der jeweilige Inhalt, Prozess oder Status hinterlegt wird. Dadurch wird die Gästemappe nicht nur schöner, sondern verlässlicher, weil das System weiß, welche Informationen zu welchem Hotel, Gast, Inhalt oder Ablauf gehören.

Technische Einordnung
Für Entwickler

Technisch ist `hcc_sg_service_request` eine modulnahe Fach- bzw. Steuerungstabelle innerhalb von StayGuide. Je nach Funktionsbereich wird sie von Backend-Masken, Gäste-Views, Kommunikationsflows oder Automationslogik gelesen und teilweise auch geschrieben. Relevante Felder sind unter anderem `request_id`, `hotel_nr`, `gast_id`, `session_id`, `guest_ref`, `booking_ref`, `request_typ`, `entity_typ`. Typische Beziehungen bestehen zu `hcc_hotel`, `hcc_sg_settings`, `hcc_sg_medien`, `hcc_sg_gast`.

Was Änderungen auslösen können

Änderungen an dieser Tabelle wirken sich in der Regel direkt auf Backend-Pflege, StayGuide-Ausgabe oder angrenzende Kommunikations- bzw. Serviceprozesse aus. Vor allem Statusfelder, Scope-Felder und Referenzen zu Medien, Gästen oder Inhalten sollten kontrolliert geändert werden.

Typische Nutzung und Inhalte
Typische Nutzung
  • Pflege des betreffenden StayGuide-Bereichs im Backend
  • Bearbeitung von Gästewünschen oder Serviceanfragen
  • Verknüpfung mit angrenzenden Inhalten, Medien oder Statuslogiken
Hauptinhalte
  • Felder wie `request_id`, `hotel_nr`, `gast_id`, `session_id`
  • Felder wie `guest_ref`, `booking_ref`, `request_typ`, `entity_typ`
  • Felder wie `entity_id`, `von`, `bis`, `menge`
Beispiele
  • Ein Hotel pflegt im StayGuide-Bereich neue Daten für `hcc_sg_service_request` und diese erscheinen danach in Backend, Vorschau oder Gästemappe
  • Ein Gast sendet einen Wunsch, der als Serviceanfrage gespeichert und anschließend bearbeitet wird
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
  • Steht fachlich in Beziehung zu `hcc_sg_gast`
Risiken
  • 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.
  • 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
Wichtigkeitniedrig
Relevanz im Betriebmittel
Datenbank-EngineInnoDB
Zweck und Aufgabe

Erfasst operative Gästeanfragen wie Housekeeping, Services oder Bestellungen im Concierge-Kontext.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 2 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Verknüpft Gästekontext mit operativen Serviceanforderungen und Kommunikationsverlauf.

Risiken bei Änderungen

Fehlerhafte Status- oder Zuordnungsdaten beeinträchtigen operative Abläufe und Eskalationen.

Praktischer Hinweis

Produktiv relevante Tabelle innerhalb des dokumentierten Concierge-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äneConcierge
Datenklassetransactional
Lifecycledauerhaft
PIIja
Aufbewahrung und Historie

Personen- oder kontobezogene Daten nur gemäß Berechtigungs- und Löschkonzept bereinigen.

Worauf bei Datenqualität zu achten ist

hotel_nr, Primärschlüssel und abhängige Zuordnungen müssen konsistent bleiben. JSON-Felder nur in stabil dokumentierter Struktur schreiben.

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 von2 Lese-Hinweise
hotel/modules/stayguide/api/guestmap/invoice_request.phphotel/modules/stayguide/tabellen.sql
Wird beschrieben von0 Schreib-Hinweise

Aktuell sind keine schreibenden Prozesse oder Hinweise dokumentiert.

Zusätzliche Hinweise10 Einträge
JSON-Feld vorhanden; Struktur bei Änderungen stabil halten.#hcc#service#request#used#tenant#status#concierge#stayguide#service-request

Schlüssel & Lifecycle

Wichtige Strukturmerkmale

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

Primärschlüssel
request_id
Eindeutige Felder und Indizes
request_idhotel_nrgast_idsession_id
Status-, Lösch- und Sichtbarkeitsfelder
status
Zeitstempel, Audit und Verknüpfungen
erstellt_amaktualisiert_amhotel_nrgast_idsession_identity_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
request_idbigint(20)NOPRIauto_increment
hotel_nrint(11)NOMUL
gast_idbigint(20)YESNULLMUL
session_idbigint(20)YESNULLMUL
guest_refvarchar(64)YESNULL
booking_refvarchar(64)YESNULL
request_typvarchar(32)NO
entity_typvarchar(32)YESNULL
entity_idbigint(20)YESNULL
vondatetimeYESNULL
bisdatetimeYESNULL
mengedecimal(10,2)YESNULL
preis_snapshotdecimal(10,2)YESNULL
waehrungchar(3)NO'EUR'
bemerkungvarchar(255)YESNULL
statusvarchar(16)NO'offen'
meta_jsonlongtextYESNULL
erstellt_amdatetimeNOcurrent_timestamp()
aktualisiert_amdatetimeNOcurrent_timestamp()on update current_timestamp()