Files
fewo-stommer/app/Http/Controllers/ChannelController.php
T
LarsandClaude Opus 5.5 799869c6a4 v0.11 U1: Kanalmanager mit eigener Webseite und neuen Prozessparametern
- Eigene Webseite als Kanal eigener Art (channels.kind = website), nur zur
  Konfiguration: Webseiten-Anfragen bleiben direkt (A1) ohne Kanalbezug;
  der Eintrag nimmt an Sync, Export, Überwachung und Sperraufgaben nicht teil
  (active()/Property::channels() nur Portale, Feed nur für Portale).
- Neue Einstellungen im bestehenden ProcessSetting: Klärungsreservierung
  automatisch/Freigabe (15/180 min, 0 = keine), Rückfragemodus,
  Erinnerungen, Folgefragen, Erinnerungsabstand, Linkgültigkeit,
  Anschrift im Webformular verlangen (Standard: nein).
- „Kanäle“ in der einfachen Ansicht: Webseite und Portale an einer Stelle,
  Verweis auf „Ihre Standards“; „Wirksame Einstellungen“ mit Spalte
  „Eigene Webseite“ und Herkunft „Webseite“.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 12:52:50 +01:00

151 lines
5.8 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\Http\Controllers;
use App\Actions\MonitorChannels;
use App\Actions\ProcessPortalMail;
use App\Channels\ICal\ICalExport;
use App\Channels\Mail\MailboxReader;
use App\Channels\Mail\PortalMail;
use App\Enums\ChannelTaskStatus;
use App\Models\Channel;
use App\Models\ChannelTask;
use Carbon\CarbonImmutable;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Cache;
/**
* Public endpoints of the channel synchronisation: export feeds for portals, the health check for
* external monitoring and the callback of the optional blocking automation.
*/
class ChannelController extends Controller
{
public function feed(string $token, ICalExport $feed, Request $request): Response
{
$channel = Channel::query()->portals()->where(fn ($query) => $query->where('export_token', $token)
->orWhere(fn ($previous) => $previous->where('previous_export_token', $token)->where('previous_export_token_expires_at', '>', now())))->firstOrFail();
abort_unless($channel->servesItsLandlord(), 404);
$body = $feed->build($channel, $request->method(), $request->userAgent());
if ($body === null) {
return response('Der Export ist pausiert; es liegt noch kein gültiger Kalenderstand vor.', 503, ['Retry-After' => '300', 'Cache-Control' => 'no-store']);
}
return response($body, 200, [
'Content-Type' => 'text/calendar; charset=utf-8',
'Content-Disposition' => 'inline; filename="belegung.ics"',
'Cache-Control' => 'no-cache, max-age=0',
'X-Fewo-Export-State' => $channel->exportsOccupations() ? 'live' : 'frozen',
]);
}
public function health(Request $request): JsonResponse
{
abort_unless($this->hasValidToken($request, config('fewo.channels.health_token')), 404);
$channels = Channel::query()->active()->get()->map(fn (Channel $channel): array => [
'name' => $channel->name,
'imports' => $channel->importsOccupations(),
'ok' => ! $channel->isStale(),
'last_success_at' => $channel->last_success_at?->toIso8601String(),
'last_error' => $channel->last_error,
]);
$openTasks = ChannelTask::query()->open()->count();
$mailbox = [
'configured' => MailboxReader::isConfigured(),
'ok' => ! MonitorChannels::mailboxIsStale(),
'last_success_at' => Cache::get(MailboxReader::key(MailboxReader::LAST_SUCCESS_KEY)),
'last_error' => Cache::get(MailboxReader::key(MailboxReader::LAST_ERROR_KEY)),
];
$ok = $channels->every(fn (array $channel): bool => $channel['ok']) && $mailbox['ok'];
return response()->json([
'status' => $ok ? 'ok' : 'degraded',
'open_tasks' => $openTasks,
'mailbox' => $mailbox,
'channels' => $channels->values(),
], $ok ? 200 : 503);
}
/**
* Runs the task scheduler once (fallback for hosting without suitable cron jobs).
*/
public function scheduler(Request $request): JsonResponse
{
abort_unless($this->hasValidToken($request, config('fewo.scheduler_token')), 404);
Artisan::call('schedule:run');
return response()->json(['ran_at' => now()->toIso8601String(), 'output' => trim(Artisan::output())]);
}
/**
* Push variant of the e-mail fast path, e.g. from an n8n IMAP trigger:
* JSON {message_id, from, subject, text, received_at}, signed like the automation webhook.
*/
public function portalMail(Request $request, ProcessPortalMail $processPortalMail): JsonResponse
{
$this->verifySignature($request);
$data = $request->validate([
'message_id' => ['required', 'string', 'max:255'],
'from' => ['required', 'string', 'max:255'],
'subject' => ['required', 'string', 'max:500'],
'text' => ['required', 'string', 'max:200000'],
'received_at' => ['nullable', 'date'],
]);
$record = $processPortalMail->handle(new PortalMail(
messageId: $data['message_id'],
from: $data['from'],
subject: $data['subject'],
text: $data['text'],
receivedAt: isset($data['received_at']) ? CarbonImmutable::parse($data['received_at']) : CarbonImmutable::now(),
));
return response()->json([
'processed' => $record !== null,
'type' => $record?->type->value,
'status' => $record?->status->value,
]);
}
/**
* The automation reports a task as done. The raw body must be signed like the outgoing webhook.
*/
public function completeTask(Request $request, ChannelTask $task): JsonResponse
{
$this->verifySignature($request);
if ($task->status === ChannelTaskStatus::Open) {
$task->complete('Automatisierung');
}
return response()->json(['status' => $task->status->value]);
}
private function verifySignature(Request $request): void
{
$secret = config('fewo.automation.secret');
$signature = (string) $request->header('X-Signature');
abort_if(blank($secret) || ! hash_equals(hash_hmac('sha256', $request->getContent(), $secret), $signature), 403);
}
/**
* The token is sent as header "Authorization: Bearer <token>" (preferred – does not end up in web server logs)
* or, for older automations, as ?token=<token>.
*/
private function hasValidToken(Request $request, ?string $expected): bool
{
$given = (string) ($request->bearerToken() ?? $request->header('X-Fewo-Token') ?? $request->query('token', ''));
return filled($expected) && hash_equals((string) $expected, $given);
}
}