feat(sources): Knopf Jetzt pruefen startet den Health-Check aus dem Portal

- POST /api/sources/health/run (202, bei laufendem Run 409) stoesst den
  Lauf als BackgroundTask an: eigene DB-Connection, run_health_checks +
  generate_suggestions aus den geteilten Diensten, exakt nach dem Vorbild
  des Monitor-Nachtjobs daily_source_health_check. Kein Code-Duplikat.
- GET /api/sources/health/run-status liefert den In-Memory-Status
  (health_run.py, pure Funktionen mit Doppelstart-Sperre, unit-getestet).
  Nach einem Neustart ist der Status idle, ein partieller Stand wird vom
  naechsten Lauf archiviert und ueberschrieben (wie beim Nachtjob).
- Frontend: Knopf Jetzt pruefen + Zuletzt geprueft in der Stats-Leiste
  der Quellenliste, Polling alle 4 s, Abschluss-Toast mit geprueft/
  Probleme/neue Vorschlaege, danach Liste + Aufgaben-Badge neu laden.
  Beim Oeffnen des Reiters wird ein laufender Run aus anderer Session
  erkannt und weiterverfolgt.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Dieser Commit ist enthalten in:
claude-dev
2026-07-25 18:14:14 +00:00
Ursprung bcfdac158e
Commit 14e766173c
8 geänderte Dateien mit 222 neuen und 2 gelöschten Zeilen

47
src/health_run.py Normale Datei
Datei anzeigen

@@ -0,0 +1,47 @@
"""In-Memory-Status für den manuellen Health-Run des Portals.
Pure Funktionen ohne DB und IO, damit die Zustandsübergänge unit-testbar sind.
Der Status lebt nur im Prozess. Nach einem Neustart ist er wieder idle, ein
dabei abgebrochener Lauf hinterlässt höchstens einen partiellen Stand in
source_health_checks, den der nächste Lauf archiviert und überschreibt
(identisch zum Verhalten des Monitor-Nachtjobs um 04:00 Uhr).
"""
from datetime import datetime
def new_state() -> dict:
return {
"running": False,
"started_at": None,
"finished_at": None,
"result": None,
"error": None,
}
def _now_iso(now=None) -> str:
return now if now is not None else datetime.now().isoformat(timespec="seconds")
def try_start(state: dict, now=None) -> bool:
"""Setzt den Lauf auf running. False, wenn schon einer läuft."""
if state.get("running"):
return False
state["running"] = True
state["started_at"] = _now_iso(now)
state["finished_at"] = None
state["result"] = None
state["error"] = None
return True
def mark_finished(state: dict, result: dict, now=None) -> None:
state["running"] = False
state["finished_at"] = _now_iso(now)
state["result"] = result
def mark_failed(state: dict, error: str, now=None) -> None:
state["running"] = False
state["finished_at"] = _now_iso(now)
state["error"] = error

Datei anzeigen

@@ -15,6 +15,7 @@ from auth import get_current_admin
from database import db_dependency, get_db
from audit import log_action, get_client_ip
from source_meta import get_meta
from health_run import new_state, try_start, mark_finished, mark_failed
from config import DB_PATH
from shared.source_rules import (
discover_source,
@@ -847,6 +848,52 @@ async def get_health_history(
return [dict(row) for row in await cursor.fetchall()]
# Status des manuellen Health-Runs. In-Memory: nach einem Neustart wieder idle,
# ein dabei abgebrochener Lauf hinterlässt höchstens einen partiellen
# source_health_checks-Stand, den der nächste Lauf archiviert und heilt.
_HEALTH_RUN_STATE = new_state()
async def _health_run_background():
"""Manueller Health-Run, exakt nach dem Vorbild des Monitor-Nachtjobs
daily_source_health_check (eigene Connection, Checks + Vorschläge)."""
from shared.services.source_health import run_health_checks
from shared.services.source_suggester import generate_suggestions
db = await get_db()
try:
result = await run_health_checks(db)
suggestions = await generate_suggestions(db)
mark_finished(_HEALTH_RUN_STATE, {**result, "suggestions": suggestions})
logger.info(
"Manueller Health-Run: %s geprüft, %s Probleme, %s neue Vorschläge",
result.get("checked"), result.get("issues"), suggestions,
)
except Exception as e:
logger.error("Manueller Health-Run fehlgeschlagen: %s", e, exc_info=True)
mark_failed(_HEALTH_RUN_STATE, str(e))
finally:
await db.close()
@router.post("/health/run", status_code=202)
async def start_health_run(
background_tasks: BackgroundTasks,
admin: dict = Depends(get_current_admin),
):
"""Health-Check + Vorschläge manuell anstoßen (läuft im Hintergrund weiter)."""
if not try_start(_HEALTH_RUN_STATE):
raise HTTPException(status_code=409, detail="Es läuft bereits eine Prüfung")
background_tasks.add_task(_health_run_background)
return {"status": "started", "started_at": _HEALTH_RUN_STATE["started_at"]}
@router.get("/health/run-status")
async def health_run_status(admin: dict = Depends(get_current_admin)):
"""Aktueller Zustand des manuellen Health-Runs (Polling-Ziel des Frontends)."""
return _HEALTH_RUN_STATE
@router.get("/{source_id}/health")
async def get_source_health(
source_id: int,

Datei anzeigen

@@ -924,6 +924,10 @@ input[type="date"].filter-select { padding: 6px 10px; }
.health-badge-btn { cursor: pointer; }
.health-badge-btn:hover { filter: brightness(1.25); text-decoration: underline; }
/* "Jetzt pruefen"-Knopf in der Stats-Leiste */
.health-run-item { display: inline-flex; align-items: center; gap: 8px; }
.health-run-item #healthRunInfo { font-size: 12px; }
/* Checkbox-Spalte: nur sichtbar bei Herkunfts-Filter "Kundenquellen" */
.select-col { display: none; }
table.show-select .select-col { display: table-cell; }

Datei anzeigen

@@ -6,7 +6,7 @@
<title>AegisSight Monitor-Verwaltung</title>
<link rel="icon" type="image/svg+xml" href="/static/favicon.svg">
<link rel="apple-touch-icon" href="/static/favicon.svg">
<link rel="stylesheet" href="/static/css/style.css?v=20260725i">
<link rel="stylesheet" href="/static/css/style.css?v=20260725j">
<script>(function(){var t=localStorage.getItem('portal_theme');if(t==='light')document.documentElement.setAttribute('data-theme','light');try{var a=JSON.parse(localStorage.getItem('osint_a11y')||'{}');Object.keys(a).forEach(function(k){if(a[k])document.documentElement.setAttribute('data-a11y-'+k,'true');});}catch(e){}})()</script>
<style>
@@ -1006,7 +1006,7 @@
<script src="/static/js/a11y.js?v=20260725a"></script>
<script src="/static/js/app.js?v=20260725s"></script>
<script src="/static/js/sources.js?v=20260725c"></script>
<script src="/static/js/sources.js?v=20260725d"></script>
<script src="/static/js/aufgaben.js?v=20260725a"></script>
<script src="/static/js/x-scraper.js?v=20260522a"></script>
<script src="/static/js/audit.js?v=20260509d"></script>

Datei anzeigen

@@ -114,6 +114,7 @@ async function loadUnifiedSources() {
}
renderUnifiedStats(stats);
filterUnifiedSources();
checkHealthRunOnLoad();
} catch (err) {
console.error("Quellenliste laden fehlgeschlagen:", err);
}
@@ -194,7 +195,75 @@ function renderUnifiedStats(stats) {
if (h.warnings) parts.push(`<span class="sources-stat-item health-warning"><span class="sources-stat-value">${h.warnings}</span> Warnungen</span>`);
if (h.ok) parts.push(`<span class="sources-stat-item health-ok"><span class="sources-stat-value">${h.ok}</span> OK</span>`);
const lastCheck = stats.last_check ? formatDateTime(stats.last_check) : "noch nie";
parts.push(`<span class="sources-stat-item health-run-item"><button class="btn btn-secondary btn-small" id="runHealthCheckBtn" onclick="startHealthRun()">Jetzt prüfen</button><span class="text-secondary" id="healthRunInfo">Zuletzt geprüft ${lastCheck}</span></span>`);
bar.innerHTML = parts.join("");
if (healthRunPollTimer) setHealthRunButton(true);
}
// --- Manueller Health-Run (Knopf in der Stats-Leiste) ---
let healthRunPollTimer = null;
async function startHealthRun() {
try {
await API.post("/api/sources/health/run", {});
setHealthRunButton(true);
beginHealthRunPolling();
showToast("Prüfung gestartet. Das kann einige Minuten dauern.", "info");
} catch (err) {
if (String(err.message || "").includes("bereits")) {
showToast("Es läuft bereits eine Prüfung.", "warning");
setHealthRunButton(true);
beginHealthRunPolling();
} else {
showToast("Start fehlgeschlagen. " + err.message, "error");
}
}
}
function beginHealthRunPolling() {
if (healthRunPollTimer) return;
healthRunPollTimer = setInterval(pollHealthRunStatus, 4000);
}
async function pollHealthRunStatus() {
try {
const st = await API.get("/api/sources/health/run-status");
if (st.running) { setHealthRunButton(true); return; }
// Lauf beendet
if (healthRunPollTimer) { clearInterval(healthRunPollTimer); healthRunPollTimer = null; }
setHealthRunButton(false);
if (st.result) {
const r = st.result;
showToast(`Health-Check abgeschlossen. ${r.checked} geprüft, ${r.issues} Probleme, ${r.suggestions} neue Vorschläge.`, "success");
} else if (st.error) {
showToast("Health-Check fehlgeschlagen. " + st.error, "error");
} else {
showToast("Prüfung beendet, Ergebnis unbekannt (Server wurde neu gestartet).", "info");
}
loadUnifiedSources();
if (typeof refreshTasksBadge === "function") refreshTasksBadge();
} catch (_) { /* nächster Tick versucht es erneut */ }
}
function setHealthRunButton(running) {
const btn = document.getElementById("runHealthCheckBtn");
if (!btn) return;
btn.disabled = running;
btn.textContent = running ? "Prüfung läuft…" : "Jetzt prüfen";
}
// Beim Öffnen des Quellen-Reiters einmal nachsehen, ob (z.B. aus einer anderen
// Session) gerade ein Lauf aktiv ist, und dann das Polling aufnehmen.
async function checkHealthRunOnLoad() {
try {
const st = await API.get("/api/sources/health/run-status");
if (st.running) {
setHealthRunButton(true);
beginHealthRunPolling();
}
} catch (_) { /* unkritisch */ }
}
function renderUnifiedSources(sources) {