Upload via GUI (1 Datei)

README.md

@@ -4,7 +4,7 @@
 
 ![DeskHub Kundenportal](DeskHub-Webseite/docs/images/customer-portal.png)
 
-**Aktuelle Versionen:** Server **1.0.47** · Android-App **3.4.4** · Windows-Programm **2.10.2** · Minecraft-Plugin **1.0.0**
+**Aktuelle Versionen:** Server **1.0.47** · Android-App **3.4.4** · Windows-Programm **2.11.0** · Minecraft-Plugin **1.0.0**
 
 > Diese Anleitung ist auch für Einsteiger geeignet. Über das Inhaltsverzeichnis kommt ihr direkt zum gewünschten Thema. Die Abschnitte [Plugins entwickeln](#plugins-entwickeln) und [API und Webhooks](#api-und-webhooks-für-entwickler) richten sich an Entwickler.
 
@@ -26,6 +26,7 @@
 - **Import aus osTicket** inklusive Abteilungen, Nachrichten und Anhängen
 - **Windows-Programm und Android-App** mit hellem und dunklem Design, Push-Benachrichtigungen, Verwaltung nach Rechten und Android-**Widget** in drei Größen, direkt aus dem Mitarbeiterbereich herunterladbar
 - **Minecraft-Plugin** (Paper, Spigot, BungeeCord in einer Datei) zum Melden von Spielern und Problemen als Ticket
+- **Chrome-Erweiterung** (auch Edge und Brave; Windows, Mac, Linux) mit Zähler, Benachrichtigungen, Suche und Ticket anlegen; **Windows-Programm auch für Linux und Mac** (Mac nur selbst zu bauen)
 
 ## Einblicke
 
@@ -96,6 +97,8 @@ Klick auf die Vorschau öffnet das Video ([deskhub-demo.mp4](DeskHub-Webseite/do
 - [Windows-App und Android-App](#windows-app-und-android-app)
   - [Update-Hinweis in den Apps](#update-hinweis-in-den-apps)
   - [Minecraft-Plugin zum Herunterladen](#minecraft-plugin-zum-herunterladen)
+  - [Chrome-Erweiterung](#chrome-erweiterung)
+  - [Windows-Programm für Linux und Mac](#windows-programm-für-linux-und-mac)
 - [System-Update und Datenbank-Update](#system-update-und-datenbank-update)
 - [Import aus osTicket](#import-aus-osticket)
 - [Plugins verwenden](#plugins-verwenden)
@@ -554,6 +557,24 @@ Beide Apps (ab Windows 2.10.0 und Android 3.4.0) fragen beim Start und danach al
 ### Minecraft-Plugin zum Herunterladen
 
 Auf der Seite „Apps“ kann zusätzlich das Minecraft-Plugin (`DeskHub-Minecraft.jar`, siehe `minecraft-plugin/README.md`) erscheinen: mit Version, Größe, Prüfsumme und Kurzanleitung (Jar in `plugins`, `config.yml` ausfüllen, API-Schlüssel mit dem Recht „Tickets anlegen“, `/deskhubmc test`). Die Karte lässt sich unter **Einstellungen → System** („Minecraft-Plugin auf der Apps-Seite anzeigen“) ein- und ausblenden; ausgeblendet ist auch der Download gesperrt. Standard: aus. Die Jar veröffentlicht ihr wie die Apps in der Plugin-Webseite unter **Apps** (Plattform „Minecraft-Plugin (JAR)“).
+
+### Chrome-Erweiterung
+
+Im Ordner `chrome-erweiterung/` liegt eine Erweiterung für Chrome, Edge und Brave (Manifest V3), die auf Windows, Mac und Linux läuft; ausführlich in `chrome-erweiterung/README.md`. Sie zeigt am Symbol einen **Zähler** für neue Tickets (Abfrage jede Minute), meldet Neues per **Benachrichtigung**, hat eine **Übersicht** (meine offenen, überfällige, nicht zugewiesene und als Nächstes fällige Tickets), eine **Suche** und ein Formular zum **Anlegen von Tickets**, auch per Rechtsklick auf markierten Text („Als DeskHub-Ticket anlegen“). Ein Klick auf ein Ticket öffnet es in der Weboberfläche, ohne erneute Anmeldung (einmalige Adresse wie in den Apps).
+
+- **Installieren:** `chrome://extensions` → Entwicklermodus → „Entpackte Erweiterung laden“ → Ordner `chrome-erweiterung`. Anmelden mit Server-Adresse, E-Mail und Passwort (bei Authenticator mit Code). Chrome fragt einmal nach der Erlaubnis für **genau diesen Server**; sie wird beim Abmelden zurückgegeben.
+- **Sicherheit:** Nur HTTPS, keine Cookies, keine Weiterleitungen; das Token liegt nur im lokalen Speicher der Erweiterung, Abmelden sperrt es auf dem Server.
+- **Grenzen:** Meldungen nur bei geöffnetem Browser; Antworten, Zuweisen und Status ändern gehen in der Weboberfläche. Nicht im Chrome Web Store; `node pack.mjs` erzeugt ein ZIP dafür.
+
+### Windows-Programm für Linux und Mac
+
+Das Windows-Programm (Electron) lässt sich auch für Linux und Mac bauen. Dort nutzt es den normalen Fensterrahmen statt der eigenen Titelleiste, ein PNG-Symbol und auf dem Mac ein Bearbeiten-Menü (sonst gehen Kopieren und Einfügen nicht).
+
+- **Linux:** `npm run build:linux` im Ordner `desktop/` erzeugt ein AppImage und ein `tar.gz`. **Auf Linux bauen**, dann stimmen die Dateirechte (AppImage kann nur dort gebaut werden). Ein unter Windows gebautes `tar.gz` hat keine Ausführungsrechte: nach dem Entpacken `sh start-deskhub.sh` starten (das Skript liegt im Archiv und setzt die Rechte). Falls Chrome-Sandbox oder Schlüsselbund fehlen: ohne Schlüsselbund wird das Token in einer Datei gespeichert, die nur dein Benutzer lesen kann.
+- **Mac:** `npm run build:mac` erzeugt `dmg` und `zip`, aber **nur auf einem Mac** (Signieren und Beglaubigen geht nur dort und braucht ein Apple-Entwicklerkonto). Ohne Signatur zeigt macOS beim ersten Start eine Warnung; öffnen per Rechtsklick → „Öffnen“.
+- **Autostart:** Unter Linux legt das Programm dafür `~/.config/autostart/deskhub.desktop` an.
+- **Update-Hinweis:** Gibt es nur für Windows (der Server liefert dort das Windows-Setup). Auf Linux und Mac neue Version selbst installieren.
+- **Noch nicht getestet:** Ich konnte das Programm nicht auf Linux oder Mac starten; gebaut und geprüft ist das Archiv, nicht der Betrieb.
 ---
 
 ## System-Update und Datenbank-Update