Upload via GUI (23 Dateien)

chrome-erweiterung/README.md

@@ -1,44 +1,48 @@
 # DeskHub für Chrome (Erweiterung)
 
-DeskHub in der Browserleiste: **Zähler und Benachrichtigungen** für neue Tickets, **Suche**, **Ticket anlegen** und Tickets mit einem Klick im Browser öffnen. Sie läuft in Chrome, Edge und Brave (Manifest V3) auf Windows, Mac und Linux und ist die einfachste Lösung für Mitarbeiter ohne Windows-Programm.
+DeskHub in der Browserleiste: **Tickets lesen und beantworten**, Aufgaben, eigener Status, Zähler und Benachrichtigungen. Sie läuft in Chrome, Edge und Brave (Manifest V3) auf Windows, Mac und Linux. Version 2 ist komplett neu gebaut (Oberfläche, Anmeldung, Funktionen).
 
 ## Funktionen
 
-- **Zähler am Symbol:** Jede Minute fragt die Erweiterung den Server nach Neuem (neue nicht zugewiesene Tickets und Aktualisierungen bei deinen Tickets). Die Zahl am Symbol zählt, was seit dem letzten Öffnen dazugekommen ist; ein Klick auf das Symbol setzt sie zurück.
-- **Benachrichtigungen:** Bei Neuem meldet Chrome es (im Popup unten abschaltbar).
-- **Übersicht:** Meine offenen, überfällige und nicht zugewiesene Tickets sowie die als Nächstes fälligen Tickets.
-- **Suche:** In Betreff, Nummer, Name und Text, über alle Status.
-- **Neu:** Ticket anlegen (Anfrager, Betreff, Beschreibung, Abteilung, Priorität, optional Kunden benachrichtigen). Das Recht „Ticket anlegen“ ist Voraussetzung, sonst fehlt der Reiter.
-- **Rechtsklick auf Text oder Seite → „Als DeskHub-Ticket anlegen“:** Öffnet das Formular mit dem markierten Text und der Adresse der Seite.
-- **Ticket im Browser öffnen:** Ein Klick auf ein Ticket öffnet es in der Weboberfläche. Dafür erzeugt der Server eine einmalige Anmelde-Adresse (wie in den Apps), du musst dich dort nicht erneut anmelden.
+- **Start:** Begrüßung, **eigener Status** (Verfügbar, Beschäftigt, Pause, Offline), Kennzahlen (meine offenen, überfällige, nicht zugewiesene, unbeantwortete, heute gelöste, SLA-Quote) und die als Nächstes fälligen Tickets. Ein Klick auf eine Kennzahl öffnet die passende Ticketliste.
+- **Tickets:** Filter *Meine*, *Nicht zugewiesen*, *Überfällig*, *Unbeantwortet*, *Beobachtet*, *Wiedervorlage*, *Alle offenen*, *Gelöst/Geschlossen*; Suche in Betreff, Nummer, Name und Text; „Mehr laden“.
+- **Ticket-Ansicht direkt in der Erweiterung:** Verlauf als Chat (Kunde, Mitarbeiter, interne Notizen, Kommentare, Anhänge), **Antworten** (mit Textbausteinen, Signatur-Auswahl und Status nach dem Senden), **interne Notiz**, **Status ändern** (mit Abschlussgrund), **zuweisen** (auch „Mir zuweisen“), **Wiedervorlage**, **Beobachten**, Ticket im Browser öffnen. Strg+Enter sendet. Ein angefangener Text bleibt als Entwurf erhalten, auch wenn sich das Popup schließt.
+- **Aufgaben:** meine, alle offenen, erledigte; abhaken, neue Aufgabe mit Fälligkeit, Bearbeiter und Ticket, löschen.
+- **Neu:** Ticket anlegen (Anfrager, Betreff, Beschreibung, Abteilung, Priorität, Bearbeiter, Kunden benachrichtigen).
+- **Mehr:** Konto, Meldungen einzeln ein-/ausschalten, Darstellung (automatisch, hell, dunkel), Team-Übersicht mit Status, Weboberfläche öffnen, Abmelden.
+- **Seitenleiste:** Das Symbol oben rechts im Popup öffnet DeskHub in der Seitenleiste von Chrome (bleibt offen, volle Höhe). Alternativ als eigenes Fenster.
+- **Zähler und Benachrichtigungen:** Jede Minute fragt die Erweiterung den Server nach Neuem; die Zahl am Symbol zählt, was seit dem letzten Öffnen dazugekommen ist.
+- **Rechtsklick auf Text oder Seite → „Als DeskHub-Ticket anlegen“:** öffnet das Formular mit markiertem Text und Adresse der Seite.
+- **Tastenkürzel:** Alt+Shift+N neues Ticket, Alt+Shift+D Seitenleiste (unter `chrome://extensions/shortcuts` änderbar).
+- **Adressleiste:** „dh“, Leertaste, dann Ticketnummer (öffnet das Ticket) oder Suchbegriff (sucht Tickets).
 
 ## Installieren
 
 1. In Chrome `chrome://extensions` öffnen und **Entwicklermodus** einschalten.
