Verwaltungsapp für Ugreen Nas-Systeme

# Changelog — Ugreen NAS Admin

## 22.7.0 — 2026-04-09

### Deutsch (ausführlich)

- **Zentrale Einstellungen (`⚙️ Settings`):** Verbindungsdaten (inkl. Profile/SSH-Key), Telegram, E-Mail und Standardpfade sind jetzt zentral gebündelt.
- **Header aufgeräumt:** Verbindungsfelder aus dem Header entfernt; Hinweise und globale Aktionen bleiben kompakt rechts.
- **System & Health vereinfacht:** Telegram-Zugangsdaten sowie SMTP-Verbindungsfelder entfernt; dort bleiben Kanal-/Prüfoptionen, Schwellen, Cooldown und Testaktionen.
- **NAS-Zentral-Wächter / Tagesbericht:** Telegram- und SMTP-Credentials werden aus den zentralen Settings übernommen.
- **Erststart-Hinweis:** Sidebar-Button **Settings** pulsiert dezent, bis eine Verbindung gespeichert wurde.
- **Setup-Status:** Kleine Ampelzeile in Settings zeigt **Verbindung / Telegram / E-Mail** als `OK` oder `fehlt`.
- **Public-Defaults:** Öffentliche App startet mit leeren Standardwerten für NAS-IP und Benutzername.

Mal wieder einige Verbesserungen und neue Sachen

## 22.6.0 — 2026-04-07

### Deutsch (ausführlich)

- **SSH-Verbindungsprofile:** Mehrere gespeicherte Verbindungen (Combobox **Profil**, **＋ Neu**, **✕**); `nas_admin_connection.json` mit **`profiles`** / **`active_profile`** (Migration von alter flacher JSON-Struktur). Pro Profil optional **`docker_compose_path`**.
- **Docker:** **Live-Log** (`docker logs -f`) mit **Stop** (eigener SSH-Thread); **Compose-Datei**-Feld mit **`config`**, **`ps`**, **`up -d`** (letzteres: **Volle Rechte** + Bestätigung); Aufruf per **`bash -lc`** mit Fallback **`docker compose`** → **`docker-compose`**. Standardpfad-Vorschlag **`/volume1/docker/docker-compose.yml`**. Auswahl anderer Container beendet den Live-Stream.
- **Scripte:** Vorlagen-Buttons **rsync** / **restic** / **rclone** (Shell-Boilerplate an Cursorposition, DE/EN).
- **Tk:** Kein **`pady=(0,8)`** mehr im **`tk.Frame`-Konstruktor** (Compose-Zeile, Docker-Wizard) — behebt **`bad screen distance "0 8"`** unter Windows.
- **Update-Hinweis (weiterhin):** ca. **4,5 s** nach Start Abfrage **GitHub** (`runlevel1977-del/UgreenNASAdmin`); Cooldown **24 h**. PyInstaller: **`ugreen_app.mixin_update_check`**, **`ugreen_app.update_check`** in **`.spec`**.

### English (summary)

- **Connection profiles** (multi-NAS / saved SSH); JSON **`profiles`** + migration.
- **Docker:** live log tail + stop; Compose path + **config** / **ps** / **up -d**; **docker compose** vs **docker-compose** fallback.
- **Scripts:** backup snippet buttons **rsync**, **restic**, **rclone**.
- **Fix:** Tk **Frame** padding (Windows startup error).

### Build

- **`tools/zip_oeffentlich_forum.py`:** ZIP-Dateinamen aus **`__version__`** in **`öffentlich/ugreen_app/nas_manager.py`** (aktuell **v22.6.0**).

Eingefürt die Möglichkeit Systembenachrichtigung (Telegram oder Mail) zu bekommen. Genannt "Zentralwächter" und Tagesbericht (nutzt die selber Daten wie Zentralwächter).

