MCP-Begriffe für Markt-Hierarchie und LLM-Doku vereinheitlichen

docs/modules/market_management/konzepte/market_management_hermes_mcp_api.md

@@ -1,6 +1,6 @@
 # Hermes: Market-Management-MCP-API
 
-Stand: 2026-09-19
+Stand: 2026-09-20
 Status: Aktive technische Schnittstellendokumentation
 
 ## Verbindung
@@ -22,6 +22,22 @@ Der Token wird nicht in dieser Dokumentation oder im Repository gespeichert.
 
 ## Verbindungsablauf
 
+## Fachliche Begrifflichkeit für Hermes
+
+Die fachliche Hierarchie lautet:
+
+```text
+Markt (market_definition)
+└── Marktdurchführung (market_occurrence)
+    └── Markttag / Markttage (market_occurrence_day)
+```
+
+Ein Markt ist die zentrale Marktdefinition. Eine Marktdurchführung ist eine
+konkrete Ausgabe bzw. Teilnahme an diesem Markt. Eine Marktdurchführung besitzt
+mindestens einen Markttag. OTC-Verkäufe werden immer einem konkreten Markttag
+zugeordnet; die zugehörige Marktdurchführung und der Markt ergeben sich aus
+dieser Referenz.
+
 ### 1. Initialisieren
 
 ```json
@@ -72,16 +88,17 @@ Das Ergebnis steht bei `tools/call` als JSON im Textinhalt des ersten
     `municipality_reference_id`, `date_from`, `date_to`, `include_archived`,
     `sort`, `sort_direction`, `limit`, `offset`
 - `market_management.search_occurrences`
+  - sucht Marktdurchführungen
   - optional: `search`, `market_definition_id`, `status`, `place`, `address`,
     `municipality_reference_id`, `date_from`, `date_to`, `include_archived`,
     `sort`, `sort_direction`, `limit`, `offset`
 - `market_management.get_market`
   - erforderlich: `market_id`
   - optional: `include_archived`
-  - liefert Durchführungen inklusive Tagen, Kosten und berechneten Verkaufswerten
+  - liefert Marktdurchführungen inklusive Markttagen, Kosten und berechneten Verkaufswerten
 - `market_management.create_market`
   - erforderlich: `name`, `category_id`
-  - optional: `website_url` als HTTP(S)-URL der Veranstaltung
+  - optional: `website_url` als HTTP(S)-URL des Marktes
 - `market_management.update_market`
   - erforderlich: `market_id`
   - änderbar: `name`, `category_id`, `website_url`
@@ -100,21 +117,21 @@ Kategorien anlegen oder ändern.
 - `market_management.list_reference_data`
   - liefert Kategorien, Kantone und aktive Gemeinden
 - `market_management.get_overview`
-  - liefert serverseitig gefilterte Markt- und Durchführungslisten
+  - liefert serverseitig gefilterte Markt- und Marktdurchführungslisten
 
-### Durchführungen
+### Marktdurchführungen
 
 - `market_management.create_occurrence`
-  - erforderlich: `market_definition_id`, `days` mit mindestens einem Eintrag
+  - erforderlich: `market_definition_id`, `days` mit mindestens einem Markttag
   - initialer Status: `open`
-  - weitere Durchführungsfelder sind optional und werden typisiert validiert
+  - weitere Marktdurchführungsfelder sind optional und werden typisiert validiert
 - `market_management.get_occurrence`
   - erforderlich: `occurrence_id`
-  - liefert zusätzlich die Marktdefinition, Durchführungstage, Kosten und
+  - liefert zusätzlich den Markt, Markttage, Kosten und
     berechnete Tages- und Gesamterlöse
 - `market_management.update_occurrence`
   - erforderlich: `occurrence_id`
-  - änderbar: sämtliche GUI-Durchführungsfelder einschließlich Veranstalter,
+  - änderbar: sämtliche GUI-Marktdurchführungsfelder einschließlich Veranstalter,
     Kontaktperson, Kontakt-E-Mail und Kontakt-Telefon
 - `market_management.archive_occurrence`
   - erforderlich: `occurrence_id`
@@ -140,9 +157,10 @@ unpaid
 paid
 ```
 
-### Durchführungstage
+### Markttage
 
 - `market_management.create_day`
+  - legt einen Markttag an
   - erforderlich: `occurrence_id`, `date`
 - `market_management.update_day`
   - erforderlich: `day_id`
@@ -186,7 +204,7 @@ Weitere mögliche Tagesfelder sind `stand_start_time`, `stand_end_time`,
 }
 ```
 
-## Beispiel: Durchführung mit Tag anlegen
+## Beispiel: Marktdurchführung mit Markttag anlegen
 
 ```json
 {
@@ -236,12 +254,12 @@ Weitere mögliche Tagesfelder sind `stand_start_time`, `stand_end_time`,
 - Hermes darf keine Kategorien anlegen.
 - Umsatz und Artikelmengen werden nicht über MCP geschrieben; sie werden aus
   den OTC-Verkäufen abgeleitet.
-- Markt und Durchführung werden unabhängig archiviert.
+- Markt und Marktdurchführung werden unabhängig archiviert.
 - Alle Schreibvorgänge werden serverseitig validiert.
 - Jeder schreibende MCP-Aufruf benötigt `idempotency_key`; optional kann
   `client_id` mitgegeben werden. Wiederholungen liefern dasselbe Ergebnis.
 - Umsatz- und Artikelmengen aus OTC-Verkäufen sind erst verfügbar, sobald die
-  separate OTC-Schnittstelle die Zuordnung zum Durchführungstag bereitstellt.
+  separate OTC-Schnittstelle die Zuordnung zum Markttag bereitstellt.
 
 ## Fehler
 

docs/modules/market_management/konzepte/market_management_hermes_mcp_konzept.md

@@ -33,9 +33,9 @@ Vorgesehene Toolgruppen:
 
 - Märkte suchen und lesen
 - Märkte anlegen, ändern, archivieren und reaktivieren
-- Durchführungen suchen und lesen
-- Durchführungen anlegen, ändern, archivieren und reaktivieren
-- Durchführungstage anlegen, ändern und entfernen
+- Marktdurchführungen suchen und lesen
+- Marktdurchführungen anlegen, ändern, archivieren und reaktivieren
+- Markttage anlegen, ändern und entfernen
 - Kategorien, Kantone und Gemeinden lesen
 - Kosten und Zahlungsstatus ändern
 - Übersichtsdaten lesen