Skip to main content

Feedback an cockpitOS

Mit Feedback können alle eingeloggten Nutzer Fehler, Wünsche, Änderungsideen oder Fragen zum Dashboard melden — ohne technische Details kennen zu müssen.

Faustregel​

Erster Schritt bei etwas, das komisch aussieht oder nicht geht: Claude oder Robi fragen, bevor es an Kolleginnen und Kollegen geht.

Du musst nicht wissen, woran es technisch liegt. Reicht als Nachricht:

  • was du siehst, in deinen Worten
  • Screenshot oder Link zur Seite

Beispiel: „Bei den News wird immer ein KI-Bild mitveröffentlicht, das eigentliche Bild ist klein und verpixelt“ plus Link. Das reicht. Der Assistent schaut selbst nach.

Erst wenn der Assistent nicht weiterkommt: Button Feedback oder Kollegin/Kollege.

Was​

  • Schwebender Button Feedback unten rechts im Dashboard
  • Kurzes Formular: Art wählen, beschreiben, optional Screenshot (Klick oder Drag-and-Drop, PNG/JPG/WebP/GIF bis 5 MB)
  • cockpitOS speichert automatisch Seite, Center, Rolle und Version mit
  • Robi und Claude können denselben Eintrag über MCP anlegen. In der Inbox steht Von: cockpitOS-Assistent — ein Name für beide, kein Modell.
  • Der Ticket-Text steht beim Anlegen fest. Agenten können später mit messageAppend ergänzen (nicht bei Status Erledigt).

Warum​

Damit Redaktion und Center-Teams Probleme direkt aus dem Arbeitskontext melden können — und Entwicklung alle Infos für die Umsetzung erhält.

Wer ist betroffen​

RolleKann sendenSiehtKann entfernen
Alle Dashboard-NutzerJaEigene Einträge unter Mein Konto → Meine Feedback-EinträgeEigene Einträge (Soft-Delete)
Plattform-AdminJaSystem → Feedback-Inbox (alle Einträge, lesend)Alle Einträge
Super AdminJaSystem → Feedback-Inbox inkl. Status, Agent-Dispatch, Cursor-PromptAlle Einträge
info

Besucher-Feedback (QR, Companion, Chatbot) bleibt unter Community & Feedback → Feedback — das ist ein separates Modul.

Wo​

AktionPfad
Feedback sendenButton Feedback (unten rechts)
Eigene MeldungenNutzer-Menü → Meine Feedback-Einträge oder /dashboard/account/feedback
Entwickler-InboxSystem → Feedback-Inbox (Super Admin + Plattform-Admin)
Eigenes Feedback entfernenMeine Feedback-Einträge → Entfernen (Soft-Delete)

Feedback-Inbox (Super Admin & Plattform-Admin)​

Plattform-Admins sehen alle eingehenden Meldungen inkl. selbst angelegter Tickets. Status ändern und an SMG Coding Agents senden bleibt Super-Admin-Aufgabe. Entfernen ist für Plattform-Admins und Super Admins möglich.

Split-Ansicht: links die Liste (scrollbar), rechts die Detailspalte bleibt beim Scrollen sichtbar.

FunktionBedeutung
SucheFB-Code, Melder, Center, Text, Status
FilterStatus, Art (Fehler/Wunsch/…), Center, Agent-Status
Erledigte ausblendenStandard an — erledigte Tickets aus der Liste
Nur Agent in ArbeitNur Tickets mit laufendem Agent-Claim
VerlaufZeitachse mit Abstand zum Titel — Claim, Status, PR

Robi-Benachrichtigungen (DM) werden über AgencyOS angebunden; cockpitOS liefert Digest-API und optionalen Webhook — siehe Robi-Digest (Entwickler).

So testen​

  1. Als Redaktion anmelden, irgendeine Seite öffnen (z. B. Webseiten-Inhalte).
  2. Feedback klicken → Fehler → kurz beschreiben → Absenden.
  3. Unter Meine Feedback-Einträge Status prüfen: Fehler/Änderung werden In Arbeit, Wunsch/Frage bleiben Neu.
  4. Glocke und E-Mail prüfen, sobald der Status wechselt.
  5. Als Super Admin Feedback-Inbox öffnen → Antworttext + Status.

Umsetzung mit SMG Coding Agents (sicher)​

