tessera-ctl/docs/anleitung-anwender.md

<!-- generated-by: gsd-doc-writer -->
# Tessera — Anleitung für Anwender

Diese Anleitung richtet sich an alle Kolleginnen und Kollegen, die Tessera im Arbeitsalltag nutzen. Sie beschreibt die Oberfläche und alle Module so, wie sie tatsächlich am Bildschirm erscheinen.

## Inhaltsverzeichnis

1. [Was ist Tessera?](#was-ist-tessera)
2. [Anmeldung](#anmeldung)
3. [Aufbau der Oberfläche](#aufbau-der-oberfläche)
4. [Dashboard](#dashboard)
5. [Marktplatz](#marktplatz)
6. [Die Module](#die-module)
   - [Ausschreibungs-Radar](#ausschreibungs-radar)
   - [DKV-Rechnung](#dkv-rechnung)
   - [Zertifikat-Manager](#zertifikat-manager)
   - [Domaincheck](#domaincheck)
7. [Persönliche Einstellungen](#persönliche-einstellungen)
8. [Häufige Stolpersteine](#häufige-stolpersteine)

---

## Was ist Tessera?

Tessera ist das zentrale Portal, in dem alle Arbeitswerkzeuge Ihres Unternehmens an einem Ort zusammenlaufen. Statt zwischen einzelnen Programmen zu wechseln, finden Sie jedes freigeschaltete Werkzeug — ein sogenanntes „Modul" — in der Seitenleiste und öffnen es mit einem Klick. Ihr persönliches Dashboard zeigt Ihnen zusätzlich frei zusammenstellbare Kacheln mit Uhrzeit, Kalender, Notizen und anderen Helfern für den täglichen Gebrauch.

## Anmeldung

Rufen Sie die Anmeldeseite auf. Auf der linken Seite sehen Sie das Tessera-Logo, rechts das Anmeldeformular mit den Feldern **Benutzername** und **Passwort**.

**Wichtig:** Melden Sie sich immer mit Ihrem **Benutzernamen** an — nicht mit Ihrer E-Mail-Adresse. Das Anmeldefeld heißt zwar oft wie eine E-Mail-Eingabe aus, akzeptiert aber ausschließlich den Benutzernamen. Wird stattdessen eine E-Mail-Adresse eingegeben, meldet das System schlicht „Benutzername oder Passwort ungültig" — es sieht dann so aus, als sei die Anmeldung grundsätzlich kaputt, obwohl nur das falsche Feld befüllt wurde. Fragen Sie im Zweifel Ihren Administrator nach Ihrem Benutzernamen.

Über den Link „Passwort vergessen?" können Sie ein neues Passwort per E-Mail anfordern — dieser Weg funktioniert nur für Konten, deren Passwort lokal in Tessera verwaltet wird (siehe [Persönliche Einstellungen](#persönliche-einstellungen)).

Falls Ihr Administrator beim Anlegen Ihres Kontos eine Passwort-Änderung erzwungen hat, werden Sie nach der Anmeldung automatisch aufgefordert, ein neues Passwort zu vergeben, bevor Sie fortfahren können.

## Aufbau der Oberfläche

Die Portal-Oberfläche gliedert sich in drei feste Bereiche:

**Kopfleiste (oben)**
Links steht das Tessera-Logo, in der Mitte der aktuelle Seitentitel. Rechts finden Sie zwei Bedienelemente:
- Einen Schalter zum Umschalten zwischen hellem und dunklem Erscheinungsbild (siehe [Persönliche Einstellungen](#persönliche-einstellungen)).
- Ihr Benutzersymbol (Avatar oder Ihr Anfangsbuchstabe). Ein Klick öffnet das **Benutzermenü** mit:
  - Ihrem Namen und Ihrer Rolle (Benutzer, Admin oder Super-Admin),
  - **Einstellungen** — führt zu Ihren persönlichen Einstellungen,
  - **Administrator** — erscheint nur, wenn Sie Admin- oder Super-Admin-Rechte haben,
  - **Abmelden**.

**Seitenleiste (links)**
Ganz oben stehen zwei feste Einträge: **Dashboard** (Ihre Startseite) und **Marktplatz**. Darunter folgt ein Suchfeld „Module suchen…", mit dem Sie die Modulliste filtern können, und darunter die Liste der für Sie freigegebenen Module, gruppiert nach **Kategorien**. Ein Klick auf eine Kategorie klappt sie auf und zeigt die einzelnen Module darin. Sind für Sie noch keine Module aktiv, steht dort „Keine Module".

Unten in der Seitenleiste finden Sie die Sprachumschaltung (Deutsch/English) sowie Ihren Namen mit Rolle. Über den Pfeil-Button am unteren Rand können Sie die Seitenleiste ein- und wieder ausklappen — im eingeklappten Zustand bleiben nur die Symbole sichtbar, das spart Platz auf kleineren Bildschirmen.

## Dashboard

Das Dashboard ist Ihre persönliche Startseite und öffnet sich automatisch nach der Anmeldung. Es zeigt ein Raster aus Kacheln — den **Widgets**. Ist noch kein Widget platziert, sehen Sie nur das Tessera-Symbol mit dem Hinweis „Keine Widgets aktiv".

**Widgets hinzufügen und anordnen:** Oben rechts auf dem Dashboard befindet sich der Schalter **„Dashboard bearbeiten"**. Sobald der Bearbeitungsmodus aktiv ist:
- Erscheint der Button **„Widget hinzufügen"**, der eine Auswahl aller verfügbaren Widget-Typen als Kachel-Katalog öffnet. Ein Klick auf einen Eintrag fügt das Widget sofort dem Dashboard hinzu.
- Können Sie bestehende Widgets per Ziehen an eine neue Position verschieben.
- Können Sie Widgets an der Ecke in der Größe ziehen (jeder Widget-Typ hat eine Mindestgröße, damit der Inhalt lesbar bleibt).
- Erscheint an jedem Widget ein Symbol zum Entfernen.

Ihre Änderungen werden über **„Änderungen speichern"** übernommen. Verlassen Sie den Bearbeitungsmodus, ist das Dashboard wieder fest — Verschieben und Größenänderung sind dann gesperrt, damit Sie es im normalen Gebrauch nicht versehentlich verstellen.

**Verfügbare Widgets:**

| Widget | Zweck |
|---|---|
| Uhr | Zeigt die aktuelle Uhrzeit an (optional mit Datum) |
| Suchleiste | Schnellsuche im Web über frei konfigurierbare Suchanbieter |
| Kalender | Zeigt kommende Termine aus Ihren verbundenen Kalenderquellen |
| Notizen | Freitext-Notizen mit Markdown-Formatierung |
| Taschenrechner | Grundrechenarten, auch per Tastatur bedienbar |
| Favoriten | Schnellzugriff auf mehrere selbst gepflegte Links, als Liste oder Kachelansicht |
| Link | Schnellzugriff auf genau einen einzelnen Link |
| Stoppuhr | Zeitmessung mit Rundenzeiten |

Für Suchleiste, Kalender, Favoriten und Link gibt es zusätzliche Einstellungen (z. B. eigene Suchanbieter, Kalenderquellen, hinterlegte Links) — diese finden Sie unter **Einstellungen > Dashboard**, siehe [Persönliche Einstellungen](#persönliche-einstellungen).

## Marktplatz

Über den Eintrag **Marktplatz** in der Seitenleiste sehen Sie alle Module, die Tessera grundsätzlich anbietet — unabhängig davon, ob Sie sie bereits nutzen können. Jede Modulkachel zeigt Name, Version und einen Status:

- **Aktiviert** — das Modul wurde vom Administrator für Ihr Unternehmen freigeschaltet.
- **Verfügbar** — das Modul existiert, ist aber noch nicht aktiviert.

Über die Suche und die Filter (Status, Kategorie) lässt sich die Liste eingrenzen. Ein Klick auf eine Kachel öffnet die Detailseite mit einer ausführlicheren Beschreibung.

**Aktivieren und Freigeben sind zwei unterschiedliche Dinge:** Nur Administratoren können ein Modul für das gesamte Unternehmen **aktivieren**. Ob Sie persönlich das Modul danach auch sehen und öffnen können, hängt zusätzlich davon ab, ob Ihnen oder Ihrer Gruppe der Zugriff **freigegeben** wurde. Ein Modul kann also für das Unternehmen aktiv sein, ohne dass Sie selbst Zugriff darauf haben. Versuchen Sie in diesem Fall, das Modul zu öffnen, erscheint statt des Moduls die Meldung „Kein Zugriff auf dieses Modul" mit dem Hinweis „Sie haben für dieses Modul keine Freigabe. Wenden Sie sich an Ihren Administrator." In diesem Fall wenden Sie sich an Ihren Administrator, damit er Ihnen (direkt oder über eine Gruppe) die Freigabe für das Modul erteilt.

## Die Module

Aktuell stehen in Tessera vier Module zur Verfügung. Je nachdem, welche für Sie freigegeben sind, sehen Sie sie in der Seitenleiste unter ihrer jeweiligen Kategorie.

### Ausschreibungs-Radar

Das Ausschreibungs-Radar durchsucht öffentliche Ausschreibungen und zeigt sie Ihnen als Trefferliste.

**Trefferliste:** Die Hauptseite zeigt eine Tabelle mit Titel, Auftraggeber, Frist, Wert, Veröffentlichungsdatum und einer Spalte „Triage". Über den Button **„Jetzt abrufen"** (Zahnrad-Symbol daneben) können fällige Quellen sofort abgerufen werden, statt auf den nächsten automatischen Durchlauf zu warten. Ein Hinweisbanner erklärt die aktuelle Datenabdeckung: Erfasst werden derzeit nur EU-weite Oberschwellen-Ausschreibungen aus der zentralen DÖE-Quelle; kleinere Unterschwellen-Vergaben einzelner Vergabestellen fehlen noch, weshalb eine kurze Trefferliste kein Fehler ist. Einige Portale lassen laut ihren Nutzungsbedingungen keinen automatisierten Zugriff zu und müssen daher manuell beobachtet werden — auch das zeigt das Banner an.

**Filter:** Über das Filterfeld können Sie nach Titel oder Auftraggeber suchen, nach Frist, Postleitzahl, Bundesland, Branche (CPV-Code) und Auftragswert eingrenzen sowie nach „nur noch offene" und „nur Favoriten/Merkliste" filtern.

**Suchprofile:** Sie können die aktuell eingestellten Filter unter einem eigenen Namen als Suchprofil speichern, später wieder laden, umbenennen oder löschen. Für jedes Suchprofil lässt sich zusätzlich ein **Sofort-Alert** per E-Mail einschalten, der Sie bei neuen Treffern dieses Profils sofort benachrichtigt.

**Merken/Gelesen:** In der Trefferliste kann jede Ausschreibung als gelesen/ungelesen markiert und als Favorit gesetzt (markiert mit ★) oder wieder entfernt werden.

**Meine Quellen:** Über das Zahnrad-Symbol neben „Jetzt abrufen" gelangen Sie zu „Meine Quellen" — Ihrem persönlichen Einstellungsbereich für dieses Modul, mit drei Abschnitten:
- **Mein Postfach** — verbinden Sie Ihr eigenes E-Mail-Postfach (IMAP oder Exchange), aus dem eingehende Ausschreibungs-Benachrichtigungen automatisch erfasst werden.
- **Meine Feeds** — eigene RSS-Feeds, die Sie zusätzlich beobachten möchten.
- **Benachrichtigung** — das Intervall für die Sammel-Mail (Digest), die neue Treffer aus Ihren Suchprofilen zusammenfasst: täglich, wöchentlich oder aus.

Ausschreibungen, die über Ihr Postfach oder Ihre Feeds hereinkommen, erscheinen anschließend in der Trefferliste **aller** Kolleginnen und Kollegen Ihres Unternehmens — es gibt keine getrennte Sichtbarkeit je Postfach.

Administratoren sehen zusätzlich einen Link zu den plattformweiten Einstellungen (Abrufintervall, plattformweite RSS-Feeds), die für alle gleich gelten.

### DKV-Rechnung

Das Modul prüft automatisch ein Postfach auf eingehende DKV-Tankkarten-Rechnungen und verarbeitet sie.

- **Posteingang:** Über **„Jetzt prüfen"** lässt sich der Posteingang sofort abfragen, statt auf den nächsten automatischen Lauf zu warten. Die **Verarbeitungshistorie** zeigt Datum/Zeit, Rechnungsnummer, betroffene Fahrzeuge, Anzahl Transaktionen und Status jeder verarbeiteten Rechnung. Darunter listet **„Letzte Exportdateien"** die erzeugten Exporte zum Download.
- **Fahrzeuge:** Im Tab „Fahrzeuge" pflegen Sie die Fahrzeug-Stammdaten (Kennzeichen, Marke, Modell, Fahrer) — einzeln oder per CSV-Import (Format: `Kennzeichen;Marke;Modell;Fahrer`). Beim Import wählen Sie zwischen „Zusammenführen" (neue Fahrzeuge ergänzen, vorhandene bleiben) und „Ersetzen" (alle vorhandenen Fahrzeuge werden ersetzt — vor dieser Aktion erscheint eine Sicherheitsabfrage, da sie nicht rückgängig gemacht werden kann).
- **Moduleinstellungen:** Hier wird die Verbindung zum Postfach konfiguriert (Protokoll, Host, Zugangsdaten, Abrufintervall) sowie der Export-Empfänger, an den die verarbeiteten Rechnungen weitergeleitet werden.

### Zertifikat-Manager

Ein Werkzeug rund um SSL/TLS-Zertifikate mit vier Reitern:

- **Analysieren** — lädt ein Zertifikat (Datei oder eingefügter PEM-Text) und zeigt dessen Details, inklusive Einordnung als Root-CA, Zwischen-CA oder Endzertifikat.
- **Aufteilen** — zerlegt eine Fullchain- oder P7B-Datei in ihre einzelnen Zertifikate.
- **Zusammenführen** — fügt mehrere einzelne Zertifikate zu einer Kette zusammen.
- **Konvertieren** — wandelt ein Zertifikat in ein anderes Format um.

Unterstützte Dateiformate sind unter anderem `.pem`, `.crt`, `.cer`, `.der`, `.pfx`, `.p12`, `.p7b` und `.p7c`. Passwortgeschützte PFX/P12-Dateien verlangen die Eingabe des zugehörigen Passworts. Ergebnisse lassen sich einzeln oder gesammelt als ZIP herunterladen.

### Domaincheck

Ein einfaches Werkzeug, um zu prüfen, ob eine Internet-Domain verfügbar ist. Geben Sie einen Domain-Namen ein (z. B. `beispiel.de`) und klicken Sie auf „Prüfen" — das Ergebnis zeigt für die geprüften Endungen jeweils „Verfügbar" oder „Registriert" an, ergänzt um alternative Vorschläge.

## Persönliche Einstellungen

Öffnen Sie **Einstellungen** über das Benutzermenü oben rechts. Der Bereich gliedert sich in zwei Kategorien in der linken Unterleiste:

**Allgemein > Konto:**
- **Profilbild:** Laden Sie ein Bild hoch (PNG, JPEG oder WebP, maximal 2 MB) oder löschen Sie das vorhandene wieder.
- **Akzentfarbe:** Passt die Hauptfarbe der Oberfläche an Ihren Geschmack an; über „Zurücksetzen" kehren Sie zur Standardfarbe zurück.
- **Passwort ändern:** Nur sichtbar und nutzbar, wenn Ihr Konto **lokal** in Tessera verwaltet wird. Wird Ihr Konto stattdessen über das Verzeichnis (LDAP/Active Directory) verwaltet, zeigt Tessera stattdessen den Hinweis „Ihr Passwort wird über das Verzeichnis (LDAP) verwaltet. Eine Änderung ist hier nicht möglich." — in diesem Fall ändern Sie Ihr Passwort über die üblichen Firmenwege (z. B. Windows-Anmeldung), nicht in Tessera.

**Dashboard > Widgets:** Hier finden Sie für jedes auf Ihrem Dashboard platzierte Widget die zugehörigen Einstellungen, zum Beispiel eigene Suchanbieter für die Suchleiste.

**Dashboard > Kalender:** Hier verwalten Sie die Kalenderquellen, aus denen das Kalender-Widget seine Termine bezieht — Quellen hinzufügen, die Verbindung testen und nicht mehr benötigte Quellen wieder entfernen.

**Erscheinungsbild (Hell/Dunkel/System):** Der Schalter oben rechts in der Kopfleiste wechselt bei jedem Klick reihum zwischen Hell, Dunkel und System (folgt der Einstellung Ihres Betriebssystems).

**Sprache:** Unten in der Seitenleiste finden Sie die Sprachumschaltung zwischen Deutsch und Englisch.

## Häufige Stolpersteine

- **Die Anmeldung schlägt fehl, obwohl Passwort und E-Mail stimmen.** Prüfen Sie, ob Sie im Feld „Benutzername" tatsächlich Ihren Benutzernamen eingegeben haben — nicht Ihre E-Mail-Adresse. Das ist mit Abstand der häufigste Grund für eine scheinbar kaputte Anmeldung.
- **Ein Modul wird im Marktplatz als „Aktiviert" angezeigt, lässt sich aber nicht öffnen.** Das Modul ist für Ihr Unternehmen freigeschaltet, aber Ihnen persönlich (oder Ihrer Gruppe) wurde noch keine Freigabe erteilt. Wenden Sie sich an Ihren Administrator.
- **Im Bereich „Passwort ändern" fehlt das Formular komplett.** Ihr Konto wird über das Verzeichnis (LDAP) verwaltet — das ist kein Fehler, sondern Absicht. Ändern Sie Ihr Passwort in diesem Fall über den üblichen Firmenweg.
- **Nach der Anmeldung werden Sie sofort zur Passwort-Änderung gezwungen.** Das ist eine Sicherheitsmaßnahme, die der Administrator beim Anlegen Ihres Kontos aktiviert hat — vergeben Sie einfach ein neues Passwort, um fortzufahren.
- **Die Seitenleiste zeigt „Keine Module".** Für Sie sind noch keine Module freigegeben. Das ist normal für neu angelegte Konten — wenden Sie sich an Ihren Administrator.
- **Im Ausschreibungs-Radar erscheinen nur sehr wenige Treffer.** Aktuell werden nur EU-weite Oberschwellen-Ausschreibungen erfasst; kleinere Unterschwellen-Vergaben fehlen noch. Das Hinweisbanner auf der Modulseite erklärt das.
- **Zahlen, die Sie über „Meine Quellen" im Ausschreibungs-Radar eingebracht haben, tauchen in der Trefferliste aller Kollegen auf.** Das ist beabsichtigt — die Trefferliste ist für das ganze Unternehmen gemeinsam, nicht postfachbezogen getrennt.