docs(15.9): document the new 15.9 features

de/15.9/admin/backup-guide.rst

@@ -45,6 +45,11 @@ doc.json
 
 doc.json enthält die Mapping-Informationen des Fess-Index.
 
+chat_log.ndjson
+:::::::::::::::
+
+chat_log.ndjson enthält die Nutzungsprotokolle des KI-Chats.
+
 click_log.ndjson
 ::::::::::::::::
 

de/15.9/admin/docreport-guide.rst

@@ -0,0 +1,71 @@
+===============
+Dokumentbericht
+===============
+
+Übersicht
+=========
+
+Die Seite Dokumentbericht hilft beim Aufräumen gecrawlter Dateiserver und Ähnlichem. Sie listet
+Dokumente mit gleichem Inhalt und Dokumente auf, die lange nicht geändert wurden; jede Liste lässt
+sich als CSV herunterladen.
+
+Um die Seite zu öffnen, wählen Sie im linken Menü [Systeminformationen > Dokumentbericht]. Zum
+Anzeigen ist die Rolle ``admin-docreport`` oder ``admin-docreport-view`` erforderlich. Die Seite
+zeigt Berichte nur an und lädt sie herunter; sie ändert keine Dokumente.
+
+Beide Registerkarten lassen sich mit „URL-Präfix“ eingrenzen, zum Beispiel ``smb://server/share/``.
+
+Duplikate
+=========
+
+Dokumente mit gleichem oder nahezu gleichem Inhalt werden gruppiert, die größte Gruppe zuerst. Die
+Gruppen beruhen auf der beim Indexieren berechneten Inhaltssignatur (``content_minhash_bits``,
+dieselbe, die doppelte Suchergebnisse zusammenfasst); eine Neuindexierung ist daher nicht nötig.
+Dokumente, deren Inhalt keine Wörter enthält (etwa leere Dateien), werden ausgelassen.
+
+Die Seite zeigt bis zu ``docreport.duplicate.group.size`` (Standard: 100) Gruppen und je Gruppe bis zu
+``docreport.duplicate.docs.size`` (Standard: 10) Dokumente. Mit [CSV herunterladen] erhalten Sie alle
+Gruppen. Die CSV-Datei liest auch bei einem großen Index alle Gruppen, mit den Spalten
+``group, groupSize, url, title, filename, contentLength, lastModified, owner, lastModifier, clickCount, docId``.
+
+.. note::
+
+   Bei einem Index, der die Inhaltssignatur nicht speichert (die Mappings ``cloud`` und ``aws``), ist
+   der Duplikatbericht nicht verfügbar.
+
+Inaktive Dokumente
+==================
+
+Dokumente, deren letzte Änderung älter als die angegebene Anzahl von Tagen ist („Nicht geändert seit
+(Tagen)“, Standard 365 aus ``docreport.dormant.days``), werden aufgelistet, die ältesten zuerst.
+Dokumente ohne Änderungsdatum werden nicht aufgeführt. Mit „Nie aus den Suchergebnissen geöffnet“
+werden Dokumente ausgelassen, die aus Suchergebnissen angeklickt wurden.
+
+Die Seite zeigt die Anzahl der passenden Dokumente, ihre Gesamtgröße und eine seitenweise Liste. Das
+Blättern endet bei ``indexer.max.result.window.size``; Dokumente darüber hinaus erhalten Sie mit
+[CSV herunterladen].
+
+Einstellungen
+=============
+
+Die folgenden Einstellungen in ``fess_config.properties`` steuern den Bericht.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 40 45 15
+
+   * - Eigenschaft
+     - Beschreibung
+     - Standard
+   * - ``docreport.duplicate.group.size``
+     - Höchstzahl der Duplikatgruppen, die die Seite anzeigt
+     - ``100``
+   * - ``docreport.duplicate.docs.size``
+     - Höchstzahl der Dokumente, die die Seite je Gruppe auflistet
+     - ``10``
+   * - ``docreport.duplicate.export.page.size``
+     - Anzahl der Inhaltssignaturen, die beim CSV-Download je Anfrage gelesen werden
+     - ``10000``
+   * - ``docreport.dormant.days``
+     - Standardanzahl der Tage seit der letzten Änderung, ab der ein Dokument als inaktiv gilt
+     - ``365``

