iobroker.eos-admin 7.9.87-rc.3 → 7.9.89

package/INSTALL_TEST_V7.9.89.md

@@ -0,0 +1,73 @@
+# Installation und Abnahme – NexoWatt EOS Admin 7.9.89
+
+## Installation aus npm
+
+```bash
+cd /opt/iobroker
+iobroker backup
+iobroker stop eos-admin.0
+npm install --no-save --omit=dev iobroker.eos-admin@7.9.89
+iobroker upload eos-admin
+iobroker restart eos-admin.0
+```
+
+## Portbelegung
+
+```bash
+iobroker set admin.0 --port 18081 --ip 127.0.0.1 --enabled false
+iobroker set eos-admin.0 --port 8081 --ip 0.0.0.0 --enabled true
+iobroker restart eos-admin.0
+```
+
+Aufruf:
+
+```text
+http://SYSTEM-IP:8081
+```
+
+## Pflichtabnahme
+
+### Admin / Service
+
+- Anmeldung mit dem fest eingerichteten Passwort.
+- Kein erzwungener Erstkennwortdialog.
+- Expertenmodus verfügbar.
+- Interner Admin und System-Notfallsicherung sichtbar.
+- Vollständige Zugangs- und Rechteverwaltung.
+
+### Installateur
+
+- Erste Aktivierung: Ebene **Installateur**, Benutzer `installer`, Passwort leer, danach persönliches Passwort setzen.
+- Kein Expertenmodus.
+- Inbetriebnahme, Module, Dienste, Datenpunkte und Diagnose erreichbar.
+- **Zugänge & Rechte** erreichbar; nur Endkunden-Reset möglich.
+- Interner Admin und interne BackItUp-Notfallreserve nicht sichtbar.
+- NexoWatt Sicherung nutzbar, sofern installiert und freigegeben.
+
+### Gast / Endkunde
+
+- Erste Aktivierung: Ebene **Gast / Endkunde**, Benutzer `guest`, Passwort leer, danach persönliches Passwort setzen.
+- Kein Expertenmodus.
+- Freigegebenes Smart Home, Räume, Funktionen und Bedienoberflächen erreichbar.
+- Keine technischen System-, Repository-, Zertifikats- oder Rohdiagnosebereiche.
+- Interner Admin und interne BackItUp-Notfallreserve nicht sichtbar.
+- NexoWatt Sicherung nutzbar, sofern freigegeben.
+
+### Bedienoberfläche
+
+- EOS Assist sitzt im Kopfbereich und überlappt keine Inhalte.
+- Zugangsverwaltung erscheint nur unter **Zugänge & Rechte**.
+- Startseite ist **Übersicht**, nicht Easy.
+- Keine `permissionError`-Leerseite.
+- Dialoge, Popups und Schließen-Schaltflächen funktionieren.
+- Schreibbare Datenpunkte sind entsprechend Rolle bedienbar.
+
+## Rückfall auf 7.9.86
+
+```bash
+cd /opt/iobroker
+iobroker stop eos-admin.0
+npm install --no-save --omit=dev iobroker.eos-admin@7.9.86
+iobroker upload eos-admin
+iobroker restart eos-admin.0
+```

package/NEXOWATT_EOS_BUILD_INFO.json

