Loheide-eu-mitarbeiterplatt.../app/Ask/Knowledge.php
Friederich Loheide 9d8bdc08ce
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Has been skipped
CI / PHP 8.4 / mariadb:10.6 (pull_request) Has been skipped
CI / PHP 8.3 / mariadb:11.4 (pull_request) Has been skipped
CI / PHP 8.4 / mariadb:11.4 (pull_request) Has been skipped
CI / PHP 8.3 / mysql:8.0 (pull_request) Has been skipped
CI / PHP 8.4 / mysql:8.0 (pull_request) Has been skipped
CI / PHP 8.3 / mysql:8.4 (pull_request) Has been skipped
CI / PHP 8.4 / mysql:8.4 (pull_request) Has been skipped
CI / Browser-Tests (pull_request) Failing after 19m38s
CI / PHP 8.3 / mysql:8.4-1 (pull_request) Successful in 24m17s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 9m13s
CI / Build-Artefakte aktuell (pull_request) Successful in 6m4s
Frag das Portal (0.64.0)
Antworten mit Quellen aus Seiten, QM-Dokumenten, Glossar und Neuigkeiten –
nur aus Sichtbarem, über den KI-Assistenten (Anthropic, OpenAI, Ollama).
Wissensquellen als Registry für Plugins, Auswertung ohne Personenbezug.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-07 18:08:35 +00:00

120 lines
4 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\Ask;
use App\Models\User;
use App\Plugins\PluginAccess;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Query\Builder as QueryBuilder;
use Illuminate\Support\Facades\Log;
use Throwable;
/**
* Wissensquellen für „Frag das Portal“. Kern und Plugins melden an, worin gesucht
* wird – z. B. Handbuch-Seiten, QM-Dokumente, Glossar, Neuigkeiten. Jede Quelle
* liefert nur, was die fragende Person sehen darf, und dazu den vollen Text
* (die Antwort entsteht aus diesen Texten).
*
* Treffer: ['title' => …, 'url' => …, 'text' => Klartext, 'meta' => ?string]
*/
class Knowledge
{
/** Höchstens so viel Text je Treffer – ausgewählt wird später ohnehin nur ein Ausschnitt */
public const MAX_TEXT = 30000;
/** @var array<string, array{label: string, search: callable}> */
private array $sources = [];
/**
* Die Quelle bekommt Person, Suchbegriffe (klein geschrieben; ein Treffer enthält
* mindestens einen) und Höchstzahl.
*
* @param callable(User, list<string>, int): list<array<string, mixed>> $search
*/
public function add(string $key, string $label, callable $search): void
{
$this->sources[$key] = compact('label', 'search');
}
public function remove(string $key): void
{
unset($this->sources[$key]);
}
/**
* @return array<string, string> Schlüssel => Bezeichnung
*/
public function labels(): array
{
return array_map(fn (array $source) => $source['label'], $this->sources);
}
/**
* @param list<string> $terms
* @return list<array{source: string, label: string, title: string, url: string, text: string, meta: ?string}>
*/
public function gather(User $user, array $terms, int $perSource = 8): array
{
if ($terms === []) {
return [];
}
$documents = [];
foreach ($this->sources as $key => $source) {
if (! app(PluginAccess::class)->allows($key, $user)) {
continue;
}
try {
foreach (array_slice(($source['search'])($user, $terms, $perSource), 0, $perSource) as $hit) {
$documents[] = [
'source' => $key,
'label' => $source['label'],
'title' => (string) $hit['title'],
'url' => (string) $hit['url'],
'text' => mb_substr((string) $hit['text'], 0, self::MAX_TEXT),
'meta' => $hit['meta'] ?? null,
];
}
} catch (Throwable $e) {
// Eine fehlerhafte Quelle darf die Antwort nicht verhindern.
Log::error("Wissensquelle {$key} fehlgeschlagen: ".$e->getMessage(), ['exception' => $e]);
}
}
return $documents;
}
/**
* Mindestens einer der Begriffe in mindestens einer der Spalten.
*
* @template T of Builder|QueryBuilder
*
* @param T $query
* @param list<string> $columns
* @param list<string> $terms
* @return T
*/
public static function whereAny(Builder|QueryBuilder $query, array $columns, array $terms): Builder|QueryBuilder
{
return $query->where(function ($q) use ($columns, $terms) {
foreach ($terms as $term) {
$like = '%'.str_replace(['\\', '%', '_'], ['\\\\', '\\%', '\\_'], $term).'%';
foreach ($columns as $column) {
$q->orWhere($column, 'like', $like);
}
}
});
}
/** HTML in lesbaren Klartext (Absätze bleiben als Zeilenumbrüche erhalten) */
public static function plain(?string $html): string
{
$text = preg_replace('#<(br|/p|/li|/h[1-6]|/tr|/div)\b[^>]*>#i', "\n", (string) $html) ?? '';
$text = html_entity_decode(strip_tags($text), ENT_QUOTES | ENT_HTML5);
return trim(preg_replace(["/[ \t]+/u", "/\n\s*\n+/u"], [' ', "\n"], $text) ?? '');
}
}