main rollt das Dashboard auf Render automatisch aus. Deshalb gilt:

  1. Zu Fehlern und Änderungen kann ein Vorschlag vorbereitet werden, sobald die Automation verbunden ist. Neue Meldungen gehen automatisch. Ältere (Status Neu): Inbox öffnen → An SMG Coding Agents senden. Alternativ im Chat: „Es gab Feedback FB-…, bitte abarbeiten“.
  2. SMG Coding Agents arbeiten auf einem Feature-Branch und öffnen einen Pull Request — kein Push auf main.
  3. Im Chat „Merge“ sagen, wenn der Vorschlag passt. Ohne dieses Wort wird nicht gemergt.
  4. Nach dem Merge: Health https://dashboard.cockpit-os.de/api/health. Erst wenn das grün ist: Status Erledigt + Antwort an den Melder (Glocke und E-Mail).
  5. Health rot: Ticket bleibt In Arbeit. Schnellster Weg zurück: Render → mallos-dashboard → Rollback. Danach Revert auf main.

Wünsche und Fragen werden nicht automatisch umgesetzt. Schema, Auth, Middleware, Dynamic Routes ebenfalls nicht.

Cloud-Läufe sind kein Extra-Abo. Sie zählen zum Cursor-Kontingent des Teams (Token). Nach dem Inklusiv-Kontingent gilt On-Demand zum Modellpreis. Acht alte Tickets auf einmal = acht Läufe — deshalb einzeln senden, nicht in Serie.

Regel für Agenten: .cursor/rules/product-feedback-cursor-workflow.mdc.

Screenshots für Coding Agents: Liegt ein Screenshot am Ticket, steht in cursorPrompt oben Screenshot ansehen: mit der CDN-URL. Agent-API und AgencyOS liefern zusätzlich das Feld screenshotUrl. SMG Coding Agents sollen das Bild laden und prüfen (Produktion: öffentliche Bunny-URL unter BUNNY_CDN_URL, kein Login). Lokaler Fallback /uploads/product-feedback/… ist nur Dev — auf Render nicht dauerhaft.

Betrieb​

VariableZweck
COCKPIT_FEEDBACK_TEAMS_WEBHOOK_URLOptional: Teams-Nachricht bei neuem Feedback. Nicht die Kanal-URL aus Teams kopieren — siehe unten.
PRODUCT_FEEDBACK_NOTIFY_WEBHOOK_URLOptional: JSON-Webhook bei neu/Claim/Status (für AgencyOS/Robi)
CURSOR_FEEDBACK_AUTOMATION_WEBHOOK_URLOptional: Webhook der SMG-Coding-Agents-Automation. Nach dem Speichern kopieren.
CURSOR_FEEDBACK_AUTOMATION_API_KEYAPI-Key der Automation (Bearer). Wird auch für Agent-PATCH akzeptiert, falls COCKPIT_FEEDBACK_AGENT_SECRET abweicht.
CURSOR_FEEDBACK_AUTOMATION_TIMEOUT_MSOptional: Webhook-Timeout in ms (Standard 45000, min. 5000, max. 120000).
COCKPIT_FEEDBACK_AGENT_SECRETBearer für GET/POST/PATCH /api/product-feedback/agent (Cloud Agent ohne AgencyOS-Key).
GITHUB_PRODUCT_FEEDBACK_WEBHOOK_SECRETOptional: HMAC für GitHub-Webhook POST /api/webhooks/github/product-feedback (setzt cursorPrUrl aus PR-Titel/Body/Branch). Fallback: GITHUB_WEBHOOK_SECRET.
GITHUB_PRODUCT_FEEDBACK_REPOOptional: erlaubtes Repo (Default sawmuedev/smg-cockpit-os).

PR-Link automatisch: GitHub-Webhook auf pull_request (opened/edited/…) → cockpitOS sucht FB-… im PR und schreibt cursorPrUrl, wenn noch leer. Agent-PATCH bleibt Fallback. Backfill offener PRs: node scripts/backfill-product-feedback-cursor-pr.mjs --apply.

Schema (additiv, 2026-09-07): product_feedback.resolutionNote, cursorPrUrl, claimedAt — SQL 20260907140000_product_feedback_agent_SAFE.sql. Ohne diese Spalten schlägt die Inbox fehl.

Teams: Kanal Coding​

Empfohlen: Meldungen in den Team-Kanal Coding (nicht den öffentlichen Updates-Release-Kanal).

Variante A — Kanal-Menü (wenn sichtbar)​

  1. Kanal Coding → ⋯ → Workflows (fehlt bei manchen Tenants — dann Variante B/C)
  2. Vorlage Post to a channel when a webhook request is received
  3. Kanal Coding → speichern → HTTP POST URL kopieren

