From 5e32ba547d57bd9ff893a11988d32e98615d35cb Mon Sep 17 00:00:00 2001 From: Stommer Date: Sat, 24 Oct 2026 22:10:54 +0200 Subject: [PATCH 1/7] =?UTF-8?q?Verlege=20die=20Paperless-Suchparameter=20u?= =?UTF-8?q?nd=20das=20Vorschaubild=20in=20das=20Modul=20und=20korrigiere?= =?UTF-8?q?=20das=20Handy-Layout=20der=20gro=C3=9Fen=20Auswahl.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die gemeinsame Suchroute kennt keine Filternamen mehr; das Modul deklariert sie und unbekannte Parameter werden abgewiesen. Unvollständige Zusatzfeld-Zeilen werden gemeldet statt weggelassen. Vorschaubilder nur als Rastergrafik. Abschlussmatrix und API-Referenz nachgeführt. Co-Authored-By: Claude Sonnet 5.5 --- backend/app/api/sources.py | 94 +++++-------------- backend/app/sourceport.py | 7 -- backend/app/sourceregistry.py | 7 +- backend/app/sources.py | 26 ++++- backend/tests/test_connector_followup.py | 32 +++++-- docs/architecture/API_REFERENZ.md | 4 +- ...GU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md | 17 ++++ frontend/src/pages/Sources.jsx | 32 +++++-- frontend/src/styles.css | 7 +- 9 files changed, 127 insertions(+), 99 deletions(-) diff --git a/backend/app/api/sources.py b/backend/app/api/sources.py index 1d5ef83..e8c7f37 100644 --- a/backend/app/api/sources.py +++ b/backend/app/api/sources.py @@ -4,7 +4,7 @@ from __future__ import annotations from uuid import UUID -from fastapi import APIRouter, Depends +from fastapi import APIRouter, Depends, Request from fastapi.responses import JSONResponse, Response from psycopg import Connection @@ -28,7 +28,6 @@ from app.sources import ( list_connectors, owned_connector, paperless_content, - paperless_thumbnail, parse_connector, probe, save_connector, @@ -265,55 +264,23 @@ def _mail_bytes(data: bytes, media_type: str, filename: str, inline: bool = Fals ) -class SearchFilters: - """The query parameters every search route shares. A source answers only those it declares.""" +# These belong to the route. Every other query parameter is a filter the registered module must declare. +_ROUTE_PARAMS = frozenset({"q", "connector_id", "mailbox", "before", "uidvalidity"}) - def __init__( - self, - mode: str = "", - title: str = "", - correspondent: str = "", - document_type: str = "", - storage_path: str = "", - tag: str = "", - tag_mode: str = "", - document_from: str = "", - document_to: str = "", - added_from: str = "", - added_to: str = "", - asn: str = "", - custom: str = "", - sort: str = "", - cursor: str = "", - ): - self.values = { - "mode": mode, - "title": title, - "correspondent": correspondent, - "document_type": document_type, - "storage_path": storage_path, - "tag": tag, - "tag_mode": tag_mode, - "document_from": document_from, - "document_to": document_to, - "added_from": added_from, - "added_to": added_to, - "asn": asn, - "custom": custom, - "sort": sort, - "cursor": cursor, - } + +def _filters(request: Request) -> dict: + return {name: value for name, value in request.query_params.items() if name not in _ROUTE_PARAMS} @router.get("/api/v1/sources/paperless/documents") def search_paperless( + request: Request, q: str = "", connector_id: UUID | None = None, - filters: SearchFilters = Depends(), principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn), ): - return _run_search("paperless", conn, principal.account_id, q.strip(), connector_id, "", None, filters.values) + return _run_search("paperless", conn, principal.account_id, q.strip(), connector_id, "", None, _filters(request)) @router.get("/api/v1/sources/{kind}/facets") @@ -344,14 +311,18 @@ def preview_paperless_document( ) -@router.get("/api/v1/sources/paperless/documents/{document_id}/thumb") -def thumbnail_paperless_document( - document_id: str, +@router.get("/api/v1/sources/{kind}/thumbnail") +def thumbnail_source( + kind: str, connector_id: UUID, + item: str, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn), ): - data, media = paperless_thumbnail(conn, principal.account_id, document_id, connector_id) + module = require_source(kind) + if not module.capabilities["search"].get("result_preview") or module.thumbnail is None: + raise unsupported("Diese Quelle hat keine Vorschaubilder.") + data, media = module.thumbnail(conn, principal.account_id, connector_id, item) return Response(content=data, media_type=media, headers=_PRIVATE) @@ -366,19 +337,19 @@ def list_mailboxes( @router.get("/api/v1/sources/imap/messages") def search_mail( + request: Request, connector_id: UUID, q: str = "", mailbox: str = "", before: int | None = None, uidvalidity: int | None = None, - filters: SearchFilters = Depends(), principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn), ): if before is not None and before < 1: raise unprocessable("Die Seitenangabe ist ungültig.") return _run_search( - "imap", conn, principal.account_id, q.strip(), connector_id, mailbox.strip(), before, filters.values, uidvalidity + "imap", conn, principal.account_id, q.strip(), connector_id, mailbox.strip(), before, _filters(request), uidvalidity ) @@ -434,29 +405,14 @@ def _connector_parts(body: ConnectorIn, current: dict | None) -> tuple[str, dict return parse_connector(body.kind, body.name, flat, body.config, current) -_SEARCH_FLAGS = { - "mode": "mode", - "title": "title", - "correspondent": "correspondent", - "document_type": "document_type", - "storage_path": "storage_path", - "tag": "tags", - "tag_mode": "tag_mode", - "document_from": "document_range", - "document_to": "document_range", - "added_from": "added_range", - "added_to": "added_range", - "asn": "asn", - "custom": "custom_fields", - "sort": "sort", - "cursor": "continuation", -} - - def _run_search(kind: str, conn, owner, query: str, connector_id: UUID | None, mailbox: str, before: int | None, filters: dict, uidvalidity: int | None = None) -> dict: module = require_source(kind) search = module.capabilities["search"] - refused = [name for name, value in filters.items() if str(value or "").strip() and not search.get(_SEARCH_FLAGS.get(name, name))] + refused = [ + name + for name, value in filters.items() + if str(value or "").strip() and not search.get(module.search_params.get(name, "")) + ] if before is not None and not search.get("continuation"): refused.append("before") if refused: @@ -479,18 +435,18 @@ def _run_navigate(kind: str, conn, owner, connector_id: UUID) -> dict: @router.get("/api/v1/sources/{kind}/search") def search_source( + request: Request, kind: str, q: str = "", connector_id: UUID | None = None, mailbox: str = "", before: int | None = None, - filters: SearchFilters = Depends(), principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn), ): if before is not None and before < 1: raise unprocessable("Die Seitenangabe ist ungültig.") - return _run_search(kind, conn, principal.account_id, q.strip(), connector_id, mailbox.strip(), before, filters.values) + return _run_search(kind, conn, principal.account_id, q.strip(), connector_id, mailbox.strip(), before, _filters(request)) @router.get("/api/v1/sources/{kind}/navigate") diff --git a/backend/app/sourceport.py b/backend/app/sourceport.py index 35762ff..38eb219 100644 --- a/backend/app/sourceport.py +++ b/backend/app/sourceport.py @@ -71,19 +71,12 @@ EDITORS = { } UNSUPPORTED_SEARCH = ( - "mode", "title", "correspondent", "document_type", - "storage_path", "tag", - "tag_mode", "document_from", "document_to", - "added_from", - "added_to", - "asn", - "custom", "sort", "cursor", ) diff --git a/backend/app/sourceregistry.py b/backend/app/sourceregistry.py index 6c7c386..a44bc25 100644 --- a/backend/app/sourceregistry.py +++ b/backend/app/sourceregistry.py @@ -2,7 +2,7 @@ from __future__ import annotations -from dataclasses import dataclass +from dataclasses import dataclass, field from typing import Callable from app.core.errors import unprocessable @@ -65,6 +65,11 @@ class SourceModule: navigate: Callable | None = None preview: Callable | None = None facets: Callable | None = None + # Query parameter of a search, mapped to the capability flag that must be true for it. + # The module owns its filter names. Anything not declared here is refused. + search_params: dict[str, str] = field(default_factory=dict) + # thumbnail(conn, owner_id, connector_id, item) -> (bytes, media type), when the module declares it. + thumbnail: Callable | None = None _MODULES: dict[str, SourceModule] = {} diff --git a/backend/app/sources.py b/backend/app/sources.py index fc292da..df619aa 100644 --- a/backend/app/sources.py +++ b/backend/app/sources.py @@ -478,6 +478,27 @@ def paperless_facets(conn, owner_id: UUID, connector_id: UUID) -> dict: } +_THUMBNAIL_MEDIA = frozenset({"image/png", "image/jpeg", "image/webp", "image/gif"}) + +PAPERLESS_SEARCH_PARAMS = { + "mode": "mode", + "title": "title", + "correspondent": "correspondent", + "document_type": "document_type", + "storage_path": "storage_path", + "tag": "tags", + "tag_mode": "tag_mode", + "document_from": "document_range", + "document_to": "document_range", + "added_from": "added_range", + "added_to": "added_range", + "asn": "asn", + "custom": "custom_fields", + "sort": "sort", + "cursor": "continuation", +} + + def paperless_thumbnail(conn, owner_id: UUID, document_id: str, connector_id: UUID) -> tuple[bytes, str]: if not document_id.isdigit() or len(document_id) > 12: raise unprocessable("Die Paperless-Nummer ist ungültig.") @@ -489,7 +510,8 @@ def paperless_thumbnail(conn, owner_id: UUID, document_id: str, connector_id: UU if fetched is None: raise not_found() data, media, _name = fetched - if not media.startswith("image/"): + # Raster pictures only. A vector file could carry markup. + if media not in _THUMBNAIL_MEDIA: raise unprocessable("Paperless hat kein Vorschaubild geliefert.") return data, media @@ -2086,6 +2108,8 @@ def _install_sources() -> None: navigate=None, preview=None, facets=paperless.facets, + search_params=PAPERLESS_SEARCH_PARAMS, + thumbnail=lambda conn, owner, connector_id, item: paperless_thumbnail(conn, owner, str(item), connector_id), )) register_source(SourceModule( kind="imap", diff --git a/backend/tests/test_connector_followup.py b/backend/tests/test_connector_followup.py index 82bbcbd..6e4dd73 100644 --- a/backend/tests/test_connector_followup.py +++ b/backend/tests/test_connector_followup.py @@ -520,12 +520,20 @@ def test_paperless_default_search_reads_title_and_content_and_shows_a_preview(cl facets = ada.request("GET", "/api/v1/sources/paperless/facets", params={"connector_id": first["id"]}) assert facets["storage_paths"] == [] assert facets["tag_modes"] == ["all", "any", "none"] + # A filter of another source is refused, not ignored. + ada.request( + "GET", + "/api/v1/sources/imap/messages", + params={"connector_id": first["id"], "mailbox": "INBOX", "mode": "title"}, + status=422, + ) for params in ( {"mode": "regex"}, {"tag_mode": "x"}, {"asn": "x1"}, {"storage_path": "a"}, {"q": "miete", "mode": "title", "title": "vertrag"}, + {"bogus": "1"}, ): ada.request( "GET", @@ -631,6 +639,8 @@ def test_paperless_thumbnail_is_bound_to_the_owners_instance(client, db, monkeyp return b"RIFFxxxxWEBP", "image/webp", "" if path.endswith("/8/thumb/"): return b"

", "text/html", "" + if path.endswith("/7/thumb/"): + return b"", "image/svg+xml", "" return None monkeypatch.setattr(sources, "_paperless_file", fake_file) @@ -643,21 +653,27 @@ def test_paperless_thumbnail_is_bound_to_the_owners_instance(client, db, monkeyp json={"kind": "paperless", "name": "Archiv", "base_url": "https://paper.example.test", "token": "token-alpha"}, status=201, ) - url = "/api/v1/sources/paperless/documents/{}/thumb" - ok = ada.client.get(url.format(9), params={"connector_id": first["id"]}, headers=_headers(ada)) + url = "/api/v1/sources/paperless/thumbnail" + + def get(actor, item, kind_url=url): + return actor.client.get(kind_url, params={"connector_id": first["id"], "item": item}, headers=_headers(actor)) + + ok = get(ada, 9) assert ok.status_code == 200 assert ok.headers["content-type"] == "image/webp" assert ok.headers["cache-control"] == "private, no-store" assert seen[-1] == ("token-alpha", "/api/documents/9/thumb/") - assert ada.client.get(url.format(8), params={"connector_id": first["id"]}, headers=_headers(ada)).status_code == 422 - assert ada.client.get(url.format(5), params={"connector_id": first["id"]}, headers=_headers(ada)).status_code == 404 - assert ada.client.get(url.format("x1"), params={"connector_id": first["id"]}, headers=_headers(ada)).status_code == 422 + assert get(ada, 8).status_code == 422 + assert get(ada, 7).status_code == 422 + assert get(ada, 5).status_code == 404 + assert get(ada, "x1").status_code == 422 + # IMAP declares no thumbnails, and the module must declare the capability. + assert get(ada, 9, "/api/v1/sources/imap/thumbnail").status_code == 422 ben = Actor(client, "ben-thumb@example.test", "Ben Thumb") register(db, ben.email, ben.name) ben.login() - stranger = ben.client.get(url.format(9), params={"connector_id": first["id"]}, headers=_headers(ben)) - assert stranger.status_code == 404 - assert len(seen) == 3 + assert get(ben, 9).status_code == 404 + assert len(seen) == 4 def test_revoked_grant_hides_bytes_fetched_during_the_call(client, db, monkeypatch): diff --git a/docs/architecture/API_REFERENZ.md b/docs/architecture/API_REFERENZ.md index 9ed1d90..ed363d2 100644 --- a/docs/architecture/API_REFERENZ.md +++ b/docs/architecture/API_REFERENZ.md @@ -193,13 +193,13 @@ Legende Spalte „Auth“: **–** öffentlich, **S** gültige Session, **S+R** | DELETE | `/api/v1/connectors/{id}` | Zugang löschen; bestehende Referenzen bleiben und werden nicht umgehängt | | POST | `/api/v1/connectors/{id}/probe` | gespeicherten Zugang prüfen; Ergebnis (auch ein Fehler) wird als Prüfstand festgehalten. Es gibt keine Prüfung mit ungespeicherten Entwürfen | | GET | `/api/v1/sources/capabilities` | erklärte Such-, Lese- und Editorfähigkeiten; nicht Vorhandenes bleibt falsch | -| GET | `/api/v1/sources/{kind}/search` | Suche der registrierten Quelle im erklärten Umfang; unbekannte Art und nicht erklärte Filter antworten `422` | +| GET | `/api/v1/sources/{kind}/search` | Suche der registrierten Quelle im erklärten Umfang. Außer `q`, `connector_id`, `mailbox`, `before` und `uidvalidity` ist jeder Abfrageparameter ein Filter, den das Modul in `search_params` deklariert; unbekannte Art, nicht deklarierte oder nicht erklärte Filter und unbekannte Parameter antworten `422` | | GET | `/api/v1/sources/{kind}/navigate?connector_id=` | Fachnavigation, wenn die Quelle sie erklärt | | GET | `/api/v1/sources/{kind}/preview` | Vorschau vor dem Übernehmen, wenn die Quelle sie erklärt | | GET | `/api/v1/sources/paperless/documents?q=&connector_id=` | Paperless-Suche, 20 Treffer je Seite, `cursor` ist die Seitennummer. `mode`: `title_content` (Standard, Titel und Inhalt ohne Index), `title`, `content`, `index` (Volltextindex von Paperless). Filter: `title`, `correspondent`, `document_type`, `storage_path` (jeweils Nummer oder `none` für „ohne“), `tag` (Nummern, durch Komma) mit `tag_mode` `all` (Standard), `any` oder `none`, `document_from`/`document_to` (Dokumentdatum), `added_from`/`added_to` (Hinzugefügt), `asn`, `custom` (JSON-Liste `[{field, op, value}]`, höchstens 5, alle zugleich; `field` ist die Nummer aus `facets.custom_fields`, `op` je Feldtyp `exact`, `icontains`, `istartswith`, `iendswith`, `gt`, `gte`, `lt`, `lte`, `range` oder `exists`; Dokumentverweis-Felder sind nicht filterbar; wird als `custom_field_query` an Paperless gegeben), `sort` (`created`, `added`, `title`, jeweils mit `-`; `-score` nur bei `mode=index` mit Suchtext). Ein ungültiger Wert antwortet `422`. Je Treffer: `title`, `document_on`, `added_on`, `correspondent`, `document_type`, `storage_path`, `tags` (Namen), `pages`, `asn`, `snippet` (Textauszug, reiner Text) und `open_url`; dazu `total`, `next_page`, `previous_page` | | GET | `/api/v1/sources/{kind}/facets?connector_id=` | Auswahllisten der Instanz (Paperless: Korrespondenten, Dokumenttypen, Speicherpfade, Tags, Zusatzfelder mit Typ und Auswahlwerten). Namen und Listen werden je Instanz und Schlüssel eine Minute lang vorgehalten | | GET | `/api/v1/sources/paperless/documents/{id}/preview?connector_id=` | Datei zum Ansehen vor dem Übernehmen | -| GET | `/api/v1/sources/paperless/documents/{id}/thumb?connector_id=` | Vorschaubild der Trefferliste. Läuft über den Server der eigenen Instanz, `private, no-store`; fremde Instanz `404`, Antwort ohne Bild `422` | +| GET | `/api/v1/sources/{kind}/thumbnail?connector_id=&item=` | Vorschaubild eines Treffers, nur wenn das Modul `search.result_preview` erklärt und ein `thumbnail` bereitstellt, sonst `422`. Läuft über den Server der eigenen Instanz, `private, no-store`, nur Rastergrafiken (PNG, JPEG, WebP, GIF); fremde Instanz `404`, eine Antwort ohne Bild `422` | | GET | `/api/v1/sources/imap/mailboxes?connector_id=` | IMAP-Fächer | | GET | `/api/v1/sources/imap/messages?connector_id=&mailbox=&q=&before=` | Nachrichtenliste, 30 je Seite, Fortsetzung über `before` | | GET | `/api/v1/sources/imap/message?connector_id=&mailbox=&uid=` | Vorschau vor dem Übernehmen | diff --git a/docs/product/TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md b/docs/product/TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md index 0b0c3ba..6ebb10e 100644 --- a/docs/product/TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md +++ b/docs/product/TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md @@ -99,3 +99,20 @@ Die Konfiguration einer Instanz gehört dem Modul. Ein Modul deklariert `config_ Neuer Connector: Modul mit `config_fields` in `register_source` eintragen, UI-Modul mit `registerSourceModule` registrieren. Kein Eingriff in `ConnectorIn`, `Sources.jsx` oder die Fachseiten. Nachweis und Grenzen: `backend/tests/test_connector_config.py` (Manifest, Geheimnis, Instanzerhalt, Fremdzugriff, Prüfstand) und `frontend/src/sources/config-core.test.mjs` (6 Node-Tests bestanden), Frontend-Build erfolgreich. Die Backend-Tests wurden in dieser Umgebung **nicht ausgeführt** (kein Python, keine PostgreSQL-Instanz). Keine Bedienprüfung im Browser. Zugangsdaten bleiben im Klartext (R-05); Archivmodus und DataPolicy sind nicht Teil dieses Schnitts. + +## Paperless-Suche, Erweiterung am 24.10.2026 + +Auf Wunsch des Nutzers erweitert über den Umfang von Abschnitt C des Nacharbeitsauftrags hinaus: Suchart (Titel und Inhalt als Standard ohne Index, nur Titel, nur Inhalt, Volltextindex), Speicherpfad, Tag-Verknüpfung (alle, mindestens eines, keines), „ohne“ bei Korrespondent, Typ und Pfad, Hinzugefügt-Datum, Archivnummer und Zusatzfelder. Dazu eine Trefferkarte mit Vorschaubild, Textauszug, Tags, Typ und Seitenzahl sowie ein großer Dialog mit Filtern links und Treffern rechts. Zusatzfeld-Abfragen waren im Auftrag ausdrücklich kein Pflichtumfang und sind hier auf Nutzerwunsch dazugekommen. + +**Verantwortung im Modul:** Die Filternamen eines Moduls deklariert `SourceModule.search_params` (Parametername auf Fähigkeitsflag). Die gemeinsame Suchroute kennt keinen Filternamen mehr. Sie reicht alle übrigen Abfrageparameter weiter und weist jeden ab, den das Modul nicht deklariert oder dessen Fähigkeit nicht wahr ist. Das gilt auch für unbekannte Parameter. Das Vorschaubild ist eine optionale Modulfähigkeit (`SourceModule.thumbnail`, Route `/api/v1/sources/{kind}/thumbnail`, Flag `search.result_preview`). Ein Modul ohne Deklaration lehnt es mit `422` ab. + +**Verbleibende Quellkenntnis im allgemeinen Code (zulässig oder bekannt):** Die Kompatibilitätsrouten `/api/v1/sources/paperless/documents` und `.../preview` in `backend/app/api/sources.py` delegieren nur. Die Fähigkeitswörterbücher `PAPERLESS_CAPABILITIES` und `IMAP_CAPABILITIES` liegen weiterhin in `backend/app/sourceport.py`, ebenso die unbenutzte Liste `UNSUPPORTED_SEARCH`. Das war schon vor dieser Erweiterung so und ist nicht bereinigt. In der Oberfläche liegt der Paperless-Auswahldialog in `frontend/src/pages/Sources.jsx` und wird über `registerSourceModule` (`large: true`) eingehängt; Fachseiten und Modal kennen nur das allgemeine Flag. + +| Nachweis | Ergebnis | +|---|---| +| Backend-Suite gegen `tsumugu_local_test` (eingebettete PostgreSQL, Wegwerf-Umgebung) | **164 Tests bestanden** | +| `test_connector_followup.py`: Parameterübertragung je Filter, Standardsuche, Textauszug, Namensauflösung, Zusatzfelder samt Ablehnung ungültiger Eingaben, fremder Filter und unbekannter Parameter `422`, Vorschaubild nur für Raster, fremde Instanz `404` | bestanden, gegen Attrappe | +| Bedienung im Browser (Chrome headless, Desktop 1440×900 und 390×844) gegen die echte Oberfläche, die echte API und einen nachgebildeten Paperless-HTTP-Server: Dialoggröße, Suche, Vorschaubilder, Textauszug, Ansicht in der Karte, unvollständige Zusatzfeld-Zeile meldet statt zu senden, Zusatzfelder gehen als `custom_field_query` hinaus, Blättern erhält die Auswahl, Einfügen, keine Konsolenfehler | 38 von 38 Prüfungen bestanden. Dabei ist ein Überlappen von Filtern und Treffern auf 390 px gefunden und behoben worden. | + +**Grenze:** Keine der Prüfungen lief gegen die echte Paperless-Instanz. Die Parameternamen (`title_content`, `tags__id__none`, `storage_path__id`, `added__date__gte`, `archive_serial_number`, `custom_field_query`) stammen aus der Kenntnis der Paperless-ngx-API und stehen am Stellvertreter, nicht an der Nutzerinstanz belegt. Die Flags `custom_fields` und `result_preview` sind damit nur durch Code und Attrappe ausführbar belegt. Offen sind insbesondere der Wert eines Betragsfelds (reine Zahl ohne Währung), der Textauszug im Volltextindex und die Mindestversion für Zusatzfeld-Abfragen. Eine Prüfung an der echten Instanz braucht eine ausdrückliche Freigabe. + diff --git a/frontend/src/pages/Sources.jsx b/frontend/src/pages/Sources.jsx index bc3e9b7..12eb83d 100644 --- a/frontend/src/pages/Sources.jsx +++ b/frontend/src/pages/Sources.jsx @@ -155,7 +155,20 @@ function customKind(field) { return CUSTOM_KINDS[field?.type] || "text"; } -// Only rows that are complete go to the server. An empty row is a row not filled in yet. +// A row that is not complete is reported, not left out of the search. +function customProblem(rows) { + for (const row of rows) { + const name = row.field ? "Eine Zusatzfeld-Bedingung" : "Eine Zusatzfeld-Bedingung ohne Feld"; + if (!row.field) return `${name} ist unvollständig. Wähle ein Feld oder entferne die Zeile.`; + const presence = row.op === "set" || row.op === "unset"; + if (presence || row.kind === "boolean") continue; + if (row.op === "range" ? !(row.value && row.value2) : !String(row.value).trim()) { + return `${name} ist unvollständig. Gib den Wert an oder entferne die Zeile.`; + } + } + return ""; +} + function customPayload(rows) { const payload = []; for (const row of rows) { @@ -259,7 +272,7 @@ function PaperlessThumb({ connectorId, id }) { let made = ""; setUrl(""); setFailed(false); - fetchBlob(`/api/v1/sources/paperless/documents/${id}/thumb?connector_id=${connectorId}`) + fetchBlob(`/api/v1/sources/paperless/thumbnail?connector_id=${connectorId}&item=${id}`) .then((blob) => { if (!alive) return; made = URL.createObjectURL(blob); @@ -294,6 +307,8 @@ export function PaperlessPicker({ context, placement, chapterId = "", chapterTit const [previewUrl, setPreviewUrl] = useState(""); const [pending, setPending] = useState(false); const [error, setError] = useState(""); + // The filters sit beside the hits on a wide screen. On a phone they start folded away. + const [moreOpen, setMoreOpen] = useState(() => typeof window === "undefined" || !window.matchMedia || window.matchMedia("(min-width: 900px)").matches); const searchRef = useRef(0); const previewRef = useRef(0); const facetRef = useRef(0); @@ -338,8 +353,7 @@ export function PaperlessPicker({ context, placement, chapterId = "", chapterTit if (connectorId) params.set("connector_id", connectorId); if (text) params.set("q", text); if (text && filters.mode !== "title_content") params.set("mode", filters.mode); - // The search text already is the title in this mode. - if (filters.title.trim() && !(text && filters.mode === "title")) params.set("title", filters.title.trim()); + if (filters.title.trim()) params.set("title", filters.title.trim()); if (filters.correspondent) params.set("correspondent", filters.correspondent); if (filters.documentType) params.set("document_type", filters.documentType); if (filters.storagePath) params.set("storage_path", filters.storagePath); @@ -383,6 +397,11 @@ export function PaperlessPicker({ context, placement, chapterId = "", chapterTit setError("Wähle zuerst den Paperless-Zugang."); return; } + const problem = customProblem(filters.custom); + if (problem) { + setError(problem); + return; + } const token = searchRef.current + 1; searchRef.current = token; const asked = connectorId; @@ -568,15 +587,12 @@ export function PaperlessPicker({ context, placement, chapterId = "", chapterTit

{PAPERLESS_MODE_HINTS[filters.mode]}

-
+
setMoreOpen(event.currentTarget.open)}> {active ? `Weitere Filter (${active} aktiv)` : "Weitere Filter"}