de/15.9/admin/general-guide.rst

@@ -111,6 +111,13 @@ Letzte Änderung prüfen
 
 Aktivieren Sie dies für differenzielles Crawling.
 
+Bei HTTP/HTTPS-URLs wird, wenn der ``Last-Modified``-Wert der HEAD-Antwort keine Entscheidung
+erlaubt (kein Änderungsdatum im Index, kein ``Last-Modified`` in der HEAD-Antwort oder ein anderer
+Status als 200/404), der GET als bedingter GET mit ``If-None-Match`` (dem indexierten ``ETag``)
+und/oder ``If-Modified-Since`` gesendet. Eine mit ``304 Not Modified`` beantwortete Seite wird wie
+eine unveränderte Seite behandelt und nicht erneut abgerufen. Um alles erneut abzurufen, etwa nach
+einer Änderung der Crawl-Einstellungen, deaktivieren Sie diese Einstellung für einen Crawl.
+
 Gleichzeitige Crawler-Konfiguration
 :::::::::::::::::::::::::::::::::::::
 

de/15.9/admin/index.rst

@@ -50,6 +50,7 @@ Rollen bis zu Protokollen und Sicherungen.
    log-guide
    failureurl-guide
    searchlist-guide
+   docreport-guide
    backup-guide
    maintenance-guide
    esreq-guide

de/15.9/admin/labeltype-guide.rst

@@ -85,11 +85,46 @@ Anzeigereihenfolge
 
 Geben Sie die Anzeigereihenfolge der Labels an.
 
+Art
+:::
+
+Geben Sie „Label“ oder „Tag“ an. Ein gewöhnliches Label ist „Label“. „Tag“ ist ein Tag, den Benutzer
+auf der Suchseite hinzufügen (siehe „Tags“ unten). Ein bestehendes Label ohne Art wird als „Label“
+behandelt.
+
+
 Konfiguration löschen
 ---------------------
 
 Klicken Sie auf den Konfigurationsnamen auf der Übersichtsseite und dann auf die Schaltfläche „Löschen". Es wird ein Bestätigungsbildschirm angezeigt.
 Klicken Sie auf die Schaltfläche „Löschen", um die Konfiguration zu löschen.
 
+Tags
+----
+
+Mit ``user.tag.enabled=true`` (Standard: ``false``) in ``fess_config.properties`` können
+angemeldete Benutzer Suchergebnisse taggen. Im mitgelieferten Theme ``bootstrap`` werden Tags an den
+Ergebnissen angezeigt, Benutzer können Tags hinzufügen und eigene entfernen, und eine Facette „Tags“
+grenzt die Ergebnisse ein. Zur API siehe :doc:`../api/api-tag`.
+
+Ein Tag wird als Label der Art „Tag“ gespeichert: Der Name ist der Tag-Name, der Wert der SHA-256
+des Namens, die eingeschlossenen Pfade sind die getaggten URLs (eine je Zeile, exakte
+Übereinstimmung), und die Berechtigungen bestimmen, wer das Tag sehen kann. Ein Benutzer, der ein Tag
+hinzufügt, wird zu dessen Berechtigungen hinzugefügt.
+
+- Ein Tag ist nur sichtbar, wenn die Berechtigungen seines Labels auf den Aufrufer zutreffen.
+  Administratoren können ein Tag auf dieser Seite bearbeiten, um es mit einer Rolle oder Gruppe zu
+  teilen, oder es löschen.
+- Tags mit gleichem Namen werden zu einem Label zusammengeführt; Benutzer, die ein Tag gleichen
+  Namens hinzugefügt haben, sehen daher gegenseitig, wo ihre Tags gesetzt sind.
+- Tags erscheinen weder in der Label-Listen-API (``/api/v2/labels``) noch in der Label-Auswahl der
+  Suchseite.
+- Tags zählen zum Label-Limit (``page.labeltype.max.fetch.size``, Standard: 1000). Ist das Limit
+  erreicht, kann kein neues Tag erstellt werden.
+- Ändert oder löscht ein Administrator ein Tag auf dieser Seite, behalten die indexierten Dokumente die
+  alten Werte, bis sie erneut gecrawlt werden oder der Job „Label Updater“ läuft.
+- Ein Dokument kann bis zu ``user.tag.max.document.tags`` (Standard: 100) Tags haben, ein Tag-Name bis
+  zu ``user.tag.name.max.length`` (Standard: 50) Zeichen.
+
 .. |image0| image:: ../../../resources/images/en/15.9/admin/labeltype-1.png
 .. |image1| image:: ../../../resources/images/en/15.9/admin/labeltype-2.png

