Files
AfiS-Aktensystem/web/lib/search/query.ts
T
Harlekin cb0eabb266 Phase 7 abgeschlossen: Suche mit gestuftem Index, Facetten, Palette
Der bisherige Suchvektor enthielt nur, was jeder sehen darf. Das war
leck-sicher und unbrauchbar zugleich: ab Stufe 1 fand die Suche nichts von
dem, was einen Fall ausmacht.

SearchIndex hält jetzt sechs Zeilen je Ziel, eine pro Freigabestufe. Die Zeile
zur Stufe N enthält alles, was ein Leser dieser Stufe sehen darf. Eine Suche
nimmt genau diese eine Zeile und kann deshalb nichts finden, was sie nicht
lesen darf - auch keinen höher eingestuften Eintrag in einer sichtbaren Akte.

Schwärzungen werden dabei stufenweise aufgelöst: strip_redactions_above
entfernt nur, was über der Stufe liegt. Sonst fände ein Leser der Stufe 4
einen Namen nicht, den er auf der Seite im Klartext sieht, und ein Leser der
Stufe 1 einen, den er dort nur als Balken sieht.

Die Suchbedingung ist nicht die Zugriffsprüfung: der Volltext liefert
Kandidaten, die Sichtbarkeit kommt aus visibleCaseWhere - derselben Funktion
wie in der Fallliste, und Treffer, Trefferzahl und Facettenzähler entstehen
gemeinsam in einer Abfrage. Eine in SQL nachgebaute Sichtbarkeitsregel wäre
die Sorte Duplikat, die auseinanderläuft.

Filter stehen in der Adresse. Damit ist jeder Zustand teilbar, der
Zurück-Knopf tut das Richtige, und eine gespeicherte Ansicht ist ein
Lesezeichen. Die mitgelieferten Ansichten stehen im Programm, weil sie von der
Gegenwart abhängen.

Strg+K öffnet die Kommandopalette. Im Grundgerüst steckt nur das
Tastaturereignis, die Palette selbst wird beim Öffnen geholt - das kostet die
anderen Seiten rund hundert Byte.

Offen geblieben: "Zuletzt geöffnet" als Ansicht. Dafür müsste jeder Aufruf
jeder Akte mitgeschrieben werden; das wäre eine Überwachungsfunktion, die
niemand bestellt hat. In TASKS vermerkt.

165 Tests im Web-Paket, 17 in der Datenbank, 7 im Worker, 34 e2e.
Grösste Route bei 119,7 kB gegen 120 erlaubte.
2026-09-02 21:23:01 +02:00

63 lines
2.1 KiB
TypeScript

/**
* Die Filter einer Suche, als Adressparameter und als Objekt.
*
* Ohne Abhängigkeiten: die Suchseite baut damit ihre Adresse, und gespeicherte
* Ansichten sind nichts anderes als eine solche Adresse. Dass beides dieselbe
* Darstellung benutzt, ist der Punkt — eine Ansicht ist ein Lesezeichen.
*/
export const SEARCH_KINDS = ['case', 'document', 'personnel'] as const
export type SearchKind = (typeof SEARCH_KINDS)[number]
export type SearchFilters = {
q: string
kind: SearchKind
status?: string
templateKey?: string
classification?: number
/** Nur Akten, an denen der Suchende beteiligt ist. */
mine?: boolean
/** Wiedervorlage bis einschliesslich diesem Tag. */
dueBefore?: string
/** Seit diesem Zeitpunkt geändert, ISO. */
changedSince?: string
/** Seit diesem Zeitpunkt **nicht** geändert, ISO. */
idleSince?: string
cursor?: string
}
export function parseFilters(params: URLSearchParams | Record<string, string | undefined>): SearchFilters {
const get = (name: string): string | undefined => {
const wert = params instanceof URLSearchParams ? params.get(name) : params[name]
return wert && wert.length > 0 ? wert : undefined
}
const kind = get('kind')
const stufe = get('classification')
return {
q: (get('q') ?? '').slice(0, 200),
kind: (SEARCH_KINDS as readonly string[]).includes(kind ?? '')
? (kind as SearchKind)
: 'case',
status: get('status'),
templateKey: get('templateKey'),
classification: stufe !== undefined && /^[0-5]$/.test(stufe) ? Number(stufe) : undefined,
mine: get('mine') === '1',
dueBefore: get('dueBefore'),
changedSince: get('changedSince'),
idleSince: get('idleSince'),
cursor: get('cursor'),
}
}
/** Zurück in eine Adresse. Leere Filter fallen weg, damit sie kurz bleibt. */
export function toSearchParams(filters: Partial<SearchFilters>): string {
const params = new URLSearchParams()
for (const [name, wert] of Object.entries(filters)) {
if (wert === undefined || wert === '' || wert === false) continue
params.set(name, wert === true ? '1' : String(wert))
}
return params.toString()
}