Christoph Kroczek
6e6cb0dc8d
- doc/architecture.md: arc42-Detaildokument mit Mermaid-Diagrammen (Bausteinsicht, Klassendiagramm, Statusmodell, 5 Sequenzdiagramme), Speicherkonzept, DEC-01..19-Entscheidungen mit Trade-offs - doc/requirements/: 7 Features als Gherkin-Szenarien (TDD-Grundlage) mit Traceability-Tabellen Szenario <-> Stdlib-Testname - doc/openapi.yaml: API-Vertrag fuer alle 9 Endpunkte (Quelle der Wahrheit) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# Feature: Volltextsuche und Index-Rebuild
|
|
|
|
Als API-Client möchte ich Dokumente über ihren Inhalt und ihre Metadaten finden
|
|
und den Suchindex jederzeit neu aufbauen können.
|
|
|
|
```gherkin
|
|
Funktionalität: Volltextsuche
|
|
|
|
Szenario: Dokument ist über seinen Inhalt findbar
|
|
Angenommen ein verarbeitetes Dokument, dessen Text "Stromabrechnung Stadtwerke" enthält
|
|
Wenn GET /v1/search?q=stadtwerke aufgerufen wird
|
|
Dann enthält das Ergebnis das Dokument mit id, title, original_name, archive_path und snippet
|
|
|
|
Szenario: Suche berücksichtigt Metadaten
|
|
Angenommen ein angereichertes Dokument mit dem Tag "versicherung"
|
|
Wenn GET /v1/search?q=versicherung aufgerufen wird
|
|
Dann wird das Dokument gefunden, auch wenn der Begriff nicht im Text vorkommt
|
|
|
|
Szenario: Umlaute und Diakritika werden tolerant behandelt
|
|
Angenommen ein Dokument, dessen Text "Gebührenbescheid" enthält
|
|
Wenn nach "gebuhrenbescheid" gesucht wird
|
|
Dann wird das Dokument gefunden
|
|
|
|
Szenario: Treffer sind nach Relevanz sortiert
|
|
Angenommen mehrere Dokumente enthalten den Suchbegriff unterschiedlich häufig
|
|
Wenn gesucht wird
|
|
Dann sind die Treffer nach BM25-Relevanz absteigend sortiert
|
|
|
|
Szenario: OCR-Inhalte sind durchsuchbar
|
|
Angenommen ein gescanntes Dokument, dessen Text nur per OCR gewonnen wurde
|
|
Wenn nach einem Begriff aus dem OCR-Text gesucht wird
|
|
Dann wird das Dokument gefunden
|
|
|
|
Funktionalität: Index-Rebuild über die API
|
|
|
|
Szenario: Rebuild stellt einen konsistenten Index wieder her
|
|
Angenommen ein inkonsistenter oder leerer FTS-Index bei gefüllter documents-Projektion
|
|
Wenn POST /v1/admin/search/rebuild aufgerufen wird
|
|
Dann wird der Index vollständig aus der Projektion neu aufgebaut
|
|
Und alle zuvor findbaren Dokumente sind wieder findbar
|
|
|
|
Szenario: Rebuild erfordert Authentifizierung
|
|
Angenommen kein oder ein falscher API-Token
|
|
Wenn POST /v1/admin/search/rebuild aufgerufen wird
|
|
Dann antwortet das System mit 401
|
|
```
|
|
|
|
## Traceability
|
|
|
|
| Szenario | Go-Test (Pakete `internal/search`, `internal/api`) |
|
|
|---|---|
|
|
| Dokument ist über seinen Inhalt findbar | `TestSearch_FindsDocumentByContent` |
|
|
| Suche berücksichtigt Metadaten | `TestSearch_FindsDocumentByTag` |
|
|
| Umlaute und Diakritika werden tolerant behandelt | `TestSearch_DiacriticsInsensitive` |
|
|
| Treffer sind nach Relevanz sortiert | `TestSearch_ResultsOrderedByBM25` |
|
|
| OCR-Inhalte sind durchsuchbar | `TestSearch_FindsOCRContent` |
|
|
| Rebuild stellt einen konsistenten Index wieder her | `TestSearchRebuild_RestoresConsistentIndex` |
|
|
| Rebuild erfordert Authentifizierung | `TestSearchRebuild_RequiresAuth` |
|