Files

T

RichardandClaude Opus 5 168f4699e1 Deployment-Center-Integration im WinFormsHost

Loest die getrennten Server Watchdog (watchdog.mhdf.de) und LicenseLabrador
(license.mhdf.de) durch das Deployment Center (dc.mhdf.de) ab.

- DcConfig: einkompilierte Basis-URL und Produkt-Slug, Version aus BuildInfo
- DcApiClient: gemeinsamer HTTP-Zugang
- DcHeartbeatService: Heartbeat mit Metriken und DB-Health-Check
- DcErrorReporter/DcErrorSink: Error- und Fatal-Meldungen an den Fehler-Stream
- DcUpdateService: Update-Pruefung gegen den UpdateService
- LicenseGuard/LicenseDialog: Lizenzgate ueber /api/license/v1/validate,
  mit LicenseSession, Hardware-ID v2 und Unterscheidung transienter Fehler

WatchdogHeartbeatService entfernt, Betriebsdoku ersetzt.

Build: 0 Fehler.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-08 20:56:45 +02:00

3.8 KiB

Raw Blame History

Predictalytics

Betriebsdokumentation zur Anbindung an das Deployment Center (Lizenz, Watchdog, Updates, Fehler-Stream): docs/BETRIEB-Deploymentcenter.md.

Zentraler Bugtracker — Deployment Center

Erfasse unbehandelte Fehler, geplante Verbesserungen und Ideen im zentralen Deployment Center. Basis-URL: https://dc.mhdf.de

Zugang

Token steht in der Umgebungsvariable DC_TOKEN. Header: Authorization: Bearer $DC_TOKEN

Ist DC_TOKEN nicht gesetzt, melde nichts und weise stattdessen darauf hin — die Endpunkte antworten sonst mit 401 unauthorized.

Die vollständige Schnittstellenbeschreibung liegt maschinenlesbar unter GET /api/openapi.json, das Handbuch unter /docs/.

Projekt

Dieses Projekt ist predictalytics. Repo: http://192.168.178.10:8418/Richard/Predictalytics Fällt dir ein Fehler im Deployment Center selbst auf, melde ihn unter deploymentcenter.

Etwas melden

POST /api/bugtracker/v1/report

{
  "project_slug": "predictalytics",
  "type": "bug",
  "title": "Kurze, aussagekräftige Zusammenfassung",
  "description": "Unter welchen Bedingungen tritt es auf?",
  "error_message": "Exakte Fehlermeldung",
  "stack_trace": "Vollständiger Stacktrace",
  "severity": "high",
  "environment": "production",
  "build_version": "v1.0.0",
  "repo_url": "http://192.168.178.10:8418/Richard/Predictalytics",
  "git_branch": "main",
  "commit_sha": "a21536f",
  "file_path": "src/Predictalytics.Worker/Services/TraderAnalyticsWorker.cs",
  "line_no": 152,
  "client_ref": "eindeutige-id-dieses-laufs"
}

Setze immer client_ref — ein wiederholter Aufruf mit demselben Wert legt kein Duplikat an. Gib nach Möglichkeit file_path und line_no an; das spart dem nächsten Agenten das Parsen des Stacktrace.

Schweregrade: idea (Gedanke für später), wishlist (Backlog), low, medium, high, critical.

Arbeit übernehmen

Bevor du an einem Item arbeitest, übernimm es — sonst arbeiten zwei Agenten parallel am selben Problem:

POST /api/bugtracker/v1/manage?action=next
Body: {"project_slug": "predictalytics", "limit": 1}

Antwortet der Server mit 409 already_claimed, nimm das nächste Item. Die Reservierung läuft nach 30 Minuten ab; action=claim auf dieselbe ID erneuert sie.

Fortschritt festhalten

POST /api/bugtracker/v1/manage?action=comment&id=<ID>
Body: {"comment": "Was du herausgefunden hast", "action_taken": "investigated"}

action_taken: investigated, fix_proposed, pr_opened, needs_human, blocked, commented.

Abschließen

POST /api/bugtracker/v1/manage?action=resolve&id=<ID>
Body: {"resolved_in_build": "v1.0.1", "resolution_notes": "Was geändert wurde"}

Kommst du nicht weiter, gib das Item zurück statt es blockieren zu lassen:

POST /api/bugtracker/v1/manage?action=release&id=<ID>
Body: {"note": "Grund"}

Laufzeitfehler

Die Anwendung meldet Error/Fatal selbst über POST /api/errors/v1/report (Services/DcErrorReporter.cs) — dort nichts von Hand nachreichen.

Release melden

Nach einem Release schließen sich Items mit passendem resolved_in_build automatisch:

POST /api/updateservice/v1/publish
Body: {"product_slug": "predictalytics", "version": "1.0.1",
       "download_url": "...", "sha256_hash": "...", "git_commit": "..."}

Die Version in src/Predictalytics.WinFormsHost/Predictalytics.WinFormsHost.csproj (<Version>) muss dazu passen — sie ist es, die der Client als installierte Version meldet.

Fehlerbehandlung

Antworten haben die Form {"status":"error","error":{"code":"…"}}. Reagiere auf code, nicht auf den Text:

401 unauthorized — Token prüfen, nicht wiederholen
409 already_claimed — nächstes Item nehmen
429 rate_limited — Intervall verdoppeln, später erneut

3.8 KiB Raw Blame History