@@ -1,37 +1,33 @@
 {
-  "version": "7.9.87-rc.3",
-  "channel": "release-candidate",
-  "baseFrontend": "validated v84 runtime with NexoWatt EOS role, first-login and product branding hardening",
+  "version": "7.9.89",
+  "channel": "stable-latest",
+  "baseFrontend": "validated Admin 7 runtime with NexoWatt EOS role, login, overview and service-reserve hardening",
   "runtimeEntry": "v84",
-  "releaseType": "product-role-first-login-rc3",
-  "release": "product-role-first-login-rc3",
-  "label": "v87-rc3",
+  "releaseType": "stable-sales-product-role-login-overview-reserve-visibility",
+  "release": "stable-sales-product-role-login-overview-reserve-visibility",
+  "label": "v89",
   "notes": [
-    "Stable 7.9.86 remains unchanged; this release candidate becomes 7.9.87 stable only after system and field acceptance.",
-    "Administrator/NexoWatt Service keeps unrestricted access and is never forced through first-login password setup.",
-    "Installer and end-user accounts must choose their own password at the first authenticated login.",
-    "Installers receive commissioning and troubleshooting access without users, credentials, repositories, certificates, ACL or expert administration.",
-    "End users can open EOS Admin for Smart Home, room/function assignment and explicitly released NexoWatt UI surfaces.",
-    "Customer-visible platform branding is NexoWatt EOS; technical compatibility identifiers and third-party license notices remain internal.",
-    "After first-login password setup, every detected authentication-session representation is invalidated server-side and authentication cookies are cleared.",
-    "Release candidates are publishable on npm under the rc dist-tag; the project .npmrc and publish guard prevent accidental latest publication.",
-    "Fresh EOS Admin instances use port 8081; the internal legacy admin is moved to the protected local port 18081 by the EOS security policy/installer sequence."
+    "7.9.89 is the accepted stable sales-product release and is intended for npm dist-tag latest.",
+    "Installer and Guest/End User perform their one-time passwordless activation inside the normal login card, then must create a personal password.",
+    "Admin/Service retains the configured password and is excluded from passwordless activation and role reset.",
+    "EOS Assist is integrated into the header and account management exists only under Zugänge & Rechte.",
+    "The current tab-intro overview is modernized; the Easy overview is not used.",
+    "The internal admin and BackItUp emergency reserve are restricted to Admin/Service; NexoWatt Backup remains available to approved roles.",
+    "EOS Admin defaults to port 8081; the internal legacy admin remains protected on 127.0.0.1:18081."
   ],
   "changes": [
-    "Creates and repairs NexoWatt Service, Installer and End User role groups with purpose-specific ACL profiles.",
-    "Repairs EOS Admin, system configuration and repository metadata ACLs so authenticated installer/end-user sessions can read the shell without gaining direct system-write access.",
-    "Keeps certificates, platform licenses and credential objects restricted to NexoWatt Admin / Service.",
-    "Adds a blocking first-login password workflow for installer/end-user roles with server-side password validation and forced logout.",
-    "Allows end-user Smart Home room/function assignments while keeping raw system, adapter and expert areas hidden.",
-    "Adds a low-overhead visible-branding sanitizer for NexoWatt EOS product presentation.",
-    "Uses the authenticated EOS self-service route with trusted backend context so installer/end-user roles can set their own first-login password without global user-management rights.",
-    "Fails closed to the end-user policy for missing socket identities and invalidates first-login sessions after the password is changed.",
-    "Replaces the all-or-nothing prerelease publish blocker with an rc-channel guard and regression test.",
-    "Sets the EOS Admin product default port to 8081 and adds a regression test that rejects a return to 8091."
+    "Integrates role selection into the normal login card and removes the separate passwordless-first-login panel.",
+    "Moves EOS Assist into the top header and removes overlapping floating launchers.",
+    "Keeps account and password reset functions exclusively under Zugänge & Rechte.",
+    "Modernizes the current overview for Admin, Installer and Guest/End User without using Easy mode.",
+    "Restricts exact official admin and backitup adapter/instance visibility and control to Admin/Service at UI, socket and object ACL layers.",
+    "Keeps NexoWatt Backup visible and usable for approved installer and end-user roles.",
+    "Retains Admin/Service-only expert mode, service settings and security administration.",
+    "Publishes the final stable package through npm latest with exact version and package validation."
   ],
-  "brandingCacheVersion": 87,
-  "shellCacheVersion": 87,
-  "nativeShellVersion": 87,
-  "shellCacheTag": "87rc3",
-  "repositoryEntry": "nexowatt-eos-admin-repository-entry-v87-rc3.json"
+  "brandingCacheVersion": 89,
+  "shellCacheVersion": 89,
+  "nativeShellVersion": 89,
+  "shellCacheTag": "89",
+  "repositoryEntry": "nexowatt-eos-admin-repository-entry-v89.json"
 }

package/PUBLISH_STABLE_V7.9.89.md

@@ -0,0 +1,33 @@
+# npm-Veröffentlichung – NexoWatt EOS Admin 7.9.89 Stable
+
+## Vorprüfung
+
+```powershell
+npm run check:eos-publish-channel
+npm run check:eos-package
+npm run check:eos-stability
+npm publish --dry-run --tag latest
+```
+
+## Veröffentlichung
+
+```powershell
+npm login
+npm whoami
+npm publish --tag latest
+```
+
+## Kontrolle
+
+```powershell
+npm view iobroker.eos-admin@latest version
+npm dist-tag ls iobroker.eos-admin
+```
+
+Erwartet:
+
+```text
+latest: 7.9.89
+```
+
+Bereits veröffentlichte Paketversionen dürfen nicht mit verändertem Inhalt erneut veröffentlicht werden. Jede spätere Änderung benötigt eine höhere Versionsnummer.

package/README.md

@@ -13,6 +13,12 @@ Standard-Port:          8081
 
 Damit überschreibt der Adapter den offiziellen `admin`-Adapter nicht mehr. Die alte ioBroker-Admin-Oberfläche kann parallel vorhanden bleiben, während NexoWatt-Systeme über `eos-admin.0` die EOS-Oberfläche nutzen.
 
