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_push_delivery

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
7
Spalten
3
Dateibezüge
3
Lese-/Schreibhinweise
3
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 – Push Delivery

Die Tabelle `hcc_sg_push_delivery` verwaltet Zustellungen von Push-Nachrichten 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_push_delivery` verwaltet Zustellungen von Push-Nachrichten 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, Zustellungen von Push-Nachrichten 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 `delivery_id`, `push_id`, `hotel_nr`, `subscription_id`, `status`, `gesendet_am`, 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 Zustellungen von Push-Nachrichten 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_push_delivery` 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 `delivery_id`, `push_id`, `hotel_nr`, `subscription_id`, `status`, `gesendet_am`, `error_text`. Typische Beziehungen bestehen zu `hcc_hotel`, `hcc_sg_settings`, `hcc_sg_medien`.

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
  • Steuerung und Nachverfolgung von Push-Kommunikation
  • Verknüpfung mit angrenzenden Inhalten, Medien oder Statuslogiken
Hauptinhalte
  • Felder wie `delivery_id`, `push_id`, `hotel_nr`, `subscription_id`
  • Felder wie `status`, `gesendet_am`, `error_text`
Beispiele
  • Ein Hotel pflegt im StayGuide-Bereich neue Daten für `hcc_sg_push_delivery` und diese erscheinen danach in Backend, Vorschau oder Gästemappe
  • Eine Push-Kampagne wird erstellt, geplant und die Zustellung später protokolliert
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
  • 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

Protokolliert die Zustellung einzelner Push-Nachrichten an Abonnements oder Sessions.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 3 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Verbindet Push-Kampagnen mit Übersetzungen, Abonnements und Zustellstatus.

Risiken bei Änderungen

Fehlerhafte Zustell- oder Zielgruppendaten können zu nicht gesendeten, falschen oder unerwünschten Push-Nachrichten führen.

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
PIInein
Aufbewahrung und Historie

Verlaufs- und Protokolldaten nur mit definierter Archivierungs- bzw. Löschstrategie bereinigen.

Worauf bei Datenqualität zu achten ist

hotel_nr, Primärschlüssel und abhängige Zuordnungen müssen konsistent bleiben.

Risiko bei Umbauten

Änderungen mit kurzem Funktions- und Ausgabetest absichern.

Führende Datenquelle

Führende Push- und Zustellquelle 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 von3 Lese-Hinweise
hotel/modules/stayguide/push_edit.phphotel/modules/stayguide/reports.phphotel/modules/stayguide/tabellen.sql
Wird beschrieben von0 Schreib-Hinweise

Aktuell sind keine schreibenden Prozesse oder Hinweise dokumentiert.

Zusätzliche Hinweise8 Einträge
#hcc#push#delivery#used#tenant#status#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
delivery_id
Eindeutige Felder und Indizes
delivery_idpush_idsubscription_id
Status-, Lösch- und Sichtbarkeitsfelder
status
Zeitstempel, Audit und Verknüpfungen
push_idhotel_nrsubscription_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 öffnen7 Spalten
SpalteTypNullDefaultKeyExtraKommentar
delivery_idbigint(20)NOPRIauto_increment
push_idbigint(20)NOMUL
hotel_nrint(11)NO
subscription_idbigint(20)YESNULLMUL
statusvarchar(16)NO'queued'
gesendet_amdatetimeYESNULL
error_textvarchar(255)YESNULL