# noahROBOT Mini-PC

Der aktuelle, einzige Installationspfad fuer den PELADN Ryzen 5 5600H ist das
versionierte Offline-Paket unter `/robot/downloads/`. Es installiert den
gehaerteten FastAPI-Gateway-Dienst, die lokale PWA, nginx/TLS, systemd und die
Funduino-Firmware als getrennte Komponenten.

## Schnellstart

1. Ubuntu 24.04 LTS manuell installieren und aktualisieren.
2. Paket und `SHA256SUMS` vertrauenswuerdig uebertragen.
3. `sha256sum -c SHA256SUMS` ausfuehren.
4. Archiv entpacken.
5. `sudo scripts/install-noahrobot.sh --dry-run` pruefen.
6. Erst danach `sudo scripts/install-noahrobot.sh --apply` ausfuehren.
7. Mit `sudo scripts/diagnose-noahrobot.sh` kontrollieren.

Die vollstaendige Anleitung liegt unter `/robot/installation.html` und in
`docs/INSTALLATION.md`.

## Rollen

- **PELADN**: lokales Gateway, PWA und spaeter eine getrennte Modellruntime.
- **Smartphone**: `/robot/?role=head` als Gesicht, Kamera, Mikrofon und Ausgabe.
- **iPad**: `/robot/?role=controller` als Touch-Steuerung mit sichtbarem STOP.
- **Funduino**: USB-Mikrocontroller mit eigenem Watchdog und physischem E-Stop.

## Sicherheitszustand

Installation und Pairing oeffnen die Motorsteuerung nicht. Das Hardware-Gate
bleibt geschlossen, bis Stromwerte, Treiberlast, Sicherung, Verdrahtung,
physischer rastender Not-Stopp und revisionsgebundene Tests lokal bestaetigt
sind. Programmstart, Timeout und Verbindungsverlust bedeuten immer STOP.

## Historische Bridge

Die Dateien `noah_robot_bridge.py`, `install-noah-robot-bridge.sh` und
`noah-robot-bridge.service.example` sind nur noch historische Referenzen. Sie
werden nicht in das Mini-PC-Release aufgenommen und duerfen nicht parallel zum
Gateway betrieben werden.

## Rueckfall

`sudo scripts/uninstall-noahrobot.sh --apply` deaktiviert die installierten
Dienste und stellt die PWA auf dem Mini-PC still. Die oeffentliche `/robot/`
Simulation bleibt davon unberuehrt.