+## Aktuelle Stable 7.9.89
+
+Die Verkaufsversion 7.9.89 verwendet die aktuelle **Übersicht** als Startseite, integriert EOS Assist in den Header und führt Zugangsverwaltung ausschließlich unter **Zugänge & Rechte**. Installer und Guest aktivieren ihr Konto beim ersten Login im normalen Anmeldeformular einmalig ohne Startpasswort und vergeben anschließend ein persönliches Passwort. Admin / Service bleibt unverändert.
+
+Der interne Admin und die interne BackItUp-Notfallreserve bleiben installiert, sind aber ausschließlich für Admin / Service sichtbar. Für den regulären Betrieb wird die NexoWatt Sicherung verwendet.
+
 ## Installation über das NexoWatt Repository
 
 Im NexoWatt Repository muss der Adapter unter dem Key `eos-admin` stehen. Da das npm-Paket unscoped `iobroker.eos-admin` heißt, ist kein `packetName` nötig.
@@ -23,7 +29,7 @@ Minimaler Repository-Eintrag:
 {
   "eos-admin": {
     "name": "eos-admin",
-    "version": "7.9.29",
+    "version": "7.9.89",
     "title": "NexoWatt EOS Admin",
     "desc": {
       "de": "NexoWatt EOS Administrationsoberfläche als eigenständiger Adapter.",
@@ -81,7 +87,7 @@ Danach läuft NexoWatt EOS Admin unter:
 http://DEINE-IP:8081
 ```
 
-Den offiziellen `admin`-Adapter erst löschen, wenn der Zugriff über `eos-admin.0` zuverlässig funktioniert.
+Den internen `admin`-Adapter nicht löschen. Er bleibt deaktiviert auf `127.0.0.1:18081` als geschützte Service-Reserve erhalten.
 
 
 ## EOS Rollen- und Löschschutz
@@ -97,7 +103,12 @@ Standardmäßig geschützt:
 
 ```text
 eos-admin
+admin
 backitup
+nexowatt-backup
+eos-backup
+nexowatt-devices
+nexowatt-ui
 ```
 
 Administratoren können weitere Adapter in der Tabelle `Protected adapters` ergänzen. Die sichtbaren Admin-Gruppen werden über `EOS admin groups` definiert, standardmäßig `administrator`.

package/README_STABILITY_V7.9.89.md

@@ -0,0 +1,26 @@
+# NexoWatt EOS Admin 7.9.89 – Stable
+
+Version 7.9.89 ist die freigegebene Produktlinie für NexoWatt-EOS-Verkaufssysteme auf Basis der bewährten Admin-7-Laufzeit.
+
+## Produktfunktionen
+
+- Rollenmodell **Admin / Service**, **Installateur** und **Gast / Endkunde**.
+- Expertenmodus ausschließlich für Admin / Service.
+- Installateurzugriff für Inbetriebnahme, Konfiguration und Fehlersuche.
+- Endkundenzugriff für freigegebenes Smart Home, Räume, Funktionen und NexoWatt-Bedienbereiche.
+- Erstanmeldung von `installer` und `guest` direkt in der normalen Anmeldekarte: Benutzerstufe wählen, Passwort einmalig leer lassen und anschließend zwingend ein persönliches Passwort vergeben.
+- Passwort-Reset: Admin / Service darf Installateur und Endkunde zurücksetzen; Installateur ausschließlich Endkunde.
+- EOS Assist im Kopfbereich ohne Überlagerung der Inhaltsfläche.
+- Zugangsverwaltung ausschließlich unter **Zugänge & Rechte**.
+- Moderne aktuelle **Übersicht**; die Easy-Übersicht wird nicht als Produktstartseite verwendet.
+- Interner System-Admin und interne BackItUp-Notfallreserve nur für Admin / Service sichtbar.
+- NexoWatt Sicherung für die dafür freigegebenen Rollen nutzbar.
+- Standardport 8081; interne Admin-Reserve auf 127.0.0.1:18081.
+
+## Sicherheitsprinzip
+
+Ausgeblendete Bedienelemente sind nicht die einzige Schutzschicht. Kritische Aktionen werden zusätzlich über Rollenprüfung, Socket-Guard und Objekt-ACLs abgesichert. Fehlende oder unbekannte Rollen fallen auf die geringsten Endkundenrechte zurück.
+
+## Rückfallstand
+
+Die vorherige Stable 7.9.86 bleibt als dokumentierter Rückfallstand erhalten. Vor einem Produktupdate ist ein vollständiges Backup vorgeschrieben.

package/RELEASE_ACCEPTANCE_V7.9.89.md

@@ -0,0 +1,40 @@
+# Release-Abnahme – NexoWatt EOS Admin 7.9.89
+
+## Automatische Prüfgates
+
+- [ ] Versionsgleichheit in package.json, Lockdateien, io-package.json, Frontend und Build-Info
+- [ ] npm-Kanal `latest`
+- [ ] Paketvalidierung
+- [ ] Syntax- und Importintegrität
+- [ ] Frontend-Abhängigkeitsgraph
+- [ ] Rollen- und Rechteprüfung
+- [ ] integrierte Erstanmeldung
+- [ ] Passwort-Reset-Hierarchie
+- [ ] Expertenmodus-Sperre
+- [ ] interne Admin-/BackItUp-Reserve
+- [ ] NexoWatt-Sicherung für freigegebene Rollen
+- [ ] moderne Übersicht und Header-EOS-Assist
+- [ ] Zugangsverwaltung nur unter Zugänge & Rechte
+- [ ] Popup-, Datenpunkt- und Updateprüfung
+- [ ] Standardport 8081
+- [ ] npm pack und npm publish --dry-run
+
+## Reale Systemabnahme
+
+- [ ] Neuinstallation auf dem Produktcontroller
+- [ ] Update von 7.9.86
+- [ ] Admin-/Service-Anmeldung
+- [ ] Installateur-Erstanmeldung ohne Startpasswort
+- [ ] Guest-Erstanmeldung ohne Startpasswort
+- [ ] Admin setzt Installateur zurück
+- [ ] Admin setzt Guest zurück
+- [ ] Installateur setzt Guest zurück
+- [ ] Installateur kann weder sich selbst noch Admin zurücksetzen
+- [ ] Guest kann keine Zugänge zurücksetzen
+- [ ] Neustart des Controllers
+- [ ] Anmeldung nach Neustart
+- [ ] NexoWatt Sicherung erstellen und Rücklesetest
+- [ ] interne Notfallreserve nur als Admin sichtbar
+- [ ] Rollback auf 7.9.86
+
+Eine Checkbox darf erst nach nachvollziehbarem Testnachweis gesetzt werden.

package/admin/jsonConfig.json5

@@ -385,13 +385,46 @@
                     newLine: true,
                     type: 'checkbox',
                     label: 'Standardkonten automatisch den EOS Rollen zuordnen',
-                    help: 'Ordnet vorhandene Konten installer/installateur der Installateurgruppe und user/endkunde/kunde der Endkundengruppe zu. Eigene Konten werden weiterhin über Gruppen verwaltet.',
+                    help: 'Stellt die Standardkonten installer und guest bereit, ordnet vorhandene Alternativkonten den passenden Rollen zu und bereitet die einmalige Erstanmeldung vor.',
                     default: true,
                     xs: 12,
                     sm: 12,
                     md: 8,
                     lg: 5,
                 },
+                eosPasswordlessFirstLogin: {
+                    newLine: true,
+                    type: 'checkbox',
+                    label: 'Einmalige Erstanmeldung ohne Passwort erlauben',
+                    help: 'Nur ausdrücklich vorbereitete Installateur- und Endkunden-/Gast-Konten können sich einmalig ohne Passwort aktivieren und müssen unmittelbar ein persönliches Passwort vergeben. Admin/Service ist ausgeschlossen.',
+                    default: true,
+                    xs: 12,
+                    sm: 12,
+                    md: 8,
+                    lg: 5,
+                },
+                eosPasswordlessFirstLoginPrivateNetworkOnly: {
+                    type: 'checkbox',
+                    label: 'Erstanmeldung auf lokales/privates Netzwerk begrenzen',
+                    help: 'Verhindert eine kennwortlose Erstaktivierung über öffentliche Client-Adressen. Für Verkaufsgeräte empfohlen und standardmäßig aktiv.',
+                    default: true,
+                    xs: 12,
+                    sm: 12,
+                    md: 8,
+                    lg: 5,
+                },
+                eosPasswordClaimTtlMinutes: {
+                    type: 'number',
+                    label: 'Gültigkeit der Erstaktivierung (Minuten)',
+                    help: 'Der kurzlebige Aktivierungsnachweis verfällt automatisch. Zulässig sind 3 bis 30 Minuten.',
+                    min: 3,
+                    max: 30,
+                    default: 10,
+                    xs: 12,
+                    sm: 6,
+                    md: 4,
+                    lg: 3,
+                },
                 eosProtectAdapterDeletion: {
                     newLine: true,
                     type: 'checkbox',