Telegram bot Daten und eigene Telegram nummer eintragen oder Mail Adresse. Dann auf "Auf Nas Installieren" klicken. Ein script wird abgelegt. Im Crontab die Zeit eintragen wann es ausgefürt werden soll und fertig.

Beim Tagesbericht geht es gleich. Anklicken "Tagesbericht auf nas aktiv" und auf nas Installieren. Cron einrichten und fertig. Läuft von alleine.

Weil im Systemhealth viele Sachen sind ist der Bereich scrollbar.

Weitere Verbesserungen:

- **Öffentliches Release-Paket:** Forum-/Release-ZIP (**`UgreenNASAdmin_v22.5.0_oeffentlich_mit_EXE.zip`**) enthält neben Quellen und **`dist/UgreenNASAdmin.exe`** den Ordner **`images/`** inkl. **drei neuen Screenshots** zum Tab **System & Health** (`health_system_1.png`–`health_system_3.png`, einheitliche Dateinamen ohne Leerzeichen). Die bisherigen Übersichtsbilder **`1.png`–`6.png`** bleiben erhalten.
- **Dokumentation (`öffentlich/README.md` + Root-`README.md`):** Kurzanleitung **Einrichten der Benachrichtigungen** (Telegram-Wächter, NAS-Zentral-Wächter mit **E-Mail/Telegram**, Hinweise zu SMTP/SMTPS und DNS auf dem NAS) auf **Deutsch und Englisch**; neue **Funktionsliste** der App (DE/EN).
- **Internationalisierung:** Upload-/Download-**Dialoge** und zugehörige **Transfer-Log**-Texte über **`i18n`** (keine fest eingebauten deutschen `messagebox`-Titel mehr in diesen Pfaden); **Telegram:** manuelle NAS-Prüfung, Teststatus und **Testnachrichtentext** folgen der UI-Sprache.
- **Stabilität (Tk/Windows):** SSH-Befehle aus **Hintergrund-Threads** rufen die Statuszeile nicht mehr mit **`update_status=True`** auf (**Explorer** Verzeichnisgrößen/Aufklappen/Suche, **Transfer** Abbruch-Cleanup, **Docker** Stats/Inspect/Logs, **Telegram-Wächter** Prüfschleife) — reduziert Risiko von UI-Freezes analog zur bereits behobenen NAS-Wächter-Installation.
- **NAS-Zentral-Wächter / Tagesbericht (Kontext Release):** Fortführung der zuvor dokumentierten Features: **SMTPS (Port 465)**, **`--smtp-test`**, robusterer **E-Mail-Betreff**, optional **SSH-Login-Fehler** in der Auswertung, **Tagesbericht** (`nas_daily_report.py`) mit **`message_lang`**, gekürzter Berichtsinhalt und Emojis; **PyInstaller**-`datas` enthalten **`nas_central_watch.py`** und **`nas_daily_report.py`** (siehe `.spec`).
- **SSH / Zeitpläne:** Bei **`sudo -S`** liefert die App den Befehlsausgang ohne angehängte **stderr**-Zeilen (z. B. `[sudo] password for …`), damit **`/etc/cron.d/papa_jobs`** im Editor stabil bleibt; sudo-Zeilen werden beim Lesen von Cron-Text verworfen (`nas_ssh.run`, `_sanitize_stable_cron_text`).
- **Scripte-Tab:** **„💾 Speichern“** (root), **„💾 Als Benutzer“** und **Strg+S** speichern den Editor (u. a. **STABLE_TASKS**).
- **Docker-Assistent:** **Zwei Schritte** (Editor → Weiter → Scan/mkdir/Start), **grid**-Layout, **`tk.Button`**, Mindesthöhe Editor.
- **System & Health (Layout):** Aktionsleiste, scrollbares Panel für Telegram/Wächter/Tagesbericht, Mausrad-Scroll, Telegram **Cooldown** neben **Temp max**, NAS-Wächter-Checkboxen kompakt.

# Changelog — Ugreen NAS Admin

