# synadm TUI – Thüringen Edition

Die Thüringen Edition ergänzt den unveränderten Anwendungskern von [`synadm-tui`](https://git.blackwall.ipv64.de/pan/synadm-tui) um das Thüringen-Thema, das Wappen und getrennte Release-Pakete.

Programmlogik, Navigation, Assistenten und Sicherheitsfunktionen werden nicht kopiert. Das Repository bindet einen geprüften `synadm-tui`-Stand als Git-Submodul ein; dadurch bleiben beide Editionen funktional identisch.

## Quellcode testen

```bash
git clone --recurse-submodules https://git.blackwall.ipv64.de/pan/synadm-tui-thueringen.git
cd synadm-tui-thueringen
PYTHONPATH=vendor/synadm-tui python3 -m unittest discover -v
PYTHONPATH=vendor/synadm-tui python3 -m synadm_tui_thueringen --version
```

## Native Datei und Pakete bauen

```bash
python3 -m pip install pyinstaller
python3 scripts/build_native.py
python3 scripts/build_packages.py
cd dist/packages && sha256sum --check SHA256SUMS
```

## Pakete ohne Runner veröffentlichen

```bash
python3 scripts/publish_packages.py --tea-login Building --dry-run
python3 scripts/publish_packages.py --tea-login Building
```

DEB-Pakete werden in die Distribution `thueringen`, RPM-Pakete in die Gruppe `thueringen` veröffentlicht. Dadurch bleiben auch die Paketquellen von der Standard Edition getrennt.

## Über APT installieren

```bash
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://git.blackwall.ipv64.de/api/packages/pan/debian/repository.key \
  -o /etc/apt/keyrings/pan-gitea.asc
echo "deb [signed-by=/etc/apt/keyrings/pan-gitea.asc] https://git.blackwall.ipv64.de/api/packages/pan/debian thueringen main" \
  | sudo tee /etc/apt/sources.list.d/synadm-tui-thueringen.list
sudo apt update
sudo apt install synadm-tui-thueringen
```

Dieser Ablauf wurde mit Version 0.15 in einer isolierten APT-Umgebung geprüft: Signaturprüfung, Paketauflösung, Download, Dateirechte und Programmstart waren erfolgreich.

## RPM-Status

Die getrennte RPM-Quelle ist unter
`https://git.blackwall.ipv64.de/api/packages/pan/rpm/thueringen.repo` erreichbar. Metadaten, SHA256-Prüfsumme, Paketinhalt und Programmstart von Version 0.15 wurden geprüft. Ein realer Test unter Fedora 42 mit DNF5 lädt Repository und Paket korrekt, beendet die Transaktion aber mit `The package is not signed`. Die bisher veröffentlichte RPM-Datei besitzt noch keine eingebettete Paketsignatur, obwohl die Gitea-Repository-Datei `gpgcheck=1` aktiviert. Die DNF-Installation wird deshalb erst nach Einrichtung eines dauerhaften RPM-Signaturschlüssels empfohlen; `gpgcheck` sollte nicht deaktiviert werden.

## Gemeinsamen Kern aktualisieren

Nach einem neuen `synadm-tui`-Release wird ausschließlich der Submodul-Pin aktualisiert:

```bash
git -C vendor/synadm-tui fetch --tags
git -C vendor/synadm-tui checkout vNEUE_VERSION
git add vendor/synadm-tui
PYTHONPATH=vendor/synadm-tui python3 -m unittest discover -v
```

Anschließend werden Overlay-Version, Binärdatei und Pakete mit derselben Versionsnummer gebaut. Programmlogik wird nicht kopiert.

## Voraussetzungen

- Linux x86-64 oder ARM64
- Python 3.10+ für den Quellstart
- PyInstaller für native Builds
- `dpkg-deb` und `rpmbuild` für Systempakete
- separat installiertes `synadm`, wahlweise über den integrierten Installationsassistenten

## Lizenz

GPL-3.0-or-later, siehe `LICENSE`.