homelab-codex-ws/services/kb-query/tests/test_frontend.py
oskar a73a986bbe feat(kb-query): add search frontend (module 5 phase 4, plan §7, Krok 4)
Krok 4 of the phase-4 plan done ahead of the local-embed-fallback step
(Krok 2, deliberately deferred -- embed stays a plain SOLARIA call, per
task instruction): one FastAPI process now serves both the /search API
and the UI, no separate frontend build (plan §2 decision 4).

- GET / renders a Jinja2 shell; app/static/app.js (vanilla, no build) and
  style.css are the whole client. Query -> /search, results grouped by
  envelope_id client-side (chunks sorted by dist, <details> fragments).
- Colour thresholds per plan §7: dist<0.45 green, 0.45-0.55 yellow (still
  shown with a warning), >0.55 never rendered as an individual result; if
  a query ends up with nothing renderable, one "Brak odpowiedzi w KB"
  message replaces the list, carrying the best observed dist.
- Paperless hits link out; gmail hits get a "kopiuj Message-ID" button
  (there's nothing to link to yet, plan §2 decision 3) plus header
  metadata. Cascade/flat toggle defaults to cascade. Footer shows
  sol_status, refreshed from /healthz on load and after each search.
- /search gained additive summary/summary_tags fields (document_summary,
  haiku track) so the UI can show a document summary as each result
  group's header -- non-breaking, existing response shape untouched.
- Tests: app/db.py + app/search.py unit tests (mocked DB/HTTP, no live
  deps) cover the new summary join; tests/test_frontend.py drives GET /
  and /static/* via TestClient without running the DB-requiring lifespan;
  tests/frontend/app.test.js (Node's built-in test runner, no framework)
  covers query-URL encoding, threshold colouring, and envelope grouping.
- Verified live: docker build + container against kb-postgres@PIHA over
  LAN and Ollama@SOLARIA over Tailscale -- GET / (HTML), /static/app.js,
  /healthz, and /search (cascade + flat) all round-tripped correctly,
  including real summary/summary_tags data.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-22 16:49:36 +02:00

49 lines
1.7 KiB
Python

"""Unit tests for the frontend endpoints (GET /, static assets) -- module 5 phase 4 §7.
Uses FastAPI's TestClient without entering it as a context manager, so the app's `lifespan`
(which needs a live kb-postgres DSN, app/main.py:34-49) never runs -- `/` and `/static/*` don't
touch `app.state`, so this is safe and keeps these tests DB-free like the rest of the suite.
`/search`/`/healthz` behavior is covered separately (tests/test_search.py) against the
DB-independent `run_search` core, not through this TestClient."""
from __future__ import annotations
import pathlib
import sys
sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[1]))
from fastapi.testclient import TestClient # noqa: E402
from app.main import app # noqa: E402
client = TestClient(app)
class TestIndex:
def test_returns_html(self):
response = client.get("/")
assert response.status_code == 200
assert response.headers["content-type"].startswith("text/html")
def test_contains_search_form_and_polish_copy(self):
response = client.get("/")
assert 'id="search-form"' in response.text
assert 'id="query"' in response.text
assert 'id="mode-flat"' in response.text
assert "Wyszukiwarka KB" in response.text
def test_references_static_assets(self):
response = client.get("/")
assert "/static/app.js" in response.text
assert "/static/style.css" in response.text
class TestStaticAssets:
def test_app_js_served(self):
response = client.get("/static/app.js")
assert response.status_code == 200
assert "buildSearchUrl" in response.text
def test_style_css_served(self):
response = client.get("/static/style.css")
assert response.status_code == 200