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_campaign

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
10
Spalten
4
Dateibezüge
4
Lese-/Schreibhinweise
1
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 Campaign

Die Tabelle `hcc_sg_push_campaign` verwaltet Push-Kampagnen 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_campaign` verwaltet Push-Kampagnen 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, Push-Kampagnen 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 `push_id`, `hotel_nr`, `zielgruppe_json`, `senden_am`, `status`, `erstellt_von`, 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 Push-Kampagnen 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_campaign` 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 `push_id`, `hotel_nr`, `zielgruppe_json`, `senden_am`, `status`, `erstellt_von`, `erstellt_am`, `aktualisiert_am`. 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 `push_id`, `hotel_nr`, `zielgruppe_json`, `senden_am`
  • Felder wie `status`, `erstellt_von`, `erstellt_am`, `aktualisiert_am`
  • Felder wie `geloescht_am`, `geloescht_von`
Beispiele
  • Ein Hotel pflegt im StayGuide-Bereich neue Daten für `hcc_sg_push_campaign` 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

Verwaltet Push-Kampagnen, Zielgruppen und Versandstatus im Concierge-Modul.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 4 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
Datenklassecontent
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.

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 von4 Lese-Hinweise
hotel/modules/stayguide/index.phphotel/modules/stayguide/push.phphotel/modules/stayguide/push_edit.phphotel/modules/stayguide/tabellen.sql
Wird beschrieben von0 Schreib-Hinweise

Aktuell sind keine schreibenden Prozesse oder Hinweise dokumentiert.

Zusätzliche Hinweise9 Einträge
Soft-Delete-Feld vorhanden.#hcc#push#campaign#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
push_id
Eindeutige Felder und Indizes
push_idhotel_nr
Status-, Lösch- und Sichtbarkeitsfelder
status
Zeitstempel, Audit und Verknüpfungen
erstellt_amaktualisiert_amhotel_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 öffnen10 Spalten
SpalteTypNullDefaultKeyExtraKommentar
push_idbigint(20)NOPRIauto_increment
hotel_nrint(11)NOMUL
zielgruppe_jsonlongtextYESNULL
senden_amdatetimeYESNULL
statusvarchar(16)NO'entwurf'
erstellt_vonint(11)YESNULL
erstellt_amdatetimeNOcurrent_timestamp()
aktualisiert_amdatetimeNOcurrent_timestamp()on update current_timestamp()
geloescht_amdatetimeYESNULL
geloescht_vonbigint(20)YESNULL