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 " (preferred – does not end up in web server logs) * or, for older automations, as ?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); } }