-2. **Entpackte Erweiterung laden** und den Ordner `chrome-erweiterung` wählen (oder das ZIP aus `release/` vorher entpacken).
+2. **Entpackte Erweiterung laden** und den Ordner `chrome-erweiterung` wählen (oder das ZIP aus `release/` vorher entpacken). Eine ältere Version vorher entfernen.
 3. Das DeskHub-Symbol in der Leiste anheften, anklicken und anmelden: Server-Adresse (zum Beispiel `support.example.de`), E-Mail und Passwort. Ist dein Konto mit einem Authenticator geschützt, fragt die Erweiterung danach den 6-stelligen Code.
 
-Chrome fragt dabei **einmal** nach der Erlaubnis, auf deinen DeskHub-Server zuzugreifen. Die Erlaubnis gilt nur für diese eine Adresse, nicht für andere Webseiten, und wird beim Abmelden wieder zurückgegeben.
+Es gibt **keine Rückfrage** und keinen zweiten Anmeldeschritt: Der Zugriff auf den Server ist im Manifest erlaubt (`host_permissions`). Die Erweiterung spricht trotzdem nur mit dem Server, bei dem du dich anmeldest.
 
 ## Sicherheit und Datenschutz
 
 - Verbindung nur über **HTTPS** (`http` nur für `localhost` zum Testen). Die Erweiterung folgt keinen Weiterleitungen und sendet keine Cookies.
-- Das Anmelde-Token liegt nur in `chrome.storage.local` dieser Erweiterung (nicht in `sync`, nicht im Seitencode). **Abmelden** sperrt das Token auf dem Server.
-- Rechte: `storage`, `alarms`, `notifications`, `contextMenus`. Zugriff auf Webseiten gibt es erst nach deiner Zustimmung bei der Anmeldung, und nur für deinen Server.
-- Die Oberfläche baut alles mit DOM-Aufrufen auf (kein `innerHTML` mit Serverdaten); die Inhaltsrichtlinie der Erweiterung erlaubt nur eigene Skripte und Verbindungen über HTTPS.
-- Texte, die du anlegst, werden als Text gesendet (Sonderzeichen maskiert); der Server bereinigt sie zusätzlich.
+- Das Anmelde-Token liegt nur in `chrome.storage.local` dieser Erweiterung (nicht in `sync`, nicht im Seitencode). **Abmelden** sperrt das Token auf dem Server und löscht lokale Daten samt Entwürfen.
+- Der Manifest-Zugriff gilt für alle HTTPS-Adressen, damit keine Berechtigungsabfrage nötig ist; der Code verbindet sich ausschließlich mit der angemeldeten Server-Adresse. Chrome zeigt bei einer Installation aus dem Web Store dafür eine einmalige Warnung (bei „Entpackte Erweiterung laden“ nicht).
+- Die Oberfläche baut alles mit DOM-Aufrufen auf (kein `innerHTML` mit Serverdaten); die Inhaltsrichtlinie erlaubt nur eigene Skripte und Verbindungen über HTTPS.
+- Texte, die du sendest, werden als Text übertragen (Sonderzeichen maskiert); der Server bereinigt sie zusätzlich.
 
-## Grenzen
+## Hinweise
 
