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
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>
120 lines
4 KiB
PHP
120 lines
4 KiB
PHP
<?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) ?? '');
|
||
}
|
||
}
|