Dokumentiere Marktmanagement-Anforderungen

2026-09-15 09:53:13 +02:00
1 parent 0e5d3fda91
commit 4d4f354eef
@@ -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.
@@ -0,0 +1 @@
@@ -0,0 +1 @@
@@ -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.