Upload via GUI (1 Datei)

This commit is contained in:
2026-11-08 20:31:00 +00:00
parent 7c1a6d9537
commit 8a95c68c5e
+114 -5
View File
@@ -4,7 +4,7 @@
![DeskHub Kundenportal](DeskHub-Webseite/docs/images/customer-portal.png) ![DeskHub Kundenportal](DeskHub-Webseite/docs/images/customer-portal.png)
**Aktuelle Versionen:** Server **1.0.66** · Chrome-Erweiterung **2.0.0** · WordPress-Plugin **1.2.2** · Android-App **3.4.5** · Windows-Programm **2.11.1** · Minecraft-Plugin **1.1.0** **Aktuelle Versionen:** Server **1.1.0** · Chrome-Erweiterung **2.1.1** · WordPress-Plugin **1.3.0** · Android-App **3.5.3** · Windows-Programm **2.12.3** · Minecraft-Plugin **1.2.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. > 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.
@@ -345,6 +345,108 @@ Ist eine Adresse nirgends hinterlegt, landet das Ticket in der Standardabteilung
### Nach dem Abruf ### Nach dem Abruf
**Tastenkürzel, Bildvorschau, verknüpfte Tickets, Antworten einplanen, Berichte per E-Mail, Datenschutz-Werkzeuge (Server 1.0.68):**
- **Tastenkürzel** (`assets/js/staff-shortcuts.js`, in jeder Mitarbeiterseite): In der Ticketliste `j`/`k` wählen, `Enter`/`o` öffnen, `r` öffnen und antworten, `x` ankreuzen, `/` Suche, `n` neues Ticket; im Ticket `j`/`k` durch die Nachrichten, `r` Antwort schreiben, `u` zurück zur Liste; `Strg + Enter` sendet die Antwort; `?` zeigt die Übersicht und erlaubt das Abschalten (gilt nur für diesen Browser). Die Kürzel greifen nicht in Eingabefeldern.
- **Bildvorschau** (`assets/js/ticket-lightbox.js`): Ein Klick auf ein Bild im Ticket zeigt es groß, ohne Download; Pfeiltasten blättern, `Esc` schließt, ein Knopf lädt herunter. Ohne JavaScript öffnet der Link das Bild wie zuvor in einem neuen Tab.
- **Verknüpfte Tickets** (`includes/ticket_links.php`, Tabelle `ticket_links`): Im Ticket unter „Organisation“ lassen sich beliebige Tickets per Nummer verknüpfen: *verwandt*, *doppelt* oder *blockiert*. Beide Tickets zeigen die Verknüpfung mit der passenden Bezeichnung („Doppelt zu“ / „Hat Duplikat“, „Blockiert“ / „Blockiert durch“). Mitarbeiter sehen nur Tickets ihrer Abteilungen; ein offener Blocker wird als Hinweis angezeigt. Beim Löschen eines Tickets verschwinden dessen Verknüpfungen.
- **Antwort einplanen** (`includes/scheduled_replies.php`, Tabelle `scheduled_replies`, Hintergrundjob `cron/send_scheduled_replies.php`, jede Minute): Unter dem Antwortformular „Später senden“ wählt Datum und Uhrzeit (Serverzeit, höchstens 90 Tage voraus). Die Antwort erscheint bis dahin als „Geplante Antworten“ im Ticket und lässt sich vom Verfasser oder einem Administrator abbrechen. Beim Senden gelten Status, Abschlussgrund und Signatur wie beim sofortigen Antworten. Anhänge sind beim Einplanen nicht möglich. Ist das Ticket gelöscht oder der Verfasser deaktiviert, wird nichts gesendet und der Grund gespeichert.
- **Berichte per E-Mail** (`includes/report_schedules.php`, Tabelle `report_schedules`, Hintergrundjob `cron/send_report_schedules.php`, alle 5 Minuten): Im Bericht-Baukasten unter „Versand per E-Mail (Zeitplan)“ wird ein gespeicherter Bericht täglich, wöchentlich oder monatlich für einen relativen Zeitraum (gestern, letzte 7 oder 30 Tage, letzte Kalenderwoche, letzter Monat) als Tabelle per Mail gesendet. Berechnet wird mit den Abteilungsrechten des Einrichters. Nicht-Administratoren dürfen nur an aktive Mitarbeiter senden, Administratoren auch an externe Adressen (höchstens 10 Empfänger). „Test senden“ verschickt sofort. **Weniger Mails (ab Server 1.0.70, Datenbank-Update `php_0073`):** Je Zeitplan gibt es drei Schalter, die auch nachträglich umschaltbar sind: *Nur bei Daten* (ein leerer Bericht wird nicht gesendet), *Nur bei Änderung* (gleiche Zahlen wie beim letzten Versand: nichts senden) und, bei „Täglich“, *Nur Mo–Fr*. Die ersten beiden sind für neue und bestehende Zeitpläne standardmäßig an; „Test senden“ sendet immer. Warum nichts kam, steht in der Spalte „Zuletzt“ („Übersprungen: …“). Der Versand nutzt den eingerichteten E-Mail-Weg; ohne ihn steht „Kein Empfänger erreicht“ im Zeitplan.
- **Datenschutz-Werkzeuge** (`includes/gdpr.php`, optional): Unter Einstellungen → Datenschutz einschaltbar („Auskunft und Löschung auf Anfrage im Kundenprofil anbieten“, standardmäßig aus). Im Kundenprofil sehen dann nur Administratoren „Alle Daten exportieren (JSON)“ (Stammdaten, alle Tickets mit Nachrichten, Anhangsnamen, Mitleser, Bewertung, Notizen; interne Notizen sind als intern gekennzeichnet, Dateiinhalte fehlen) und „Kundendaten löschen“ (Bestätigung durch Eingabe der E-Mail-Adresse; Tickets bleiben anonymisiert mit Nummer, Betreff, Status und Zeiten; Nachrichten, Dateien und Notizen des Kunden sowie das Konto werden entfernt; offene Tickets nur mit ausdrücklichem Erzwingen). Beides steht im Audit-Log. Dateien, die Mitarbeiter gesendet haben, und Namen in Mitarbeiter-Notizen oder Zitaten bleiben unberührt und sind bei Bedarf von Hand zu prüfen.
- Die englische Sprachdatei (`lang-en` 1.1.11) enthält die neuen Texte. Muster mit mehreren Treffern wählt die Übersetzung jetzt nach Länge des Schlüssels, sodass ein spezielles Muster ein allgemeineres nicht mehr überdeckt.
**Update überschreibt Dateien unabhängig vom Besitzer (Server 1.0.100):** Gehört eine Datei oder ein ganzer Ordner einem anderen Benutzer (z. B. `root`), ersetzt das Update den obersten nicht beschreibbaren Ordner samt Inhalt durch einen eigenen (umbenennen, kopieren, alten löschen; im beschreibbaren Elternordner geht das unabhängig vom Besitzer der Dateien darin). Voraussetzung: der DeskHub-Hauptordner selbst gehört dem Webserver-Benutzer. `config`, `database`, `uploads`, `backups`, `plugins` und `app_downloads` werden nie umgesetzt. Lässt sich der alte Ordner nicht löschen, bleibt er als `….alt-JJJJMMTT-HHMMSS` liegen (die Update-Meldung nennt ihn, die `.htaccess` sperrt ihn; bitte später per FTP entfernen).
**Rechte-Skript (Server 1.0.99, `tools/fix-permissions.sh`, kommt mit jedem Update mit):** Setzt Ordner auf 755, Dateien auf 644, `config/config.php` und die Datenbank auf 640 und prüft am Ende, ob der Webserver in die wichtigen Ordner schreiben darf. Aufruf auf dem Server (SSH oder beim Hoster als geplante Aufgabe): `sh tools/fix-permissions.sh --check` zeigt nur an, was nicht stimmt; `sh tools/fix-permissions.sh` setzt die Rechte; `sh tools/fix-permissions.sh BENUTZER` setzt zusätzlich den Besitzer (nur als root möglich, bei Plesk unter „Geplante Aufgaben“ als Befehl, z. B. `sh /pfad/zu/deskhub/tools/fix-permissions.sh windelweb.org_87bb9o1qa75`). Mit `--group-write` werden 775/664 gesetzt, wenn Webserver und FTP-Benutzer nur über eine Gruppe schreiben. Ändert nur Rechte und Besitzer, löscht nichts. **Nicht auf einem Linux-Server ausprobiert** (getestet nur auf Syntax und auf einer Windows-Kopie); zuerst mit `--check` ansehen.
**Ordner mit fremdem Besitzer (Server 1.0.97):** Darf der Webserver in einen Ordner nicht schreiben (er gehört einem anderen Benutzer), liegt der Ordner aber in einem beschreibbaren, ersetzt das Update ihn durch einen eigenen (Inhalt wird kopiert, der alte Ordner gelöscht oder bei Misserfolg als `.alt-…` gemeldet). Die Update-Seite zeigt außerdem den Besitzer der betroffenen Datei und des Ordners. Die Änderungen am Update-Fenster zeigt der Hinweis „Update verfügbar“ (1.0.96).
**Vorhandene `.htaccess` bleiben bei Updates erhalten (Server 1.0.95):** Hoster tragen dort eigene Zeilen ein (PHP-Version, Handler); ein Update überschreibt sie nicht mehr. Fehlt eine, wird sie aus dem Paket angelegt.
**Das Update ersetzt auch seine eigene Seite (Server 1.0.94):** `staff/update.php` wird bei einem Update als letzte Datei mit ersetzt (bisher musste sie von Hand hochgeladen werden). Fehlermeldungen zu Schreibrechten nennen jetzt Rechte und Beschreibbarkeit einer betroffenen Datei und ihres Ordners. Das Update setzt fehlende Schreibrechte an Dateien, die dem Webserver-Benutzer gehören, selbst (Server 1.0.93).
**Update meldet Schreibfehler (Server 1.0.91):** Das System-Update schreibt Dateien, die dem FTP-Benutzer gehören, über eine Hilfsdatei neu und meldet ausdrücklich, wenn Dateien oder `version.php` nicht geschrieben werden konnten (bisher zeigte es trotzdem „Update installiert“ und die Versionsnummer blieb alt). Dann Rechte der Dateien prüfen.
**Die Konfiguration bleibt bei jedem Update unangetastet (Server 1.0.90):** Aus dem Update-Paket wird nichts aus `config/` installiert (auch `config.php` nicht, in jeder Schreibweise), ebenso keine `.env`; Datenbank, Plugins, Uploads, Backups und App-Dateien ebenfalls nicht. Test: `tests/update_security.php`.
**System-Updates von der Plugin-Webseite (Server 1.0.89):** Adminportal → System-Update holt neue Versionen jetzt zuerst von der Plugin-Webseite (dieselbe Adresse und derselbe Zugangsschlüssel wie der Katalog), **Gitea bleibt Ausweichquelle**: Liefert die Plugin-Webseite nichts oder ist nicht erreichbar, erscheinen die Gitea-Releases wie bisher (auf der Seite steht, woher die Liste kommt).
- **Veröffentlichen (Herausgeber):** Plugin-Webseite → Reiter **„DeskHub-Update“** (eigener Reiter, nicht mehr unter Apps; dort stehen auch alle veröffentlichten Versionen), das Projekt-ZIP hochladen. Die Version wird aus `version.php` im Paket gelesen (eine eingetippte hat Vorrang), die Plugin-Webseite **signiert das Paket selbst** mit ihrem Signierschlüssel (Nachricht wie bei `tools/release-sign.php`); `.sig`-Datei und Gitea-Release sind dafür nicht mehr nötig. Ältere Versionen bleiben für „Bestimmte Version installieren“ erhalten (die letzten 20).
- **Installieren:** DeskHub lädt die Liste (`app-release.php?platform=server&list=1`), danach Paket (`&version=…&download=1`), prüft **SHA-256 und Signatur** (mit eingebautem Herausgeber-Schlüssel Pflicht; Paket ohne gültige Signatur oder mit falscher Prüfsumme wird abgelehnt und im Admin-Protokoll vermerkt) und installiert wie bisher mit Backup und Datenbank-Update.
- **Wichtig für die Umstellung:** Die Plugin-Webseite muss die neue Fassung haben (`app-release.php`, `inc/lib.php`, `admin.php`) und dort muss mindestens eine Version von „DeskHub-Server“ liegen, sonst nimmt DeskHub weiter Gitea. Server mit einer Version vor 1.0.89 kennen die neue Quelle nicht und müssen einmal wie bisher (Gitea oder Upload) auf 1.0.89 gebracht werden. Test: `tests/update_security.php`, `tests/plugin_website_apps.php`. **Nicht gegen die echte Plugin-Webseite ausprobiert.**
**Plugin-Updates mit einem Klick (Server 1.0.88):** „Jetzt aktualisieren“ an einem installierten Plugin installiert die neue Version aus dem Katalog sofort (Prüfsumme und Signatur wie bei der Installation), statt in den Reiter „Plugin hinzufügen“ zu springen. Im Hinweis „Updates verfügbar“ aktualisiert „Jetzt aktualisieren“ bzw. „Alle aktualisieren“ alle Plugins auf einmal; ein fehlgeschlagenes Update wird gemeldet und stoppt die anderen nicht. Test: `tests/plugins.php`.
**Apps und Sprachpaket zu den neuen Rechten (Server 1.0.87, Windows-Programm 2.12.3, Android-App 3.5.3, `lang-en` 1.1.19):**
- **Windows-Programm und Android-App** kennen alle 44 Rechte. Der **Rollen-Editor** zeigt sie in den Gruppen und mit den Beschriftungen vom Server (Fallback für ältere Server) und kreuzt für jede Rolle die **wirksamen** Rechte an (Standardwerte für Rechte, die in der Rolle noch fehlen; neue Rollen beginnen mit den Standardrechten). Bisher hätte das Speichern in der App solche Standardrechte stillschweigend abgeschaltet. Die Schnittstelle `roles.php` liefert dafür `effectivePermissions`, `permissionLabels` und `permissionGroups`.
- **Rechte wirken in den Apps wie im Web:** „E-Mails abrufen“ (`fetch_mail`), „Für alle Mitarbeiter sichtbar“ bei gespeicherten Ansichten und Berichten (`share_views`), die **Sperrliste** (`manage_banlist`, nicht mehr nur für Administratoren), die **Automatisierung** (`manage_automation`) und das **Ändern des Status der Kollegen** (`manage_availability`). Wer eines dieser Rechte hat, sieht die Verwaltung, auch ohne Administrator zu sein.
- **Englisch:** `lang-en` 1.1.19 übersetzt alle Rechte mit Erklärungen, die Rollen-Vorlagen, die Rollen-Seite, die Hilfe-Seite und viele ältere Rückfragen und Beschriftungen (3901 Texte). Die Wörterbücher von Windows-Programm und Android-App enthalten die Rechte-Texte ebenfalls. **Nicht übersetzt** bleiben Daten (Namen, Tickets), die Texte der automatischen Mails und die Handbuch-PDF. Test: `tests/lang_en_rights.php`.
- Beide Apps sind mit derselben Signatur gebaut wie bisher und lassen sich über die alte Version installieren (Android: `versionCode` 57). **Nicht auf Geräten ausprobiert:** geprüft sind die Windows-Oberflächentests (114), die Android-Unit-Tests und die Signatur des Pakets; bitte nach dem Update den Rollen-Editor und eine Rolle mit nur einem Recht auf einem echten Gerät ansehen. Die Chrome-Erweiterung (2.1.1) ist unverändert.
**Vordefinierte Rollen (Server 1.0.86, Datenbank-Update `php_0076`):** Bei Installation und Update legt DeskHub elf fertige Rollen an, die ihr wie jede andere Rolle **ändern oder löschen** könnt (Adminportal → Rollen, gekennzeichnet als „vordefiniert“): **Co-Administrator** (alle vergebbaren Rechte), **Support-Manager**, **IT / Technik**, **Teamleitung**, **Support 2nd Level**, **Support 1st Level**, **Redaktion (Wissen und Inhalte)**, **Auswertung / Controlling**, **Teamverwaltung / Schichtplanung**, **Aushilfe / Praktikant** und **Nur lesen**. Die Rechte jeder Rolle stehen in `permission_presets()` (`includes/permissions.php`) und stehen im Formular auch als „Vorlage laden“ zur Verfügung (dort zusätzlich „Mitarbeiter“ = Standardrechte). Vorhandene Rollen werden nie verändert: Gibt es schon eine Rolle gleichen Namens (Groß-/Kleinschreibung egal), bleibt sie wie sie ist. Eine gelöschte vordefinierte Rolle kommt nicht von selbst wieder; auf der Rollen-Seite legt der Knopf **„Fehlende Rollen anlegen“** (nur Administratoren) genau die fehlenden nach. Der „Co-Administrator“ ist **kein** echter Administrator: Einstellungen, Backup, System-Update, Plugins, API-Schlüssel, Webhooks, Import und Sicherheitsprüfung bleiben gesperrt. Test: `tests/default_roles.php`.
**Rechte neu geordnet (Server 1.0.85, `includes/permissions.php`):** Alle Rechte stehen in einem **Katalog** (`permission_catalog()`: Gruppe, Beschriftung, Hinweis, Standardwert, Adminportal-Bereich ja/nein). Es gibt jetzt **44 Rechte** statt 25. `default_permissions()`, `admin_section_permissions()`, die Rollen-Seite, die Mitarbeiter-Übersicht, die App-Schnittstelle (`me.php`, `roles.php`) und der Menüaufbau lesen alle aus diesem Katalog; ein neues Recht wird nur dort eingetragen.
- **Neue Rechte:** Zusammenführen und teilen, Verknüpfen, Sperrliste und Absender sperren, Tickets als CSV exportieren, E-Mails jetzt abrufen, Ansichten teilen, Berichte per E-Mail versenden, Kundenprofile ansehen (Tickets) sowie für das Adminportal: Kundenverzeichnis, Textbausteine (das bisher vorhandene Recht gilt jetzt wirklich), Ticket-Felder und Listen, Ticket-Vorlagen, Ticket-Regeln und wiederkehrende Tickets, Seiten, Sprachen, Statusseite, Mail-Warteschlange, Anmelde-Wächter ansehen, Problemmanagement, Status und Schichten der Kollegen, Hilfe und Handbuch. Bisher waren diese Seiten fest nur für echte Administratoren oder für alle offen.
- **Nichts bricht:** Eine gespeicherte Rolle behält ihre Werte. Fehlt ein **altes** Recht in einer Rolle, gilt wie bisher „nein“; fehlt ein **neues**, gilt der Standardwert (was bisher jeder durfte, bleibt erlaubt; neue Adminbereiche sind aus). Eine ältere App, die ein neues Recht nicht kennt, lässt es beim Speichern einer Rolle unverändert.
- **Sammelaktionen** in der Ticketliste prüfen jetzt die Rechte je Ticket und Abteilung (Zuweisen, Priorität, Status, Löschen, Absender sperren); bisher konnte jeder Mitarbeiter per Sammelaktion löschen.
- **Rollen-Seite:** Rechte in sieben Gruppen mit Erklärung, „Alle/Keine“ je Gruppe, Vorlagen (Mitarbeiter, Nur lesen, Teamleitung, Support-Manager), Zähler und eine **Rechte-Übersicht** (Tabelle Rolle × Recht). Wer kein Administrator ist, kann keine Rechte vergeben, die er selbst nicht hat (keine Hochstufung über Rollen).
- **Weiterhin nur echte Administratoren:** Einstellungen, Backup, System-Update, Plugins, API-Schlüssel, Webhooks, osTicket-Import, Sicherheitsprüfung, die Einstellungen des Anmelde-Wächters (inkl. „Passkeys erlauben“, Protokoll leeren) und die Datenschutz-Löschfunktionen.
- **Apps:** Die Schnittstelle liefert alle 44 Rechte, `permissionLabels` und `permissionGroups`. Das Windows-Programm zeigt die Beschriftungen vom Server an; im Rollen-Editor der Android-App erscheinen die neuen Rechte erst mit einer neuen App-Version (bis dahin bleiben sie beim Speichern erhalten). Tests: `tests/permissions.php`, `tests/permissions_web.php`.
**Hilfe-Seite für Administratoren mit Handbuch (Server 1.0.84, `staff/help.php`, `includes/manual_file.php`):** Adminportal → **System → Hilfe** (nur echte Administratoren, auch Co-Admins sehen sie nicht). Die Seite hat das **Handbuch (PDF)** zum Herunterladen mit Größe, Stand, Version und SHA-256-Prüfsumme, eine **Kurzhilfe** („Erste Schritte“ mit Sprungmarken, „Wenn etwas nicht funktioniert“) und die Daten dieser Installation (Version, PHP, Website-URL). Das Handbuch **kommt mit dem Update**: Die Datei `docs/DeskHub-Handbuch.pdf` gehört zum Programmpaket (der Ordner `docs/` ist für den Webserver gesperrt, ausgeliefert wird sie nur über die Hilfe-Seite an Administratoren). Es gibt deshalb keinen Upload. Das System-Update installiert diese eine Datei (alle anderen Dateien in `docs/` werden wie bisher übersprungen, Regel in `update_path_is_skipped()`). **Beim Veröffentlichen einer Version** die aktuelle Fassung aus `release/DeskHub-Handbuch.pdf` (erzeugt mit `tools/manual/`) nach `DeskHub-Webseite/docs/DeskHub-Handbuch.pdf` kopieren; fehlt sie, zeigt die Seite „nicht vorhanden“. Die Datei ist rund 18 MB und vergrößert das Update-Paket entsprechend. Test: `tests/help_page_web.php`.
**Neues Mail-Design (Server 1.0.80, `includes/mailer.php`):** Alle System-Mails (Ticket erstellt, neue Antwort, neues Ticket, SLA überschritten, Chat-Verlauf, Erinnerung, Passwort zurücksetzen, Anmelde-Wächter, Abmelden, Zufriedenheit u. a.) haben einen neuen Rahmen: breiterer Kopf mit Name oder **Logo** (das Firmenlogo aus Einstellungen → Design, wenn eine https-Adresse oder ein Pfad auf dem Server gesetzt ist; „Name neben dem Logo ausblenden“ gilt auch hier), Überschrift je Mail, Ticketnummer als **volle Karte mit Farbbalken**, Antworttext als Zitatkasten, ein **großer Knopf** (in Outlook als echter Knopf über VML, sonst als abgerundeter Link) und eine ruhige Fußzeile. Der Aufbau ist tabellenbasiert mit Inline-Styles und 600 px Breite, die auf dem Handy schrumpft; Flexbox, `<style>`-Blöcke und `position` werden bewusst nicht benutzt, weil Outlook sie ignoriert. Vom Admin angepasste Vorlagentexte (Adminportal → E-Mail-Vorlagen) bekommen automatisch den neuen Rahmen. Neue Bausteine: `email_h()`, `email_quote()`, `email_small()`. Vorschau mit Beispieldaten: `DESKHUB_TESTS_FORCE_SQLITE=1 php tools/mail_preview.php > vorschau.html`. Test: `tests/mail_design.php`. **Nicht in echtem Outlook, Gmail und auf dem Handy ausprobiert:** gerendert und geprüft ist der Aufbau in einem Browser; bitte einmal die Test-Mail unter Einstellungen → E-Mail und eine Ticket-Bestätigung in euren Mailprogrammen ansehen. Ein Dunkelmodus wird nicht eigens gestaltet (Mailprogramme färben automatisch um). Mails von Plugins (zum Beispiel Tagesbericht) behalten ihr eigenes Aussehen.
**Gelöst und Geschlossen sind beide „erledigt“ (Server 1.0.78):** Für ein gelöstes oder geschlossenes Ticket läuft keine SLA mehr und es kommt nichts mehr von DeskHub:
- **Anzeige:** In der Ticketliste, im Dashboard, in der Ticketansicht und in den Apps (Windows, Android, über das Feld `dueLabel`) steht bei erledigten Tickets keine Fälligkeit mehr („–“ bzw. „✓ erledigt“) und nie „überfällig“. Bisher zeigte die Spalte „Fällig“ bei geschlossenen Tickets noch „in 36 Std“ oder „vor 9 Std (überfällig)“. Die Apps brauchen dafür keine neue Version.
- **Beim Erledigen:** Der Überfällig-Merker und eine Wiedervorlage des Tickets werden entfernt (bei „gelöst“ wie bei „geschlossen“).
- **Keine Meldungen:** SLA-Überschreitung, Eskalationsregeln und die Erinnerung „Ticket wartet auf Antwort“ erfassten erledigte Tickets schon nicht mehr (jetzt mit Test abgesichert). Neu: Eine noch eingetragene **Wiedervorlage** eines erledigten Tickets löst keine Benachrichtigung „Wiedervorlage fällig“ mehr aus, sie wird still entfernt. Öffnet der Kunde ein erledigtes Ticket wieder, beginnt die SLA wie bisher neu. Tests: `tests/ticket_done.php`, `tests/ticket_done_web.php`.
**Passkeys für die Anmeldung der Mitarbeiter (Server 1.0.77, Datenbank-Update `php_0075`, `includes/webauthn.php`, `staff/passkey.php`, `assets/js/passkey.js`):** Mitarbeiter melden sich im Browser ohne Passwort an: Auf der Anmeldeseite steht **„🔑 Mit Passkey anmelden“** (Fingerabdruck, Gesicht, Geräte-PIN, Windows Hello, Handy oder Sicherheitsschlüssel). Ein Passkey verlangt immer die Nutzerprüfung des Geräts und ersetzt deshalb Passwort **und** 2FA-Code; Passwort und 2FA bleiben als Rückfall bestehen.
- **Einrichten:** Profil → Sicherheit → Karte „Passkeys“: Name eintragen, das **Passwort bestätigen** (damit niemand mit einer offenen fremden Sitzung dauerhaft einen eigenen Zugang einträgt) und „Passkey einrichten“. Mehrere Passkeys je Mitarbeiter sind möglich, die Liste zeigt Name, Datum und „zuletzt benutzt“; Entfernen verlangt wieder das Passwort.
- **Administrator entfernt Passkeys:** Mitarbeiterverwaltung → Menü **⋯** → **„Passkeys entfernen (n)“** (der Eintrag erscheint nur, wenn der Mitarbeiter Passkeys hat; in der Zeile steht „🔑 n Passkeys“). Das löscht alle Passkeys dieses Mitarbeiters, schreibt Admin-Protokoll und Anmelde-Wächter („Passkey entfernt“) und schickt dem Mitarbeiter eine Mail; er kann sich weiter mit Passwort (und 2FA) anmelden und neue Passkeys einrichten. Mit „Das war ich nicht“ und beim Löschen eines Mitarbeiters werden Passkeys ebenfalls gelöscht. Das Recht „Mitarbeiter verwalten“ genügt.
- **Ein- und ausschalten (ab Server 1.0.79):** Adminportal → **Anmelde-Wächter** → Einstellungen → **„Passkeys erlauben“**. Ausgeschaltet verschwindet der Knopf auf der Anmeldeseite und Anmeldungen mit Passkey werden abgelehnt; vorhandene Passkeys bleiben gespeichert und gelten wieder, sobald ihr es einschaltet.
- **Beim Mitarbeiter entfernen (ab Server 1.0.79):** Adminportal → **Mitarbeiter** → bei der Person **Bearbeiten**: Unter dem Formular steht die Karte **„🔑 Passkeys von …“** mit allen Passkeys (Name, Datum, zuletzt benutzt), **Entfernen** je Passkey und **„Alle Passkeys entfernen“**. Alternativ in der Liste über das Menü **⋯**.
- Der Knopf „Mit Passkey anmelden“ steht im selben Block wie die Knöpfe der Anmelde-Plugins (zum Beispiel authentik), mit gleicher Gestaltung und einem Schlüssel-Symbol.
- **Subdomain (ab Server 1.0.81):** Wird DeskHub unter einer Subdomain der Website-URL aufgerufen (Website-URL `https://beispiel.de`, aufgerufen unter `https://support.beispiel.de`), gilt für den Passkey die Adresse, unter der die Seite gerade aufgerufen wird (`support.beispiel.de`). Sie erscheint auch im Dialog des Browsers; **den Namen und das Symbol im Dialog bestimmt der Browser, nicht DeskHub** (Chrome und Windows zeigen die Domain und ein eigenes Symbol). Welche Adresse gilt, entscheidet in dieser Reihenfolge der `Origin`-Kopf des Browsers (zuverlässig auch hinter einem Reverse-Proxy, der den Host-Kopf umschreibt; ab Server 1.0.83), `X-Forwarded-Host` (nur von vertrauenswürdigen Proxys) und der `Host`-Kopf. Im Profil steht unter „Passkeys“, für welche Domain sie gelten. Fremde Domains werden ignoriert, dann gilt die Website-URL. Ein Passkey gilt nur für genau diese Domain; wer ihn unter einer anderen Subdomain angelegt hat, richtet dort einen neuen ein.
- **Voraussetzungen:** Die **Website-URL** (Einstellungen → Anzeigename & URL) muss mit `https://` beginnen und die Adresse sein, unter der der Mitarbeiterbereich aufgerufen wird; Passkeys gelten nur für diese Domain, ein Domainwechsel macht sie ungültig. Unterstützt werden ES256 und RS256; geprüft wird ohne Fremdbibliothek mit PHP und OpenSSL (Attestation „none“, es wird nicht geprüft, von welchem Gerätetyp der Passkey stammt).
- **Schutz:** Challenge nur einmal und höchstens 5 Minuten gültig, Prüfung von Herkunft, Domain und Signatur, Zähler gegen kopierte Passkeys (bei Geräten, die immer 0 melden, entfällt er), Begrenzung der Versuche je IP-Adresse, Konto muss aktiv sein; Anmeldungen laufen durch den Anmelde-Wächter (neues Gerät, Protokoll).
- **Grenzen:** Passkeys gibt es nur in der **Weboberfläche** des Mitarbeiterbereichs. Windows-Programm, Android-App und Chrome-Erweiterung melden sich weiter mit Passwort (und 2FA) an. Kunden im Portal haben keine Passkeys. **Nicht an echten Geräten ausprobiert:** geprüft ist der Ablauf mit einem nachgebauten Authenticator (`tests/passkey.php`, `tests/passkey_web.php`); bitte nach dem Einrichten einmal mit Windows Hello oder dem Handy registrieren und anmelden. Die englische Sprachdatei `lang-en` 1.1.18 enthält die neuen Texte (Fehlermeldungen des Geräts erscheinen auf Deutsch).
**Neue Mitarbeiter-Übersicht (Server 1.0.75, `staff/staff_manage.php`):** Statt einer schlichten Tabelle zeigt die Liste je Mitarbeiter Avatar (oder Initialen), Name und E-Mail, die **Rolle** (Administrator, eigene Rolle oder Mitarbeiter, dazu „🔒 2FA an“), **Abteilung** samt weiteren Abteilungen und Teams, die Zahl der **offenen Tickets**, **zuletzt aktiv** (mit grünem Punkt bei „online“, bis 5 Minuten) und den **Status** (Aktiv, Deaktiviert, Im Urlaub, „Anmeldung zeitweise gesperrt“). Oben stehen Filter (Alle, Administratoren, Mitarbeiter, Deaktiviert, Gesperrt, jeweils mit Zahl) und ein Suchfeld, das nach Name, E-Mail, Abteilung und Rolle filtert. Rechts gibt es **Bearbeiten** und das Menü **⋯** mit „Sperre aufheben“ (nur bei gesperrter Anmeldung), „Überall abmelden“ und „Löschen“ (nicht beim eigenen Konto). Auf schmalen Bildschirmen blendet die Liste „Offene Tickets“ und „Zuletzt aktiv“ aus. Das Menü **⋯** schwebt frei über der Seite (ab Server 1.0.76) und öffnet bei wenig Platz nach oben, damit es auch bei wenigen Mitarbeitern nicht abgeschnitten wird.
**Anmeldesperre: bekannte Geräte, Sperre aufheben (Server 1.0.74):** Nach zu vielen falschen Anmeldeversuchen (Standard 5, einstellbar im Anmelde-Wächter) ist das **Konto** für 15 Minuten gesperrt; zusätzlich gilt ein Limit je **IP-Adresse** (10 Versuche in 15 Minuten). Das ist keine dauerhafte Sperre, sie endet von selbst. Neu:
- **Bekannte Geräte bleiben anmeldbar:** Ein Browser, den der Anmelde-Wächter bei einer früheren Anmeldung gemerkt hat (Cookie `dh_device`), wird von der Kontosperre nicht ausgesperrt, wenn das Passwort stimmt. Damit kann niemand, der nur die E-Mail-Adresse kennt, den echten Mitarbeiter durch Fehlversuche dauerhaft aussperren. Die Sperre je IP-Adresse gilt auch für bekannte Geräte; für Apps gilt die Ausnahme nicht (ihre Kennung ist frei wählbar).
- **Sperre aufheben:** Administratoren sehen in der Mitarbeiterverwaltung „Anmeldung zeitweise gesperrt“ und den Knopf **„Sperre aufheben“** (auch an Sperr-Einträgen im Anmelde-Wächter). Das löscht die Fehlversuch-Zähler für Web, App und 2FA-Code dieses Kontos; die IP-Sperre bleibt.
- **„Passwort vergessen“ hebt die Sperre auf:** Wer das Passwort über den Link aus der Mail zurücksetzt, hat sich als Besitzer des Postfachs ausgewiesen; die Sperre endet damit.
Jedes Aufheben steht im Anmelde-Wächter („Sperre aufgehoben“) und im Admin-Protokoll.
**Von allen Geräten abmelden (Server 1.0.73, `includes/signout.php`):** Beendet alle Anmeldungen eines Mitarbeiters auf einmal: Browser-Sitzungen (über den Widerrufs-Zeitpunkt, den `current_staff()` prüft), die Anmeldungen der Apps (Android, Windows-Programm, Chrome-Erweiterung: ihre Tokens werden gelöscht, die Programme fordern danach die Anmeldung neu an), Browser-Push und Android-Push-Geräte sowie die Ticket-Sperren und laufende Zeiterfassung des Mitarbeiters. Das Passwort bleibt unverändert. Zwei Wege: **Profil → Sicherheit → „Von allen Geräten abmelden“** (wahlweise „alle anderen“, dann bleibt die aktuelle Sitzung, oder „auch hier“; die angemeldeten Apps werden dort aufgelistet) und für Administratoren **Mitarbeiterverwaltung → „Überall abmelden“** (der Mitarbeiter bekommt eine Mail). Jeder Vorgang steht im Anmelde-Wächter („Überall abgemeldet“) und im Admin-Protokoll. Ein normaler Mitarbeiter kann niemand anderen abmelden. Eine Anmeldung, die nach der Abmeldung erfolgt, gilt wieder.
**SLA-Überschreitung: nur Administratoren, wieder geöffnete Tickets starten neu (Server 1.0.72):**
- **Wer benachrichtigt wird:** Einstellungen → Allgemein → „Bei überschrittener SLA-Frist benachrichtigen“. Neu ist **„Nur die Administratoren (per E-Mail)“** und der Standard: Dann geht die Mail „SLA überschritten“ nur an die aktiven Administratoren (bei Urlaub an die Vertretung), weder an den Bearbeiter oder die Abteilung noch als Push in die Android-App. „Bearbeiter bzw. Abteilung (E-Mail und Push in der App)“ stellt das frühere Verhalten wieder her.
- **Wieder geöffnete Tickets:** Wird ein gelöstes oder geschlossenes Ticket wieder geöffnet (zum Beispiel weil der Kunde antwortet oder ein Mitarbeiter den Status zurücksetzt), beginnt die SLA neu: Die Lösungsfrist wird mit den Zeiten der Priorität bzw. des SLA-Plans ab jetzt berechnet, die Markierung „überfällig“ verschwindet, im SLA-Verlauf steht „SLA neu gestartet“. Vorher galt die alte, längst abgelaufene Frist, und das Ticket löste sofort „SLA überschritten“ aus.
- Gelöste und geschlossene Tickets zeigen in der Ticketliste und in der Ticketansicht nie „überfällig“.
**Screenshot einfügen, Erinnerung bei wartenden Tickets, „Meine Woche“ (Server 1.0.71, Datenbank-Update `php_0074`):**
- **Bilder einfügen:** Im Antwortfeld eines Tickets setzt `Strg + V` einen Screenshot oder ein kopiertes Bild direkt in die Antwort; auch Ziehen einer Bilddatei in das Feld geht. Das Bild wird über denselben Weg hochgeladen wie der Bildknopf (PNG, JPG, GIF, höchstens 5 MB) und als Bild in der Mail an den Kunden angezeigt. Enthält die Zwischenablage Text (zum Beispiel aus Word), bleibt das normale Einfügen. Die Dateien liegen unter `uploads/` mit zufälligem Namen und sind über ihre Adresse öffentlich abrufbar, wie die Bilder in Signaturen.
- **Erinnerung an den Bearbeiter** (`includes/wait_reminders.php`, im Hintergrundjob „SLA-Prüfung“ alle 15 Minuten): Wartet ein Ticket, das jemandem zugewiesen ist, seit einstellbar vielen **Arbeitsstunden** (Standard 4) auf die Antwort und ist die SLA-Frist noch nicht gerissen, bekommt der Bearbeiter einen Push in der Android-App und im Browser, auf Wunsch zusätzlich eine Mail. Pro Kundennachricht gibt es eine Erinnerung; nicht zugewiesene, beantwortete, zurückgestellte, SLA-pausierte und überfällige Tickets sowie Spam und von Mitarbeitern angelegte Tickets zählen nicht. Die Arbeitszeit folgt den Geschäftszeiten und Feiertagen aus den SLA-Einstellungen. Einstellungen → Allgemein: „Bearbeiter erinnern …“. Jeder Mitarbeiter kann die Push-Art „Ticket wartet auf meine Antwort“ in seinen Push-Einstellungen abschalten.
- **Meine Woche** (`staff/my_week.php`, Menüpunkt in der Seitenleiste, nur für den Mitarbeiter selbst): gelöste Tickets, gesendete Antworten (ohne interne Notizen), durchschnittliche Zeit bis zur ersten Antwort (nur Tickets, bei denen die erste öffentliche Antwort von dir kam; Arbeitszeit, wenn Geschäftszeiten eingerichtet sind), pünktlich gelöst (vor Ablauf der Lösungsfrist) und, wenn die Zufriedenheitsabfrage eingeschaltet ist, die Bewertung deiner Tickets. Dazu je ein Vergleich mit dem gleich langen Zeitraum davor, ein Balkendiagramm „Gelöst pro Tag“ und was gerade bei dir offen ist. Zeiträume: diese und letzte Woche, dieser und letzter Monat.
**Zähler in Chrome-Erweiterung und Windows-Programm zeigt den echten Stand (Server 1.0.69, Chrome 2.1.1, Windows 2.12.1):** Bisher zählten beide Programme neue Ereignisse nur auf und leerten den Zähler erst beim Öffnen. Jetzt berechnet der Server (`includes/ticket_attention.php`, Antwortfeld `attention` in `api/staff/v1/activity.php`), wie viele Tickets **jetzt** Aufmerksamkeit brauchen: offen (unbeantwortet), noch niemandem zugewiesen oder dir zugewiesen, nicht zurückgestellt, kein Spam und seit der letzten Kundennachricht von dir nicht geöffnet. Öffnen, Beantworten, Schließen, Zuweisen an jemand anderen oder Zurückstellen nimmt ein Ticket beim nächsten Abruf aus dem Zähler, auch wenn das in der Weboberfläche oder in einem anderen Programm geschah. Benachrichtigt wird nur für Tickets, die neu dazukommen. Gemerkt wird das Öffnen in der Tabelle `ticket_acks` (Datenbank-Update `php_0072`). Die Chrome-Erweiterung fragt alle 30 Sekunden ab (Chrome ab 120, ältere jede Minute), das Windows-Programm standardmäßig alle 30 Sekunden (einstellbar), außerdem sofort beim Zurückkehren zum Fenster und kurz nach einer Änderung am Ticket. Ältere Server ohne `attention` funktionieren mit den neuen Programmen weiter (wie bisher aufsummierend).
**E-Mail-Abruf und Nachladen in den Apps (Windows 2.12.0, Android 3.5.0):** Beide Apps haben den Knopf **„📥 E-Mails abrufen“** (Kopfleiste bzw. Ticketliste) und bei E-Mail-Tickets **„📎 Anhänge laden“**. Die Schnittstellen dazu: `POST api/staff/v1/mail_fetch.php` (liefert `ok`, `level`, `message`, `processed`, `newTickets`, `replies`) und `POST api/staff/v1/ticket_mail_reload.php` mit `{"number": "…"}` (Recht „Antworten“; liefert `added`, `inlineImages`, `formatting`, `skipped`, `alreadyThere`, `failed`). Eingebettete Bilder stehen nicht in der Anhangliste von `ticket.php`. In den Apps steht außerdem „Apps und Downloads“ unter den Seiten der Weboberfläche.
**E-Mail-Abruf von Hand (ab Server 1.0.67):** In der Ticketliste gibt es oben den Knopf **„📥 E-Mails jetzt abrufen“** (sichtbar, sobald ein Postfach eingerichtet ist). Er startet denselben Abruf wie der Cronjob und meldet danach, wie viele Mails verarbeitet wurden (neue Tickets, Antworten) oder was schiefging (zum Beispiel falsches Passwort). Damit nichts doppelt läuft, gilt eine Sperre von 20 Sekunden: Ein zweiter Klick, ein gleichzeitig laufender Zeitgeber oder ein anderer Mitarbeiter bekommen dann nur den Hinweis „lief gerade eben schon“. Der Abruf von Hand setzt den Zeitpunkt des letzten Abrufs, der automatische Abruf wartet danach wieder sein übliches Intervall. Wer will, sieht den letzten Abruf, wenn er mit der Maus über den Knopf fährt. Der Vorgang steht im Admin-Protokoll. (Einstellungen → Cron-Jobs gibt es weiterhin für Administratoren.)
**Antworten werden Tickets zugeordnet (ab Server 1.0.67):** Eine eingehende Mail wird als Antwort an ein bestehendes Ticket gehängt, wenn (1) im Betreff die DeskHub-Nummer steht (`[#260101-0001]`, wie bisher), (2) eine andere Nummer im Betreff steht, die es als Ticketnummer gibt (zum Beispiel aus einem früheren Ticketsystem, `[#923425]`), oder (3) die Kopfzeilen `In-Reply-To`/`References` eine DeskHub-Mail nennen. Dazu bekommt jede ausgehende Mail zu einem Ticket eine Message-ID mit der Ticketnummer (`<deskhub.NUMMER.zufall@domain>`), die das Mailprogramm des Kunden in der Antwort mitschickt; so funktioniert die Zuordnung auch, wenn der Kunde den Betreff ändert. Bei (2) und (3) muss der Absender zum Ticket gehören (Auftraggeber oder früherer Verfasser einer Nachricht), damit niemand mit einer geratenen Nummer fremden Tickets Nachrichten unterschieben kann. Im Abruf-Protokoll steht, worüber die Antwort zugeordnet wurde.
**Zitierter Verlauf wird eingeklappt (ab Server 1.0.67):** In der Ticketansicht steht der eigene Text einer Mail oben; der zitierte Verlauf früherer Mails (Outlook-Linie mit „Von/Gesendet/An/Betreff“, „Am … schrieb …:“, „On … wrote:“, „-----Ursprüngliche Nachricht-----“, `>`-Zitate) ist hinter **„▶ Verlauf anzeigen“** zugeklappt. Besteht eine Mail nur aus Zitat oder Weiterleitung, bleibt sie vollständig sichtbar.
**Mehr Dateiendungen für Mail-Anhänge (ab Server 1.0.67):** Unter Einstellungen → Uploads gibt es zusätzlich zur Liste der erlaubten Endungen die Liste **„Zusätzlich erlaubt für Anhänge eingehender E-Mails“** (Standard: `doc, xls, ppt, pptx, odt, ods, odp, csv, rtf, msg, heic, webp`). Sie gilt nur für Mails, nicht für das Formular. Gefährliche Typen bleiben immer gesperrt.
**E-Mails mit Formatierung und Bildern (ab Server 1.0.67, braucht das Datenbank-Update `php_0070`):** Bei Mails mit HTML-Teil zeigt das Ticket die Nachricht so, wie sie ankam: Absätze, fett, Überschriften, Listen, Tabellen und Links. Bilder, die in der Mail stecken (Logos, Signaturbilder, eingefügte Fotos), werden gespeichert und im Text gezeigt, aber nicht als Anhang aufgelistet. Weitergeleitete Mails (angehängte `.eml`) kommen als Anhang mit dem Betreff als Namen. Bilder, die nur als Link auf eine fremde Webseite verweisen, werden **nicht geladen** (Datenschutz: sonst erführe der Absender, wann und von wo das Ticket geöffnet wurde). Statt dessen steht ein Hinweis über der Nachricht mit dem Link **„Bilder jetzt laden“**: Er lädt die Bilder nur für diese eine Ansicht (die Sicherheitsrichtlinie der Seite wird für diesen Aufruf erweitert, es wird kein Verweis auf das Ticket mitgeschickt); beim nächsten Öffnen sind sie wieder aus. Gespeichert wird nur eine bereinigte HTML-Fassung ohne Skripte, Stilblöcke und Formulare; der Nur-Text bleibt für Benachrichtigungen, Regeln und Suche erhalten. Ohne das Datenbank-Update verhält sich alles wie bisher (nur Text).
**Anhänge von Mails (ab Server 1.0.67):** Anhänge einer eingehenden Mail werden an die Nachricht im Ticket gehängt, bei neuen Tickets ebenso wie bei Antworten. Es gelten dieselben Regeln wie beim Hochladen: erlaubte Endungen (Einstellungen → Uploads) und die maximale Größe; Skripte und ausführbare Dateien bleiben gesperrt. Eingebettete Signaturbilder (Logos) zählen nicht als Anhang. Was nicht übernommen wird, steht im Verlauf des Tickets („Anhang aus E-Mail nicht übernommen: …“) und im Abruf-Protokoll. Für Mails, die vor diesem Update abgerufen wurden (oder deren Anhang damals nicht übernommen werden konnte), gibt es im Ticket den Knopf **„📎 Anhänge und Bilder aus E-Mail laden“**: DeskHub sucht die Original-Mail im Postfach (über die gespeicherte UID, sonst die Message-ID), hängt Anhänge und eingebettete Bilder an die passende Nachricht, trägt die Formatierung nach und speichert nichts doppelt. Das geht, solange die Mail noch im Postfach liegt (auch im Archiv- oder Spam-Ordner, in den DeskHub sie verschoben hat); wurde sie gelöscht, kommt eine Meldung. Der Knopf braucht das Recht „Antworten“.
Pro Postfach legt ihr fest, was mit einer verarbeiteten Mail passiert: als gelesen markieren (Voreinstellung und sicherste Wahl), in einen Ordner verschieben oder löschen. Pro Postfach legt ihr fest, was mit einer verarbeiteten Mail passiert: als gelesen markieren (Voreinstellung und sicherste Wahl), in einen Ordner verschieben oder löschen.
--- ---
@@ -426,7 +528,7 @@ Windows-Programm (ab 2.9.0) und Android-App (ab 3.3.0) gibt es auf **Deutsch und
- **Zufriedenheitsabfrage (CSAT):** Einstellungen → Allgemein → „Zufriedenheitsabfrage“. Nach dem Schließen oder Lösen eines Tickets (Wartezeit einstellbar, Standard 30 Minuten) bekommt der Kunde eine Mail mit fünf Sternen; ein Klick öffnet `csat.php`, gespeichert wird erst mit dem Knopf (so zählen automatische Link-Prüfungen nicht). Pro Ticket genau eine Abfrage, nur für Tickets, die nach dem Einschalten geschlossen werden; kein Spam, kein Live-Chat. Der Versand läuft über den Hintergrunddienst (`cron/send_csat.php`, alle 5 Minuten). Die Bewertung steht im Ticket (Web, App, Windows-Programm); die Auswertung (Durchschnitt, Rücklaufquote, Verteilung, nach Mitarbeiter, letzte Kommentare) auf der Übersicht im Web, im Windows-Programm unter Berichte und im Dashboard der App. Schnittstelle: `GET api/staff/v1/csat.php?days=30`. - **Zufriedenheitsabfrage (CSAT):** Einstellungen → Allgemein → „Zufriedenheitsabfrage“. Nach dem Schließen oder Lösen eines Tickets (Wartezeit einstellbar, Standard 30 Minuten) bekommt der Kunde eine Mail mit fünf Sternen; ein Klick öffnet `csat.php`, gespeichert wird erst mit dem Knopf (so zählen automatische Link-Prüfungen nicht). Pro Ticket genau eine Abfrage, nur für Tickets, die nach dem Einschalten geschlossen werden; kein Spam, kein Live-Chat. Der Versand läuft über den Hintergrunddienst (`cron/send_csat.php`, alle 5 Minuten). Die Bewertung steht im Ticket (Web, App, Windows-Programm); die Auswertung (Durchschnitt, Rücklaufquote, Verteilung, nach Mitarbeiter, letzte Kommentare) auf der Übersicht im Web, im Windows-Programm unter Berichte und im Dashboard der App. Schnittstelle: `GET api/staff/v1/csat.php?days=30`.
- **Cc und Beobachter:** Beobachter (Mitarbeiter) und Cc-Empfänger (E-Mail, bekommen die öffentlichen Antworten in Kopie) gab es im Web; jetzt auch in App und Windows-Programm (Karte „Beobachter und Cc“ im Ticket). Schnittstelle: `POST api/staff/v1/ticket_collaborators.php` (`add`/`remove`), `ticket.php` liefert `collaborators`, `followers` und `csat`. - **Cc und Beobachter:** Beobachter (Mitarbeiter) und Cc-Empfänger (E-Mail, bekommen die öffentlichen Antworten in Kopie) gab es im Web; jetzt auch in App und Windows-Programm (Karte „Beobachter und Cc“ im Ticket). Schnittstelle: `POST api/staff/v1/ticket_collaborators.php` (`add`/`remove`), `ticket.php` liefert `collaborators`, `followers` und `csat`.
- **Statusseite:** Adminportal → Statusseite (Dienste mit Zustand In Betrieb/Wartung/Eingeschränkt/Ausfall, Störungsmeldungen mit Updates). Öffentlich unter `/status.php` (Link „Status“ im Kundenbereich, wenn eingeschaltet). Dienste können deaktiviert werden; dann werden sie ausgeblendet und nicht weiter geprüft. Der Minecraft-Java-Eintrag wird der Kategorie „Apps“ zugeordnet; als Prüfziel sind Domain oder IP mit Port möglich (z. B. `play.example.de:25565` oder `203.0.113.10:25565`). Danach den Dienst aktivieren. Die **Plugin-Webseite** (offizieller Katalog) lässt sich als Dienst „Plugin-Webseite“ überwachen: Mit „Fehlende Standarddienste wiederherstellen“ wird er angelegt (nur wenn in `includes/catalog_defaults.php` ein Katalog eingetragen ist), geprüft wird das `health.php` neben dem Katalog (Prüfart „Plugin-Webseite“, auch am Namen automatisch erkannt). Er ist **intern**: Er wird geprüft und ist für Mitarbeiter sichtbar (Kategorie „Server & Datenbank“), steht aber nicht auf der öffentlichen Statusseite und ändert deren Gesamtzustand nicht. Mit „Intern machen“ / „Öffentlich machen“ lässt sich das für jeden Dienst umstellen (braucht das Datenbank-Update, Migration `php_0069`). Eine Meldung kann den Dienst gleich umstellen; „Behoben“ setzt ihn zurück, solange keine andere Meldung offen ist. In App und Windows-Programm unter Verwaltung → Statusseite (Zustände ändern und Meldungen veröffentlichen nur als Administrator). Schnittstelle: `api/staff/v1/status.php`. - **Statusseite:** Adminportal → Statusseite (Dienste mit Zustand In Betrieb/Wartung/Eingeschränkt/Ausfall, Störungsmeldungen mit Updates). Öffentlich unter `/status.php` (Link „Status“ im Kundenbereich, wenn eingeschaltet). Dienste können deaktiviert werden; dann werden sie ausgeblendet und nicht weiter geprüft. Der Minecraft-Java-Eintrag wird der Kategorie „Apps“ zugeordnet; als Prüfziel sind Domain oder IP mit Port möglich (z. B. `play.example.de:25565` oder `203.0.113.10:25565`). Danach den Dienst aktivieren. Die **Plugin-Webseite** (offizieller Katalog) lässt sich als Dienst „Plugin-Webseite“ überwachen: Mit „Fehlende Standarddienste wiederherstellen“ wird er angelegt (nur wenn in `includes/catalog_defaults.php` ein Katalog eingetragen ist), geprüft wird das `health.php` neben dem Katalog (Prüfart „Plugin-Webseite“, auch am Namen automatisch erkannt). Er ist **intern**: Er wird geprüft und ist für Mitarbeiter sichtbar (Kategorie „Server & Datenbank“), steht aber nicht auf der öffentlichen Statusseite und ändert deren Gesamtzustand nicht. Mit „Intern machen“ / „Öffentlich machen“ lässt sich das für jeden Dienst umstellen (braucht das Datenbank-Update, Migration `php_0069`). Fällt ein überwachter Dienst aus (zwei Prüfungen hintereinander) oder läuft wieder, bekommen die **Administratoren eine E-Mail und eine Push-Nachricht** (höchstens eine je Dienst und Richtung innerhalb von 10 Minuten; auch bei internen Diensten). Abschaltbar unter Statusseite → Einstellungen. Eine Meldung kann den Dienst gleich umstellen; „Behoben“ setzt ihn zurück, solange keine andere Meldung offen ist. In App und Windows-Programm unter Verwaltung → Statusseite (Zustände ändern und Meldungen veröffentlichen nur als Administrator). Schnittstelle: `api/staff/v1/status.php`.
- **Ticket-Vorlagen:** Adminportal → Ticket-Vorlagen (Name, Betreff, Text, Abteilung, Hilfethema, Priorität; „für Kunden sichtbar“ zeigt sie auf „Neues Ticket“). Mitarbeiter wählen sie beim Anlegen eines Tickets im Web, im Windows-Programm und in der App (`GET api/staff/v1/ticket_templates.php`). Gepflegt werden die Vorlagen nur im Web. - **Ticket-Vorlagen:** Adminportal → Ticket-Vorlagen (Name, Betreff, Text, Abteilung, Hilfethema, Priorität; „für Kunden sichtbar“ zeigt sie auf „Neues Ticket“). Mitarbeiter wählen sie beim Anlegen eines Tickets im Web, im Windows-Programm und in der App (`GET api/staff/v1/ticket_templates.php`). Gepflegt werden die Vorlagen nur im Web.
## Weboberfläche aus den Apps öffnen ## Weboberfläche aus den Apps öffnen
@@ -596,6 +698,7 @@ Im Ordner `chrome-erweiterung/` liegt eine Erweiterung für Chrome, Edge und Bra
- **Installieren:** `chrome://extensions` → Entwicklermodus → „Entpackte Erweiterung laden“ → Ordner `chrome-erweiterung` (eine ältere Version vorher entfernen). Anmelden mit Server-Adresse, E-Mail und Passwort (bei Authenticator mit Code). Es gibt **keine Rückfrage** und keinen zweiten Anmeldeschritt: Der Serverzugriff steht im Manifest. - **Installieren:** `chrome://extensions` → Entwicklermodus → „Entpackte Erweiterung laden“ → Ordner `chrome-erweiterung` (eine ältere Version vorher entfernen). Anmelden mit Server-Adresse, E-Mail und Passwort (bei Authenticator mit Code). Es gibt **keine Rückfrage** und keinen zweiten Anmeldeschritt: Der Serverzugriff steht im Manifest.
- **Sicherheit:** Nur HTTPS, keine Cookies, keine Weiterleitungen; das Token liegt nur im lokalen Speicher der Erweiterung, Abmelden sperrt es auf dem Server und löscht lokale Entwürfe. Der Manifest-Zugriff gilt für alle HTTPS-Adressen, der Code verbindet sich aber nur mit dem angemeldeten Server. - **Sicherheit:** Nur HTTPS, keine Cookies, keine Weiterleitungen; das Token liegt nur im lokalen Speicher der Erweiterung, Abmelden sperrt es auf dem Server und löscht lokale Entwürfe. Der Manifest-Zugriff gilt für alle HTTPS-Adressen, der Code verbindet sich aber nur mit dem angemeldeten Server.
- **Update-Hinweis (ab 2.1.0):** Die Erweiterung fragt alle 6 Stunden den Server, ob in der Plugin-Webseite (Apps → Chrome-Erweiterung) eine neuere Version liegt. Dann erscheint eine Benachrichtigung (einmal je Version) und auf der Startseite ein Hinweis mit „Download-Seite öffnen“ (Seite „Apps“ der Weboberfläche). Aktualisieren bleibt Handarbeit: ZIP laden, in denselben Ordner entpacken, unter `chrome://extensions` neu laden.
- **Grenzen:** Meldungen nur bei geöffnetem Browser; Anhänge werden angezeigt, zum Herunterladen das Ticket im Browser öffnen. Ein Ticket zu öffnen sperrt es für andere (wie in der Weboberfläche). Nicht im Chrome Web Store; `node pack.mjs` erzeugt ein ZIP dafür. - **Grenzen:** Meldungen nur bei geöffnetem Browser; Anhänge werden angezeigt, zum Herunterladen das Ticket im Browser öffnen. Ein Ticket zu öffnen sperrt es für andere (wie in der Weboberfläche). Nicht im Chrome Web Store; `node pack.mjs` erzeugt ein ZIP dafür.
### WordPress-Plugin ### WordPress-Plugin
@@ -604,7 +707,7 @@ Im Ordner `wordpress-plugin/` liegt das Plugin **DeskHub Tickets** (ZIP: `releas
- **Funktionen:** Formular mit den **eigenen Feldern und Texten des Hilfethemas aus DeskHub** (auch das Formular der Abteilung), Einwilligungs-Kästchen, Statusabfrage mit Verlauf, Spamschutz (Falle-Feld, Mindestzeit, Mengenbegrenzung, optional Cloudflare Turnstile), Verbindungstest, Deutsch und Englisch. Die Farben (Schrift, Rahmen, Feldhintergrund, Knopf) übernimmt das Formular automatisch vom Theme; die Akzentfarbe lässt sich in den Einstellungen fest vorgeben. Ausführlich in `wordpress-plugin/README.md`. - **Funktionen:** Formular mit den **eigenen Feldern und Texten des Hilfethemas aus DeskHub** (auch das Formular der Abteilung), Einwilligungs-Kästchen, Statusabfrage mit Verlauf, Spamschutz (Falle-Feld, Mindestzeit, Mengenbegrenzung, optional Cloudflare Turnstile), Verbindungstest, Deutsch und Englisch. Die Farben (Schrift, Rahmen, Feldhintergrund, Knopf) übernimmt das Formular automatisch vom Theme; die Akzentfarbe lässt sich in den Einstellungen fest vorgeben. Ausführlich in `wordpress-plugin/README.md`.
- **Sicherheit:** Der Schlüssel liegt nur auf dem WordPress-Server (oder in der `wp-config.php`) und geht nie an den Browser. Abteilung, Thema und Priorität sind im Formular unterschrieben. DeskHub selbst lässt sich nicht in einen Rahmen (iframe) einbetten; das Plugin braucht das nicht. - **Sicherheit:** Der Schlüssel liegt nur auf dem WordPress-Server (oder in der `wp-config.php`) und geht nie an den Browser. Abteilung, Thema und Priorität sind im Formular unterschrieben. DeskHub selbst lässt sich nicht in einen Rahmen (iframe) einbetten; das Plugin braucht das nicht.
- **Grenzen:** Keine Dateianhänge (die API nimmt nur Text). DeskHub sieht die IP-Adresse des WordPress-Servers, nicht die des Besuchers. - **Grenzen:** Dateianhänge: bis zu 5 Dateien, zusammen 10 MB (Plugin ab 1.3.0, DeskHub ab 1.0.67; Typen und Größe bestimmt DeskHub). DeskHub sieht die IP-Adresse des WordPress-Servers, nicht die des Besuchers.
- **Stand der Prüfung:** Getestet mit einem Nachbau der WordPress-Funktionen und gegen einen echten DeskHub-Server, noch nicht in einer echten WordPress-Installation. - **Stand der Prüfung:** Getestet mit einem Nachbau der WordPress-Funktionen und gegen einen echten DeskHub-Server, noch nicht in einer echten WordPress-Installation.
### Windows-Programm für Linux und Mac ### Windows-Programm für Linux und Mac
@@ -718,9 +821,13 @@ Katalog und Schlüssel sind **fest in DeskHub eingebaut** (`includes/catalog_def
### Mitgeliefertes Plugin: Tagesbericht per E-Mail ### Mitgeliefertes Plugin: Tagesbericht per E-Mail
Unter `Plugins/plugins/tagesbericht-1.0.1.zip` (im Projektordner neben `DeskHub-Webseite/`) liegt ein fertiges Plugin. Es schickt Mitarbeitern jeden Morgen eine Übersicht: offene, unzugewiesene, überfällige und eigene Tickets, Zugänge und Erledigungen der letzten 24 Stunden sowie die fünf ältesten offenen Tickets. Jeder sieht nur Tickets seiner Abteilungen. Unter `Plugins/plugins/tagesbericht-1.1.1.zip` (im Projektordner neben `DeskHub-Webseite/`) liegt ein fertiges Plugin. Es schickt Mitarbeitern morgens eine Übersicht: offene, unzugewiesene, überfällige und eigene Tickets, Zugänge und Erledigungen der letzten 24 Stunden sowie die fünf ältesten offenen Tickets. Jeder sieht nur Tickets seiner Abteilungen.
Nach Installation und Aktivierung findet ihr im Menü den Punkt **„Tagesbericht“**: Dort schaltet ihr den Versand ein, legt Uhrzeit, Werktage und Empfänger fest und könnt einen **Testbericht** an euch schicken. Voraussetzung ist der eingerichtete E-Mail-Versand. Nach Installation und Aktivierung findet ihr im Menü den Punkt **„Tagesbericht“**: Dort schaltet ihr den Versand ein, legt Uhrzeit, **Rhythmus** (täglich, nur Werktage oder einmal pro Woche mit Wochentag) und Empfänger fest und könnt einen **Testbericht** an euch schicken. Voraussetzung ist der eingerichtete E-Mail-Versand.
**Zahlen wie in der Ticketliste (ab Plugin 1.1.1):** „Offen“, „Unzugewiesen“ und „Überfällig“ zählen jetzt dasselbe wie der Reiter „Offen“: nur Status offen, wartet auf Kunde und beantwortet, ohne Spam, ohne gesperrte Absender, ohne Tickets in der Wiedervorlage und ohne pausierte. Vorher kamen Tickets gesperrter Absender dazu, die in der Liste nirgends unter „Offen“ stehen.
**Weniger Mails (ab Plugin 1.1.0):** Standardmäßig kommt der Bericht nur noch, wenn es etwas zu tun gibt, also unzugewiesene oder überfällige Tickets (abschaltbar mit „Nur senden, wenn es etwas zu tun gibt“). Außerdem hat jeder Mitarbeiter unter **„Mein Tagesbericht“** eine persönliche Wahl: *wie eingestellt*, *nur wenn Tickets überfällig sind*, *nur einmal pro Woche (montags)* oder *gar nicht mehr*. Jede Mail enthält dazu einen Link. Ein Testbericht ignoriert diese Regeln. Wenn ein Administrator ohne Empfängerauswahl arbeitet, bekommen alle aktiven Mitarbeiter den Bericht; wer ihn nicht möchte, stellt ihn selbst ab. Das Plugin braucht keine Änderung am Server.
### Mitgelieferte Plugins: Virenscan, Spamfilter, Discord/Telegram-Bot, Vertretung, Schichtübergabe, Rundmail, Überwachung, Datenschutz ### Mitgelieferte Plugins: Virenscan, Spamfilter, Discord/Telegram-Bot, Vertretung, Schichtübergabe, Rundmail, Überwachung, Datenschutz
@@ -1046,6 +1153,8 @@ Website-Formulare (zum Beispiel das [WordPress-Plugin](#wordpress-plugin)) holen
- `GET /api/public/v1/tickets.php?topics=1` liefert die öffentlichen, aktiven Hilfethemen: `{ "topics": [{ "id", "name", "path", "depth", "parentId", "departmentId" }] }`. - `GET /api/public/v1/tickets.php?topics=1` liefert die öffentlichen, aktiven Hilfethemen: `{ "topics": [{ "id", "name", "path", "depth", "parentId", "departmentId" }] }`.
- `GET /api/public/v1/tickets.php?form=1&helpTopicId=3` (oder `departmentId=2`) liefert das Formular des Hilfethemas: `{ "form": { "title", "intro", "ownForm", "subject": { "show", "label" }, "message": { "show", "label", "hint" }, "submitLabel", "fields": [{ "id", "label", "type", "required", "options", "helpHtml", "width", "section", "radioInline" }] } }`. Hat die Abteilung ein eigenes Formular, gelten dessen Texte und Felder, sonst die allgemeinen Felder und die des Hilfethemas. Feldtypen: `text`, `textarea`, `select`, `radio`, `checkbox`, `number`, `date`. `helpHtml` ist sicheres HTML (Links mit absoluter Adresse). - `GET /api/public/v1/tickets.php?form=1&helpTopicId=3` (oder `departmentId=2`) liefert das Formular des Hilfethemas: `{ "form": { "title", "intro", "ownForm", "subject": { "show", "label" }, "message": { "show", "label", "hint" }, "submitLabel", "fields": [{ "id", "label", "type", "required", "options", "helpHtml", "width", "section", "radioInline" }] } }`. Hat die Abteilung ein eigenes Formular, gelten dessen Texte und Felder, sonst die allgemeinen Felder und die des Hilfethemas. Feldtypen: `text`, `textarea`, `select`, `radio`, `checkbox`, `number`, `date`. `helpHtml` ist sicheres HTML (Links mit absoluter Adresse).
**Dateianhänge (ab Server 1.0.67):** Im JSON der Ticket-Anlage kann `"attachments": [{ "name": "Bericht.pdf", "data": "<Base64>" }]` stehen: höchstens 5 Dateien, je höchstens 5 MB (und nicht größer als die Upload-Grenze der Einstellungen), zusammen höchstens 10 MB. Erlaubte Endungen: die Liste unter Einstellungen → Uploads (nicht die Zusatzliste für Mails); Skripte und ausführbare Dateien sind immer gesperrt. Alles wird **vor** dem Anlegen geprüft; bei einem Fehler (`INVALID_ATTACHMENT`, HTTP 422) entsteht kein Ticket. Das Formular-Angebot (`?form=1`) nennt die Grenzen unter `"attachments": { "enabled", "maxFiles", "maxFileBytes", "maxTotalBytes", "allowedExtensions" }`; ein eigenes Formular kann Anhänge abschalten (`enabled: false`). Anfragen mit Anhängen dürfen bis rund 14 MB groß sein, alle anderen höchstens 200 KB.
#### Ticketstatus abfragen #### Ticketstatus abfragen
`GET /api/public/v1/tickets.php?number=T-1042&email=erika@example.de`, Recht „Tickets lesen“. `GET /api/public/v1/tickets.php?number=T-1042&email=erika@example.de`, Recht „Tickets lesen“.