# 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.

## MCP-Schnittstelle zu Hermes

Die App stellt die MCP-Server-Schnittstelle bereit. Hermes Agent ist MCP-Client
und ruft ausschließlich freigegebene Funktionen des Marktmanagement-Moduls
auf.

Die App behält die Kontrolle über:

- Authentifizierung und Berechtigungsprüfung
- Validierung und fachliche Interpretation der Eingaben
- erlaubte Schreiboperationen
- Persistierung in der eigenen Datenbank
- Audit- und Quelleninformationen

Hermes erhält keinen direkten Zugriff auf die Datenbank. Das Zielbild und die
offenen Schnittstellenentscheidungen sind in
[market_management.hermes_mcp.md](integrations/market_management.hermes_mcp.md)
dokumentiert.

## Abgrenzung

- 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)
- [Datenarchitektur](data/market_management_data_architecture.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.