diff --git a/docs/modules/market_management/data/market_management_data_architecture.md b/docs/modules/market_management/data/market_management_data_architecture.md index af1422c..2d1f248 100644 --- a/docs/modules/market_management/data/market_management_data_architecture.md +++ b/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? diff --git a/docs/modules/market_management/requirements/market_management_requirements.md b/docs/modules/market_management/requirements/market_management_requirements.md index 453e9b7..f78c2ce 100644 --- a/docs/modules/market_management/requirements/market_management_requirements.md +++ b/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-, -Logistik- und Auswertungsfelder zu Kategorie, Markt, Durchführung oder -Durchführungstag ist noch separat festzulegen. +Der zentrale Marktstamm enthält ausschließlich: + +- 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: