Center Manager App

Die Center Manager App ist die mobile Begleiter-App für Center-Personal und Mieter. Sie vereint Funktionen für Center Manager, Mieter (Tenants) und Techniker in einer App – je nach Rolle sieht der Nutzer nur die für ihn relevanten Bereiche.

Zugang: https://manager.cockpit-os.de (nach Anmeldung; Subdomain/Konfiguration pro Center möglich).

---

Rollen und Nutzerkreise

Die App unterstützt mehrere Rollen. Nach dem Login wird die Navigation automatisch angepasst:

Rolle	Zielgruppe	Sichtbare Bereiche (Auszug)
Center Manager	Center-Management, Marketing	KI-Chat, Shops/Events/Angebote, Entwürfe, Berichte, Admin, Hilfe
Mieter (Tenant)	Store-Mitarbeiter, Shop-Leitung	Abholung bestätigen (Reserve & Collect), Shop-Dashboard, Meine Angebote, Nachrichten, Support
Techniker	Facility, Wartung	Wartungsaufträge, Störungen, Gebäudetechnik, Berichte
Assistant	Assistenten	KI-Chat, Entwürfe, Einführung
Viewer	Nur-Lese-Zugang	Dashboard (nur Anzeige)

• Center Manager: Vollumfang – KI-Assistent, Content, Entwürfe, Freigaben, Berichte, System-Einstellungen.
• Mieter: Reduzierte Ansicht „Mein Shop“ – ideal für Reserve & Collect (Abholcode eingeben, Abholung/Bezahlung bestätigen), eigene Angebote, Nachrichten vom Center.
• Techniker: Fokus auf Wartung, Störungen und technische Anlagen.

Die Rolle wird im cockpitOS-Dashboard am Benutzer hinterlegt (center_manager, cm_assistant, facility_manager, tenant). Nach dem Login mappt die App diese Rollen auf eigene Ansichten und leitet zur passenden Startseite weiter.

---

Architektur & Anbindung (Betrieb)

Was

Die Manager-App ist ein eigenständiger Next.js-Service, der keine direkte Datenbank nutzt. Alle CMS-Daten laufen über das Dashboard (NEXT_PUBLIC_API_BASE_URL).

Center-Kontext

• Nach Login: Center-UUID aus der Benutzer-Zuordnung (UserCenterAssignment)
• Optional Production: Subdomain {slug}.manager.cockpit-os.de → Auflösung über /api/centers/by-subdomain
• Entwicklung: Query ?center=slug oder NEXT_PUBLIC_DEFAULT_CENTER_SLUG

Session & Sicherheit

• Login setzt ein HttpOnly-Cookie (cm-auth-token, HMAC-signiert)
• Geschützte Routen werden per Middleware abgesichert; Client liest Session über GET /api/auth/me
• Env: CM_SESSION_SECRET (oder NEXTAUTH_SECRET) — in Render als Secret hinterlegen, min. 32 Zeichen

Subdomain & DNS (Render)

Host	Ziel	Zweck
manager.cockpit-os.de	Service mallos-center-manager	Standard-Login (Center aus Session)
{slug}.manager.cockpit-os.de	gleicher Service	Center-spezifischer Einstieg (Subdomain → Center-Slug)

Einrichtung in Render:

1. Custom Domain manager.cockpit-os.de am Service mallos-center-manager hinzufügen
2. Wildcard *.manager.cockpit-os.de als CNAME auf die Render-URL (oder über DNS-Provider)
3. Im Dashboard muss der Center-Slug mit dem Subdomain-Teil übereinstimmen (z. B. demomall.manager.cockpit-os.de → Slug demomall)

Umgebungsvariablen (Render / Production)

Maßgeblich: render.yaml → Service mallos-center-manager. Werte dort nicht manuell in Render überschreiben, wenn sie aus dem Blueprint kommen — Secrets (sync: false) nur im Render-Dashboard als Secret setzen.

Variable	Render (Blueprint)	Lokal (.env.example)
NEXT_PUBLIC_API_URL	https://dashboard.cockpit-os.de	http://localhost:3000
NEXT_PUBLIC_API_BASE_URL	https://dashboard.cockpit-os.de/api	http://localhost:3000/api
NEXT_PUBLIC_APP_NAME	Center Manager	gleich
NEXT_PUBLIC_PRIMARY_COLOR	#2563eb	gleich
NEXT_PUBLIC_SECONDARY_COLOR	#1d4ed8	gleich
CM_SESSION_SECRET	Secret (sync: false)	Dev-Wert in .env.local
CM_BRIDGE_SECRET	Secret (sync: false, identisch auf Dashboard + CM-App)	optional lokal leer
PORT	3000	3001 (Dev)
NODE_ENV	production	development
REDIS_URL / REDIS_HOST / REDIS_PORT	von Service mallos-redis	optional lokal
REDIS_DB	0	optional
BUNNY_* / NEXT_PUBLIC_BUNNY_CDN_URL	siehe Blueprint	optional lokal

Dashboard-API-Auth (Schreibzugriffe): Issues, Messages, Parkzonen und weitere Mutationen laufen über CM-Proxies (/api/center-data, …) oder direkt ans Dashboard mit Center-Auth — Session-Cookie, Authorization: Bearer (CM-Token) oder X-CM-Bridge-Secret + Center-ID. In Production muss CM_BRIDGE_SECRET auf beiden Services gesetzt sein, sonst schlagen Schreib-APIs mit 401/403 fehl.

KI-Chat: OpenAI/Pinecone laufen über Dashboard (Center-AI-Settings), nicht als Pflicht-Env in mallos-center-manager. Optional lokal: OPENAI_API_KEY für Proxy-Fallback.

Kein festes NEXT_PUBLIC_APP_ID — Center wird pro Session/Subdomain bestimmt.

Oberfläche (Design)

• Operational Cockpit: neutrale Hintergründe, klare Karten — kein Vollbild-Gradient mehr; dezenter Primary-Glow oben für Tiefe
• Hell / Dunkel: Umschaltung im Header (Sonne/Mond) oder unter Einstellungen (/settings) — auch Systemmodus
• Center-Branding: 3px-Akzentstreifen oben + Primary-Farbe aus CMS (theme.primaryColor); Theme lädt erst nach Session/Center-ID
• Daten-Tab: /analytics — Tagesübersicht (Besucher, Parkplätze, Issues) aus der Session-Center-ID
• KI-Chat: sachliche Chips statt rotierender Demo-Texte; Bestätigung für geplante Aktionen per Button oder „ja“
• Alle Manager-Seiten: Entwürfe, Issues, News, Kommunikation usw. nutzen dieselben Theme-Tokens (kein text-white auf hellem Hintergrund mehr)
• Einstellungen: /settings — Theme Hell / Dunkel / System

KI-Chat: wie „smart“ ist das wirklich?

Schicht	Technik	Rolle
Intent	Dashboard analyzeIntentWithAI (LLM, strukturiertes JSON)	Versteht was gemeint ist — Ticket, Entwurf, Reinigung, Bewerbung
Kontext	Pinecone Hybrid Search + generateManagerContext (DB-Slices)	Antworten mit echten Center-Daten (Shops, Offers, Issues, …)
Aktionen	/api/ai/actions/execute → Issues, Entwürfe, CMS	Echte Dashboard-APIs, keine Mock-Daten
Ketten	ai-orchestrator plant Folgeschritte aus Intent (z. B. Ticket → Benachrichtigung)	Abgeleitet aus actionType, intent, entityTypes — nicht aus festen Sätzen
Fallback	Regex + regelbasiertes analyzeIntent	Nur wenn OpenAI/Dashboard-Intent nicht verfügbar

Endpoint: POST /api/ai/orchestrate — Manager-Antwort + Intent + Ausführung in einem Durchlauf.

Beispiel „Müll überall“: LLM setzt create_ticket mit category: "cleaning" → Orchestrator legt Ticket an + informiert Team.

Beispiel „Angebot bei ABC bewerben“: LLM setzt create_draft + filters.search: "ABC" → Shop wird aus CMS aufgelöst → News-Entwurf + Mieter-Rundmail.

Voraussetzung: OpenAI-Key im Dashboard (Center-AI-Settings), Pinecone optional für Volltext-Kontext.

Detail (Dev): Center Manager AI-Orchestrator

So testen (Allgemein):

1. Benutzer mit Rolle + Center-Zuordnung im Dashboard anlegen
2. Manager-App öffnen, anmelden → Navigation je Rolle (Manager / Mieter / Techniker)
3. News/Events/Angebote: Daten müssen im Dashboard für dasselbe centerId existieren
4. Mieter: Reserve & Collect unter Mein Shop → Abholung bestätigen

---

Überblick (Center-Manager-Funktionen)

Die App ist der digitale Begleiter für Center Manager und bietet:

• Dashboard mit Live-Daten und Übersichten
• KI-gestützter Content-Assistent für schnelle Inhaltserstellung
• Problem-Management mit Foto-Upload und Tracking
• Team-Kommunikation und Koordination
• Entwurfs-Verwaltung mit Freigabe-Workflows

Hauptfunktionen

Dashboard & Übersicht

• Live-Besucherzahlen (IMAS API Integration)
• Tagesübersicht mit wichtigen KPIs
• Schnellaktionen für häufige Aufgaben
• Aktivitäten-Timeline der letzten Ereignisse
• Content-Statistiken (Aktive Angebote, Wartende Entwürfe)

KI-gestützter Content-Assistent

• Natürliche Spracheingabe - einfach beschreiben, was erstellt werden soll
• Automatische Content-Erstellung für Angebote, Events, Shop-Updates
• Intelligente Kategorisierung und Formatierung
• Multi-Channel-Optimierung (Website, Social Media, Digital Signage)
• Spracheingabe für noch schnellere Bedienung

Problem-Management

• Schnelle Problem-Meldung mit Foto-Upload
• Kategorisierung (Technik, Wartung, Sicherheit, Reinigung)
• Prioritäten-System (Hoch, Mittel, Niedrig)
• Status-Tracking (Offen, In Bearbeitung, Gelöst)
• Team-Benachrichtigungen bei kritischen Issues

Entwurfs-Verwaltung

• Zentrale Entwurfs-Übersicht aller Content-Entwürfe
• Status-Filter (Entwurf, Wartend, Genehmigt, Abgelehnt)
• Freigabe-Workflows für Content-Approval
• Versionskontrolle und Änderungshistorie
• Bulk-Operationen für mehrere Entwürfe

Team-Kommunikation

• Mieter-Kontakte mit direkter Nachrichtenfunktion
• Team-Koordination zwischen Center-Mitarbeitern
• Techniker-Kontakte für schnelle Problemlösung
• Nachrichtenverlauf und Kommunikationshistorie

KI-Content-Assistent

Funktionsweise

Der KI-Assistent versteht natürliche Sprache und erstellt automatisch strukturierte Inhalte:

Beispiel-Eingaben:

• "Neues Angebot: 20% Rabatt auf Winterjacken ab morgen bis Sonntag"
• "Event Modenschau am 15. Februar um 18 Uhr im Atrium"
• "Shop MediaMarkt hat neue Öffnungszeiten: Mo-Sa 9-21 Uhr"

Unterstützte Content-Typen

• Angebote - Rabattaktionen, Sales, Sonderangebote
• Events - Veranstaltungen, Shows, Aufführungen
• Shop-Updates - Öffnungszeiten, neue Services, Änderungen
• News - Allgemeine Nachrichten und Ankündigungen

Automatische Optimierung

• SEO-optimierte Texte für bessere Auffindbarkeit
• Social Media Formate für verschiedene Plattformen
• Digital Signage Layouts für Bildschirme im Center
• Mobile-optimierte Darstellung für Apps und responsive Websites

Admin-Einstellungen

KI-Konfiguration

• Provider-Auswahl (OpenAI, Anthropic, lokale Modelle)
• Modell-Einstellungen (GPT-4, Claude 3, etc.)
• API-Schlüssel Verwaltung mit Sicherheits-Features
• Temperatur und Token-Limits für optimale Ergebnisse

Workflow-Management

• Freigabe-Prozesse konfigurieren
• Auto-Approval Rollen definieren
• Content-Limits pro Benutzer festlegen
• Benachrichtigungs-Einstellungen anpassen

Sicherheit

• Rate Limiting zum Schutz vor Missbrauch
• Benutzer-Berechtigungen granular verwalten
• Audit-Logs für Nachverfolgbarkeit
• Domain-Beschränkungen für Zugriffskontrolle

Integration & Datenquellen

cockpitOS Integration

• Nahtlose Anbindung an das Haupt-Dashboard
• Daten-Synchronisation in Echtzeit
• Einheitliche Benutzer-Verwaltung
• Konsistente Design-Sprache

Externe APIs

• IMAS API für Besucherzahlen-Daten
• Social Media APIs für Content-Distribution
• WordPress Integration für Website-Updates
• E-Mail-Marketing Tools für Newsletter

Benutzeroberfläche

Design-Prinzipien

• Mobile-First Ansatz für optimale Smartphone-Nutzung
• Intuitive Navigation mit Bottom-Navigation
• Schnellaktionen für häufige Aufgaben
• Moderne Glasmorphism-Effekte für ansprechende Optik

Responsive Design

• Smartphone-optimiert als primäre Zielplattform
• Tablet-Unterstützung für größere Bildschirme
• Desktop-Kompatibilität für Büro-Arbeitsplätze
• Touch-optimierte Bedienung für alle Interaktionen

Workflow-Beispiele

Content-Erstellung Workflow

1. Eingabe - Natürliche Beschreibung des gewünschten Inhalts
2. KI-Verarbeitung - Automatische Strukturierung und Optimierung
3. Entwurf-Erstellung - Generierung des fertigen Content-Entwurfs
4. Review - Überprüfung und eventuelle Anpassungen
5. Freigabe - Approval durch berechtigte Personen
6. Veröffentlichung - Automatische Distribution auf alle Kanäle

Problem-Management Workflow

1. Entdeckung - Problem wird im Center entdeckt
2. Foto-Upload - Schnelle Dokumentation per Smartphone
3. Kategorisierung - Automatische oder manuelle Zuordnung
4. Priorität - Bewertung der Dringlichkeit
5. Zuweisung - Weiterleitung an zuständiges Team
6. Tracking - Verfolgung bis zur Lösung

---

Schnellstart & Anleitungen

Als Center Manager: Erste Schritte

1. App öffnen unter manager.cockpit-os.de und anmelden.
2. KI-Chat – Im Menü „AI-Chat“ oder „AI-Assistent“ öffnen; in natürlicher Sprache z. B. ein Angebot oder Event beschreiben („20 % Rabatt auf Winterjacken ab morgen“). Der Assistent erstellt einen Entwurf.
3. Entwürfe prüfen – Unter „Entwürfe“ die erstellten Inhalte sichten, anpassen und zur Freigabe einreichen. Die Freigabe erfolgt im Dashboard (Workflow & Freigaben).
4. Berichte & Admin – „Berichte“ für Übersichten; „Admin-Bereich“ für KI- und System-Einstellungen.

Als Mieter (Store): Abholung bei Reserve & Collect bestätigen

1. App öffnen und als Mieter/Tenant anmelden.
2. „Abholung bestätigen“ im Bereich Mein Shop auswählen.
3. Abholcode eingeben, den der Gast auf dem Handy zeigt (z. B. LiLi-ABC123), oder per Scanner erfassen → Suchen.
4. Reservierung erscheint mit Produkt und Shop → „Abgeholt“ oder „Bezahlt“ tippen.
5. „Nächste Abholung“ für den nächsten Gast – die Seite eignet sich als Lesezeichen an der Kasse.

Weitere Details zu Reserve & Collect: Digital Signage – Reserve & Collect.

Als Techniker: Wartung und Störungen

1. Nach Anmeldung als Techniker erscheinen Wartungsaufträge, Störungen und Gebäudetechnik.
2. Offene Aufträge anzeigen und abarbeiten; Berichte für Dokumentation nutzen.

---

Vorteile für Center Manager

Effizienz-Steigerung

• 50% weniger Zeit für Content-Erstellung durch KI-Unterstützung
• Sofortige Problem-Meldung ohne Umwege
• Zentrale Übersicht aller wichtigen Daten
• Mobile Verfügbarkeit für Arbeit von überall

Qualitäts-Verbesserung

• Konsistente Content-Qualität durch KI-Standards
• Fehlerreduktion durch automatische Checks
• Professionelle Formatierung für alle Kanäle
• SEO-Optimierung automatisch integriert

Team-Koordination

• Bessere Kommunikation zwischen allen Beteiligten
• Transparente Workflows mit klaren Zuständigkeiten
• Schnellere Reaktionszeiten bei Problemen
• Dokumentierte Prozesse für Nachverfolgbarkeit

---

Siehe auch

• Workflow & Freigaben – Freigabe von Entwürfen aus der Manager App im Dashboard
• Reserve & Collect – Abholung bestätigen (für Mieter) und Kampagnen einrichten
• Core Features & Module – Übersicht aller Plattform-Module

---

Die Center Manager App vereint in einer Anwendung die Bedürfnisse von Center-Managern, Mietern und Technikern. Sie macht die tägliche Arbeit im Center effizienter und ermöglicht Mietern eine einfache Teilnahme an Aktionen wie Reserve & Collect.