Erweitere Marktmanagement-Datenhierarchie

docs/modules/market_management/data/market_management_data_architecture.md

@@ -0,0 +1,82 @@
+# market_management_data_architecture
+
+Stand: 2026-09-18
+Status: Bestätigtes Datenarchitektur-Zielbild; Feldzuordnung teilweise offen
+
+## 1. Ziel
+
+Das Marktmanagement-Modul muss wiederkehrende Märkte mit mehreren konkreten
+Durchführungen und mehreren Tagen je Durchführung ohne redundante Vermischung
+der Daten abbilden können.
+
+## 2. Bestätigte Hierarchie
+
+```text
+Kategorie ─── Markt 1 ─── n Durchführung 1 ─── n Durchführungstag
+```
+
+Für Kategorie und Markt werden beliebig viele Datensätze unterstützt. Ob die
+Zuordnung Kategorie–Markt `1:n` oder `n:m` ist, bleibt offen.
+
+### Kategorie
+
+Eine Kategorie ordnet Märkte fachlich. Die konkrete Kategorisierung und die
+zulässigen Kategorieattribute sind noch nicht weiter spezifiziert.
+
+### Markt
+
+Ein Markt ist die übergeordnete fachliche Identität, unter der mehrere konkrete
+Durchführungen geführt werden können.
+
+### Durchführung
+
+Eine Durchführung ist eine konkrete Ausgabe bzw. Teilnahme an einem Markt. Die
+Durchführung kann einen oder mehrere Durchführungstage umfassen.
+
+### Durchführungstag
+
+Ein Durchführungstag ist ein einzelner Tag innerhalb einer konkreten
+Durchführung. Tagesbezogene Zeit-, Erlös- und Verkaufsdaten gehören auf diese
+Ebene.
+
+## 3. Ownership- und Normalisierungsregeln
+
+- Jede Ebene erhält eine eigene stabile Identität.
+- Mehrere Durchführungstage werden nicht als wiederholte Spalten in der
+  Durchführung gespeichert.
+- Mehrere Durchführungen werden nicht als wiederholte Spalten im Markt
+  gespeichert.
+- Tageserlöse und Tagesverkaufszahlen werden nur am Durchführungstag erfasst.
+- Aggregierte Werte für Durchführung oder Markt werden aus den untergeordneten
+  Durchführungstagen abgeleitet oder als klar definierte Auswertung bereitgestellt.
+- MCP-Schreiboperationen müssen eindeutig an die betroffene Ebene gebunden sein.
+- Fremde Modul- oder DB-Ownership wird durch diese Datenarchitektur nicht
+  eingeführt.
+
+## 4. Noch offene Feldzuordnung
+
+Die Anforderungen enthalten Felder, deren genaue Ebene noch nicht verbindlich
+bestimmt ist. Dazu gehören insbesondere:
+
+- Marktname und Marktart
+- Veranstalter- und Kontaktdaten
+- Anmeldung und Bestätigung
+- Stand, Infrastruktur und Logistik
+- Kosten und Zahlungsdaten
+- Vertrag und Unterlagen
+- Statuswerte
+
+Vor der DB-Implementierung muss für jedes Feld festgelegt werden, ob es zur
+Kategorie, zum Markt, zur Durchführung oder zum Durchführungstag gehört. Diese
+Entscheidung darf nicht aus der Tabellenbequemlichkeit abgeleitet werden.
+
+## 5. Offene fachliche Fragen
+
+- Ist die Zuordnung Kategorie–Markt `1:n` oder `n:m`?
+- Sind Kategorien frei erweiterbar oder gibt es eine verwaltete Liste?
+- Ist eine Durchführung immer eine konkrete Teilnahme oder eine allgemeine
+  Veranstaltungsausgabe?
+- Welche Felder gelten dauerhaft für den Markt und welche können sich je
+  Durchführung ändern?
+- Welche Felder gelten für die gesamte Durchführung und welche ausschließlich
+  für einzelne Durchführungstage?