de/15.9/admin/mapping-guide.rst

@@ -49,6 +49,33 @@ Upload
 
 Sie können im Mapping-Wörterbuchformat hochladen.
 
+Mitgelieferte Mapping-Wörterbücher
+==================================
+
+Das Standard-``mapping.txt`` wird bei der Analyse von Suchfeldern wie ``title`` und ``content``
+verwendet. Es vereinheitlicht Hiragana, kleine Kana und Halbbreiten-Katakana zu Vollbreiten-Katakana,
+sodass りんご, リンゴ und ﾘﾝｺﾞ einander finden. In |Fess| 15.9 werden zusätzlich folgende
+Schreibweisen vereinheitlicht:
+
+- ゐ und ゑ (zu イ und エ), kleine Kana wie ゎ, ゕ, ゖ, ヮ, ヵ, ヶ und ㇰ-ㇿ sowie ゝ und ゞ (zu ヽ und ヾ)
+- ヴ, ヴャ, ヴュ und ヴョ, Hiragana ゔ, Halbbreiten-ｳﾞ sowie ウ oder う mit einem kombinierenden
+  Stimmhaftigkeitszeichen (U+3099); zum Beispiel wird ラヴ zu ラブ und レヴュー zu レビユー
+
+Außerdem werden ‐ ‑ ‒ – — ― ⁻ ₋ − und －, die direkt nach Kana stehen, als Längungszeichen ー
+behandelt (``prolonged_sound_mark_filter``), sodass サ―バ－ und サ−バ‐ サーバー finden. Ein
+ASCII-Bindestrich (``-``) und ein Strich nach Kanji, Buchstaben oder Ziffern (東京－大阪,
+2026−10−02) werden nicht verändert.
+
+``ja/mapping.txt`` für Japanisch (die ``*_ja``-Felder) lässt Hiragana und kleine Kana unverändert,
+weil die morphologische Analyse sie benötigt, und vereinheitlicht nur Schreibweisen wie ヴ.
+
+.. note::
+
+   Diese Einstellungen gelten für einen neu erstellten Dokumentindex. Ein bestehender Index behält
+   seine Analyse-Einstellungen und Wörterbücher, bis er neu indexiert wird. Um sie auf einen
+   bestehenden Index anzuwenden, indexieren Sie auf der Seite :doc:`maintenance-guide` mit
+   aktiviertem „Wörterbücher zurücksetzen“ neu. Das Zurücksetzen überschreibt Änderungen an
+   ``mapping.txt`` / ``ja/mapping.txt``, die in der Administrationsoberfläche vorgenommen wurden.
 
 .. |image0| image:: ../../../resources/images/en/15.9/admin/mapping-1.png
 .. |image1| image:: ../../../resources/images/en/15.9/admin/mapping-2.png

de/15.9/admin/relatedquery-guide.rst

@@ -54,6 +54,76 @@ Konfiguration löschen
 Klicken Sie auf den Konfigurationsnamen auf der Übersichtsseite und dann auf die Schaltfläche „Löschen". Es wird ein Bestätigungsbildschirm angezeigt.
 Klicken Sie auf die Schaltfläche „Löschen", um die Konfiguration zu löschen.
 
