# 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.

Die Bedienung funktioniert wahlweise per Tastatur oder Maus. Ein Klick auf einen Bereich zeigt dessen Befehle; ein Klick auf einen Befehl öffnet ihn direkt.

## 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 und signierte RPM-Quelle wird so eingerichtet:

```bash
sudo curl -fsSL https://git.blackwall.ipv64.de/api/packages/pan/generic/synadm-tui-repository/1/synadm-tui-thueringen.repo \
  -o /etc/yum.repos.d/synadm-tui-thueringen.repo
sudo dnf install synadm-tui-thueringen
```

Ab Version 0.16 besitzen die RPM-Pakete dieselbe eingebettete RSA/SHA512-Signatur wie die Standard Edition. `gpgcheck=1` bleibt aktiviert; der öffentliche Schlüssel wird aus dem neutralen Kernrepository geladen.

## 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`.