-- Die Erweiterung fragt **jede Minute** ab (Chrome erlaubt für Erweiterungen nicht öfter). Ist Chrome geschlossen, gibt es keine Meldungen. Für Meldungen auch bei geschlossenem Browser nutzt die Android-App oder das Windows-Programm.
-- Antworten auf Tickets, Zuweisen, Status ändern und Notizen gehen nicht in der Erweiterung: Dafür öffnet ein Klick das Ticket in der Weboberfläche.
+- **Ein Ticket zu öffnen sperrt es für andere** (wie in der Weboberfläche) und weist ein nicht zugewiesenes Ticket dir zu. Beim Verlassen der Ansicht wird die Sperre wieder freigegeben.
+- Die Erweiterung fragt **jede Minute** ab (Chrome erlaubt für Erweiterungen nicht öfter). Ist Chrome geschlossen, gibt es keine Meldungen. Dafür gibt es die Android-App und das Windows-Programm.
+- Anhänge werden angezeigt, aber nicht heruntergeladen: Dafür das Ticket im Browser öffnen.
 - Die Oberfläche ist deutsch.
-- Sie ist (noch) nicht im Chrome Web Store. Das ZIP lässt sich dort als nicht gelistete Erweiterung hochladen, dafür braucht es ein Entwicklerkonto bei Google.
 
 ## Entwickeln und testen
 
 ```bash
-node --test test/core.test.mjs        # Kern und Hintergrunddienst mit nachgebautem Browser und Server
+node --test test/core.test.mjs        # Kern, Hintergrunddienst, Zeitangaben mit nachgebautem Browser und Server
 ```
 
 Gegen einen **echten** DeskHub-Server (Testinstallation, nicht Produktion):
@@ -47,7 +51,7 @@ Gegen einen **echten** DeskHub-Server (Testinstallation, nicht Produktion):
 DESKHUB_URL=http://127.0.0.1:8181 DESKHUB_EMAIL=… DESKHUB_PASSWORD=… node --test test/integration.test.mjs
 ```
 
-Der Integrationstest meldet an, ruft Stammdaten, Übersicht und Suche ab, legt ein Ticket an, prüft die Aktivitätszählung, öffnet ein Ticket per einmaliger Adresse und meldet ab (danach muss das alte Token abgelehnt werden). Ohne `DESKHUB_URL` wird er übersprungen.
+Der Integrationstest meldet an, ruft Stammdaten, Übersicht und Suche ab, legt ein Ticket an, prüft die Aktivitätszählung, antwortet, schreibt Notizen, setzt Wiedervorlage, Beobachten und Status, legt Aufgaben an und meldet ab (danach muss das alte Token abgelehnt werden). Ohne `DESKHUB_URL` wird er übersprungen. Der Suchtest erwartet das Ticket `T-TEST-0001` der Testinstallation.
 
 Packen für die Weitergabe: `node pack.mjs` erzeugt `../release/deskhub-chrome-erweiterung-<Version>.zip` mit nur den Laufzeitdateien.
 
@@ -55,8 +59,10 @@ Packen für die Weitergabe: `node pack.mjs` erzeugt `../release/deskhub-chrome-e
 
 | Datei | Aufgabe |
 |---|---|
-| `manifest.json` | Rechte, Hintergrunddienst, Inhaltsrichtlinie |
-| `background.js` | Abfrage jede Minute, Zähler, Benachrichtigungen, Rechtsklick-Menü |
-| `popup.html/js/css` | Oberfläche (Anmeldung, Übersicht, Suche, Neu) |
-| `lib/core.js` | Serveradresse, Anmeldung, API-Aufrufe, Sicherheitsprüfungen |
+| `manifest.json` | Rechte, Hintergrunddienst, Seitenleiste, Tastenkürzel, Adressleiste, Inhaltsrichtlinie |
+| `background.js` | Abfrage jede Minute, Zähler, Benachrichtigungen, Rechtsklick-Menü, Kürzel, Adressleiste |
+| `app.html/css/js` | Gerüst der Oberfläche (Popup, Seitenleiste, Fenster) |
+| `views/` | Ansichten: Anmeldung, Start, Tickets, Ticket, Aufgaben, Neu, Mehr |
+| `lib/core.js` | Serveradresse, Anmeldung, API-Aufrufe, Zeitangaben |
+| `lib/dom.js`, `lib/ui.js` | DOM-Baukasten, Symbole, gemeinsame Bausteine |
 | `test/` | Tests |