Server-Bibliothek – Prototyp

Für eine technische Übergabe (z. B. Git-Repository): Diese Datei ist
die Bedienungsanleitung. Die technische Architektur (Datenbankschema,
Kernkonzepte, bekannte Grenzen) steht in ARCHITEKTUR.md, die
Entwicklungshistorie in CHANGELOG.md.

Ein einfaches internes Web-Tool für euren Windows-11-Server:
- Katalog aller Software-Tools mit Version, Installer-Pfad und Dokumentation
- Status-Anzeige: Aktuell / Bitte prüfen / Nie geprüft (Warnung ab 30 Tagen ohne Prüfung)
- Protokoll: welcher Mitarbeiter hat welche Software auf welchem Rechner bekommen

Läuft komplett lokal auf eurem Server, keine Cloud, keine Installation von Zusatzsoftware
außer Python. Die Daten liegen in einer einzigen Datei (data/bibliothek.db).

1. Einmalige Einrichtung auf dem Server

Schritt 1 – Ordner kopieren

Kopiert den kompletten Ordner server-bibliothek auf den Windows-11-Server,
z. B. nach C:\server-bibliothek.

Schritt 2 – Python installieren (falls noch nicht vorhanden)

1. Öffnet im Browser: https://www.python.org/downloads/
2. Ladet die neueste Version für Windows herunter und startet die Installation.
3. Wichtig: Auf der ersten Seite des Installers unten das Kästchen
   "Add python.exe to PATH" anhaken, bevor ihr auf "Install Now" klickt.

Schritt 3 – Einrichtung starten

Im Ordner C:\server-bibliothek die Datei install.bat doppelklicken.
Es öffnet sich ein schwarzes Fenster, das die benötigte Bibliothek installiert.
Am Ende steht "Fertig!" – das Fenster kann dann geschlossen werden.
(Falls Python noch fehlt, sagt dir das Fenster das und verlinkt die Download-Seite.)

2. Programm starten

Im Ordner C:\server-bibliothek die Datei start.bat doppelklicken.

Es öffnet sich ein Fenster mit der Meldung, dass der Server läuft.
Dieses Fenster muss offen bleiben, solange das Tool genutzt werden soll –
es ist quasi der "Motor", der die Web-Seite im Hintergrund am Laufen hält.

Jetzt im Browser öffnen:
http://localhost:5000

Von anderen Rechnern im selben Netzwerk erreicht ihr es über die IP-Adresse
des Servers, z. B. http://192.168.1.50:5000 (steht auch direkt im
Konsolenfenster von start.bat, in der Zeile die NICHT mit 127.0.0.1
beginnt).

Klappt der Zugriff von einem anderen Rechner nicht? Das liegt fast immer
an der Windows-Firewall, die eingehende Verbindungen auf Port 5000
standardmäßig blockiert. Einmalig firewall-freigabe-einrichten.bat
doppelklicken – richtet die nötige Firewall-Regel automatisch ein.

Zum Beenden: das Konsolenfenster einfach schließen (oder STRG+C drücken).

3. Bedienung

• Software-Katalog (Startseite): alle Tools mit Status auf einen Blick.
  Über "+ Neues Tool anlegen" ein neues Tool mit Installer-Pfad, Silent-Parametern
  und Doku-Text hinterlegen.
• Auf einem Tool auf Details klicken → dort steht die komplette Anleitung,
  außerdem der Button "Jetzt als geprüft markieren" – das solltet ihr klicken,
  wann immer ihr den Installer manuell aktualisiert habt. Danach zählt der
  30-Tage-Timer wieder von vorn.
• Zuweisungen: Protokolliert dort jede Installation (Mitarbeiter, Rechnername,
  installierte Version, Datum). Über die Filterfelder lässt sich nach Mitarbeiter
  oder Rechnername suchen.

3a. Rechner einrichten (Verteilung an neue Rechner)

Menüpunkt "Rechner einrichten": Häkchen bei den benötigten Tools setzen,
Mitarbeiter eintragen, "Installations-Paket herunterladen" klicken. Das
erzeugte ZIP enthält die ausgewählten Installer-Dateien direkt mit (kein
Nachladen vom Server nötig).

