Loheide-eu-mitarbeiterplatt.../app/Support/Feedback/FeedbackResult.php
Friederich Loheide 029dbd243d Rückmeldungen, Hintergrundaufgaben, Systemzustand und Web-Installer
- Rückmeldungen an den Hersteller (docs/specs/feedback.md): Fehlerbericht und
  Funktionswunsch, nur freigeschaltete Wege, Idempotency-Key je Meldung,
  Warteschlange mit höchstens fünf Versuchen, 422 am Feld, 429 mit Wartezeit,
  404 blendet den Weg aus, Referenznummer und „Meine Rückmeldungen“,
  sichtbare technische Angaben und Datenschutzhinweis über dem Absendeknopf
- Hintergrundaufgaben ohne Dauerprozess: Cron, Web-Cron (/cron/{token}) oder
  Pseudo-Cron nach dem Seitenaufruf; Queue in kurzen Häppchen
- Seite „Systemzustand“ mit Voraussetzungen, Grenzen, Betrieb, Sicherheit und
  Anleitung für den Cronjob
- Web-Installer (Systemprüfung → Datenbank → Administrator), legt .env und
  Anwendungsschlüssel selbst an, arbeitet vor der Einrichtung ohne Datenbank
- Datenbank-Benachrichtigungen im Admin-Bereich

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 06:11:09 +00:00

58 lines
1.4 KiB
PHP

<?php
namespace App\Support\Feedback;
/**
* Ergebnis eines Zustellversuchs.
*/
final class FeedbackResult
{
public const SENT = 'sent';
public const INVALID = 'invalid';
public const RATE_LIMITED = 'rate_limited';
public const DISABLED = 'disabled';
public const RETRY = 'retry';
/**
* @param array<string, string> $errors Feld => Meldung (bei 422)
*/
private function __construct(
public readonly string $status,
public readonly ?string $reference = null,
public readonly array $errors = [],
public readonly ?int $retryAfter = null,
public readonly ?string $message = null,
) {}
public static function sent(string $reference): self
{
return new self(self::SENT, reference: $reference);
}
/**
* @param array<string, string> $errors
*/
public static function invalid(array $errors, ?string $message = null): self
{
return new self(self::INVALID, errors: $errors, message: $message);
}
public static function rateLimited(?int $retryAfter): self
{
return new self(self::RATE_LIMITED, retryAfter: $retryAfter);
}
public static function disabled(): self
{
return new self(self::DISABLED);
}
public static function retry(string $message, ?int $retryAfter = null): self
{
return new self(self::RETRY, retryAfter: $retryAfter, message: $message);
}
}