admin
7b3403d943
Für extern verwaltete Deployments (Portainer, kein direkter Mongo-Zugriff) wird beim Start automatisch ein Admin-User angelegt, falls die user-Collection leer ist und ADMIN_EMAIL/ADMIN_PASSWORD gesetzt sind. Login-Seite zeigt einen Hinweis, solange noch kein User existiert. Version auf 1.5.0 angehoben.
66 lines
4.2 KiB
Markdown
Executable File
66 lines
4.2 KiB
Markdown
Executable File
# Beschreibung von esp2senor
|
|
|
|
|
|
### Erststart / Bootstrap
|
|
|
|
Ist die `user`-Collection in der Mongo-Datenbank leer (z.B. bei einem neuen, extern verwalteten Deployment ohne direkten Datenbankzugriff), legt der Server beim Start automatisch einen Admin-User an — vorausgesetzt, die Umgebungsvariablen `ADMIN_EMAIL` und `ADMIN_PASSWORD` sind gesetzt. Fehlen sie, erscheint auf der Login-Seite ein entsprechender Hinweis und im Log eine Warnung.
|
|
|
|
Nach dem ersten Login mit diesen Zugangsdaten sollte das Passwort über den **Profil**-Tab geändert werden. Sobald mindestens ein User existiert, greift der Bootstrap-Mechanismus nicht mehr — weitere User werden wie gewohnt über den **User**-Tab (nur für Admins) angelegt.
|
|
|
|
### Aufruf
|
|
Für die Tests:
|
|
|
|
```
|
|
esp2sensor.fuerst-stuttgart.de
|
|
```
|
|
|
|
### Darstellung
|
|
|
|
Die Einstigsseite ist die **Login** Seite:
|
|
|
|
|
|
Hier wird die **E-Mail** als Username und das **Passwort** eingegeben. Während der Eingabe der E-Mail wird diese überprüft. Unterhalb der Eingabezeile wird angezeigt, ob die E-Mail bekannt ist, so dass Tippfehler sofort verbessert werdern können. Solange die E-Mail nicht vollständig ist, wird *Benutzer nicht gefunden* angezeigt.
|
|
Wurden die richtige E-Mail und das richtige Passwort eingegeben, gelangt man zu nächsten Seite.
|
|
|
|
|
|
Dies ist die **Eingabe**-Seite und sieht folgendermaßen aus:
|
|
|
|
|
|
Ganz oben sind zwei oder drei Tabs, ja nachdem ob der eingeloggte User ein Admin ist oder nicht. Der Admin kann über den Tab **User** einen neuen User anlegen. Diser Tab erschein bei 'Nicht-Admins' nicht.
|
|
Der Tab **Eingabe** wird automatisch als Standard ausgewählt. Hier werden nun folgende Daten eingegeben:
|
|
|
|
* In die Zeile **Sensornummer** wird die Sensornummer (die von sensor.community) eingetragen. Das Programm sucht daraufhin, ob die Sensornummer in der bisherigen Datenbank bekannt ist. Wenn ja, wird die Adresse aus den Koordinaten gelesen und in der Zeile **Anschrift** angezeigt. Falls nicht, erfolgt eine Fehlermeldung.
|
|
|
|
* Nun können die restlichen Daten, nämlich ESP-ID, Bezeichnung und Beschreibung eigegeben werden. Nur die ESP_ID **muss** eingegeben werden, die anderen beiden sind optional. Die Anschrift kann *nicht* eingegeben und *nicht* verändert werden.
|
|
|
|
* Durch Klick auf **Speichern** werden die Daten in die Datenbank übernommen. Eventuell schon in der DB vorhandene Daten werden überschrieben. Die Anschrift wird *nicht* gespeichert, da diese sich immer aus den schon vohandenen Koordinaten berechnet.
|
|
|
|
* Sollte die Sensornummer schon mal eingegeben worden sein, so werden alle eingegebenen Daten aus der Datenbank geholt und angezeigt. Sie können hier nun auch geändert werden (außer Anschrift).
|
|
|
|
|
|
Die zweite Seite ist die **Liste**:
|
|
|
|
|
|
Je mehr Daten vorliegen, desto länger wird die Liste. Über den Button **Aktualisieren** kann die Liste neu geladen werden. Über **Seite** kann die angezeigte Seite angewählt werde, über **Limit** wird die Anzahl der Einträge einer Seite festgelegt.
|
|
Am rechten Rand in der Spalte **Aktionen** sind zwei Symbole: einmal der **Stift** (✏️). Beim Klick darauf werde die Daten dieser Zeile wieder in die Eingabe-Maske geschrieben und können hier dann ggf. verändert werden. Das zweite Symbol ist der **Mülleimer** (🗑️), mit dem der komplette Eintrag (nach einer Sicherheitsrückfrage) gelöscht wird.
|
|
Die Liste kann nach folgenden Kriterien auf- oder absteigend sortiert werden: SensorNr, ESP-ID und Datum. Erkenntlich ist das an den kleine Pfeilen (↑↓)
|
|
|
|
Wenn der angemeldete user ein **Admin** ist, so kann über den Tab **User** ein neuer User angelegt werden:
|
|
|
|
|
|
Folgen Daten müssen eingegeben werden:
|
|
* der **Benutzername** ( == E-Mail)
|
|
* das **Passwort** für diesen Benutzer
|
|
* und die **Rolle**, also entweder normaler Benutzer (*User*) oder Administrator (*Admin*).
|
|
|
|
Durch Klicken auf **Anlegen** wird der neue User in der Datenbank gespeichert.
|
|
|
|
|
|
#### History
|
|
| Version | Datum | Author |Bemerkung|
|
|
|---------|-------|-----|----------|
|
|
| 1.2.0 | 2025-11-21 | rxf | extra properties-collection entfernt |
|
|
| 1.1.0 | 2025-09-03 | rxf | Ändern,Löschen und Usereingabe |
|
|
|1.0.0 | 2025-08-19 | rxf | erste Fassung |
|
|
|
|
|