diff --git a/docs/modules/market_management/README.md b/docs/modules/market_management/README.md new file mode 100644 index 0000000..ea3702c --- /dev/null +++ b/docs/modules/market_management/README.md @@ -0,0 +1,45 @@ +# Market Management + +Stand: 2026-09-15 +Status: Fachliches Zielbild / Anforderungen in Ausarbeitung + +## Zweck + +Das Modul verwaltet Märkte von der Recherche und Prüfung über Anfrage, Anmeldung +und Durchführung bis zur Kosten-, Zahlungs- und Erlösauswertung. + +## Fachliche Ownership + +Das Modul soll die fachliche Ownership für Marktstammdaten, Markttermine, +Teilnahme- und Durchführungsstatus, marktbezogene Kosten und Zahlungen sowie +Erlös- und Tagesauswertungen tragen. + +## Zugriffsmodell + +Die Nutzung des Moduls ist an eine Benutzeridentität gebunden. Das Modul soll +separat von der übrigen Anwendung nutzbar und an weitere Personen verkaufbar +sein. + +Die Ownership der Lizenz-/Entitlement-Daten ist noch nicht entschieden und +bleibt offen. + +## Abgrenzung + +- Kein Offline-Modus in der ersten Phase. +- Zunächst keine eigene Benutzerverwaltung. +- Keine eigene technische Runtime- oder Scheduler-Logik. +- Fachlich neutrale UI- und technische Querschnittsbausteine gehören nach + `shared`. + +## Dokumente + +- [Anforderungsprofil](requirements/market_management_requirements.md) +- Prozessdokumente werden unter `processes/main/` und + `processes/sub_processes/` angelegt, sobald die fachlichen Prozesse explizit + definiert sind. + +## Offene Architekturentscheidung + +Die Ownership und konkrete Ablage der Lizenz-/Entitlement-Daten ist offen. +Diese Entscheidung darf bei der weiteren Umsetzung nicht stillschweigend +vorweggenommen werden. diff --git a/docs/modules/market_management/processes/main/.gitkeep b/docs/modules/market_management/processes/main/.gitkeep new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/modules/market_management/processes/main/.gitkeep @@ -0,0 +1 @@ + diff --git a/docs/modules/market_management/processes/sub_processes/.gitkeep b/docs/modules/market_management/processes/sub_processes/.gitkeep new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/modules/market_management/processes/sub_processes/.gitkeep @@ -0,0 +1 @@ + diff --git a/docs/modules/market_management/requirements/market_management_requirements.md b/docs/modules/market_management/requirements/market_management_requirements.md new file mode 100644 index 0000000..3a8fdbe --- /dev/null +++ b/docs/modules/market_management/requirements/market_management_requirements.md @@ -0,0 +1,240 @@ +# Anforderungsprofil Marktübersicht + +Stand: 2026-09-15 +Status: Fachliche Arbeitsanforderung + +## 1. Ziel des Systems + +Das System unterstützt die Suche, Prüfung, Anmeldung, Durchführung und +Auswertung von Herbstmärkten, Weihnachtsmärkten und weiteren geeigneten +Märkten. + +## 2. Umfang der ersten Phase + +- Es wird jeweils nur ein Markt gleichzeitig bearbeitet. +- Ein Offline-Modus ist zunächst nicht erforderlich. +- Zunächst gibt es nur eine Benutzerin: Fabienne. +- Eine eigene Benutzerverwaltung ist zunächst nicht erforderlich. +- Die Anwendung soll übersichtlich und einfach bedienbar sein. + +## 3. Nutzungsberechtigung + +- Die Rechte zur Nutzung des Moduls werden an die Benutzeridentität geknüpft. +- Das Modul soll ohne die restliche Anwendung an weitere Personen verkauft und + separat genutzt werden können. +- Die Ownership und Ablage der Lizenz-/Entitlement-Daten ist noch nicht + entschieden und bleibt offen. + +## 4. Marktarten + +Erfassbare Marktarten: + +- Herbstmärkte +- Weihnachtsmärkte +- Frühlingsmärkte +- Ostermärkte +- Kunsthandwerksmärkte +- Regionalmärkte +- Weitere geeignete Märkte + +Die Marktart wird pro Markt ausgewählt oder ergänzt. + +## 5. Stammdaten pro Markt + +### 5.1 Allgemeine Informationen + +- Name des Marktes +- Marktart +- Veranstalter +- Ort +- Gemeinde +- Kanton +- Adresse +- Kontaktperson +- E-Mail-Adresse +- Telefonnummer +- Notizen + +### 5.2 Termin und Durchführung + +- Beginn und Ende des Marktes +- Datum jedes einzelnen Markttages +- Standzeiten pro Tag +- Auf- und Abbauzeiten +- Anmeldefrist +- Datum der Anfrage oder Anmeldung +- Datum der Bestätigung +- Datum der Durchführung +- Wochentag +- Saison + +### 5.3 Stand und Infrastruktur + +- Standgröße +- Tisch vorhanden +- Tisch kann gemietet werden +- Eigener Tisch erforderlich +- Zelt oder Überdachung vorhanden +- Strom vorhanden +- Wasser vorhanden +- Beleuchtung vorhanden +- Weitere Infrastruktur +- Anforderungen an den eigenen Stand + +### 5.4 Anfahrt und Logistik + +- Anfahrtsadresse +- Entfernung oder Fahrzeit +- Parkmöglichkeiten +- Zufahrt für Anlieferung +- Zeitfenster für die Anlieferung +- Möglichkeit zum direkten Ausladen +- Lager- oder Aufbewahrungsmöglichkeiten +- Besondere Hinweise zur Anfahrt + +### 5.5 Kosten und Konditionen + +- Standgebühr +- Gebühren für Tisch, Strom oder weitere Infrastruktur +- Weitere Pflichtkosten +- Gesamtkosten +- Zahlungsfrist +- Zahlungsart +- Abmeldebedingungen +- Umsatzbeteiligung, falls vorhanden +- Weitere Teilnahmebedingungen + +### 5.6 Vertrag und Unterlagen + +Die zugehörigen Unterlagen sollen über einen Link mit einem eigenen Ordner +verbunden werden können. + +- Link zum Vertragsordner + +## 6. Statusverwaltung + +Folgende Marktstatus sollen verfügbar sein: + +- Warteliste +- Angemeldet +- Bestätigung ausstehend +- Bestätigt +- Abgesagt +- Durchgeführt + +Der aktuelle Status ist in der Übersicht sofort erkennbar und manuell änderbar. + +## 7. Bezahlung + +Der Zahlungsstatus wird unabhängig vom allgemeinen Marktstatus gespeichert. + +Zahlungsstatus: + +- Nicht bezahlt +- Zahlung ausstehend +- Teilweise bezahlt +- Bezahlt + +Zusätzliche Zahlungsinformationen: + +- Zahlungsdatum +- Bezahlter Betrag +- Offener Betrag + +## 8. Erlöserfassung + +Nach der Durchführung soll der Erlös pro Markt erfasst werden können. +Bei mehrtägigen Märkten wird der Erlös je Markttag separat erfasst. + +Pro Markttag: + +- Datum +- Bruttoerlös +- Anzahl verkaufter Artikel +- Besondere Ereignisse oder Beobachtungen + +Automatisch zu berechnen: + +- Gesamterlös des Marktes +- Gesamtzahl verkaufter Artikel +- Durchschnittlicher Erlös pro Tag +- Durchschnittlicher Erlös pro verkauftem Artikel, sofern berechenbar + +Die Tageswerte sollen einzeln und als Gesamtergebnis auswertbar sein. + +## 9. Marktübersicht + +Die zentrale Übersicht soll ermöglichen: + +- alle Märkte anzuzeigen +- nach Marktart zu filtern +- nach Status zu filtern +- nach Gemeinde oder Ort zu filtern +- nach Datum zu sortieren +- nach Erlös zu sortieren +- den Bezahlstatus zu erkennen +- kommende Märkte hervorzuheben +- überfällige Anmeldungen oder Zahlungen zu erkennen +- Märkte zu öffnen und zu bearbeiten + +Mindestens sichtbar: + +- Marktname +- Marktart +- Ort oder Gemeinde +- Datum +- Wochentag +- Status +- Gesamtkosten +- Bezahlstatus +- Bruttoerlös + +## 10. Intelligente Auswertungen + +Das System soll später Zusammenhänge, Unterschiede und mögliche Korrelationen +zwischen Marktmerkmalen und Ergebnissen sichtbar machen. + +### 10.1 Marktart und Erlös + +- Welche Marktarten erzielen den höchsten Erlös? +- Sind Weihnachtsmärkte erfolgreicher als Herbstmärkte? +- Welche Marktarten haben das beste Verhältnis zwischen Erlös und Kosten? +- Welche Marktarten führen zu den meisten verkauften Artikeln? + +### 10.2 Datum, Saison und Erlös + +- An welchen Daten werden die höchsten Erlöse erzielt? +- Gibt es Unterschiede zwischen frühem und spätem Saisonzeitpunkt? +- Wie entwickelt sich der Erlös innerhalb einer Saison? +- Welche Monate und Jahreszeiten sind besonders erfolgreich? +- Gibt es einen Zusammenhang zwischen Marktdatum und Verkaufsleistung? + +### 10.3 Zahlungstermin und Markterfolg + +- Wie viele Tage liegen zwischen Zahlungstermin und Marktdatum? +- Laufen Märkte besser, wenn der Zahlungstermin früh oder spät vor dem Markt + liegt? +- Gibt es einen Zusammenhang zwischen dem Zeitpunkt der Zahlung und dem + späteren Erlös? +- Gibt es Unterschiede zwischen Märkten vor und nach dem eigenen Zahlungstag? + +### 10.4 Gemeinde und wirtschaftliches Umfeld + +Der Ort soll später über die Gemeinde mit zusätzlichen wirtschaftlichen Daten +vergleichbar sein. + +Zu prüfen ist insbesondere die Hypothese, dass Märkte in Gemeinden mit höherem +durchschnittlichem Einkommen möglicherweise einen höheren Erlös erzielen als +Märkte in Gemeinden mit tieferem Einkommen. + +Auswertungen: + +- Zusammenhang zwischen Gemeinde und Erlös +- Zusammenhang zwischen Gemeinde-Einkommen und Erlös +- Zusammenhang zwischen Kaufkraft und Anzahl verkaufter Artikel +- Vergleich verschiedener Gemeinden +- Vergleich ähnlicher Märkte in Gemeinden mit unterschiedlichem + Einkommensniveau + +Die Quelle, Aktualisierung und fachliche Ownership der zusätzlichen +wirtschaftlichen Gemeindedaten sind noch nicht spezifiziert.