iobroker.eos-admin 7.10.1 → 7.10.3

package/PUBLISH_STABLE_V7.10.3.md

@@ -0,0 +1,10 @@
+# NPM-Veröffentlichung 7.10.3
+
+Aus einer frisch entpackten Repository-ZIP ausführen:
+
+```powershell
+npm publish --dry-run
+npm publish
+```
+
+Der Publish-Workflow ist dependency-frei und darf weder `tsc`, `tsx`, `npm install` noch einen verschachtelten `npm pack`-Prozess verlangen.

package/README.md

@@ -13,9 +13,9 @@ 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.
 
-## Aktueller Stable-Verkaufskandidat 7.9.98
+## Aktueller Stable-Verkaufskandidat 7.10.3
 
-Version 7.9.98 verwendet die native **Übersicht** als Startseite und ergänzt dort die ausschließlich lesende EMS-Live-Diagnose. Der Inhaltsbereich ist vertikal scrollbar, während Header und Hauptnavigation stehen bleiben.
+Version 7.10.3 übernimmt den validierten und absturzfreien Stand 7.10.2. Die Einstellung **Automatische Adapter-Updates** liegt jetzt ausschließlich in den **Systemeinstellungen** hinter dem Schraubenschlüssel. Auf Übersicht, Module und allen anderen Hauptseiten wird die Karte nicht mehr angezeigt. Die restart-sichere Updateverwaltung, der verzögerte Repository-Abgleich und die vollständige Backend-Paketprüfung bleiben unverändert.
 
 Verwaltete Installateur- und Endkundenkonten verwenden das Startpasswort `nexowatt`. Nach der ersten Anmeldung beziehungsweise nach einem Reset muss unmittelbar ein persönliches Passwort vergeben werden. Der Reset und die persönliche Passwortvergabe schreiben das reale ioBroker-Benutzerkennwort; EOS-Metadaten werden davon getrennt aktualisiert.
 
