Loheide-eu-mitarbeiterplatt.../plugins-core/it-service/src/ItService.php
Friederich Loheide 50ee85c06b
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 3m31s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 3m39s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 3m57s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 3m46s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 5m9s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 5m13s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 4m30s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 4m27s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m7s
IT-Service: Baumstruktur, HTML-Antworten, Fehlermeldungen, geschlossene Tickets, Meine IT im Profilkasten
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 20:30:24 +00:00

347 lines
14 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 Inhaus\Plugins\ItService;
use App\Models\User;
use App\Support\RichText;
use Illuminate\Http\Client\Response;
use Illuminate\Support\Arr;
use Inhaus\Plugins\ItService\OpenNit\Client;
use Inhaus\Plugins\ItService\OpenNit\Settings;
/**
* IT-Self-Service für eine Person: alle Abfragen laufen mit ihrer E-Mail-Adresse,
* OpenNIT liefert damit nur ihre eigenen Geräte, Tickets und Ausleihen.
* Antworten werden defensiv aufbereitet – die Oberfläche bekommt feste Felder.
*/
class ItService
{
public const CLOSED_STATUSES = ['closed', 'resolved', 'solved', 'done', 'geschlossen', 'erledigt', 'geloest', 'gelöst', 'cancelled', 'canceled'];
public const OPEN_STATUSES = ['open', 'new', 'pending', 'in_progress', 'waiting', 'reopened', 'offen', 'neu', 'in_bearbeitung', 'wartend'];
public function __construct(private readonly Client $client, private readonly Settings $settings) {}
public function configured(): bool
{
return $this->settings->configured();
}
/**
* @return list<array<string, mixed>>
*/
public function assets(User $user): array
{
return array_map(fn (array $asset) => [
'id' => (int) ($asset['id'] ?? 0),
'name' => (string) ($asset['name'] ?? $asset['title'] ?? 'Gerät'),
'type' => self::text($asset, ['type', 'category', 'device_type']),
'serial' => self::text($asset, ['serial', 'serial_number']),
'inventory' => self::text($asset, ['inventory_number', 'asset_tag', 'inventory']),
'manufacturer' => self::text($asset, ['manufacturer', 'vendor']),
'model' => self::text($asset, ['model']),
'location' => self::text($asset, ['location', 'location_name']),
'warranty_end' => self::text($asset, ['warranty_end', 'warranty_until']),
'maintenance' => self::text($asset, ['next_maintenance', 'maintenance_due', 'maintenance']),
], $this->list($this->client->get('/my-assets', ['email' => $user->email]), 'assets'));
}
/**
* @return list<array<string, mixed>>
*/
public function tickets(User $user): array
{
$tickets = array_map(fn (array $ticket) => self::ticketSummary($ticket), $this->list($this->client->get('/my-tickets', ['email' => $user->email]), 'tickets'));
usort($tickets, fn ($a, $b) => [$b['open'], $b['created_at']] <=> [$a['open'], $a['created_at']]);
return $tickets;
}
/**
* @return array<string, mixed>
*/
public function ticket(User $user, int $id): array
{
$data = $this->client->get("/tickets/{$id}", ['email' => $user->email]);
$ticket = (array) ($data['ticket'] ?? $data);
return [
...self::ticketSummary($ticket),
'description' => self::html(self::text($ticket, ['description', 'body', 'message', 'text'])),
'category' => self::text($ticket, ['category', 'category_name']),
'location' => self::text($ticket, ['location', 'location_name']),
'asset' => self::text($ticket, ['asset', 'asset_name']),
'replies' => array_map(fn ($reply) => [
'message' => self::html(is_array($reply) ? self::text($reply, ['message', 'body', 'text', 'content']) : (string) $reply),
'author' => is_array($reply) ? self::text($reply, ['author', 'from_name', 'name', 'user', 'author_name']) : null,
'from_staff' => is_array($reply) && (bool) ($reply['is_staff'] ?? $reply['internal_user'] ?? $reply['from_staff'] ?? (isset($reply['from_email']) && mb_strtolower((string) $reply['from_email']) !== mb_strtolower($user->email))),
'created_at' => is_array($reply) ? self::text($reply, ['created_at', 'date', 'created']) : null,
], array_values(array_filter((array) ($data['replies'] ?? []), fn ($reply) => ! (is_array($reply) && ($reply['internal'] ?? $reply['is_internal'] ?? false))))),
'attachments' => array_values(array_filter(array_map(fn ($file) => is_array($file) && isset($file['id']) ? [
'id' => (int) $file['id'],
'name' => (string) ($file['name'] ?? $file['filename'] ?? $file['original_name'] ?? 'Anhang'),
'size' => isset($file['size']) ? (int) $file['size'] : null,
] : null, (array) ($data['attachments'] ?? [])))),
'assignees' => array_values(array_filter(array_map(fn ($person) => is_array($person) ? self::text($person, ['name', 'display_name', 'username']) : (is_string($person) ? $person : null), (array) ($data['assignees'] ?? [])))),
];
}
/**
* @param array{subject: string, description?: ?string, category_id?: ?int, location_id?: ?int, asset_id?: ?int} $data
*/
public function createTicket(User $user, array $data): int
{
$response = $this->client->post('/tickets', array_filter([
'subject' => $data['subject'],
'from_email' => $user->email,
'from_name' => $user->name,
'description' => $data['description'] ?? null,
'category_id' => $data['category_id'] ?? null,
'location_id' => $data['location_id'] ?? null,
'asset_id' => $data['asset_id'] ?? null,
], fn ($value) => $value !== null && $value !== ''));
return (int) ($response['id'] ?? $response['ticket_id'] ?? 0);
}
public function reply(User $user, int $ticketId, string $message): void
{
$this->client->post("/tickets/{$ticketId}/reply", ['email' => $user->email, 'message' => $message]);
}
public function attachment(User $user, int $id): Response
{
return $this->client->download("/ticket-attachments/{$id}", ['email' => $user->email]);
}
/**
* @return list<array<string, mixed>>
*/
public function loans(User $user): array
{
return array_map(fn (array $loan) => [
'id' => (int) ($loan['id'] ?? 0),
'device' => (string) ($loan['device_title'] ?? $loan['device'] ?? 'Leihgerät'),
'status' => (string) ($loan['status'] ?? ''),
'status_label' => self::loanStatus((string) ($loan['status'] ?? '')),
'start' => self::text($loan, ['planned_start', 'start']),
'end' => self::text($loan, ['planned_end', 'end']),
'cancellable' => in_array($loan['status'] ?? '', ['pending', 'reserved'], true),
], $this->list($this->client->get('/my-loans', ['email' => $user->email]), 'loans'));
}
/**
* @return list<array<string, mixed>>
*/
public function loanDevices(?string $type, ?string $from, ?string $to): array
{
return array_map(fn (array $device) => [
'id' => (int) ($device['id'] ?? 0),
'title' => (string) ($device['title'] ?? $device['name'] ?? 'Leihgerät'),
'type' => self::text($device, ['type', 'category']),
'available' => (bool) ($device['available'] ?? true),
'description' => self::text($device, ['description', 'notes']),
], $this->list($this->client->get('/loan-devices', ['type' => $type, 'date_from' => $from, 'date_to' => $to]), 'devices'));
}
/**
* @return list<array{start: string, end: string}>
*/
public function slots(int $deviceId): array
{
return array_values(array_filter(array_map(fn ($slot) => is_array($slot) && isset($slot['start']) ? ['start' => (string) $slot['start'], 'end' => (string) ($slot['end'] ?? $slot['start'])] : null, $this->list($this->client->get("/loan-devices/{$deviceId}/slots"), 'slots'))));
}
/**
* @param array{device_id: int, planned_start: string, planned_end: string, purpose?: ?string} $data
* @return array{status: string, message: ?string}
*/
public function requestLoan(User $user, array $data): array
{
$body = [
'device_id' => $data['device_id'],
'planned_start' => $data['planned_start'],
'planned_end' => $data['planned_end'],
'borrower_name' => $user->name,
'borrower_email' => $user->email,
'purpose' => $data['purpose'] ?? null,
];
if (($auto = $this->settings->autoReserve()) !== null) {
$body['auto_reserve'] = $auto;
}
$response = $this->client->post('/loan-requests', array_filter($body, fn ($value) => $value !== null));
return ['status' => (string) ($response['status'] ?? 'pending'), 'message' => is_string($response['message'] ?? null) ? $response['message'] : null];
}
public function cancelLoan(User $user, int $id): void
{
$this->client->post("/loan-requests/{$id}/cancel", ['email' => $user->email]);
}
/**
* @return array{categories: list<array<string, mixed>>, locations: list<array<string, mixed>>}
*/
public function ticketOptions(): array
{
return [
'categories' => self::tree($this->list($this->client->cached('/ticket-categories'), 'categories')),
'locations' => self::tree($this->list($this->client->cached('/ticket-locations'), 'locations')),
];
}
/**
* @return list<string>
*/
public function deviceTypes(): array
{
return array_values(array_filter(array_map(fn ($type) => is_string($type) ? $type : (is_array($type) ? ($type['name'] ?? null) : null), $this->list($this->client->cached('/device-types'), 'types'))));
}
/**
* @param array<string, mixed> $ticket
* @return array<string, mixed>
*/
private static function ticketSummary(array $ticket): array
{
$status = (string) ($ticket['status'] ?? '');
return [
'id' => (int) ($ticket['id'] ?? 0),
'subject' => (string) ($ticket['subject'] ?? $ticket['title'] ?? 'Ticket'),
'status' => $status,
'status_label' => self::ticketStatus($status),
'open' => self::isOpen($status),
'created_at' => self::text($ticket, ['created_at', 'created', 'date']) ?? '',
'updated_at' => self::text($ticket, ['updated_at', 'last_activity']),
'number' => self::text($ticket, ['number', 'ticket_number', 'reference']),
];
}
public static function isOpen(string $status): bool
{
return ! in_array(mb_strtolower($status), self::CLOSED_STATUSES, true);
}
public static function ticketStatus(string $status): string
{
return match (mb_strtolower($status)) {
'open', 'new', 'offen', 'neu' => 'Offen',
'in_progress', 'in_bearbeitung', 'assigned' => 'In Bearbeitung',
'pending', 'waiting', 'wartend', 'on_hold' => 'Wartet auf Rückmeldung',
'reopened' => 'Wieder geöffnet',
'resolved', 'solved', 'geloest', 'gelöst', 'done', 'erledigt' => 'Gelöst',
'closed', 'geschlossen' => 'Geschlossen',
'cancelled', 'canceled' => 'Storniert',
default => $status !== '' ? ucfirst(str_replace('_', ' ', $status)) : 'Offen',
};
}
public static function loanStatus(string $status): string
{
return match ($status) {
'pending' => 'Angefragt',
'reserved' => 'Reserviert',
'active' => 'Ausgeliehen',
'returned' => 'Zurückgegeben',
'rejected' => 'Abgelehnt',
'cancelled' => 'Storniert',
default => $status !== '' ? ucfirst($status) : 'Angefragt',
};
}
/**
* @param array<string, mixed> $data
* @return list<array<string, mixed>>
*/
private function list(array $data, string $key): array
{
// Laut Doku {"key": [...]}; manche Versionen verpacken in {"data": …}
$items = $data[$key] ?? $data['data'][$key] ?? (isset($data['data']) && is_array($data['data']) && array_is_list($data['data']) ? $data['data'] : null) ?? (array_is_list($data) ? $data : []);
return array_values(array_filter((array) $items, fn ($item) => is_array($item) || is_string($item)));
}
/**
* Hierarchie (parent_id) als eingerückte Liste für Auswahlfelder.
*
* @param list<array<string, mixed>> $items
* @return list<array{value: int, label: string}>
*/
private static function tree(array $items): array
{
$byId = [];
$children = [];
foreach ($items as $item) {
if (is_array($item) && isset($item['id'])) {
$byId[$item['id']] = $item;
}
}
foreach ($byId as $item) {
// Eltern, die in der Liste fehlen, machen den Eintrag zur obersten Ebene
$parent = $item['parent_id'] ?? null;
$children[$parent !== null && isset($byId[$parent]) ? $parent : 0][] = $item;
}
$result = [];
$walk = function ($parent, int $depth, array $path) use (&$walk, &$children, &$result) {
foreach ($children[$parent] ?? [] as $item) {
$name = trim((string) ($item['name'] ?? ''));
// Einrückung mit geschützten Leerzeichen – Auswahllisten verschlucken normale
$result[] = [
'value' => (int) $item['id'],
'label' => ($depth > 0 ? str_repeat("\u{00A0}\u{00A0}\u{00A0}\u{00A0}", $depth - 1)."\u{00A0}\u{00A0}└\u{00A0}" : '').$name,
'path' => implode(' › ', [...$path, $name]),
'depth' => $depth,
];
$walk($item['id'], $depth + 1, [...$path, $name]);
}
};
$walk(0, 0, []);
return $result;
}
/**
* Texte aus OpenNIT können HTML enthalten (<br>, <p> …): bereinigt ausgeben,
* reinen Text mit Zeilenumbrüchen übernehmen.
*/
private static function html(?string $text): ?string
{
if ($text === null || trim($text) === '') {
return null;
}
if ($text === strip_tags($text)) {
return nl2br(e($text), false);
}
return app(RichText::class)->sanitize($text);
}
/**
* @param array<string, mixed> $data
* @param list<string> $keys
*/
private static function text(array $data, array $keys): ?string
{
foreach ($keys as $key) {
$value = Arr::get($data, $key);
if (is_array($value)) {
$value = $value['name'] ?? $value['title'] ?? null;
}
if (is_scalar($value) && trim((string) $value) !== '') {
return trim((string) $value);
}
}
return null;
}
}