homelab-codex-ws/services/kb-query/tests/test_frontend.py

49 lines
1.7 KiB
Python
Raw Normal View History

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:39:46 +02:00
"""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