@@ -33,7 +33,7 @@ Minimaler Repository-Eintrag:
 {
   "eos-admin": {
     "name": "eos-admin",
-    "version": "7.9.98",
+    "version": "7.10.3",
     "title": "NexoWatt EOS Admin",
     "desc": {
       "de": "NexoWatt EOS Administrationsoberfläche als eigenständiger Adapter.",
@@ -141,7 +141,7 @@ npm publish --dry-run --tag latest
 npm publish --tag latest
 ```
 
-Die Version muss vor jedem erneuten Publish erhöht werden. Für 7.9.98 ist die Veröffentlichung des separat geprüften `iobroker.eos-admin-7.9.98.tgz` der sicherste Weg.
+Die Version muss vor jedem erneuten Publish erhöht werden. Für 7.10.3 wird direkt aus der vollständig geprüften Repository-ZIP veröffentlicht; `npm publish` benötigt dabei weiterhin weder `tsc` noch `tsx`.
 
 ## Lizenz
 

package/README_STABILITY_V7.10.3.md

@@ -0,0 +1,5 @@
+# NexoWatt EOS Admin 7.10.3 – Stabilitätsstand
+
+Version 7.10.3 übernimmt die validierten Backend-, Paket- und Restart-Schutzmaßnahmen aus 7.10.2 unverändert. Die sichtbare Karte **Automatische Adapter-Updates** wird ausschließlich im Dialog **Systemeinstellungen** hinter dem Schraubenschlüssel eingebunden. Sie darf weder in der Übersicht noch in Module, Dienste, Datenpunkte oder anderen Hauptseiten erscheinen.
+
+Die Browserdateien `src-admin/public/js/eos-auto-update.js` und `adminWww/js/eos-auto-update.js` sowie die zugehörigen CSS-Dateien müssen identisch sein. Der Cache-Schlüssel `7103` erzwingt nach dem Update das Laden der neuen Platzierungslogik.

package/RELEASE_ACCEPTANCE_V7.10.3.md

@@ -0,0 +1,3 @@
+# Release Acceptance 7.10.3
+
+Akzeptiert, wenn Paketvalidierung, Stabilitätstests, Prebuilt-Manifest, Backend-Runtime, Publish-Dry-Run und der Auto-Update-Placement-Test erfolgreich sind. Die Update-Karte ist ausschließlich im System-Settings-Dialog zulässig.

package/RELEASE_NOTES_V7.10.3.md

@@ -0,0 +1,7 @@
+# Release Notes 7.10.3
+
+- Automatische NexoWatt-Adapter-Updates aus dem normalen Seiteninhalt entfernt.
+- Update-Karte ausschließlich in **Systemeinstellungen** hinter dem Schraubenschlüssel platziert.
+- Keine Änderung an Stable-Repository, verwalteten Adaptern oder Update-Backendlogik.
+- Eigener Browser-Cache-Schlüssel `7103` verhindert die Verwendung der alten Platzierung.
+- Neuer Placement-Selbsttest verhindert eine spätere Rückkehr auf Übersicht oder Module.

package/adminWww/css/eos-auto-update.css

@@ -1,4 +1,5 @@
-/* NexoWatt EOS native stable auto-update card */
-.eos-nexowatt-auto-update{box-sizing:border-box;display:flex;align-items:center;justify-content:space-between;gap:28px;width:calc(100% - 32px);margin:0 16px 14px;padding:22px 24px;border:1px solid rgba(0,229,138,.28);border-radius:20px;background:linear-gradient(120deg,rgba(0,71,66,.62),rgba(4,25,39,.96) 52%,rgba(4,21,34,.98));color:#effbff;box-shadow:0 16px 36px rgba(0,0,0,.18)}
+/* NexoWatt EOS stable auto-update settings card: visible only inside the System Settings dialog. */
+.eos-nexowatt-auto-update{box-sizing:border-box;display:flex;align-items:center;justify-content:space-between;gap:28px;flex:none;width:calc(100% - 32px);margin:16px;padding:20px 24px;border:1px solid rgba(0,229,138,.28);border-radius:20px;background:linear-gradient(120deg,rgba(0,71,66,.62),rgba(4,25,39,.96) 52%,rgba(4,21,34,.98));color:#effbff;box-shadow:0 16px 36px rgba(0,0,0,.18)}
+.eos-nexowatt-auto-update[data-context="system-settings"]{position:relative;z-index:1}
 .eos-nexowatt-auto-update[data-enabled="false"]{border-color:rgba(117,145,160,.34);background:linear-gradient(120deg,rgba(31,54,65,.72),rgba(4,21,34,.98))}
-.eos-nau-copy{min-width:0;flex:1}.eos-nau-eyebrow{display:block;margin-bottom:5px;color:#00e58a;font-size:.72rem;font-weight:900;letter-spacing:.13em;text-transform:uppercase}.eos-nau-copy h2{margin:0 0 6px;font-size:1.35rem;line-height:1.2}.eos-nau-copy p{max-width:960px;margin:0;color:#a9c2d0;font-size:.82rem;line-height:1.55}.eos-nau-meta{display:flex;flex-wrap:wrap;gap:8px 18px;margin-top:13px;color:#84a8ba;font-size:.72rem}.eos-nau-meta strong{color:#d9f6ee}.eos-nau-adapters{display:flex;flex-wrap:wrap;gap:6px;margin-top:12px}.eos-nau-adapters span{padding:5px 9px;border:1px solid rgba(0,229,138,.24);border-radius:999px;background:rgba(0,229,138,.08);color:#b9f6db;font-size:.7rem;font-weight:800}.eos-nau-error{margin-top:10px;padding:8px 10px;border:1px solid rgba(255,183,77,.38);border-radius:9px;background:rgba(255,152,0,.09);color:#ffd18d;font-size:.72rem}.eos-nau-switch{display:grid;grid-template-columns:50px auto;grid-template-rows:auto auto;align-items:center;column-gap:10px;min-width:160px;cursor:pointer}.eos-nau-switch input{position:absolute;opacity:0;pointer-events:none}.eos-nau-track{grid-row:1/3;position:relative;width:50px;height:28px;border:1px solid rgba(130,161,176,.55);border-radius:999px;background:#273e4c;transition:.2s}.eos-nau-thumb{position:absolute;top:3px;left:3px;width:20px;height:20px;border-radius:50%;background:#b6c8d1;box-shadow:0 3px 8px rgba(0,0,0,.28);transition:.2s}.eos-nau-switch input:checked+.eos-nau-track{border-color:#00e58a;background:rgba(0,229,138,.26)}.eos-nau-switch input:checked+.eos-nau-track .eos-nau-thumb{left:25px;background:#00e58a}.eos-nau-switch strong{align-self:end;font-size:.82rem}.eos-nau-switch small{align-self:start;color:#83a2b2;font-size:.67rem}.eos-nau-switch input:focus-visible+.eos-nau-track{outline:2px solid #4bdcff;outline-offset:3px}@media(max-width:760px){.eos-nexowatt-auto-update{align-items:flex-start;flex-direction:column}.eos-nau-switch{align-self:flex-end}}
+.eos-nau-copy{min-width:0;flex:1}.eos-nau-eyebrow{display:block;margin-bottom:5px;color:#00e58a;font-size:.72rem;font-weight:900;letter-spacing:.13em;text-transform:uppercase}.eos-nau-copy h2{margin:0 0 6px;font-size:1.25rem;line-height:1.2}.eos-nau-copy p{max-width:960px;margin:0;color:#a9c2d0;font-size:.82rem;line-height:1.55}.eos-nau-meta{display:flex;flex-wrap:wrap;gap:8px 18px;margin-top:13px;color:#84a8ba;font-size:.72rem}.eos-nau-meta strong{color:#d9f6ee}.eos-nau-adapters{display:flex;flex-wrap:wrap;gap:6px;margin-top:12px}.eos-nau-adapters span{padding:5px 9px;border:1px solid rgba(0,229,138,.24);border-radius:999px;background:rgba(0,229,138,.08);color:#b9f6db;font-size:.7rem;font-weight:800}.eos-nau-error{margin-top:10px;padding:8px 10px;border:1px solid rgba(255,183,77,.38);border-radius:9px;background:rgba(255,152,0,.09);color:#ffd18d;font-size:.72rem}.eos-nau-switch{display:grid;grid-template-columns:50px auto;grid-template-rows:auto auto;align-items:center;column-gap:10px;min-width:160px;cursor:pointer}.eos-nau-switch input{position:absolute;opacity:0;pointer-events:none}.eos-nau-track{grid-row:1/3;position:relative;width:50px;height:28px;border:1px solid rgba(130,161,176,.55);border-radius:999px;background:#273e4c;transition:.2s}.eos-nau-thumb{position:absolute;top:3px;left:3px;width:20px;height:20px;border-radius:50%;background:#b6c8d1;box-shadow:0 3px 8px rgba(0,0,0,.28);transition:.2s}.eos-nau-switch input:checked+.eos-nau-track{border-color:#00e58a;background:rgba(0,229,138,.26)}.eos-nau-switch input:checked+.eos-nau-track .eos-nau-thumb{left:25px;background:#00e58a}.eos-nau-switch strong{align-self:end;font-size:.82rem}.eos-nau-switch small{align-self:start;color:#83a2b2;font-size:.67rem}.eos-nau-switch input:focus-visible+.eos-nau-track{outline:2px solid #4bdcff;outline-offset:3px}@media(max-width:760px){.eos-nexowatt-auto-update{align-items:flex-start;flex-direction:column}.eos-nau-switch{align-self:flex-end}}

package/adminWww/index.html

@@ -38,7 +38,7 @@
         />
         <link rel="stylesheet" href="./css/nexowatt-native-shell.css?v=7101" />
         <link rel="stylesheet" href="./css/eos-ems-overview.css?v=7101" />
-        <link rel="stylesheet" href="./css/eos-auto-update.css?v=7101" />
+        <link rel="stylesheet" href="./css/eos-auto-update.css?v=7103" />
         <link
             rel="manifest"
             href="manifest.json"
@@ -169,7 +169,7 @@
             <script defer src="./js/eos-role-ui.js?v=7101"></script>
             <script defer src="./js/eos-ems-overview.js?v=7101"></script>
             
-            <script defer src="./js/eos-auto-update.js?v=7101"></script>
+            <script defer src="./js/eos-auto-update.js?v=7103"></script>
             <script defer src="./js/eos-assistant.js?v=7101"></script>
     </head>
     <body>

package/adminWww/js/eos-auto-update.js

@@ -1,78 +1,172 @@
 (() => {
     'use strict';
-    const VERSION = 'v7100-nexowatt-stable-auto-update';
+
+    const VERSION = 'v7103-system-settings-only';
     const ROOT_ID = 'eos-nexowatt-auto-update';
+    const SYSTEM_DIALOG_SELECTOR = '[role="dialog"][aria-labelledby="system-settings-dialog-title"]';
     const script = document.currentScript;
     const API = new URL('../nexowatt/updates/', script?.src || document.baseURI).href;
+
     let busy = false;
     let lastLoad = 0;
+    let latestStatus = null;
     let pollTimer = 0;
 
     const role = () => String(window.NEXOWATT_EOS_ACCESS_ROLE || 'admin').toLowerCase();
-    const introActive = () => String(location.hash || '').replace(/^#\/?/, '').split(/[/?&]/)[0] === 'tab-intro';
-    const esc = value => String(value ?? '').replace(/[&<>'"]/g, char => ({'&':'&amp;','<':'&lt;','>':'&gt;',"'":'&#39;','"':'&quot;'}[char]));
-    const formatTime = value => value ? new Intl.DateTimeFormat(undefined, { dateStyle: 'short', timeStyle: 'medium' }).format(new Date(value)) : '–';
+    const esc = value =>
+        String(value ?? '').replace(/[&<>'"]/g, char =>
+            ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', "'": '&#39;', '"': '&quot;' })[char],
+        );
+    const formatTime = value =>
+        value
+            ? new Intl.DateTimeFormat(undefined, { dateStyle: 'short', timeStyle: 'medium' }).format(new Date(value))
+            : '–';
+
+    const getSystemSettingsMount = () => {
+        const dialog = document.querySelector(SYSTEM_DIALOG_SELECTOR);
+        if (!dialog) return null;
+
+        const content = dialog.querySelector('.MuiDialogContent-root');
+        if (!content) return null;
+
+        const appBar = Array.from(content.children).find(element => element.classList?.contains('MuiAppBar-root')) ||
+            content.querySelector('.MuiAppBar-root');
+
+        return { dialog, content, appBar };
+    };
+
+    const systemSettingsActive = () => Boolean(getSystemSettingsMount());
 
     const ensureRoot = () => {
-        if (role() !== 'admin' || !introActive()) { document.getElementById(ROOT_ID)?.remove(); return null; }
-        let root = document.getElementById(ROOT_ID);
-        if (root) return root;
-        root = document.createElement('section');
+        const existing = document.getElementById(ROOT_ID);
+        if (role() !== 'admin') {
+            existing?.remove();
+            return null;
+        }
+
+        const mount = getSystemSettingsMount();
+        if (!mount) {
+            existing?.remove();
+            return null;
+        }
+
+        if (existing && mount.content.contains(existing)) return existing;
+        existing?.remove();
+
+        const root = document.createElement('section');
         root.id = ROOT_ID;
         root.className = 'eos-nexowatt-auto-update';
-        const hero = document.getElementById('eos-native-overview-hero');
-        const ems = document.getElementById('eos-ems-overview-runtime');
-        const parent = ems?.parentElement || hero?.parentElement || document.getElementById('app-paper');
-        if (!parent) return null;
-        if (ems) parent.insertBefore(root, ems); else if (hero?.nextSibling) parent.insertBefore(root, hero.nextSibling); else parent.append(root);
+        root.dataset.context = 'system-settings';
+        root.setAttribute('data-eos-system-settings-only', 'true');
+        root.setAttribute('aria-label', 'NexoWatt Stable-Update-Einstellungen');
+
+        if (mount.appBar?.parentElement === mount.content) {
+            mount.content.insertBefore(root, mount.appBar.nextSibling);
+        } else {
+            mount.content.prepend(root);
+        }
         return root;
     };
 
     const render = status => {
-        const root = ensureRoot(); if (!root) return;
-        const enabled = status?.enabled !== false;
-        const managed = Array.isArray(status?.managedAdapters) ? status.managedAdapters : [];
-        const error = String(status?.error || '');
+        latestStatus = { ...(latestStatus || {}), ...(status || {}) };
+        const root = ensureRoot();
+        if (!root) return;
+
+        const enabled = latestStatus?.enabled !== false;
+        const managed = Array.isArray(latestStatus?.managedAdapters) ? latestStatus.managedAdapters : [];
+        const error = String(latestStatus?.error || '');
+
         root.dataset.enabled = String(enabled);
-        root.innerHTML = `<div class="eos-nau-copy"><span class="eos-nau-eyebrow">NexoWatt Stable</span><h2>Automatische Adapter-Updates</h2><p>${enabled ? 'Installierte NexoWatt-Adapter werden automatisch aktualisiert, sobald im erkannten Stable-Repository eine neuere stabile Version verfügbar ist.' : 'Automatische NexoWatt-Updates sind deaktiviert. Vorherige ioBroker-Update-Richtlinien wurden wiederhergestellt.'}</p><div class="eos-nau-meta"><span>Repository: <strong>${esc(status?.repository || 'wird erkannt')}</strong></span><span>Letzter Abgleich: <strong>${esc(formatTime(status?.lastSync))}</strong></span><span>Richtlinie: <strong>alle neueren Stable-Versionen</strong></span></div>${managed.length ? `<div class="eos-nau-adapters">${managed.map(name => `<span>${esc(name)}</span>`).join('')}</div>` : ''}${error ? `<div class="eos-nau-error">${esc(error)}</div>` : ''}</div><label class="eos-nau-switch"><input type="checkbox" ${enabled ? 'checked' : ''} ${busy ? 'disabled' : ''}><span class="eos-nau-track"><span class="eos-nau-thumb"></span></span><strong>${enabled ? 'Aktiv' : 'Deaktiviert'}</strong><small>jederzeit änderbar</small></label>`;
+        root.innerHTML = `<div class="eos-nau-copy"><span class="eos-nau-eyebrow">NexoWatt Stable</span><h2>Automatische Adapter-Updates</h2><p>${enabled ? 'Installierte NexoWatt-Adapter werden automatisch aktualisiert, sobald im erkannten Stable-Repository eine neuere stabile Version verfügbar ist.' : 'Automatische NexoWatt-Updates sind deaktiviert. Vorherige ioBroker-Update-Richtlinien wurden wiederhergestellt.'}</p><div class="eos-nau-meta"><span>Repository: <strong>${esc(latestStatus?.repository || 'wird erkannt')}</strong></span><span>Letzter Abgleich: <strong>${esc(formatTime(latestStatus?.lastSync))}</strong></span><span>Richtlinie: <strong>alle neueren Stable-Versionen</strong></span></div>${managed.length ? `<div class="eos-nau-adapters">${managed.map(name => `<span>${esc(name)}</span>`).join('')}</div>` : ''}${error ? `<div class="eos-nau-error">${esc(error)}</div>` : ''}</div><label class="eos-nau-switch"><input type="checkbox" ${enabled ? 'checked' : ''} ${busy ? 'disabled' : ''}><span class="eos-nau-track"><span class="eos-nau-thumb"></span></span><strong>${enabled ? 'Aktiv' : 'Deaktiviert'}</strong><small>jederzeit änderbar</small></label>`;
         root.querySelector('input')?.addEventListener('change', event => void save(Boolean(event.currentTarget.checked)));
     };
 
     const request = async (path, options = {}) => {
-        const response = await fetch(new URL(path, API), { cache: 'no-store', credentials: 'same-origin', ...options });
+        const response = await fetch(new URL(path, API), {
+            cache: 'no-store',
+            credentials: 'same-origin',
+            ...options,
+        });
         const data = await response.json().catch(() => ({}));
         if (!response.ok) throw new Error(data.error || `HTTP ${response.status}`);
         return data;
     };
+
     const load = async (force = false) => {
-        if (role() !== 'admin' || !introActive()) return;
+        if (role() !== 'admin' || !systemSettingsActive()) {
+            ensureRoot();
+            return;
+        }
         if (!force && Date.now() - lastLoad < 5000) return;
+
         lastLoad = Date.now();
-        try { render(await request('status')); }
-        catch (error) { render({ enabled: true, error: error?.message || error }); }
+        try {
+            render(await request('status'));
+        } catch (error) {
+            render({ enabled: latestStatus?.enabled !== false, error: error?.message || error });
+        }
     };
+
     const save = async enabled => {
         if (busy) return;
         busy = true;
+        render({ enabled, error: '' });
+
         try {
-            render({ enabled });
-            const status = await request('settings', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-NexoWatt-EOS-Auto-Update': '1' }, body: JSON.stringify({ enabled }) });
-            render(status);
+            latestStatus = await request('settings', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-NexoWatt-EOS-Auto-Update': '1',
+                },
+                body: JSON.stringify({ enabled }),
+            });
         } catch (error) {
-            render({ enabled: !enabled, error: error?.message || error });
-        } finally { busy = false; }
+            latestStatus = { ...(latestStatus || {}), enabled: !enabled, error: error?.message || error };
+        } finally {
+            busy = false;
+            render(latestStatus || { enabled });
+        }
     };
 
     let scheduled = false;
-    const schedule = () => { if (scheduled) return; scheduled = true; requestAnimationFrame(() => { scheduled = false; void load(); }); };
+    const schedule = () => {
+        if (scheduled) return;
+        scheduled = true;
+        requestAnimationFrame(() => {
+            scheduled = false;
+            void load();
+        });
+    };
+
     const start = () => {
         void load();
-        window.addEventListener('hashchange', () => { lastLoad = 0; schedule(); });
+        window.addEventListener('hashchange', () => {
+            lastLoad = 0;
+            schedule();
+        });
         window.addEventListener('nexowatt-eos-admin-socket-ready', schedule);
-        document.addEventListener('visibilitychange', () => { if (document.visibilityState === 'visible') schedule(); });
-        new MutationObserver(() => { if (!document.getElementById(ROOT_ID) && introActive()) schedule(); }).observe(document.documentElement, { childList: true, subtree: true });
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'visible') schedule();
+        });
+
+        new MutationObserver(() => {
+            const root = document.getElementById(ROOT_ID);
+            const settingsOpen = systemSettingsActive();
+            if ((settingsOpen && !root) || (!settingsOpen && root)) schedule();
+        }).observe(document.documentElement, { childList: true, subtree: true });
+
         pollTimer = window.setInterval(() => void load(true), 30000);
     };
-    document.readyState === 'loading' ? document.addEventListener('DOMContentLoaded', start, { once: true }) : start();
-    window.NEXOWATT_EOS_AUTO_UPDATE_UI = Object.freeze({ version: VERSION, refresh: load });
+
+    document.readyState === 'loading'
+        ? document.addEventListener('DOMContentLoaded', start, { once: true })
+        : start();
+
+    window.NEXOWATT_EOS_AUTO_UPDATE_UI = Object.freeze({
+        version: VERSION,
+        refresh: load,
+        location: 'system-settings',
+    });
 })();