Auf dem neuen Rechner: ZIP entpacken, Rechner-einrichten-starten.bat
doppelklicken. Das Skript:
- fragt bei Bedarf automatisch nach Admin-Rechten
- installiert jedes Tool still mit dem hinterlegten Silent-Parameter
- trägt automatisch eine Windows-Defender-Ausnahme für C:\ClientBibliothek
ein (dort landen alle Dateien gesammelt)
- meldet das Ergebnis am Ende automatisch ans zentrale Protokoll zurück
(Rechnername wird dabei selbst erkannt)

Tools ohne einzelne Installer-Datei (z. B. bereits entpackte/portable Tools
wie Blender) werden als ZIP nach C:\ClientBibliothek\pakete\ gelegt –
bewusst ohne automatisches Entpacken, das entscheidet ihr von Fall zu Fall
selbst.

⚠️ Die Windows-spezifischen Teile (Admin-Rechte-Anfrage, stille Installation)
wurden nicht auf einem echten Windows-Rechner entwickelt und getestet, nur
mit dem echten PowerShell-Parser auf Syntaxfehler geprüft sowie die
Netzwerk-/Datei-Logik separat verifiziert. Bei größerem Rollout zuerst an
1–2 unkritischen Rechnern gegentesten.

4. Automatische Aktualisierung

Bei jedem Tool kann beim Anlegen/Bearbeiten "Automatische Aktualisierung
aktivieren" angehakt werden. Dann sucht das Tool selbst nach neuen Versionen
und ersetzt die Installer-Datei automatisch, ohne Rückfrage. Dabei:

• wird die alte Datei vorher immer in einen Unterordner _sicherungen
  kopiert (Sicherheitsnetz, falls mal etwas schiefgeht)
• wird jeder Check protokolliert (sichtbar auf der Detailseite des Tools
  unter "Update-Protokoll")
• bleibt ein Tool bei "Bitte prüfen" stehen, wenn eine Prüfung fehlschlägt
  (z. B. Server nicht erreichbar) – Fehler werden nie stillschweigend
  übergangen

Als Quelle stehen drei Möglichkeiten zur Wahl: winget (für die meisten
bekannten Programme, siehe Update-Quellen-Uebersicht.md), GitHub-Projekt
(für Open-Source-Tools) oder ein direkter Download-Link. Tools ohne
Häkchen bleiben komplett unangetastet – ideal für interne oder bewusst
fest angepinnte Software.

Update jetzt manuell auslösen:
- Für ein einzelnes Tool: auf der Detailseite "Jetzt automatisch prüfen & aktualisieren"
- Für alle Tools auf einmal: Button oben im Software-Katalog, oder Doppelklick auf pruefe_updates.bat

Täglich automatisch im Hintergrund laufen lassen (empfohlen):
Einmalig automatisierung_einrichten.bat doppelklicken. Das richtet in der
Windows-Aufgabenplanung einen täglichen Lauf um 03:00 Uhr nachts ein – dann
kümmert sich das Tool von selbst darum, auch wenn niemand die Weboberfläche
geöffnet hat. Falls eine Fehlermeldung kommt: Rechtsklick auf die Datei →
"Als Administrator ausführen".

⚠️ Hinweis zum winget-Pfad: Dieser Teil konnte in meiner Entwicklungsumgebung
nicht direkt getestet werden, da winget nur unter Windows existiert (der
GitHub-Pfad wurde dagegen live gegen die echte GitHub-Schnittstelle getestet).
Probiert den winget-Weg daher am besten zuerst an einem unkritischen Tool aus,
bevor ihr euch vollständig darauf verlasst.

5. Dauerhafter Betrieb der Weboberfläche

Aktuell müsst ihr start.bat manuell starten, wenn ihr den Katalog im Browser
ansehen wollt – die automatische Update-Prüfung (siehe oben) läuft davon
unabhängig auch ohne offene Weboberfläche. Falls gewünscht, kann auch die
Weboberfläche selbst automatisch mit dem Server starten – dafür einfach
melden, wenn ihr so weit seid.

6. Datensicherung

Alle Daten liegen in der Datei data\bibliothek.db. Diese Datei ab und zu zu
sichern (z. B. in euer normales Backup einschließen) reicht als Absicherung
gegen Datenverlust vollständig aus.