Loheide-eu-mitarbeiterplatt.../app/Support/Feedback/FeedbackOutbox.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

137 lines
5 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Support\Feedback;
use App\Models\User;
use App\Models\VendorFeedback;
use Filament\Notifications\Notification;
use Illuminate\Support\Facades\Log;
/**
* Warteschlange für Rückmeldungen: Die Meldung wird sofort gespeichert (samt
* Idempotency-Key) und dann zugestellt. Klappt das nicht, versucht es der
* Hintergrundlauf erneut – höchstens fünfmal, danach wird verworfen und die
* Person informiert.
*/
class FeedbackOutbox
{
public const MAX_ATTEMPTS = 5;
public function __construct(
private readonly FeedbackClient $client,
private readonly FeedbackChannels $channels,
) {}
/**
* Neue Meldung speichern und direkt einen ersten Zustellversuch machen.
*
* @param array<string, mixed> $payload
*/
public function submit(?User $user, string $type, array $payload): FeedbackResult
{
$feedback = VendorFeedback::query()->create([
'user_id' => $user?->id,
'type' => $type,
'payload' => $payload,
// Je Meldung EINMAL erzeugt und bei jedem Wiederholungsversuch mitgeschickt.
'idempotency_key' => bin2hex(random_bytes(16)),
'status' => VendorFeedback::PENDING,
'next_attempt_at' => now(),
]);
$result = $this->attempt($feedback, timeout: 8);
// Eingabe- und Mengenfehler klärt die Person im Formular – nicht die Warteschlange.
// Die Eingabe bleibt im Formular erhalten; eine neue Meldung bekommt einen neuen Schlüssel.
if (in_array($result->status, [FeedbackResult::INVALID, FeedbackResult::RATE_LIMITED, FeedbackResult::DISABLED], true)) {
$feedback->delete();
}
return $result;
}
/**
* Fällige Meldungen erneut senden (Hintergrundlauf). Nacheinander, damit das
* Gerätetoken zwischen den Anfragen nachgeführt wird.
*/
public function processDue(): int
{
$processed = 0;
VendorFeedback::query()
->where('status', VendorFeedback::PENDING)
->where('next_attempt_at', '<=', now())
->orderBy('id')
->limit(20)
->get()
->each(function (VendorFeedback $feedback) use (&$processed) {
$this->attempt($feedback);
$processed++;
});
return $processed;
}
private function attempt(VendorFeedback $feedback, int $timeout = 15): FeedbackResult
{
$result = $this->client->send($feedback->type, $feedback->payload, $feedback->idempotency_key, $timeout);
$attempts = $feedback->attempts + 1;
switch ($result->status) {
case FeedbackResult::SENT:
$feedback->update(['status' => VendorFeedback::SENT, 'attempts' => $attempts, 'reference' => $result->reference, 'last_error' => null]);
Log::info("Rückmeldung zugestellt: {$result->reference}");
break;
case FeedbackResult::DISABLED:
$this->channels->disable($feedback->type);
$this->discard($feedback, $attempts, 'Dieser Meldeweg ist für das Programm nicht freigeschaltet.');
break;
case FeedbackResult::INVALID:
case FeedbackResult::RATE_LIMITED:
if ($feedback->attempts > 0) {
// Nur im Hintergrund möglich (z. B. 429 bei Wiederholung): später erneut.
$this->reschedule($feedback, $attempts, $result->message ?? 'Später erneut versuchen.', $result->retryAfter);
}
break;
default:
$this->reschedule($feedback, $attempts, $result->message ?? 'Nicht zugestellt.', $result->retryAfter);
}
return $result;
}
private function reschedule(VendorFeedback $feedback, int $attempts, string $error, ?int $retryAfter): void
{
if ($attempts >= self::MAX_ATTEMPTS) {
$this->discard($feedback, $attempts, $error);
return;
}
// 1, 5, 15, 60 Minuten – oder so lange, wie der Server es verlangt.
$delay = $retryAfter ?? [60, 300, 900, 3600][min($attempts - 1, 3)];
$feedback->update([
'attempts' => $attempts,
'next_attempt_at' => now()->addSeconds(max(30, $delay)),
'last_error' => mb_substr($error, 0, 500),
]);
}
private function discard(VendorFeedback $feedback, int $attempts, string $error): void
{
$feedback->update(['status' => VendorFeedback::DISCARDED, 'attempts' => $attempts, 'last_error' => mb_substr($error, 0, 500)]);
Log::warning("Rückmeldung verworfen nach {$attempts} Versuchen: {$error}");
if ($feedback->user) {
Notification::make()
->danger()
->title('Rückmeldung konnte nicht zugestellt werden')
->body('„'.($feedback->payload['title'] ?? '').'“ wurde nach '.$attempts.' Versuchen verworfen. Bitte senden Sie die Meldung später erneut.')
->sendToDatabase($feedback->user);
}
}
}