Zum Hauptinhalt springen

Product Feedback — Robi-Digest & Benachrichtigungen

cockpitOS speichert Feedback und stellt APIs bereit. Teams-DMs an Super Admins (Robi) laufen über AgencyOS — nicht im Dashboard-Repo.

Was cockpitOS liefert​

MechanismusZweck
COCKPIT_FEEDBACK_TEAMS_WEBHOOK_URLAdaptive Card in Teams-Kanal Coding bei neuem Ticket (Power Automate)
PRODUCT_FEEDBACK_NOTIFY_WEBHOOK_URLOptional: generischer JSON-Webhook bei created, claimed, status_changed (Bearer AGENCYOS_TEAMS_NOTIFY_SECRET)
GET /api/product-feedback/digestZähler + offene Tickets für Robi/Cron
POST /api/cron/product-feedback-digestGleicher Digest, nur Bearer CRON_SECRET

Melder-Benachrichtigung (Glocke, E-Mail) bei Statuswechsel: bereits in cockpitOS (notifyProductFeedbackStatusChange).

Digest-API (Vertrag)​

URL: GET /api/product-feedback/digest

Auth (eines reicht):

  • Super-Admin-Session (Browser)
  • Authorization: Bearer CRON_SECRET
  • Authorization: Bearer COCKPIT_AGENCYOS_API_KEY

Query:

ParameterDefaultBeschreibung
limit30Max. offene Einträge in openItems / needsAttention (max. 100)
format=text—Plain-Text-Zusammenfassung statt JSON

JSON-Antwort (success: true):

{
"data": {
"generatedAt": "2026-09-27T08:00:00.000Z",
"counts": {
"open": 4,
"new": 2,
"in_progress": 1,
"needs_info": 1,
"agent_claimed": 1,
"done": 12
},
"needsAttention": [
{
"referenceCode": "FB-ABC12",
"status": "new",
"statusLabel": "Neu",
"typeLabel": "Fehler",
"centerName": "Center XY",
"inboxUrl": "https://dashboard.cockpit-os.de/dashboard/system/product-feedback?highlight=FB-ABC12"
}
],
"openItems": []
}
}

needsAttention = Status Neu, Rückfrage oder In Arbeit ohne Claim — Tickets, die Super-Admin-Reaktion brauchen können.

AgencyOS / Robi (separates Repo)​

Implementierung (SMG-AgencyOS):

BausteinPfad
CronGET /api/cron/product-feedback-digest — Registry product-feedback-digest, Mo–Fr 08:00 UTC
Echtzeit-WebhookPOST /api/integrations/notifications/product-feedback
Clientsrc/lib/cockpit/product-feedback-digest-client.ts
Teams-DMsrc/lib/teams/product-feedback-notify.ts → ADMIN + GESCHAEFTSFUEHRER

AgencyOS sollte periodisch (z. B. werktags 9:00) den Digest abrufen und bei Bedarf eine DM senden:

curl -sS -H "Authorization: Bearer $CRON_SECRET" \
"https://dashboard.cockpit-os.de/api/product-feedback/digest?format=text"

Oder JSON für strukturierte Adaptive Cards:

curl -sS -H "Authorization: Bearer $COCKPIT_AGENCYOS_API_KEY" \
"https://dashboard.cockpit-os.de/api/product-feedback/digest?limit=20"

Empfohlene Robi-Logik in AgencyOS:

  1. Neues Feedback — optional zusätzlich zu Kanal-Coding: DM wenn counts.new > 0 und letzter Digest älter als X Minuten (oder Event-Webhook, siehe unten).
  2. Agent arbeitet — PRODUCT_FEEDBACK_NOTIFY_WEBHOOK_URL → AgencyOS empfängt event: "claimed" und kann kurz bestätigen („FB-… in Arbeit“).
  3. Proaktiver Digest — Cron ruft Digest; DM wenn needsAttention.length > 0 oder counts.open über Schwellwert.

Render-Cron-Alternative: POST /api/cron/product-feedback-digest mit gleichem Secret wie andere Cron-Jobs (siehe docs/CRON-SETUP.md).

Optionaler Event-Webhook​

Env: PRODUCT_FEEDBACK_NOTIFY_WEBHOOK_URL (Ziel-URL, z. B. AgencyOS POST /api/integrations/notifications/product-feedback)

Auth: Authorization: Bearer <AGENCYOS_TEAMS_NOTIFY_SECRET> — gleicher Wert in Cockpit und AgencyOS (wie Social-Review-Hooks).

POST-Body (JSON):

{
"event": "created",
"referenceCode": "FB-ABC12",
"type": "bug",
"status": "new",
"message": "…",
"centerName": "Center XY",
"userId": "550e8400-e29b-41d4-a716-446655440000",
"userEmail": "max@example.com",
"submitterEmail": "max@example.com",
"userName": "Max Mustermann",
"claimedAt": null,
"inboxUrl": "https://…/dashboard/system/product-feedback?highlight=FB-ABC12",
"at": "2026-09-27T08:00:00.000Z"
}

Events: created | claimed | status_changed

Melder-Auflösung (AgencyOS): userEmail bevorzugt (Cockpit-Login-E-Mail), Alias submitterEmail, optional userId (Cockpit-User-UUID — nicht identisch mit AgencyOS-User-ID), userName als Fallback bei fehlender E-Mail.

Dashboard-UI: userEmail kommt aus der Session.

Robi/MCP: userId in der DB bleibt der Systemnutzer „cockpitOS-Assistent“; die echte Melder-E-Mail liegt in contextJson.reporter und wird im Webhook als userEmail/submitterEmail mitgeschickt (OAuth/MCP-Actor oder explizit userEmail/submitterEmail im AgencyOS-POST).

Ohne Melder-E-Mail (nur Assistent, kein reporter) sendet AgencyOS keine DM (creator=not_resolved).

AgencyOS kann einen Power-Automate- oder Worker-Endpoint registrieren und daraus Robi-DMs bauen — Implementierung liegt in AgencyOS, nicht in cockpitOS.

Bestehende Agent-Felder​

FeldBedeutung
statusnew, in_progress, needs_info, done
claimedAtZeitpunkt Agent-Claim (Cursor-Automation oder MCP claim)
cursorPrUrlPR-Link nach Agent-Lauf (GitHub-Webhook oder PATCH cursorPrUrl)

Inbox-Filter „Agent in Arbeit“ = status === in_progress und claimedAt gesetzt.

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/product-feedback-robi-digest