feat: Laientauglichkeit — Auto-Modus, Klartext-Ausgabe, einfachere Doku
Ziel: ein einziger täglicher Befehl genügt, jede Meldung ist auch ohne IT-Wissen verständlich. Auto-Modus (ein Cron-Job genügt für alles): - data/state.json merkt sich, wann die Wochen-Prüfungen zuletzt liefen (baseline.py: load_state/save_state/is_check_due/mark_check_run) - `scan` führt fällige Zusatzprüfungen (Tarnung/externe Links/Dateien) automatisch mit aus; Gesamt-Ampel = schlechtestes Teilergebnis; EIN kombinierter Report + EIN Alert - neuer Config-Abschnitt periodic_checks (Default: wöchentlich, an) Klartext (scanner/plain.py): - Ampel 🟢/🟡/🔴 + Sätze ohne Fachbegriffe, aus den strukturierten Befunden - Report: Klartext oben, "Technische Details (für Ihren Dienstleister)" unten - Terminal-Ausgabe und E-Mail (alerter.py) ebenso umgestellt Komfort: - approve --all/--rebuild legt die Datei-Überwachung automatisch mit an (Opt-out: --skip-assets); approve-assets bleibt für den Sonderfall - status zeigt Ampel zuoberst + wann die Wochen-Prüfungen zuletzt liefen - Onboarding-Text in einfacher Sprache, wenn noch kein Vergleichsstand existiert Doku: README + BEDIENUNGSANLEITUNG mit "In 3 Schritten"-Einstieg. Tests: test_state.py, test_plain.py (Fachbegriff-Assertion), Auto-Asset- Baseline-Test. 165 Tests grün. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
54ff1a6060
commit
bed20db8bd
11 changed files with 856 additions and 202 deletions
|
|
@ -5,6 +5,46 @@ unbefugte Manipulationen. Der Scanner läuft lokal im Verantwortungsbereich des
|
|||
|
||||
---
|
||||
|
||||
## Für Einsteiger – in 3 Schritten
|
||||
|
||||
Sie brauchen kein IT-Wissen. Das Programm zeigt eine **Ampel** und erklärt alles in
|
||||
einfachen Worten.
|
||||
|
||||
**Schritt 1 — Erststand speichern** (einmalig, wenn die Website in Ordnung ist):
|
||||
```
|
||||
python -m scanner approve --all --note "Erststand geprüft"
|
||||
```
|
||||
|
||||
**Schritt 2 — täglich prüfen** (am besten automatisch per Cron, siehe Abschnitt 10):
|
||||
```
|
||||
python -m scanner scan
|
||||
```
|
||||
|
||||
**Schritt 3 — bei 🟡 oder 🔴 nachschauen:**
|
||||
```
|
||||
python -m scanner report
|
||||
```
|
||||
|
||||
Was die Ampel bedeutet:
|
||||
|
||||
| Ampel | Bedeutung | Was tun? |
|
||||
|---|---|---|
|
||||
| 🟢 | Alles in Ordnung | Nichts. |
|
||||
| 🟡 | Bitte nachschauen | Bericht lesen; wenn die Änderung gewollt war, mit `approve --all` bestätigen. |
|
||||
| 🔴 | Achtung | Website ansehen und die Person/Firma informieren, die Ihre Website betreut. |
|
||||
|
||||
> **Wichtig:** Die selteneren Prüfungen (Tarnung, externe Links, Dateien) laufen
|
||||
> **automatisch einmal pro Woche** beim täglichen `scan` mit. Sie müssen dafür **nichts**
|
||||
> extra einrichten — ein einziger täglicher Aufruf genügt für alles.
|
||||
>
|
||||
> Beim ersten `approve --all` wird zusätzlich die **Datei-Überwachung** automatisch
|
||||
> eingerichtet (Bilder, Skripte, Stylesheets). Auch dafür ist kein weiterer Schritt nötig.
|
||||
|
||||
Alles Weitere in dieser Anleitung richtet sich an **Fortgeschrittene** und an
|
||||
**Ihren Dienstleister**.
|
||||
|
||||
---
|
||||
|
||||
## Inhaltsverzeichnis
|
||||
|
||||
1. [Grundprinzip](#1-grundprinzip)
|
||||
|
|
@ -607,8 +647,9 @@ das richtige Werkzeug (URL-Prüfung → Live testen).
|
|||
|
||||
### Wann ausführen?
|
||||
|
||||
Nicht täglich — der Doppel-Crawl belastet den Server doppelt. Empfehlung: monatlich
|
||||
oder bei konkretem Verdacht.
|
||||
**Läuft automatisch wöchentlich** beim täglichen `scan` mit (steuerbar über
|
||||
`periodic_checks` in der `config.yaml`). Der manuelle Aufruf ist nur bei konkretem
|
||||
Verdacht nötig.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -643,8 +684,8 @@ Der Report liegt unter `reports/<ts>_ext-links/report.md`.
|
|||
|
||||
### Wann ausführen?
|
||||
|
||||
Wöchentlich oder monatlich reicht. Nicht im täglichen Cron — zu viele Requests an
|
||||
externe Server.
|
||||
**Läuft automatisch wöchentlich** beim täglichen `scan` mit (steuerbar über
|
||||
`periodic_checks` in der `config.yaml`). Ein manueller Aufruf ist nur bei Bedarf nötig.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -697,5 +738,7 @@ Der Report liegt unter `reports/<ts>_assets/report.md` und zeigt pro geänderter
|
|||
|
||||
### Wann ausführen?
|
||||
|
||||
Wöchentlich oder nach bekannten Website-Updates. Nicht täglich — lädt alle Assets herunter
|
||||
und ist entsprechend langsam.
|
||||
**Läuft automatisch wöchentlich** beim täglichen `scan` mit (steuerbar über
|
||||
`periodic_checks` in der `config.yaml`). Die Datei-Vergleichsgrundlage wird zudem beim
|
||||
ersten `approve --all` automatisch angelegt — `approve-assets` ist nur für den manuellen
|
||||
Sonderfall gedacht.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue