fix(261005-jqd): Bereich heisst Administration statt Verwaltung
Leiste, Seitentitel und Pfadhinweise passend zum Profilmenue 'Einstellungen/Administration'; Handbuch und CHANGELOG nachgezogen. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -12,3 +12,4 @@ date: 2026-10-05
|
||||
- Nachweis: Web 1372/1372 Tests, tsc sauber; Sichtprüfung hell/dunkel, 390/1280/1440 px (Fotos .playwright-mcp/design-before, design-r1..r3). Umgesetzt im Klon mit 4 parallelen Helfern nach Regeldatei, danach Abgleich.
|
||||
- Doku: anleitung-anwender/-administration/-betrieb Pfade auf „Verwaltung → …“, Einstellungen-Kapitel neu beschrieben; CHANGELOG „Neu“.
|
||||
- Nachtrag (User: „Einstellungen und Verwalten zeigen auf die gleiche Seite … Lass es bei Einstellungen; bei Admin Einstellungen/Administration“): Profilmenü nur noch EIN Eintrag (/settings), Beschriftung für ADMIN/SUPER_ADMIN `header.settingsAdmin` = „Einstellungen/Administration“; Verwaltungs-Eintrag entfernt. Im Browser geprüft (localhost:3000).
|
||||
- Nachtrag 06.10. (User: „In den Einstellungen heißt es immer noch Verwaltung. Dort soll auch Administration stehen“): Leistenblock, Seitentitel oben und Pfadhinweise „Administration → …“ (de); Handbuch + CHANGELOG nachgezogen. Im Browser geprüft.
|
||||
|
||||
+2
-2
@@ -6,8 +6,8 @@ Diese Liste beschreibt in einfachen Worten, was sich von Version zu Version an T
|
||||
|
||||
### Neu
|
||||
|
||||
- Einstellungen und Verwaltung sind neu und aufgeräumter aufgebaut. Beide Bereiche teilen sich jetzt eine Leiste: oben Ihre persönlichen Einstellungen, darunter – für Administratoren – die Verwaltung, gegliedert in „Benutzer und Zugang“, „Module“ und „Anbindungen“. „Freigaben“ und „Kategorien“ stehen dort direkt, statt nur über Knöpfe auf der Modulseite. Jede Seite hat oben Titel und eine kurze Erklärung, darunter Karten mit je einem Thema; Speichern steht unten rechts in der jeweiligen Karte. Formulare wie Konto, E-Mail-Versand und Verzeichnis sind in Abschnitte gegliedert, die Benutzertabelle passt ohne seitliches Scrollen auf den Bildschirm, und die Module sind nach Kategorie gruppiert. Im Profilmenü gibt es nur noch einen Eintrag: „Einstellungen“, bei Administratoren „Einstellungen/Administration“; der Bereich heißt in der Leiste „Verwaltung“. Die Seitentitel heißen wie die Einträge in der Leiste (zum Beispiel „Benutzer“ statt „Benutzerverwaltung“). Auf dem Handy wählen Sie die Seite über eine Auswahlliste.
|
||||
- Kategorien der Module lassen sich jetzt von Administratoren selbst gestalten, unter Verwaltung → Kategorien. Sie können neue Kategorien anlegen, bestehende umbenennen und mit Pfeilen in eine andere Reihenfolge bringen, jedes Modul (auch gemeinsame eigene Module) einer Kategorie zuordnen und die Module innerhalb einer Kategorie sortieren. Seitenleiste, Marktplatz und Freigaben-Matrix folgen dieser Reihenfolge und den neuen Namen. Löschen Sie eine Kategorie, in der noch Module liegen, wählen Sie eine Zielkategorie: Alle Module wandern dorthin, auch die persönlichen Einträge der Benutzer, es geht nichts verloren. „Eigene Module“ lässt sich umbenennen und verschieben, aber nicht löschen. Benutzer können für ihre eigenen Einträge jetzt jede vorhandene Kategorie wählen. Alte Modul-Adressen aus Lesezeichen funktionieren weiter.
|
||||
- Einstellungen und Administration sind neu und aufgeräumter aufgebaut. Beide Bereiche teilen sich jetzt eine Leiste: oben Ihre persönlichen Einstellungen, darunter – für Administratoren – die Administration, gegliedert in „Benutzer und Zugang“, „Module“ und „Anbindungen“. „Freigaben“ und „Kategorien“ stehen dort direkt, statt nur über Knöpfe auf der Modulseite. Jede Seite hat oben Titel und eine kurze Erklärung, darunter Karten mit je einem Thema; Speichern steht unten rechts in der jeweiligen Karte. Formulare wie Konto, E-Mail-Versand und Verzeichnis sind in Abschnitte gegliedert, die Benutzertabelle passt ohne seitliches Scrollen auf den Bildschirm, und die Module sind nach Kategorie gruppiert. Im Profilmenü gibt es nur noch einen Eintrag: „Einstellungen“, bei Administratoren „Einstellungen/Administration“; der Bereich heißt in der Leiste ebenfalls „Administration“ (vorher „Administrator“). Die Seitentitel heißen wie die Einträge in der Leiste (zum Beispiel „Benutzer“ statt „Benutzerverwaltung“). Auf dem Handy wählen Sie die Seite über eine Auswahlliste.
|
||||
- Kategorien der Module lassen sich jetzt von Administratoren selbst gestalten, unter Administration → Kategorien. Sie können neue Kategorien anlegen, bestehende umbenennen und mit Pfeilen in eine andere Reihenfolge bringen, jedes Modul (auch gemeinsame eigene Module) einer Kategorie zuordnen und die Module innerhalb einer Kategorie sortieren. Seitenleiste, Marktplatz und Freigaben-Matrix folgen dieser Reihenfolge und den neuen Namen. Löschen Sie eine Kategorie, in der noch Module liegen, wählen Sie eine Zielkategorie: Alle Module wandern dorthin, auch die persönlichen Einträge der Benutzer, es geht nichts verloren. „Eigene Module“ lässt sich umbenennen und verschieben, aber nicht löschen. Benutzer können für ihre eigenen Einträge jetzt jede vorhandene Kategorie wählen. Alte Modul-Adressen aus Lesezeichen funktionieren weiter.
|
||||
- Neues Modul „Nextcloud-Status“ in der Gruppe „Infrastruktur“. Es zeigt für jede eingetragene Nextcloud-Cloud Ihrer Kunden eine Kachel mit Logo (oder Initialen), Kundenname, Adresse (öffnet in einem neuen Tab), installierter Version, Ampelfarbe mit kurzer Begründung und dem Zeitpunkt der letzten Prüfung; oben steht die neueste Nextcloud-Version. Grün heißt: neuester Stand seiner Version und der Support läuft noch mehr als drei Monate. Gelb heißt: ein Update steht an oder der Support endet in den nächsten drei Monaten. Rot heißt: der Support ist abgelaufen, die Cloud ist nicht erreichbar, im Wartungsmodus oder wartet auf eine Datenbank-Aktualisierung. Grau heißt: Bewertung nicht möglich, zum Beispiel wenn die Versionsdaten gerade nicht abrufbar sind. Tessera prüft jede Cloud automatisch einmal pro Stunde; „Jetzt prüfen“ und ein Knopf je Kachel prüfen sofort. Die Kacheln lassen sich nach Kundenname, Status (Rot zuerst), Version oder Support-Ende sortieren, die Wahl merkt sich Tessera für jeden Benutzer. Clouds eintragen, ändern, entfernen und Logos hinterlegen (Bild hochladen bis 1 MB oder eine https-Bildadresse) dürfen Administratoren und Benutzer mit der Freigabestufe „Verwalten“; alle anderen mit Freigabe sehen die Kacheln. Aktivieren Sie das Modul als Administrator im Marktplatz und erteilen Sie die Freigabe.
|
||||
- Nextcloud-Status: Auf jeder Kachel gibt es jetzt eine Glocke „Benachrichtigen“, die jeder Benutzer mit Zugriff auf das Modul für sich ein- und ausschalten kann. Ist sie an, meldet Tessera per E-Mail und, solange Tessera geöffnet ist, als Benachrichtigung auf dem Bildschirm (in der Desktop-App als Windows-Benachrichtigung), wenn die Cloud eine Störung hat – nicht erreichbar, keine gültige Antwort, Wartungsmodus, ausstehende Datenbank-Aktualisierung oder abgelaufener Support – und wenn sie wieder in Ordnung ist. Pro Änderung kommt genau eine Nachricht, solange die Störung anhält, nicht jede Stunde neu. Ein einzelner fehlgeschlagener Abruf löst keine Meldung aus: Die Kachel zeigt weiter den letzten guten Stand mit dem Hinweis „Prüfung fehlgeschlagen, wird in wenigen Minuten wiederholt“, und Tessera prüft nach etwa fünf Minuten erneut. Für die E-Mails muss der Mailversand eingerichtet sein und im Benutzerprofil eine E-Mail-Adresse stehen. Außerdem nennt die Kachel bei „Nicht erreichbar“ jetzt den Grund in Klartext, zum Beispiel „Zertifikat passt nicht zur Adresse“, „Adresse nicht gefunden“ oder „Zeitüberschreitung“, statt eines technischen Fehlercodes.
|
||||
- Neue Dashboard-Kachel „Nextcloud-Status“: drei Zähler für Grün, Gelb und Rot und darunter die roten und gelben Clouds mit Kundenname und Grund. Ein Klick öffnet das Modul. Die Kachel erscheint nur für Benutzer, die das Modul nutzen dürfen.
|
||||
|
||||
@@ -82,7 +82,7 @@
|
||||
"settingsAdmin": "Einstellungen/Administration",
|
||||
"logout": "Abmelden",
|
||||
"admin": {
|
||||
"label": "Verwaltung",
|
||||
"label": "Administration",
|
||||
"users": "Benutzer",
|
||||
"tenants": "Mandanten",
|
||||
"modules": "Module",
|
||||
@@ -111,7 +111,7 @@
|
||||
"label": "Kategorien",
|
||||
"empty": "Keine Module"
|
||||
},
|
||||
"admin": "Verwaltung",
|
||||
"admin": "Administration",
|
||||
"users": "Benutzer",
|
||||
"tenants": "Mandanten",
|
||||
"ldap": "LDAP",
|
||||
@@ -575,7 +575,7 @@
|
||||
"resend": "Erneut senden",
|
||||
"sentAt": "Willkommensmail gesendet am {date}",
|
||||
"noEmail": "Keine E-Mail-Adresse hinterlegt – bitte zuerst eine Adresse eintragen.",
|
||||
"noSmtp": "Es ist noch kein SMTP-Server eingerichtet (Verwaltung → E-Mail-Versand).",
|
||||
"noSmtp": "Es ist noch kein SMTP-Server eingerichtet (Administration → E-Mail-Versand).",
|
||||
"inactive": "Das Konto ist deaktiviert.",
|
||||
"dialogTitle": "Willkommensmail senden",
|
||||
"dialogText": "Tessera schickt eine Willkommensmail mit Adresse, Benutzername und Hinweisen zur ersten Anmeldung an:",
|
||||
@@ -941,7 +941,7 @@
|
||||
"close": "Schließen",
|
||||
"sent": "Vielen Dank, die Meldung wurde gesendet.",
|
||||
"errorNotConfigured": "Für Fehlermeldungen ist noch kein Postfach eingerichtet.",
|
||||
"errorNotConfiguredAdminHint": "Legen Sie die Adresse unter Verwaltung → E-Mail-Versand im Feld „Fehlermeldungen an\" fest.",
|
||||
"errorNotConfiguredAdminHint": "Legen Sie die Adresse unter Administration → E-Mail-Versand im Feld „Fehlermeldungen an\" fest.",
|
||||
"errorNotConfiguredAdminLink": "Zu den SMTP-Einstellungen",
|
||||
"errorTooMany": "Zu viele Meldungen in kurzer Zeit. Bitte versuchen Sie es in einigen Minuten erneut.",
|
||||
"errorTooLarge": "Das Bild ist zu groß. Bitte senden Sie die Meldung ohne Bildschirmfoto.",
|
||||
@@ -1988,9 +1988,9 @@
|
||||
}
|
||||
},
|
||||
"controlCenter": {
|
||||
"navLabel": "Einstellungen und Verwaltung",
|
||||
"navLabel": "Einstellungen und Administration",
|
||||
"settingsTitle": "Einstellungen",
|
||||
"adminTitle": "Verwaltung",
|
||||
"adminTitle": "Administration",
|
||||
"groups": {
|
||||
"people": "Benutzer und Zugang",
|
||||
"modules": "Module",
|
||||
|
||||
@@ -28,14 +28,14 @@ Tessera kennt drei Rollen:
|
||||
|
||||
Wichtige Details, die im Code tatsächlich so umgesetzt sind:
|
||||
|
||||
- Im Profilmenü heißt der Eintrag für ADMIN und SUPER_ADMIN „Einstellungen/Administration“ (für alle anderen „Einstellungen“). Er führt in dieselbe Leiste, in der Administratoren unter den persönlichen Einstellungen zusätzlich die Verwaltung sehen. Ein Benutzer mit der Rolle USER sieht die Verwaltung dort nicht und hat keinen Zugang zum Administrationsbereich.
|
||||
- Einstellungen und Verwaltung teilen sich eine Leiste: oben die persönlichen Einstellungen, darunter die Verwaltung in drei Gruppen – **Benutzer und Zugang** (Benutzer, Gruppen, Willkommensmail, Mandanten), **Module** (Module, Freigaben, Kategorien, Eigene Module für alle) und **Anbindungen** (Verzeichnis (LDAP), E-Mail-Versand (SMTP)). „Mandanten“ ist der einzige Eintrag, der ausschließlich für SUPER_ADMIN sichtbar ist; alle anderen sind für ADMIN und SUPER_ADMIN gleichermaßen erreichbar.
|
||||
- Im Profilmenü heißt der Eintrag für ADMIN und SUPER_ADMIN „Einstellungen/Administration“ (für alle anderen „Einstellungen“). Er führt in dieselbe Leiste, in der Administratoren unter den persönlichen Einstellungen zusätzlich die Administration sehen. Ein Benutzer mit der Rolle USER sieht die Administration dort nicht und hat keinen Zugang zum Administrationsbereich.
|
||||
- Einstellungen und Administration teilen sich eine Leiste: oben die persönlichen Einstellungen, darunter die Administration in drei Gruppen – **Benutzer und Zugang** (Benutzer, Gruppen, Willkommensmail, Mandanten), **Module** (Module, Freigaben, Kategorien, Eigene Module für alle) und **Anbindungen** (Verzeichnis (LDAP), E-Mail-Versand (SMTP)). „Mandanten“ ist der einzige Eintrag, der ausschließlich für SUPER_ADMIN sichtbar ist; alle anderen sind für ADMIN und SUPER_ADMIN gleichermaßen erreichbar.
|
||||
- **ADMIN und SUPER_ADMIN haben immer Zugriff auf alle für den Mandanten aktivierten Module** – unabhängig von der Freigaben-Matrix (siehe Kapitel 5). Die Matrix regelt ausschließlich, welche Module ein Benutzer mit der Rolle USER sehen darf und in welcher Stufe („Benutzen“ oder „Verwalten“, siehe Kapitel 5). Administratoren haben auf jedem aktiven Modul automatisch die Stufe „Verwalten“.
|
||||
- Ein ADMIN kann einem Benutzer nicht die Rolle SUPER_ADMIN zuweisen – weder beim Anlegen noch beim Bearbeiten. Nur ein SUPER_ADMIN darf das.
|
||||
|
||||
## 2. Benutzerverwaltung
|
||||
|
||||
Der Bereich **Verwaltung → Benutzer** zeigt eine Tabelle mit Benutzername, E-Mail, Anzeigename, Rolle, Status und **Letzte Anmeldung** (Datum und Uhrzeit der letzten Anmeldung, bei neuen Konten „Noch nie“). Ein ADMIN sieht dabei ausschließlich die Benutzer des eigenen Mandanten, ein SUPER_ADMIN sieht alle.
|
||||
Der Bereich **Administration → Benutzer** zeigt eine Tabelle mit Benutzername, E-Mail, Anzeigename, Rolle, Status und **Letzte Anmeldung** (Datum und Uhrzeit der letzten Anmeldung, bei neuen Konten „Noch nie“). Ein ADMIN sieht dabei ausschließlich die Benutzer des eigenen Mandanten, ein SUPER_ADMIN sieht alle.
|
||||
|
||||
### Benutzer anlegen
|
||||
|
||||
@@ -64,7 +64,7 @@ Ein Passwort steht nie in der Mail. Bei einem lokalen Konto, das bereits ein Pas
|
||||
|
||||
#### Eigene Vorlage für die Willkommensmail
|
||||
|
||||
Unter **Verwaltung → Willkommensmail** legen Sie fest, mit welchen Worten Tessera neue Benutzer begrüßt. Die Vorlage gilt für Ihren Mandanten; ADMIN und SUPER_ADMIN können sie bearbeiten. Anpassen lassen sich sechs Texte:
|
||||
Unter **Administration → Willkommensmail** legen Sie fest, mit welchen Worten Tessera neue Benutzer begrüßt. Die Vorlage gilt für Ihren Mandanten; ADMIN und SUPER_ADMIN können sie bearbeiten. Anpassen lassen sich sechs Texte:
|
||||
|
||||
- **Betreff** (Pflicht, höchstens 200 Zeichen),
|
||||
- **Überschrift** (Pflicht, höchstens 200 Zeichen),
|
||||
@@ -108,7 +108,7 @@ Der eigene Account lässt sich nicht löschen; der Löschen-Button ist für die
|
||||
|
||||
## 3. Gruppen
|
||||
|
||||
Der Bereich **Verwaltung → Gruppen** verwaltet Gruppen, über die Modulzugriff vergeben wird (siehe Kapitel 5). Es gibt zwei Arten von Gruppen:
|
||||
Der Bereich **Administration → Gruppen** verwaltet Gruppen, über die Modulzugriff vergeben wird (siehe Kapitel 5). Es gibt zwei Arten von Gruppen:
|
||||
|
||||
- **Manuelle Gruppen**: über „Gruppe erstellen“ mit einem frei wählbaren Namen angelegt. Name und Mitglieder lassen sich jederzeit bearbeiten.
|
||||
- **AD-gebundene Gruppen**: entstehen ausschließlich über den Import im LDAP-Bereich (Kapitel 4, „AD-Gruppen importieren“) – sie können nicht über den „Gruppe erstellen“-Dialog angelegt werden. Der Dialog weist bei einer Neuanlage per Hinweistext auf den LDAP-Bereich hin.
|
||||
@@ -140,7 +140,7 @@ Der Löschen-Dialog zeigt vorab an, wie viele Mitglieder und Modul-Freigaben von
|
||||
|
||||
## 4. AD-/LDAP-Anbindung
|
||||
|
||||
Der Bereich **Verwaltung → Verzeichnis (LDAP)** bündelt alles rund um die Anbindung an ein Active Directory bzw. einen LDAP-Verzeichnisdienst. Er ist in mehrere Abschnitte gegliedert.
|
||||
Der Bereich **Administration → Verzeichnis (LDAP)** bündelt alles rund um die Anbindung an ein Active Directory bzw. einen LDAP-Verzeichnisdienst. Er ist in mehrere Abschnitte gegliedert.
|
||||
|
||||
### Verbindungseinstellungen
|
||||
|
||||
@@ -216,8 +216,8 @@ Schlägt der Sync-Lauf als Ganzes fehl (z. B. weil die Verbindung nicht zustande
|
||||
|
||||
Der Zugriff auf ein Modul läuft zweistufig:
|
||||
|
||||
1. **Aktivierung für den Mandanten** (Verwaltung → Module): Ein Modul muss zunächst für den Mandanten aktiviert werden. Ohne Aktivierung ist es für niemanden im Mandanten nutzbar, unabhängig von jeder Freigabe.
|
||||
2. **Freigabe pro Gruppe oder Benutzer** (Verwaltung → Freigaben bzw. Benutzer-Detaildialog): Erst danach lässt sich steuern, welche Gruppen oder einzelnen Benutzer mit der Rolle USER Zugriff erhalten.
|
||||
1. **Aktivierung für den Mandanten** (Administration → Module): Ein Modul muss zunächst für den Mandanten aktiviert werden. Ohne Aktivierung ist es für niemanden im Mandanten nutzbar, unabhängig von jeder Freigabe.
|
||||
2. **Freigabe pro Gruppe oder Benutzer** (Administration → Freigaben bzw. Benutzer-Detaildialog): Erst danach lässt sich steuern, welche Gruppen oder einzelnen Benutzer mit der Rolle USER Zugriff erhalten.
|
||||
|
||||
ADMIN und SUPER_ADMIN benötigen dafür keine Freigabe – sie haben, sobald ein Modul mandantenweit aktiviert ist, automatisch Zugriff darauf. Die Freigaben-Matrix betrifft ausschließlich die Rolle USER.
|
||||
|
||||
@@ -232,7 +232,7 @@ Ein bereits aktiviertes Modul lässt sich direkt über den Schalter wieder deakt
|
||||
|
||||
### Freigaben-Matrix
|
||||
|
||||
Unter „Verwaltung → Freigaben“ erscheint eine Tabelle: Zeilen sind die aktivierten Module (nach Kategorie gruppiert), Spalten sind die Gruppen des Mandanten (angezeigt mit ihrem internen Namen, falls gesetzt, sonst mit dem regulären Namen). Jede Zelle ist eine Checkbox, die die Freigabe für genau diese Kombination aus Modul und Gruppe an- oder abschaltet – Änderungen werden sofort gespeichert. Bei einer freigegebenen Zelle erscheint neben der Checkbox ein Auswahlfeld für die **Stufe**: „Benutzen“ (Standard) oder „Verwalten“. Ein erneutes Ankreuzen ändert die Stufe nie; sie wechseln Sie nur über das Auswahlfeld. Über das Suchfeld lässt sich sowohl nach Modul- als auch nach Gruppennamen filtern; ein Treffer auf nur einer Achse leert die andere Achse nicht.
|
||||
Unter „Administration → Freigaben“ erscheint eine Tabelle: Zeilen sind die aktivierten Module (nach Kategorie gruppiert), Spalten sind die Gruppen des Mandanten (angezeigt mit ihrem internen Namen, falls gesetzt, sonst mit dem regulären Namen). Jede Zelle ist eine Checkbox, die die Freigabe für genau diese Kombination aus Modul und Gruppe an- oder abschaltet – Änderungen werden sofort gespeichert. Bei einer freigegebenen Zelle erscheint neben der Checkbox ein Auswahlfeld für die **Stufe**: „Benutzen“ (Standard) oder „Verwalten“. Ein erneutes Ankreuzen ändert die Stufe nie; sie wechseln Sie nur über das Auswahlfeld. Über das Suchfeld lässt sich sowohl nach Modul- als auch nach Gruppennamen filtern; ein Treffer auf nur einer Achse leert die andere Achse nicht.
|
||||
|
||||
Ein Hinweistext unterhalb der Matrix erklärt die beiden Stufen und erinnert daran, dass Administratoren immer Zugriff auf alle aktiven Module haben und diese Matrix nur Benutzer ohne Administratorrechte betrifft.
|
||||
|
||||
@@ -259,7 +259,7 @@ Weiterhin **ausschließlich Administratoren** vorbehalten bleiben: Freigaben ert
|
||||
|
||||
### Kategorien
|
||||
|
||||
Unter „Verwaltung → Kategorien“ bestimmen Sie, wie die Module in der Seitenleiste, im Marktplatz und in der Freigaben-Matrix gruppiert und sortiert werden. Die Einstellung gilt für alle Benutzer. Die Seite ist nur für Administratoren erreichbar.
|
||||
Unter „Administration → Kategorien“ bestimmen Sie, wie die Module in der Seitenleiste, im Marktplatz und in der Freigaben-Matrix gruppiert und sortiert werden. Die Einstellung gilt für alle Benutzer. Die Seite ist nur für Administratoren erreichbar.
|
||||
|
||||
- **Kategorie anlegen:** Name eintragen und „Kategorie anlegen“ wählen. Die neue Kategorie steht hinten. Der Name lässt sich später jederzeit ändern; die Adresse der Kategorie (der Teil nach /modules/ in der Adresszeile) bleibt dabei bestehen, damit gespeicherte Lesezeichen weiter funktionieren.
|
||||
- **Umbenennen:** „Umbenennen“ an der Kategorie, neuen Namen eintragen, „Speichern“. Eine Kategorie, die Sie nicht umbenannt haben, zeigt weiterhin den mitgelieferten Namen in der Sprache des Benutzers.
|
||||
@@ -272,7 +272,7 @@ Benutzer können für ihre persönlichen Einträge unter „Einstellungen → Ei
|
||||
|
||||
### Eigene Module (Seitenleisten-Einträge)
|
||||
|
||||
Unter „Verwaltung → Eigene Module“ legen Sie **gemeinsame** Seitenleisten-Einträge an, die alle Benutzer des Mandanten sehen: Name, Adresse (nur https, ohne Benutzername und Kennwort) und Kategorie. Ein Klick auf den Eintrag zeigt die Seite direkt in Tessera; manche Webseiten verbieten das Einbetten, dann hilft der Knopf „In neuem Tab öffnen“. Diese Einträge hängen an keiner Modul-Aktivierung und keiner Freigabe – sie erscheinen für jeden angemeldeten Benutzer. Nur Administratoren dürfen sie anlegen, ändern und löschen.
|
||||
Unter „Administration → Eigene Module“ legen Sie **gemeinsame** Seitenleisten-Einträge an, die alle Benutzer des Mandanten sehen: Name, Adresse (nur https, ohne Benutzername und Kennwort) und Kategorie. Ein Klick auf den Eintrag zeigt die Seite direkt in Tessera; manche Webseiten verbieten das Einbetten, dann hilft der Knopf „In neuem Tab öffnen“. Diese Einträge hängen an keiner Modul-Aktivierung und keiner Freigabe – sie erscheinen für jeden angemeldeten Benutzer. Nur Administratoren dürfen sie anlegen, ändern und löschen.
|
||||
|
||||
Daneben kann **jeder Benutzer** – auch Sie selbst – unter „Einstellungen → Eigene Module“ persönliche Einträge anlegen. Diese sieht ausschließlich der Besitzer; Administratoren sehen und ändern sie nicht. Wird ein Benutzer gelöscht, verschwinden seine persönlichen Einträge mit. Die Verwaltungsseite zeigt deshalb nur die gemeinsamen Einträge.
|
||||
|
||||
@@ -358,7 +358,7 @@ Das Modul „Nextcloud-Status“ (Gruppe Infrastruktur) aktivieren Sie wie jedes
|
||||
|
||||
## 6. SMTP
|
||||
|
||||
Unter **Verwaltung → E-Mail-Versand (SMTP)** wird der Mailversand konfiguriert: Host, Port, Verschlüsselung (Keine, STARTTLS oder SSL-TLS), Benutzername, Passwort, die Absenderadresse und optional das Feld „Fehlermeldungen an“ (siehe unten). Das Passwortfeld wird aus Sicherheitsgründen nie mit dem gespeicherten Wert vorbefüllt – es bleibt beim Laden immer leer und wird nur mitgesendet, wenn tatsächlich ein neuer Wert eingegeben wurde.
|
||||
Unter **Administration → E-Mail-Versand (SMTP)** wird der Mailversand konfiguriert: Host, Port, Verschlüsselung (Keine, STARTTLS oder SSL-TLS), Benutzername, Passwort, die Absenderadresse und optional das Feld „Fehlermeldungen an“ (siehe unten). Das Passwortfeld wird aus Sicherheitsgründen nie mit dem gespeicherten Wert vorbefüllt – es bleibt beim Laden immer leer und wird nur mitgesendet, wenn tatsächlich ein neuer Wert eingegeben wurde.
|
||||
|
||||
Über „Test-E-Mail an“ lässt sich optional eine echte Testnachricht an eine beliebige Adresse verschicken, um die Konfiguration vor dem produktiven Einsatz zu prüfen.
|
||||
|
||||
@@ -373,7 +373,7 @@ Die Anmeldung selbst, der laufende Betrieb und die LDAP-Synchronisation sind von
|
||||
|
||||
## 7. Mandanten
|
||||
|
||||
Der Bereich **Verwaltung → Mandanten** ist ausschließlich für SUPER_ADMIN sichtbar und zugänglich (siehe Kapitel 1). Er bietet:
|
||||
Der Bereich **Administration → Mandanten** ist ausschließlich für SUPER_ADMIN sichtbar und zugänglich (siehe Kapitel 1). Er bietet:
|
||||
|
||||
- eine Übersicht aller Mandanten mit Name, Slug, Status (Aktiv/Inaktiv) und Anzahl der zugehörigen Benutzer;
|
||||
- „Mandant erstellen“ mit den Feldern Name und Slug (Slug nur bei der Neuanlage editierbar, danach fest);
|
||||
@@ -396,7 +396,7 @@ Ein Mandant lässt sich **nicht löschen, solange er noch aktive Benutzer hat**
|
||||
| Ein neu importierter/erstellter Benutzer hat unerwartet Zugriff auf ein Modul, das eigentlich niemandem freigegeben sein sollte. | Der Benutzer wurde automatisch Mitglied der Standardgruppe (siehe Kapitel 3), und dieser Gruppe wurde beim Aktivieren eines Moduls über „Sofort freigeben“ Zugriff erteilt. Freigaben-Matrix prüfen und ggf. die Standardgruppen-Freigabe für das betreffende Modul entfernen. |
|
||||
| Der Name einer AD-gebundenen Gruppe „springt“ nach jedem Sync-Lauf auf den AD-Namen zurück, obwohl ein anderer Name gewünscht ist. | Erwartetes Verhalten: Der Anzeigename einer AD-gebundenen Gruppe wird bei jedem Sync mit dem AD-Wert überschrieben. Für einen dauerhaft abweichenden Anzeigenamen den „Internen Namen“ im Bearbeiten-Dialog der Gruppe setzen – dieses Feld wird von der Synchronisation nie berührt. |
|
||||
| Ein AD-Gruppen-Import schlägt für eine bestimmte Gruppe mit einem Namenskonflikt fehl. | Es existiert bereits eine lokale (manuelle) Gruppe mit demselben Namen. Diese lokale Gruppe umbenennen oder – falls es sich tatsächlich um dieselbe Gruppe handeln soll – vor dem Import einen internen Namen dafür vergeben, dann erneut importieren. |
|
||||
| Anwender melden, der Knopf „Fehler melden“ sage, es sei kein Postfach eingerichtet. | Feld „Fehlermeldungen an“ unter Verwaltung → E-Mail-Versand (SMTP) ausfüllen und speichern (die SMTP-Einstellungen müssen vollständig sein, das Feld gehört zu ihnen). |
|
||||
| Eine Fehlermeldung meldet „E-Mail konnte nicht gesendet werden“. | Der SMTP-Versand des Mandanten scheitert. „Verbindung testen“ unter Verwaltung → E-Mail-Versand (SMTP) ausführen und das Serverprotokoll der API prüfen (Zeile „Bug report mail failed“). |
|
||||
| Eine Test- oder Benachrichtigungs-E-Mail kommt nicht an. | SMTP-Konfiguration unter Verwaltung → E-Mail-Versand (SMTP) prüfen (Host, Port, Verschlüsselungsart, Zugangsdaten, Absenderadresse) und über „Verbindung testen“ mit einer Test-Empfängeradresse erneut prüfen. |
|
||||
| Anwender melden, der Knopf „Fehler melden“ sage, es sei kein Postfach eingerichtet. | Feld „Fehlermeldungen an“ unter Administration → E-Mail-Versand (SMTP) ausfüllen und speichern (die SMTP-Einstellungen müssen vollständig sein, das Feld gehört zu ihnen). |
|
||||
| Eine Fehlermeldung meldet „E-Mail konnte nicht gesendet werden“. | Der SMTP-Versand des Mandanten scheitert. „Verbindung testen“ unter Administration → E-Mail-Versand (SMTP) ausführen und das Serverprotokoll der API prüfen (Zeile „Bug report mail failed“). |
|
||||
| Eine Test- oder Benachrichtigungs-E-Mail kommt nicht an. | SMTP-Konfiguration unter Administration → E-Mail-Versand (SMTP) prüfen (Host, Port, Verschlüsselungsart, Zugangsdaten, Absenderadresse) und über „Verbindung testen“ mit einer Test-Empfängeradresse erneut prüfen. |
|
||||
| Ein Mandant lässt sich nicht löschen. | Der Mandant hat noch mindestens einen aktiven Benutzer. Alle Benutzer des Mandanten zunächst deaktivieren oder umziehen, dann erneut löschen. |
|
||||
|
||||
@@ -232,7 +232,7 @@ Das Modul ordnet Handelswaren-Umsätze aus einer Excel-Liste den Erlöskonten zu
|
||||
|
||||
## Persönliche Einstellungen
|
||||
|
||||
Öffnen Sie **Einstellungen** über das Benutzermenü oben rechts (bei Administratoren heißt der Eintrag „Einstellungen/Administration“). Links steht eine Leiste mit den Seiten Konto, Widgets, Kalender, Eigene Module und Desktop-App. Jede Seite ist gleich aufgebaut: oben Titel und eine kurze Erklärung, darunter Karten mit je einem Thema; die Knöpfe zum Speichern stehen unten rechts in der jeweiligen Karte. Auf dem Handy wählen Sie die Seite oben über eine Auswahlliste. Administratoren sehen in derselben Leiste zusätzlich die Verwaltung.
|
||||
Öffnen Sie **Einstellungen** über das Benutzermenü oben rechts (bei Administratoren heißt der Eintrag „Einstellungen/Administration“). Links steht eine Leiste mit den Seiten Konto, Widgets, Kalender, Eigene Module und Desktop-App. Jede Seite ist gleich aufgebaut: oben Titel und eine kurze Erklärung, darunter Karten mit je einem Thema; die Knöpfe zum Speichern stehen unten rechts in der jeweiligen Karte. Auf dem Handy wählen Sie die Seite oben über eine Auswahlliste. Administratoren sehen in derselben Leiste zusätzlich die Administration.
|
||||
|
||||
**Konto:**
|
||||
- **Profilbild:** Laden Sie ein Bild hoch (PNG, JPEG oder WebP, maximal 2 MB) oder löschen Sie das vorhandene wieder.
|
||||
@@ -351,5 +351,5 @@ Sie schließen das Fenster mit **Verstanden**, mit dem Kreuz oben rechts, mit de
|
||||
- **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.
|
||||
- **Der Knopf „Fehler melden" antwortet, es sei kein Postfach eingerichtet.** Ihr Administrator hat unter Verwaltung → E-Mail-Versand (SMTP) noch keine Adresse im Feld „Fehlermeldungen an" hinterlegt. Sprechen Sie ihn an – die Meldung selbst geht dabei nicht verloren, Sie können sie danach erneut senden.
|
||||
- **Der Knopf „Fehler melden" antwortet, es sei kein Postfach eingerichtet.** Ihr Administrator hat unter Administration → E-Mail-Versand (SMTP) noch keine Adresse im Feld „Fehlermeldungen an" hinterlegt. Sprechen Sie ihn an – die Meldung selbst geht dabei nicht verloren, Sie können sie danach erneut senden.
|
||||
- **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.
|
||||
|
||||
@@ -159,7 +159,7 @@ Zugangsdaten.
|
||||
| `TESSERA_ADMIN_PASSWORD` | ja (für den Seed) | – | Initiales Passwort des Super-Admin. |
|
||||
| `TESSERA_FORCE_CHANGE` | nein | `true` | Erzwingt Passwortwechsel beim ersten Login des geseedeten Admin-Accounts. |
|
||||
| `TESSERA_SMTP_HOST` / `_PORT` / `_SECURE` / `_USER` / `_PASSWORD` / `_FROM` | nein (aber ohne Host kein Mailversand) | Host leer, Port `587`, `_SECURE=false` | SMTP-Relay für ausgehende Mails (Passwort-Reset, Benachrichtigungen). |
|
||||
| `TESSERA_BUGREPORT_TO` | nein | leer | Rückfall-Postfach für den Knopf „Fehler melden“ in der Kopfleiste, falls unter Verwaltung → E-Mail-Versand (SMTP) kein Feld „Fehlermeldungen an“ gesetzt ist. Leer = nur die Einstellung in der Oberfläche gilt. Wie `IMAGE_TAG` (Kapitel 9): die Serverdatei `/opt/tessera/docker-compose.prod.yml` bekommt die Zeile `TESSERA_BUGREPORT_TO: ${TESSERA_BUGREPORT_TO:-}` nur von Hand. |
|
||||
| `TESSERA_BUGREPORT_TO` | nein | leer | Rückfall-Postfach für den Knopf „Fehler melden“ in der Kopfleiste, falls unter Administration → E-Mail-Versand (SMTP) kein Feld „Fehlermeldungen an“ gesetzt ist. Leer = nur die Einstellung in der Oberfläche gilt. Wie `IMAGE_TAG` (Kapitel 9): die Serverdatei `/opt/tessera/docker-compose.prod.yml` bekommt die Zeile `TESSERA_BUGREPORT_TO: ${TESSERA_BUGREPORT_TO:-}` nur von Hand. |
|
||||
| `APP_URL` | empfohlen | `http://localhost:3001` (für `NEXT_PUBLIC_API_URL`) / `http://localhost:3000` (für `TESSERA_APP_URL`) | Öffentliche Basis-URL der Web-Oberfläche. Wird serverseitig u. a. für in E-Mails generierte Links verwendet (`TESSERA_APP_URL`). |
|
||||
| `API_INTERNAL_URL` | fest verdrahtet | `http://api:3001` | Adresse, unter der `web` die API **innerhalb** des Docker-Netzes erreicht; dorthin schreibt Next.js die `/api-proxy/*`-Rewrites um. In der Regel nicht ändern. |
|
||||
| `IMAGE_TAG` | empfohlen | `beta` | Welcher Kanal auf diesem Server läuft: `beta` (alle Neuerungen, alpha) oder `live` (nur freigegebene Versionen, tessera.ctl.de). Siehe Kapitel 9. |
|
||||
@@ -377,7 +377,7 @@ startet `web`, weil `depends_on: api: condition: service_healthy` das erzwingt.
|
||||
| Neue Version scheint nicht anzukommen, obwohl `pull` gelaufen ist | Klassische `up -d`-Falle ohne `--force-recreate` (siehe Kapitel 4) | `StartedAt` des Containers gegen `Created` des Images vergleichen, ggf. `--force-recreate` nachholen. |
|
||||
| Initialer Admin-Login funktioniert nicht nach Änderung von `TESSERA_ADMIN_PASSWORD` | Seed läuft nur, wenn der Benutzername noch **nicht** existiert; bestehende Accounts werden nicht überschrieben | Passwort über die Anwendung selbst (bzw. direkt in der Datenbank) ändern, nicht über die `.env`-Variable. |
|
||||
| Mails werden nicht versendet | `TESSERA_SMTP_HOST` leer (Prod-Default) | SMTP-Variablen vollständig setzen und Container neu erstellen. |
|
||||
| Fehlermeldungen der Anwender kommen nicht an | Kein Postfach gesetzt (weder „Fehlermeldungen an“ unter Verwaltung → E-Mail-Versand (SMTP) noch `TESSERA_BUGREPORT_TO`), oder der SMTP-Versand des Mandanten scheitert | Feld „Fehlermeldungen an“ (Verwaltung → E-Mail-Versand (SMTP)) oder `TESSERA_BUGREPORT_TO` prüfen; API-Log nach `Bug report` durchsuchen (eine Zeile je gesendeter Meldung mit dem Herkunfts-Kürzel `[Browser]`, `[Desktop/Windows]` oder `[Desktop/Linux]`, `Bug report mail failed` bei Versandfehler). |
|
||||
| Fehlermeldungen der Anwender kommen nicht an | Kein Postfach gesetzt (weder „Fehlermeldungen an“ unter Administration → E-Mail-Versand (SMTP) noch `TESSERA_BUGREPORT_TO`), oder der SMTP-Versand des Mandanten scheitert | Feld „Fehlermeldungen an“ (Administration → E-Mail-Versand (SMTP)) oder `TESSERA_BUGREPORT_TO` prüfen; API-Log nach `Bug report` durchsuchen (eine Zeile je gesendeter Meldung mit dem Herkunfts-Kürzel `[Browser]`, `[Desktop/Windows]` oder `[Desktop/Linux]`, `Bug report mail failed` bei Versandfehler). |
|
||||
| Avatare/DKV-Exporte nach einem Deploy verschwunden | Die verwendete Compose-Datei mountet `user-files/` nicht als Volume – im Repository-Stand seit dieser Version behoben, betrifft nur eine Installation mit abweichender Compose-Datei | Die zwei Zeilen aus Kapitel 6 in die verwendete Compose-Datei eintragen (auf dem Server: `/opt/tessera/docker-compose.yml`, vorher sichern) und `api` neu erstellen. |
|
||||
|
||||
## 8. Abgrenzung zur CI/CD-Pipeline
|
||||
|
||||
Reference in New Issue
Block a user