addet test set

tools/instructions.md

@@ -2,13 +2,17 @@
 
 Hier liegen Pi-Transfer/Einrichtung und die reproduzierbaren Blender-Werkzeuge.
 
-- `upload_to_pi.sh` zeigt ohne `--apply` nur eine Vorschau. Beim Übertragen
-  keine Dateien auf dem Pi löschen; `.git`, `.venv`, `data`, Vorschauen,
-  Referenzen und Schlüsseldateien ausgeschlossen lassen. SSH-Hostschlüssel
-  weiterhin prüfen.
-- `install_pi_service.sh` richtet den optionalen systemd-Autostart ein.
-  Die Python-Umgebung muss vorher auf dem Pi eingerichtet sein. Der Dienst
-  bindet über `run.py` nur an `127.0.0.1`; `sudo` nur bei `--apply`.
+- `upload_to_pi.sh` zeigt ohne `--apply` nur eine lokale Vorschau. Jede Version
+  kommt in einen neuen releases/-Ordner; niemals data/ oder bestehende Dateien
+  überschreiben/löschen. SSH-Hostschlüssel weiterhin prüfen.
+- `activate_pi_release.sh` läuft auf dem Pi: flock-Sperre, eigene venv vorbereiten,
+  verwalteten Dienst stoppen, data/ sichern, current atomar wechseln. Bei Fehlern
+  Code, Unit und Daten wiederherstellen und alten Dienst prüfen. Abhängigkeiten
+  nur als Wheels installieren. Fremde Units und manuelle Server ablehnen.
+- `install_pi_service.sh` richtet systemd-Autostart ein, beim Upload automatisch.
+  Gemeinsames HALLOWEEN_STATE_DIR; Code/venv über current, wo vorhanden.
+  Default Loopback; direkter Heimnetzzugriff nur mit ausdrücklich gewähltem Host.
+  sudo nur bei --apply; keine Browser-Automation. Alle Versionen/Backups behalten.
 - Render-, Ton- und Prüfscripte unter `tools/` erzeugen Dateien in
   `preview/`. Bearbeitbare `.blend`-Szenen werden versioniert, gerenderte
   Medien und `.blend1`-Backups bleiben lokal.
@@ -28,3 +32,15 @@ Schritte; Reihenfolge im zugehörigen Vorschau-README dokumentieren.
   fixierte NanoDet-Modell unter `data/models/`. Größe und SHA-256 vor atomarem
   Ersetzen prüfen, TLS-Prüfung beibehalten. `--state-dir` bzw.
   `HALLOWEEN_STATE_DIR` muss zum Server passen. Keine Modellgewichte hochladen.
+
+- Versionierte Updates verwenden genau einen sudo-Aufruf nach unprivilegierter
+  Paketvorbereitung. activate_pi_release.sh --privileged ist der interne Teil:
+  Unitprüfung, Sicherung, Umschaltung, systemd und Rückfall im selben sudo-Prozess.
+  Normale Einstiegsshell hält flock über dessen Laufzeit. Nicht direkt aufrufen.
+- Python-/Projektprüfungen und Unit-Renderer im privilegierten Teil mit runuser
+  als SUDO_USER ausführen. Keine Pakete als root, kein Passwortspeicher/Keepalive
+  und keine sudoers-/Zeitstempeländerung. install_pi_service.sh --print-unit
+  rendert ohne sudo; standalone --apply ist vom Updateaufruf getrennt.
+- Neu erzeugte Backupordner, Unit-Sicherung, current-Link und service-host
+  dem ursprünglichen Pi-Benutzer zuordnen; bestehende Datenbesitzer beim Kopieren
+  bewahren. Abgelehnte sudo-Anmeldung darf keine Umschaltung/Dienstpause auslösen.