---

## Deutsch

### 22.2.0 (Public) — 2026-04-01

Größeres UI-/Sicherheits-Update: **eingeschränkter Standardmodus**, schlankerer **Header**, **Live-Monitor** in der Sidebar, feste **SSH-Key-Feldbreite**, größere **Startfensterbreite**.

#### Sicherheit: „Volle Rechte“ / Restricted Mode

- **Standard:** Viele **riskante Aktionen** sind **deaktiviert** (ausgegraute Buttons, gesperrte Planer-Steuerelemente, eingeschränkte Kontextmenüs), bis du sie bewusst freischaltest.
- **Roter Header-Button** „**⚠ Volle Rechte**“ / „**⚠ Full access**“: Nach Bestätigung des Dialogs **„Vorsicht: Absolute Rechte“** werden u. a. Löschen, Uploads, Docker-Aktionen (Start/Stop/Löschen/…), Cron-/Planer-Jobs, ACL-Schreibzugriffe, Snapshot anlegen/löschen, NAS-Neustart/Herunterfahren, Telegram-Aktionen im Health-Tab, Health-Snapshot speichern und ähnliche Funktionen **bedienbar**.
- **Erneuter Klick** (orange „**🔒 Einschränken**“ / „**🔒 Restrict**“) kann den eingeschränkten Modus **wieder aktivieren** (mit Bestätigung).
- **Technik:** Modul `ugreen_app/mixin_safety_lock.py`; abgerundete Buttons unterstützen **`set_enabled()`** in `rounded_ui.py`; zusätzlich **`_danger_gate()`** an zentralen Einstiegspunkten (z. B. `write_root_file`, Upload-Queue, Docker, Explorer-Löschen, …), falls eine Aktion die UI umgeht.
- **Session:** Freischaltung gilt für die **laufende Sitzung** (kein separates JSON-Flag); nach **Theme-/Sprachwechsel** bleibt der Zustand erhalten, die UI wird neu aufgebaut.

#### Kopfzeile (Header)

- **Eine Zeile** für **NAS-IP, SSH-Port, User, Passwort, SSH-Key (Checkbox + Pfad), Passphrase** — kompaktere Abstände, **linksbündige** IP/User für bessere Lesbarkeit.
- **SSH-Key-Pfad:** **Feste Zeichenbreite** (wächst nicht unbegrenzt bei maximiertem Fenster); freier Platz wandert in eine **Leerspalte** rechts der Passphrase statt einen Riesen-Eintrag zu erzeugen.
- **Hinweistext** (Klartext-JSON / Tresor): **`wraplength`** passt sich der **Headerbreite** an (`Configure`-Event).
- **Rechte Aktionen** (Volle Rechte, Theme, Verbindung speichern, PW-Tresor, Coffee): per **Grid** am **unteren Rand des gesamten Kopfbereichs** (inkl. Hinweiszeile) ausgerichtet — optisch eine Linie mit den Eingabefeldern.
- **Startbreite** Standard **1500 px**, **`minsize`** Breite **1260 px** (siehe `nas_manager.py`).

#### Live-Monitor

- Aus dem Header in die **linke Sidebar** unten verlegt (**über** der Statusleiste mit DE/EN), Abschnitt **„Live-Monitor“**.
- **Kleinerer Start-Button** (kurze Beschriftung **„▶ Live“** / **„⏹ Stop“**).
- **CPU:** nur noch **Gesamt-CPU** (Zeile `cpu` in `/proc/stat`), **keine** Einzelkerne mehr.
- **RAM:** unverändert über `free` (ein Balken + Prozent).

#### Internationalisierung (`i18n.py`)

- Neue Schlüssel u. a. für Sicherheitsdialoge, Sidebar-Monitor, kompakte SSH-Key-Labels (**„SSH-Key“**, **„Passphrase“**).

#### Build / PyInstaller

