Claude Opus 4.8
91dfccf226
All checks were successful
CD / Build and push images (push) Successful in 3m5s
CI / Lint, typecheck, test (push) Successful in 2m19s
CI / Auth e2e pack (push) Successful in 2m51s
CI / Build container images (push) Has been skipped
CD / Deploy to Test (push) Successful in 9s
CD / Smoke tests against Test (push) Successful in 1m13s
CD / Promote to Int (push) Successful in 12s
Full-text search behind a swappable interface (ADR 0010).
- prisma: `page_content_cache.search_vector tsvector` (Unsupported column);
migration adds it plus a GIN index (raw SQL — the index is a production
perf optimization; correctness holds without it, so schema-pushed test DBs
work unchanged).
- shared: `normalizeForSearch` (NFKD + strip diacritics + lowercase) folds
both the indexed text and the query, so 'Baume' finds 'Bäume' without the
Postgres `unaccent` extension; search query schema + result view + highlight
sentinels.
- api search module:
- abstract `SearchProvider` (DI token: indexPage / removePage / search /
reindexAll) so an external engine can replace the binding — a fake proves
the seam in a test.
- `PostgresSearchProvider`: weighted vector (title A, labels B, body C),
`websearch_to_tsquery`, `ts_headline` snippets, results filtered to the
ponds the user may read; `GET /search?q=&pondId=&labels=`.
- `search:reindex` CLI (rebuilds from the content cache, idempotent).
- reindex hooks: page create/rename (title) and label assign/unassign/
rename/delete (labels are weight-B).
- collab: the persistence hook maintains `search_vector` in the same
transaction as the content cache (same weighting, normalized).
- tests: shared normalize/schema; api db (title ranks above body, highlight,
diacritic-insensitive match, permission filter, idempotent reindex) and the
fake-provider DI test; collab persistence already covers the write path.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PGdhRiwU1WRL4XxJfZYipY
21 lines
1.0 KiB
TypeScript
21 lines
1.0 KiB
TypeScript
import { SearchQuery, SearchResultView } from '@dorfteich/shared';
|
|
import { User } from '@prisma/client';
|
|
|
|
/**
|
|
* Search behind an interface (ADR 0010, issue #49) so an external engine can
|
|
* replace the PostgreSQL binding without touching call sites. Bound via DI as an
|
|
* abstract-class token — a fake implementation can be provided in tests, which
|
|
* is what proves the seam. `search` receives the requesting user so results are
|
|
* permission-filtered; scope (pond, labels) lives in the query.
|
|
*/
|
|
export abstract class SearchProvider {
|
|
/** (Re)compute the search entry for one page from its current content. */
|
|
abstract indexPage(pageId: string): Promise<void>;
|
|
/** Drop a page from the index (its cache row is also removed on purge). */
|
|
abstract removePage(pageId: string): Promise<void>;
|
|
/** Ranked, permission-filtered results for `user`. */
|
|
abstract search(query: SearchQuery, user: User): Promise<SearchResultView[]>;
|
|
/** Rebuild the whole index from `page_content_cache`; returns rows indexed. */
|
|
abstract reindexAll(): Promise<number>;
|
|
}
|