+Aus Suchprotokollen generieren
+------------------------------
+
+Klicken Sie auf der Listenseite auf [Aus Suchprotokollen generieren], um verwandte Abfragen aus den
+letzten Suchprotokollen zu erstellen. Eine Suche, die dieselbe Benutzersitzung kurz nach einer
+anderen Suche ausführt (ein Tippfehler gefolgt von seiner Korrektur oder ein allgemeiner Begriff
+gefolgt von einem genaueren), gilt als Verfeinerung. Für häufig gesuchte Begriffe werden die
+häufigsten Verfeinerungen zu den verwandten Abfragen des Begriffs.
+
+Verwandte Abfragen gelten für alle Benutzer und erweitern jede Suche nach ihrem Begriff; die
+Generierung ist daher zurückhaltend:
+
+- Es werden nur Suchen verwendet, die ein Gast sehen kann. Ein Suchprotokoll wird nur gelesen, wenn
+  alle seine Rollen ``suggest.search.log.permissions`` erfüllen (dieselbe Einstellung wie bei Suggest).
+- Suchbegriffe mit einem Feldfilter wie ``label:"x"``, Operatoren, Platzhaltern, ``sort:`` oder
+  einem führenden ``+`` / ``-`` werden nicht verwendet.
+- Wörter, die unter [Vorschlagen > Schlechtes Wort] registriert sind, werden weder als Begriff noch als
+  verwandte Abfrage verwendet.
+- Ein Begriff und jede seiner verwandten Abfragen müssen aus mindestens
+  ``related_query.generate.min.sessions`` Sitzungen stammen, und die Verfeinerungen müssen Treffer
+  haben.
+- Einträge werden für jeden virtuellen Host getrennt erzeugt. Suchprotokolle ohne virtuellen Host
+  gelten als Standardhost.
+- Begriffe, die bereits verwandte Abfragen haben, werden nicht verändert (das Ergebnis nennt die
+  Anzahl der übersprungenen), und es werden nicht mehr Einträge erzeugt, als der Cache der
+  verwandten Abfragen laden kann (``page.relatedquery.max.fetch.size``).
+
+Erzeugte verwandte Abfragen lassen sich wie manuell registrierte bearbeiten oder löschen. Sie
+können nicht erzeugt werden, solange „Suchprotokoll“ oder „Benutzerprotokoll“ unter
+[System > Allgemein] deaktiviert ist, und ein zweiter Lauf kann nicht starten, während einer läuft.
+
+Die folgenden Einstellungen in ``fess_config.properties`` steuern die Generierung.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 45 40 15
+
+   * - Eigenschaft
+     - Beschreibung
+     - Standard
+   * - ``related_query.generate.days``
+     - Anzahl der Tage an Suchprotokollen, die gelesen werden
+     - ``30``
+   * - ``related_query.generate.term.size``
+     - Höchstzahl an Begriffen je virtuellem Host
+     - ``100``
+   * - ``related_query.generate.query.size``
+     - Höchstzahl an verwandten Abfragen je Begriff
+     - ``5``
+   * - ``related_query.generate.min.sessions``
+     - Mindestzahl an Sitzungen, in denen ein Begriff und seine verwandte Abfrage vorkommen müssen
+     - ``3``
+   * - ``related_query.generate.session.interval``
+     - Zeitraum, in dem eine Suche als Verfeinerung gilt (Minuten)
+     - ``10``
+   * - ``related_query.generate.seed.log.size``
+     - Höchstzahl der je Begriff gelesenen Suchprotokolle
+     - ``1000``
+   * - ``related_query.generate.seed.session.size``
+     - Höchstzahl der je Begriff gelesenen Sitzungen
+     - ``200``
+   * - ``related_query.generate.log.fetch.size``
+     - Höchstzahl der je Begriff gelesenen Folgesuchen
+     - ``2000``
+   * - ``related_query.generate.query.min.length``
+     - Mindestlänge eines Begriffs und einer verwandten Abfrage (Zeichen)
+     - ``2``
+   * - ``related_query.generate.query.max.length``
+     - Höchstlänge eines Begriffs und einer verwandten Abfrage (Zeichen)
+     - ``50``
 
 .. |image0| image:: ../../../resources/images/en/15.9/admin/relatedquery-1.png
 .. |image1| image:: ../../../resources/images/en/15.9/admin/relatedquery-2.png