- **`UgreenNASAdmin.spec`:** Hidden Import **`ugreen_app.mixin_safety_lock`**.

#### Dokumentation & Screenshots

- **`README.md`:** Aktualisiert (Header, Sicherheitsmodus, Live-Monitor, Screenshots **1.png–6.png** unter `images/`).
- **`images/`:** bis zu sechs App-Screenshots für GitHub-README (keine echten Passwörter/IPs in den Bildern).

# Changelog — Ugreen NAS Admin

---

## Deutsch

### 22.1.0 (Public) — 2026-04-01

Ausführliche Übersicht der Änderungen gegenüber 22.0.0 (Verbindungsfelder **NAS-IP / SSH-Port / User / Passwort / SSH-Key** gab es schon früher; sie sind in **`README.md`** unter *Verbindung zur NAS (Kopfzeile)* beschrieben).

#### SSH (`nas_ssh.py`, `run_ssh_cmd`)

- **Kompression:** Paramiko-Verbindung nutzt **`compress=True`** (kann bei vielen/kleinen SSH-Antworten die Last etwas reduzieren).
- **Wiederverwendung:** unverändert eine SSH-Sitzung pro Kontext mit Lock (kein Verbindungschaos bei schnellen Klicks).
- **Lokalisierte Texte:** `SSHManager.run()` akzeptiert jetzt optionale Parameter **`status_connected`**, **`status_failed`**, **`error_message_fmt`**; die App übergibt Übersetzungen aus **`i18n`** (`status.ssh_connected`, `status.ssh_failed`, `ssh.error`). Fehler wie „SSH connection error: …“ / „Fehler bei SSH-Verbindung: …“ folgen der gewählten Sprache (DE/EN).
- **Rückwärtskompatibel:** Ohne diese Parameter bleiben die bisherigen deutschen Standardstrings.

#### Oberfläche & Reaktionszeit

- **NAS-Explorer:** Beim **Aufklappen** eines Ordners läuft `ls` per SSH in einem **Hintergrundthread**; die Treeview wird per **`after(0)`** auf dem UI-Thread aktualisiert (kurz „Lade…“ als Platzhalter). Die UI friert nicht mehr während des Verzeichnislistings ein.
- **NAS-Explorer — Suche:** `ls` + Auswertung der Treffer ebenfalls im **Hintergrund**; Meldungsdialoge nur noch vom Hauptthread.
- **Docker-Tab:** **Stats**, **Inspect** und **Container-Logs** holen die SSH-Ausgabe im Hintergrund und schreiben ins Log-Fenster, wenn die Daten da sind (kein langes Blockieren beim Klick).
- **Docker-Log-Überschrift:** einheitlich über **`i18n`** (`docker.logs_banner` / `docker.log_loading_stats` wo zutreffend).

#### Sicherheit & Passwort

- **Hinweistext** unter der Verbindungszeile: erklärt, dass **„Verbindung speichern“** das Passwort in **`nas_admin_connection.json` im Klartext** ablegt und weist auf den **optionalen OS-Tresor** hin.
- **Button „🔐 PW Tresor“ / „🔐 PW vault“:** speichert das aktuelle SSH-Passwort über das optionale Paket **`keyring`** in der **Windows-Anmeldeinformationsverwaltung** (Dienstname `UgreenNASAdmin`, Schlüssel `user@host`).
- **Laden:** Ist in der JSON das Passwort **leer**, aber IP und User gesetzt, wird beim Start aus dem Tresor gelesen (gleiche Kombination).
- **Neues Modul** `ugreen_app/keyring_helper.py` (Try/Import `keyring`; ohne Paket nur Hinweisdialog).
- **PyInstaller:** `ugreen_app.keyring_helper` als **Hidden Import** in **`UgreenNASAdmin.spec`**, damit die gebaute EXE das Modul findet (trotzdem: `pip install keyring` vor dem Build, wenn der Tresor in der EXE funktionieren soll).