Variante B — Workflows-App in Teams (wenn im Kanal-Menü nichts da ist)​

  1. Teams links Apps → nach Workflows suchen → installieren (Team-weit oder für dich)
  2. Workflows öffnen → Erstellen → Vorlage Post to a channel when a webhook request is received
    • oder Leer erstellen → Trigger: When a Teams webhook request is received
    • Aktion: Post message in a chat or channel → Team + Kanal Coding
  3. Speichern → HTTP POST URL aus dem Trigger kopieren

Variante C — Power Automate im Browser​

  1. make.powerautomate.com → Erstellen → Automatisierter Cloudflow
  2. Trigger: When a Teams webhook request is received
  3. Aktion: Post message in a chat or channel → Kanal Coding
  4. Flow speichern → Webhook-URL aus dem Trigger kopieren

Env setzen​

COCKPIT_FEEDBACK_TEAMS_WEBHOOK_URL="https://prod-….logic.azure.com/workflows/…"

In Render (Dashboard) oder lokal apps/dashboard/.env.local — nicht committen.

Test:

curl -X POST "$COCKPIT_FEEDBACK_TEAMS_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"type":"message","text":"Test Feedback-Webhook — Coding OK","message":"Test Feedback-Webhook — Coding OK"}'

cockpitOS sendet eine Adaptive Card im Webhook-Body:

  • adaptiveCard — für Power Automate (empfohlen)
  • attachments[0].content — Alternative / Vorlagen-Flows

Flow auf Adaptive Card umstellen​

  1. Schritt „Nachricht veröffentlichen“ löschen (Post message — nicht für Cards)
  2. + Neuer Schritt → Adaptive Card in einem Chat oder Kanal posten
  3. Veröffentlichen als: Flow-Bot · Kanal: Coding · Team: cockpitOS
  4. Feld Adaptive Card → fx → Ausdruck:
triggerBody()?['adaptiveCard']

Falls leer: triggerBody()?['attachments'][0]['content']

  1. Speichern

Optional JSON analysieren entfernen — bei Cards nicht nötig.

Test:

curl -X POST "$COCKPIT_FEEDBACK_TEAMS_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d @- <<'EOF'
{
"type": "message",
"adaptiveCard": {
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"version": "1.5",
"body": [
{ "type": "TextBlock", "text": "Test Card FB-MANUAL", "weight": "Bolder", "size": "Large" },
{ "type": "TextBlock", "text": "Wenn du das als Card siehst, passt der Flow.", "wrap": true }
]
}
}
EOF

Ohne Webhook: Feedback funktioniert trotzdem — Inbox unter System → Feedback-Inbox bleibt die Quelle der Wahrheit.

Ausführliche Webhook-Anleitung: docs/TEAMS-UPDATES-KANAL.md — gleiches Muster, anderer Kanal.

Screenshots werden auf Bunny CDN unter system/product-feedback/ gespeichert (Produktion auf Render). Die API liefert die volle CDN-URL (BUNNY_CDN_URL). Ohne Bunny-Credentials (lokale Entwicklung) bleibt der Fallback public/uploads/product-feedback/.

Hinweis: Ältere Einträge mit relativer URL /uploads/product-feedback/… verweisen auf Dateien auf dem ephemeralen Render-Dateisystem — diese Screenshots sind nach einem Deploy nicht wiederherstellbar. Neue Meldungen speichern dauerhafte CDN-URLs.

VariableZweck
BUNNY_STORAGE_PASSWORD oder BUNNY_ACCESS_KEYBunny Storage Upload
BUNNY_STORAGE_ZONEStorage Zone (Standard: cockpitos)
BUNNY_CDN_URLÖffentliche CDN-Basis-URL (Standard: https://cockpitos.b-cdn.net)

API (intern)​

  • POST /api/product-feedback — Feedback anlegen (Session); Fehler/Änderung → SMG-Coding-Agents-Webhook + Status In Arbeit
  • GET /api/product-feedback — Liste (eigene oder alle als Super Admin)
  • PATCH /api/product-feedback/[id] — Status + resolutionNote (nur Super Admin); benachrichtigt den Melder
  • POST /api/product-feedback/screenshot — optionaler Screenshot
  • GET/POST /api/product-feedback/agent — Liste / Claim (Bearer COCKPIT_FEEDBACK_AGENT_SECRET)
  • PATCH /api/product-feedback/agent/[id] — Status; done nur bei grünem /api/health + Antworttext
  • GET/POST/PATCH /api/agencyos/v1/product-feedback — AgencyOS/MCP: listen, anlegen (type + message, Melder cockpitOS-Assistent), Claim (id / FB-…)

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/dashboard/product-feedback