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_artikel

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
13
Spalten
8
Dateibezüge
8
Lese-/Schreibhinweise
3
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 – Artikel

Die Tabelle `hcc_sg_artikel` verwaltet redaktionelle Artikel oder Content-Einträge 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_artikel` verwaltet redaktionelle Artikel oder Content-Einträge 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, redaktionelle Artikel oder Content-Einträge 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 `artikel_id`, `hotel_nr`, `kategorie_id`, `cover_medien_id`, `status`, `veroeffentlicht_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 redaktionelle Artikel oder Content-Einträge 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_artikel` 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 `artikel_id`, `hotel_nr`, `kategorie_id`, `cover_medien_id`, `status`, `veroeffentlicht_am`, `sortierung`, `flags_json`. Typische Beziehungen bestehen zu `hcc_hotel`, `hcc_sg_settings`, `hcc_sg_medien`, `hcc_sg_kategorie`.

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
  • Ausspielung der Daten in Gästemappe, Concierge oder Vorschau
  • Verknüpfung mit angrenzenden Inhalten, Medien oder Statuslogiken
Hauptinhalte
  • Felder wie `artikel_id`, `hotel_nr`, `kategorie_id`, `cover_medien_id`
  • Felder wie `status`, `veroeffentlicht_am`, `sortierung`, `flags_json`
  • Felder wie `erstellt_von`, `aktualisiert_von`, `erstellt_am`, `aktualisiert_am`
Beispiele
  • Ein Hotel pflegt im StayGuide-Bereich neue Daten für `hcc_sg_artikel` und diese erscheinen danach in Backend, Vorschau oder Gästemappe
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_kategorie`
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
Wichtigkeitmittel
Relevanz im Betriebhoch
Datenbank-EngineInnoDB
Zweck und Aufgabe

Speichert redaktionelle Artikel der Gästemappe mit Kategorie-, Cover- und Veröffentlichungslogik.

Wichtige Beziehungen

Mandantenbezug läuft über hotel_nr. | Wird im Code von 8 Datei(en) direkt referenziert. | Soft-Delete- oder Statuslogik ist in der Struktur erkennbar. | Relevant für redaktionelle Inhalte, Struktur oder Wissensbasis innerhalb von StayGuide.

Risiken bei Änderungen

Fehlerhafte Inhalte, Zuordnungen oder Statuswerte wirken sich auf sichtbare Concierge-Funktionen und interne Abläufe aus.

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
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. 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 von8 Lese-Hinweise
hotel/modules/stayguide/articles.phphotel/modules/stayguide/article_edit.phphotel/modules/stayguide/categories.phphotel/modules/stayguide/gaestemappe.phphotel/modules/stayguide/guest_preview.phphotel/modules/stayguide/index.phphotel/modules/stayguide/search.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.JSON-Feld vorhanden; Struktur bei Änderungen stabil halten.#hcc#artikel#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
artikel_id
Eindeutige Felder und Indizes
artikel_idhotel_nrkategorie_idcover_medien_id
Status-, Lösch- und Sichtbarkeitsfelder
status
Zeitstempel, Audit und Verknüpfungen
erstellt_amaktualisiert_amhotel_nrkategorie_idcover_medien_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 öffnen13 Spalten
SpalteTypNullDefaultKeyExtraKommentar
artikel_idbigint(20)NOPRIauto_increment
hotel_nrint(11)NOMUL
kategorie_idint(11)YESNULLMUL
cover_medien_idbigint(20)YESNULLMUL
statusvarchar(16)NO'entwurf'
veroeffentlicht_amdatetimeYESNULL
sortierungint(11)NO0
flags_jsonlongtextYESNULL
erstellt_vonint(11)YESNULL
aktualisiert_vonint(11)YESNULL
erstellt_amdatetimeNOcurrent_timestamp()
aktualisiert_amdatetimeNOcurrent_timestamp()on update current_timestamp()
geloescht_amdatetimeYESNULL