de/15.9/admin/searchlog-guide.rst

@@ -1,27 +1,105 @@
-===========
+=============
 Suchprotokoll
-===========
+=============
 
 Übersicht
 =========
 
-Such-, Klick- und Favoriten-Ausführungsergebnisse werden aufgezeichnet, und Suchprotokolle können auf diesem Verwaltungsbildschirm überprüft werden.
+Suchen, Klicks und Favoriten werden aufgezeichnet. Die Seite Suchprotokoll zeigt Analyseberichte, die
+sie zusammenfassen, sowie eine Liste der einzelnen Protokolle.
 
-Verwaltung
-==========
+Um die Seite zu öffnen, wählen Sie im linken Menü [Systeminformationen > Suchprotokoll]. Zuerst wird
+die Registerkarte „Übersicht“ angezeigt. Zum Anzeigen ist die Rolle ``admin-searchlog`` oder
+``admin-searchlog-view`` erforderlich; mit ``admin-searchlog-view`` lassen sich keine Protokolle
+löschen.
 
-Übersicht
-=========
+Analyseberichte
+===============
+
+Zeitraum und Filter
+-------------------
+
+Wählen Sie oben auf jeder Registerkarte den Zeitraum aus „Heute“, „Gestern“, „Letzte 7 Tage“,
+„Letzte 28 Tage“ und „Letzte 90 Tage“, oder geben Sie mit „Benutzerdefiniert“ ein Start- und
+Enddatum an (höchstens 366 Tage). Mit „Mit vorherigem Zeitraum vergleichen“ werden die Werte mit dem
+gleich langen Zeitraum davor verglichen. Außerdem lassen sich die Zugriffsart und die Zeilenzahl der
+Tabellen wählen. Zeiträume und Diagrammintervalle folgen den Kalendertagen der Zeitzone des Servers.
+
+Registerkarten
+--------------
+
+- **Übersicht**: Suchanfragen, Benutzer, Quote ohne Treffer, Klickrate und durchschnittliche
+  Antwortzeit, jeweils mit einem kleinen Verlaufsdiagramm und der Veränderung gegenüber dem
+  vorherigen Zeitraum; ein Verlaufsdiagramm mit umschaltbarer Kennzahl (beim Vergleich wird der
+  vorherige Zeitraum gestrichelt dargestellt); sowie die häufigsten Suchbegriffe und die Suchbegriffe
+  ohne Treffer.
+- **Suchbegriffe**: je Suchbegriff die Suchanfragen, Benutzer, durchschnittlichen Treffer, Klicks,
+  Klickrate und durchschnittliche Klickposition. Außerdem die Suchbegriffe ohne Treffer (mit dem
+  Zeitpunkt der letzten Suche) und die Suchbegriffe ohne Klicks, die Treffer hatten, deren Ergebnisse
+  aber nie angeklickt wurden.
+- **Klicks**: die am häufigsten angeklickten URLs, die am häufigsten favorisierten URLs, die
+  Verteilung der Klickpositionen und der Anteil der Aufrufe ab Seite 2.
+- **Leistung**: durchschnittliche Antwortzeit, Median (p50), p95 und p99, die Verteilung der
+  Antwortzeiten, die langsamsten Suchbegriffe und die Abfragezeit.
+- **Zielgruppe**: neue und wiederkehrende Benutzer, Zugriffsarten, Suchanfragen nach Wochentag und
+  Stunde sowie die häufigsten User-Agents, Referrer, Sprachen und virtuellen Hosts. „Suchanfragen
+  nach Rolle und Gruppe“ zeigt für jede Rolle und Gruppe die Suchanfragen, Benutzer und die Quote ohne
+  Treffer. Eine Suche zählt für jede Rolle und Gruppe des ausführenden Benutzers, daher kann die Summe
+  der Zeilen über der Gesamtzahl liegen. Einzelne Benutzer werden nicht aufgeführt.
+- **KI-Chat**: Anfragen, Benutzer, Tokens insgesamt, durchschnittliche Antwortzeit und Fehlerquote des
+  KI-Suchmodus (RAG-Chat) sowie die häufigsten Benutzer und die Anfragen nach Absicht und nach
+  Modell. Die Chat-Nutzung wird aufgezeichnet, solange ``rag.chat.log.enabled`` (Standard: ``true``)
+  aktiviert ist. Fragen und Antworten werden nicht aufgezeichnet. Token-Zahlen werden nur
+  aufgezeichnet, wenn das LLM-Plugin sie meldet.
+- **Protokolle**: die Liste der einzelnen Protokolle; siehe „Protokollliste“ unten.
+
+.. note::
+
+   Klick-Kennzahlen je Suchbegriff und die Suchbegriffe ohne Klicks zählen nur Klicks, die
+   aufgezeichnet wurden, seit Suchbegriffe mit den Klicks gespeichert werden (ab |Fess| 15.9). Die
+   gesamten Klicks und die Klickrate enthalten auch ältere Klicks. Einige Werte, etwa die Zahl der
+   Benutzer, sind Näherungswerte.
 
