Definiere zentrale Marktstammdaten

docs/modules/market_management/data/market_management_data_architecture.md

@@ -1,7 +1,7 @@
 # market_management_data_architecture
 
 Stand: 2026-09-18
-Status: Bestätigtes Datenarchitektur-Zielbild; Feldzuordnung teilweise offen
+Status: Bestätigtes Datenarchitektur-Zielbild; einzelne Kardinalitäten offen
 
 ## 1. Ziel
 
@@ -26,7 +26,8 @@ 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ührungen geführt werden können. Der zentrale Marktstamm enthält nur den
+Marktnamen und die Marktart/Kategorie aus einer deterministischen Liste.
 
 ### Durchführung
 
@@ -39,7 +40,46 @@ 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
+## 3. Feld- und Referenzwert-Zuordnung
+
+### Zentraler Marktstamm
+
+- Marktname
+- Marktart/Kategorie aus einer deterministischen Liste
+
+### Durchführung
+
+Alle übrigen veränderlichen Marktangaben werden pro Durchführung erfasst,
+insbesondere Kontakt, Ort, Termine, Anmeldung, Status, Stand, Infrastruktur,
+Logistik, Kosten, Zahlung, Vertragslink und Notizen.
+
+### Durchführungstag
+
+- Datum des Durchführungstags
+- Standzeit und tagesbezogene Durchführungszeiten
+- Bruttoerlös
+- Anzahl verkaufter Artikel
+- Ereignisse und Beobachtungen
+
+### Deterministische Referenzwerte
+
+- Marktart/Kategorie
+- Marktstatus
+- Zahlungsstatus
+- Zahlungsart
+- Kanton
+- standardisierte Ja/Nein-Merkmale für Infrastrukturangaben
+
+### Abgeleitete Werte
+
+- Wochentag aus dem Datum
+- Saison aus dem Durchführungsdatum
+- Gesamtkosten aus den Kostenpositionen
+- offener Betrag aus Kosten und bezahltem Betrag
+- Gesamterlös, Durchschnittswerte und Gesamtzahl verkaufter Artikel aus den
+  Durchführungstagen
+
+## 4. Ownership- und Normalisierungsregeln
 
 - Jede Ebene erhält eine eigene stabile Identität.
 - Mehrere Durchführungstage werden nicht als wiederholte Spalten in der
@@ -53,30 +93,9 @@ Ebene.
 - 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?

docs/modules/market_management/requirements/market_management_requirements.md

@@ -36,9 +36,13 @@ Kategorie
 - Erlös- und Verkaufsdaten werden auf Ebene des Durchführungstags erfasst und
   auf Ebene der Durchführung sowie des Marktes auswertbar gemacht.
 
-Die genaue Zuordnung aller bestehenden Markt-, Anmelde-, Kosten-, Zahlungs-,
+Der zentrale Marktstamm enthält ausschließlich:
-Logistik- und Auswertungsfelder zu Kategorie, Markt, Durchführung oder
+
-Durchführungstag ist noch separat festzulegen.
+- Marktname
+- Marktart/Kategorie aus einer deterministischen Liste
+
+Alle übrigen veränderlichen Angaben werden pro Durchführung erfasst. Tages-
+und Verkaufsdaten werden pro Durchführungstag erfasst.
 
 ## 4. Nutzungsberechtigung
 
@@ -60,14 +64,13 @@ Erfassbare Marktarten:
 - Regionalmärkte
 - Weitere geeignete Märkte
 
-Die Marktart wird pro Markt ausgewählt oder ergänzt.
+Die Marktart/Kategorie wird zentral am Markt aus einer deterministischen Liste
+ausgewählt. Eine Durchführung überschreibt diese Zuordnung nicht.
 
-## 6. Stammdaten pro Markt
+## 6. Markt- und Durchführungsdaten
 
-### 5.1 Allgemeine Informationen
+### 6.1 Allgemeine Informationen
 
-- Name des Marktes
-- Marktart
 - Veranstalter
 - Ort
 - Gemeinde
@@ -78,7 +81,10 @@ Die Marktart wird pro Markt ausgewählt oder ergänzt.
 - Telefonnummer
 - Notizen
 
-### 5.2 Termin und Durchführung
+Diese Angaben werden pro Durchführung erfasst. Marktname und Marktart/Kategorie
+gehören ausschließlich zur zentralen Marktdefinition.
+
+### 6.2 Termin und Durchführung
 
 - Beginn und Ende des Marktes
 - Datum jedes einzelnen Markttages
@@ -91,7 +97,7 @@ Die Marktart wird pro Markt ausgewählt oder ergänzt.
 - Wochentag
 - Saison
 
-### 5.3 Stand und Infrastruktur
+### 6.3 Stand und Infrastruktur
 
 - Standgröße
 - Tisch vorhanden
@@ -104,7 +110,7 @@ Die Marktart wird pro Markt ausgewählt oder ergänzt.
 - Weitere Infrastruktur
 - Anforderungen an den eigenen Stand
 
-### 5.4 Anfahrt und Logistik
+### 6.4 Anfahrt und Logistik
 
 - Anfahrtsadresse
 - Entfernung oder Fahrzeit
@@ -115,7 +121,7 @@ Die Marktart wird pro Markt ausgewählt oder ergänzt.
 - Lager- oder Aufbewahrungsmöglichkeiten
 - Besondere Hinweise zur Anfahrt
 
-### 5.5 Kosten und Konditionen
+### 6.5 Kosten und Konditionen
 
 - Standgebühr
 - Gebühren für Tisch, Strom oder weitere Infrastruktur
@@ -127,13 +133,36 @@ Die Marktart wird pro Markt ausgewählt oder ergänzt.
 - Umsatzbeteiligung, falls vorhanden
 - Weitere Teilnahmebedingungen
 
-### 5.6 Vertrag und Unterlagen
+### 6.6 Vertrag und Unterlagen
 
 Die zugehörigen Unterlagen sollen über einen Link mit einem eigenen Ordner
 verbunden werden können.
 
 - Link zum Vertragsordner
 
+Der Link wird pro Durchführung erfasst.
+
+### 6.7 Deterministische Referenzwerte und Berechnungen
+
+Deterministisch vorgegebene Referenzwerte; die jeweilige Auswahl wird auf der
+zuständigen Ebene gespeichert:
+
+- Marktart/Kategorie
+- Marktstatus
+- Zahlungsstatus
+- Zahlungsart
+- Kanton
+- standardisierte Ja/Nein-Merkmale für Infrastrukturangaben
+
+Abgeleitete Werte werden nicht manuell eingegeben:
+
+- Wochentag aus dem Datum
+- Saison aus dem Durchführungsdatum
+- Gesamtkosten aus den Kostenpositionen
+- offener Betrag aus Kosten und bezahltem Betrag
+- Gesamterlös, Durchschnittswerte und Gesamtzahl verkaufter Artikel aus den
+  Durchführungstagen
+
 ## 7. Statusverwaltung
 
 Folgende Marktstatus sollen verfügbar sein: