Refactor server state and add health checks

2026-05-24 22:24:13 +02:00
parent a78a708757
commit d49fe28f08
12 changed files with 378 additions and 104 deletions
@@ -61,6 +61,18 @@ Or with `uv`:
 uv sync
 ```

+## Smoke Test
+
+A smoke test is a quick "does it start and answer basic requests?" check. It does
+not replace full tests, but it catches broken imports, routes, and JSON responses.
+
+```bash
+python scripts/smoke_test.py
+```
+
+The smoke test starts the web server on `127.0.0.1:18080` and disables automatic
+continuous scraping for that process.
+
 ## Running

 ### Web UI
@@ -90,6 +102,8 @@ The current web panel includes:
 - scrape/export/media actions
 - shared `scrape_media` toggle
 - local message viewer powered by SQLite + media files
+- API docs at `/swagger` and `/openapi.json`
+- health checks at `/health` and `/health/continuous`

 ### CLI