-In der Übersicht können Sie Such-, Klick- und Favoriten-Suchprotokolle überprüfen.
-Um Details des Suchprotokolls anzuzeigen, klicken Sie auf das entsprechende Suchprotokoll.
+Suchbegriffe ohne Treffer untersuchen
+-------------------------------------
+
+Klicken Sie auf den Registerkarten „Übersicht“ und „Suchbegriffe“ auf einen Suchbegriff ohne Treffer,
+um die Registerkarte „Protokolle“ mit den Suchprotokollen dieses Begriffs zu öffnen, gefiltert auf
+„Nur ohne Treffer“. So sehen Sie, welche Suchen nichts gefunden haben, und können Dokumente,
+Synonyme oder verwandte Abfragen ergänzen.
+
+CSV herunterladen
+-----------------
+
+Jede Tabelle und jedes Diagramm der Analyseberichte hat einen CSV-Link, der die Werte für den
+aktuellen Zeitraum, Vergleich, die Zugriffsart und die Größe herunterlädt. Die Filterleiste hat
+außerdem einen Link auf eine CSV-Datei der Kennzahlen. Zahlen werden unverändert ausgegeben
+(Anteile als 0 bis 1, Zeiten in Millisekunden). Ein verglichenes Diagramm erhält eine zusätzliche
+Spalte ``<series>_previous``.
+
+Protokollliste
+==============
+
+Die Registerkarte „Protokolle“ listet Suchprotokolle, Klickprotokolle, Favoritenprotokolle und
+Benutzerprotokolle auf. Sie lassen sich nach Protokollart, Abfrage-ID, Benutzer-ID, Zeitraum,
+Zugriffsart und Suchbegriff filtern, Suchprotokolle zusätzlich nach Trefferzahl („Alle“, „Nur ohne
+Treffer“, „Mindestens ein Treffer“). Um die Details eines Protokolls anzuzeigen, klicken Sie darauf.
 
 |image0|
 
+Klicken Sie auf [CSV herunterladen], um die Protokolle, die dem aktuellen Filter entsprechen, ohne
+Zeilenbegrenzung und neueste zuerst als CSV herunterzuladen. Die Kopfzeile enthält die Feldnamen und
+hängt daher nicht von der Sprache der Oberfläche ab.
+
+CSV-Dateien, auch die der Analyseberichte, werden in der Kodierung von ``csv.file.encoding``
+geschrieben; eine UTF-8-Datei beginnt mit einer Byte-Order-Mark. Ein Wert, der mit ``=``, ``+``,
+``-``, ``@``, einem Tabulator oder einem Wagenrücklauf beginnt, erhält ein vorangestelltes ``'``,
+damit eine Tabellenkalkulation ihn nicht als Formel ausführt.
+
 Details
-=======
+-------
 
-Durch Klicken auf ein Suchprotokoll in der Übersicht werden die Details des entsprechenden Suchprotokolls angezeigt.
+Klicken Sie in der Liste auf ein Protokoll, um seine Details anzuzeigen.
 
 |image1|