Partner-Medien-Einreichungen (KAM-Dropzone)

Entwickler: Architektur, Partner-API, Proxy-Muster → Partner-API v1
v0/MallCrew: docs/v0-mallcrew-prompt.md, Handoff docs/PARTNER-MANAGER-HANDOFF.md

Was

Center-Ansprechpartner, Mieter und Shops reichen Fotos/Videos mit Metadaten (Thema, Datum, Text) ein. Die Einreichungen landen in einer Warteschlange im Cockpit — KAM/Redaktion prüft und erstellt daraus News, Events oder Social-Posts.

Warum

Bisher fehlte ein strukturierter Intake-Kanal zwischen Partner vor Ort und Redaktion. Partner können im Cockpit oder in MallCrew einreichen; CockpitOS bleibt Source of Truth (Speicher, Freigabe, MCP).

Wer ist betroffen

Rolle	Nutzen
Center Manager / Mieter	Einreichung im Cockpit (Partner & Beiträge), MallCrew oder Token-Link
KAM / Redaktion	Inbox im Center-Reiter Medien-Einreichungen
Agenten	AgencyOS-API + MCP-Tools

Wo

• Partner (Cockpit): Menü Partner & Beiträge → Beiträge einreichen (/dashboard/partner/contributions) — Entwürfe, Upload, KI, Kommentare, Aufgaben, Tab Nachrichten, Tab Störungen (Facility/Center-Team)
• Partner (MallCrew): https://crew.cockpit-os.de — gleiche Warteschlange, optional für unterwegs
• Dashboard (Redaktion): Content → Center öffnen → Reiter Medien-Einreichungen
• Partner-API: /api/partner/v1/… (Login, Upload, Einreichung)
• AgencyOS: /api/agencyos/v1/centers/{centerId}/media-intake
• Token-Link: mi_-Token, Einreichung ohne Login

So testen

1. Migrationen 20260828130000 und 20260828160000 auf Staging anwenden.
2. Im Center-Reiter Medien-Einreichungen einen Einreich-Link erstellen und URL kopieren.
3. Mit Partner-Login Token holen, Entwurf anlegen (status: draft), später einreichen (submit: true per PATCH).
4. KI: POST /api/partner/v1/ai/improve-text mit centerId und text.
5. Kommentare: KAM im Reiter, Mieter über Partner-API …/comments.
6. Aufgaben: KAM legt Partner-Aufgabe an; Mieter bestätigt via POST …/tasks/{id}/ack.
7. MCP: cockpit_list_media_intake, cockpit_create_partner_task.

MallCrew / Partner-API (Erweiterung 0.1.213)

Feature	Partner-API	Proxy (MallCrew)
Text verbessern (KI)	POST /api/partner/v1/ai/improve-text	POST /api/ai/improve-text
Entwurf anlegen	POST …/media-intake mit saveAsDraft: true	gleicher Proxy
Entwurf bearbeiten/einreichen	PATCH …/media-intake/{id} (submit: true)	Proxy
Kommentare	GET/POST …/media-intake/{id}/comments	Proxy
Aufgaben	GET …/tasks, POST …/tasks/{id}/ack	Proxy

Beitragstypen: opening, promotion, event, hiring, renovation, other.

Benachrichtigungen & Nachrichten (0.1.219)

Kanal	Verhalten
Cockpit Partner & Beiträge	Tab Nachrichten — GET /api/notifications (Kategorie partner): Status-Updates, Redaktions-Antworten, neue Aufgaben
Cockpit Redaktion	Benachrichtigung bei neuer Einreichung und Partner-Kommentar; Reiter Medien-Einreichungen
MallCrew	Kein /api/notifications — Kommentare am Beitrag + Tab Info & Aufgaben; optional Polling/Badge (siehe docs/V0-MALLCREW-CHECKLIST.md)

Auslöser (automatisch im Cockpit): neue Einreichung, Statuswechsel, öffentlicher Kommentar, neue Partner-Aufgabe.

Betrieb

• Env optional: NEXT_PUBLIC_PARTNER_INTAKE_APP_URL = https://crew.cockpit-os.de
• Env optional: COCKPIT_PARTNER_API_TOKEN_SECRET — Signatur für Partner-Bearer (Fallback: NEXTAUTH_SECRET)
• Env optional: PARTNER_AI_GATEWAY_URL / PARTNER_AI_GATEWAY_API_KEY — KI „Text verbessern"
• Keine destruktive Migration — nur additive Tabellen/Spalten

Siehe auch: Partner-API v1 · v0-Prompt Dropzone · Handoff docs/PARTNER-MANAGER-HANDOFF.md