#### Hilfsfunktionen (`nas_utils.py`)

- **`looks_like_ssh_error_output(text)`:** erkennt typische SSH-Verbindungsfehler-Strings (DE und EN), damit Explorer/Du-Hintergrundjobs fehlerhafte Ausgaben nicht als Dateilisten interpretieren.
- **`explorer_sanitize_ls_line`:** filtert zusätzlich englische SSH-Fehlerzeilen (konsistent zu den neuen Übersetzungen).

#### Qualität / Tests (nur Quellbaum mit `tests/`)

- Zusätzliche Unit-Tests für **`looks_like_ssh_error_output`** und Sanitize-Verhalten (im **privaten** Hauptprojekt unter `tests/`; die öffentliche ZIP-Quelle enthält die Tests optional nicht).

#### Dokumentation & GitHub-README

- **`README.md`:** Abschnitt **Screenshots / App-Bilder** oben (zentrierte Vorschau für GitHub); ausführlicher Abschnitt **SSH-Passwort im Windows-Tresor**; **Verbindung zur NAS (Kopfzeile)** mit SSH-Port und SSH-Key; Hinweise zu öffentlichen Screenshots.
- **`requirements.txt`:** Kommentar zu optionalem **`pip install keyring`**.
- Dieses **CHANGELOG:** ausführliche Release-Notiz für 22.1.0.

### 22.0.0 (Public) — 2026-03-30

#### Neu

- Ordner **`öffentlich/`**: enthält alle zum **Starten** und **Bauen** der App nötigen Dateien (Release-Quelle für öffentliche Versionen). Siehe `öffentlich/README.md` — **Ordner nicht löschen**; bei Änderungen im Hauptprojekt Inhalt bei Bedarf spiegeln.
- **Öffentliche Version** mit zweisprachiger Oberfläche **Deutsch / Englisch**.
- **Sprach-Umschalter** `DE / EN` unten links in der Statusleiste; Umschalten lädt die UI neu (gleiche Session, Verbindungsdaten bleiben erhalten).
- **Persistenz:** `ui_lang` wird in `nas_admin_connection.json` neben IP/User/Passwort gespeichert (beim „Verbindung speichern“ mit abgelegt).
- **Übersetzungen** zentral in `ugreen_app/i18n.py` (UI-Texte, Cron-Klartext-Mappings, häufige Dialoge).
- **Versionsnummer** und Fenstertitel nutzen die gleiche Quelle (`__version__`).
- **NAS Explorer (Tab):** Zwei-Spalten-Ansicht (NAS-Baum / **Dieser PC**) zum **Hoch- und Herunterladen** sowie **Kopieren** zwischen NAS und lokalem Rechner — über Werkzeugleiste, Kontextmenü und Direktaktionen (z. B. Upload einzelner Dateien oder ganzer Ordner, „Auf NAS kopieren“ / „Auf PC kopieren“), inkl. Fortschrittsanzeige bei Übertragungen.

#### Geändert (gegenüber 21.2.0)

- Hauptfenster, Sidebar, alle Tab-Bereiche (Scripts, Explorer, Docker, Health/Telegram, Speicher, ACL, Snapshots, Planer), Statuszeile und viele Meldungen sind **sprachabhängig**.
- Cron-/Planer-Klartext und Combobox-Bezeichnungen folgen der gewählten Sprache.
- Abgerundete Buttons (Pillow) unverändert nutzbar; PyInstaller: `ugreen_app.i18n` als Hidden Import ergänzt.

#### Hinweis

- Einzelne tiefe Dialoge (z. B. einige Snapper/Btrfs-Eingaben) können noch deutsche Standardtexte zeigen; die zentralen Pfade sind übersetzt.

#### 21.2.0 und älter

- Vorherige Versionen ohne integrierte DE/EN-Umschaltung; siehe Git/Backup bzw. interne Release-Notizen.

Korrigierte und optimierte Version.