espid2sensor: Doku aktualisiert, eigene Bedienungsanleitung ergänzt
beschreibung.md auf technische Inhalte gekürzt und Bildverweise entfernt; neue Bedienungsanleitung.md für Endanwender ergänzt (ebenfalls ohne Bilder). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -7,59 +7,23 @@ Ist die `user`-Collection in der Mongo-Datenbank leer (z.B. bei einem neuen, ext
|
||||
|
||||
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:
|
||||
|
||||
Die Login-Seite dient der Anmeldung per E-Mail und Passwort. Nach erfolgreicher Anmeldung erscheint die Hauptseite mit den Tabs **Eingabe**, **Liste**, **Profil** und — nur für Admins — **User**, sowie einem **Logout**-Button ganz rechts in der Tab-Zeile.
|
||||
|
||||
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.
|
||||
* **Eingabe**: Erfassen/Ändern eines Datensatzes über Sensornummer (mit automatischer Adressermittlung), ESP-ID, Bezeichnung und Beschreibung.
|
||||
* **Liste**: paginierte, sortierbare Übersicht aller Datensätze mit Bearbeiten- und Löschen-Aktion je Zeile.
|
||||
* **Profil**: Ändern des eigenen Passworts (aktuelles Passwort, neues Passwort, Wiederholung).
|
||||
* **User** (nur Admin): Anlegen neuer User (E-Mail, Passwort, Rolle) sowie eine Liste aller vorhandenen User mit Aktionen zum Passwort-Zurücksetzen und Löschen (der eigene Account kann nicht gelöscht werden).
|
||||
|
||||
|
||||
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.
|
||||
Eine ausführliche Bedienungsanleitung für Endanwender steht in `Bedienungsanleitung.md`.
|
||||
|
||||
|
||||
#### History
|
||||
| Version | Datum | Author |Bemerkung|
|
||||
|---------|-------|-----|----------|
|
||||
| 1.2.0 | 2025-11-21 | rxf | extra properties-collection entfernt |
|
||||
| 1.2.0 | 2026-08-07 | rxf | verkürzt auf technische Dinge, Verweis auf Bedienunsgaleitung
|
||||
| 1.1.0 | 2025-09-03 | rxf | Ändern,Löschen und Usereingabe |
|
||||
|1.0.0 | 2025-08-19 | rxf | erste Fassung |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user