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

---

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