# Mitarbeiten

Das Projekt ist noch in **Phase 0** (Machbarkeits-Spike). Bis die vier Beweise S1–S4
stehen, kann sich die Architektur noch grundlegend ändern — Beiträge sind trotzdem
willkommen, vor allem Geräte-Meldungen.

## Am hilfreichsten gerade jetzt

**Geräte-Meldungen.** Lauf die Skripte aus [`spike/`](spike/) auf deinem Gerät und
melde das Ergebnis, egal ob es funktioniert hat. Ein sauber dokumentierter Fehlschlag
ist genauso wertvoll wie ein Erfolg — beides geht in die Kompatibilitätsliste.

## Ehernes Gesetz

Zwei Regeln, die keine Ausnahme kennen. Ein Beitrag, der eine davon bricht, wird
abgelehnt, egal wie nützlich er sonst ist:

1. **Der Bridge-Layer auf der Android-Seite ist zustandslos.** Er speichert keine
   Nutzdaten. Alles wird ins Linux durchgereicht und nur dort persistiert.
2. **Keine Serverabhängigkeit.** Das Telefon funktioniert vollständig ohne fremde
   Infrastruktur. Ein externes Backup-Ziel ist optional und jederzeit abwählbar.

Dazu zwei Regeln, die den Alltag betreffen:

3. **Kein Root, kein entsperrter Bootloader.** Wenn etwas nur mit Root geht, geht es
   in diesem Projekt nicht.
4. **Kein Privilegienkanal im Dauerbetrieb.** ADB ist ausschließlich für die einmalige
   Ersteinrichtung vorgesehen. Alles Laufende kommt mit gewöhnlichen App-Berechtigungen aus.

## Bevor du etwas vorschlägst

Lies [`docs/verworfene-entscheidungen.md`](docs/verworfene-entscheidungen.md). Sieben
naheliegende Wege wurden bereits geprüft und begründet verworfen — Waydroid, AVF, SIP,
APK-Daten-Redirect und andere. Wenn du einen davon wiederbeleben willst: gern, aber mit
einem Argument, das dort noch nicht widerlegt ist.

## Stil

- Skripte: `bash`, `set -euo pipefail`, deutschsprachige Ausgaben, jeder Schritt protokolliert
- Kommentare erklären das *Warum*, nicht das *Was*
- Architekturentscheidungen kommen als ADR nach `docs/`, nicht in die Commit-Nachricht
- Keine Zugangsdaten, Tokens oder Zieladressen im Repo — auch nicht in Beispieldateien