iobroker.eos-admin 7.9.26 → 7.9.28

package/adminWww/css/eos-branding.css

@@ -2448,3 +2448,202 @@ html.eos-app .MuiAppBar-root .MuiToolbar-root img[alt*="user" i] {
     }
 }
 
+
+/* === NexoWatt EOS v27: logo contrast, compact nav, EOS Assist ============
+   Der Pfeil ist kein Voll-Schließen mehr: er schaltet nur zwischen normaler
+   und kompakter Navigationsstufe um. Das Logo bekommt einen schwarzen Grund,
+   damit das NexoWatt-Zeichen sauberer und hochwertiger wirkt. */
+html.eos-app .eos-brand-badge {
+    grid-template-columns: 78px minmax(170px, 1fr) 12px !important;
+    padding-left: 6px !important;
+    background:
+        radial-gradient(circle at 38px 29px, rgba(0, 255, 136, 0.18), transparent 44px),
+        linear-gradient(135deg, rgba(4, 18, 26, 0.98), rgba(0, 7, 12, 0.84) 52%, rgba(0, 32, 26, 0.50)) !important;
+}
+
+html.eos-app .eos-brand-badge-mark {
+    background:
+        radial-gradient(circle at 50% 44%, rgba(0, 255, 136, 0.16), rgba(0, 0, 0, 0.96) 58%, #000000 100%) !important;
+    border-color: rgba(126, 255, 216, 0.84) !important;
+    box-shadow:
+        inset 0 0 0 1px rgba(255, 255, 255, 0.05),
+        inset 0 0 20px rgba(0, 255, 136, 0.18),
+        0 0 0 1px rgba(0, 0, 0, 0.55),
+        0 0 20px rgba(0, 255, 136, 0.62),
+        0 0 40px rgba(0, 212, 255, 0.20) !important;
+    transform: translateY(-5px) !important;
+}
+
+html.eos-app .eos-brand-badge-logo {
+    filter:
+        brightness(2.35)
+        contrast(1.22)
+        saturate(1.48)
+        drop-shadow(0 0 1px rgba(255, 255, 255, 0.95))
+        drop-shadow(0 0 11px rgba(0, 255, 136, 0.82))
+        drop-shadow(0 0 22px rgba(0, 212, 255, 0.28)) !important;
+}
+
+/* Drawer/rail stays visible. The native arrow becomes a compact-mode toggle. */
+html.eos-app .MuiDrawer-paper,
+html.eos-app .eos-drawer {
+    transform: none !important;
+    visibility: visible !important;
+    opacity: 1 !important;
+    display: flex !important;
+    padding-left: 86px !important;
+}
+
+html.eos-app .eos-native-drawer-header {
+    position: absolute !important;
+    left: 12px !important;
+    top: 8px !important;
+    flex: 0 0 58px !important;
+    width: 58px !important;
+    min-width: 58px !important;
+    max-width: 58px !important;
+    height: 56px !important;
+    min-height: 56px !important;
+    margin: 0 !important;
+    z-index: 4 !important;
+    background: rgba(0, 0, 0, 0.38) !important;
+    border-color: rgba(0, 255, 136, 0.38) !important;
+    box-shadow: inset 0 0 16px rgba(0, 255, 136, 0.10), 0 0 20px rgba(0, 255, 136, 0.10) !important;
+}
+
+html.eos-app .eos-native-drawer-header > div:first-child {
+    width: 58px !important;
+    min-width: 58px !important;
+    max-width: 58px !important;
+    padding: 4px 6px !important;
+}
+
+html.eos-app .eos-native-drawer-header button.eos-nav-compact-toggle,
+html.eos-app .eos-native-drawer-header .eos-nav-compact-toggle {
+    width: 46px !important;
+    height: 46px !important;
+    min-width: 46px !important;
+    min-height: 46px !important;
+    border-radius: 16px !important;
+    background:
+        radial-gradient(circle at 50% 50%, rgba(0, 255, 136, 0.18), rgba(0, 0, 0, 0.72)) !important;
+    border: 1px solid rgba(0, 255, 136, 0.44) !important;
+    box-shadow: 0 0 16px rgba(0, 255, 136, 0.18) !important;
+}
+
+html.eos-app.eos-nav-compact .eos-native-drawer-header .eos-nav-compact-toggle svg,
+html.eos-app.eos-nav-compact .eos-native-drawer-header button.eos-nav-compact-toggle svg {
+    transform: rotate(180deg) !important;
+}
+
+html.eos-app .eos-scroll-nav,
+html.eos-app .MuiDrawer-paper .MuiList-root {
+    margin-left: 0 !important;
+}
+
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiListItemButton-root,
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiButtonBase-root.MuiListItemButton-root {
+    width: 58px !important;
+    min-width: 58px !important;
+    max-width: 58px !important;
+    padding: 0 !important;
+    justify-content: center !important;
+    gap: 0 !important;
+}
+
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiListItemText-root,
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiListItemButton-root .MuiTypography-root,
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiButtonBase-root.MuiListItemButton-root .MuiTypography-root {
+    display: none !important;
+    max-width: 0 !important;
+    opacity: 0 !important;
+    overflow: hidden !important;
+}
+
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiListItemIcon-root {
+    min-width: 0 !important;
+    margin: 0 !important;
+}
+
+html.eos-app.eos-nav-compact .MuiDrawer-paper .MuiBadge-root .MuiBadge-badge {
+    transform: scale(0.88) translate(42%, -42%) !important;
+}
+
+/* EOS Assist: leichte Bedienhilfe als Vorbereitung für eine spätere echte KI. */
+.eos-assist-root {
+    position: fixed !important;
+    right: 26px !important;
+    bottom: 24px !important;
+    z-index: 1700 !important;
+    font-family: inherit !important;
+}
+
+.eos-assist-button {
+    display: grid !important;
+    grid-template-columns: 12px auto !important;
+    grid-template-rows: auto auto !important;
+    column-gap: 8px !important;
+    align-items: center !important;
+    min-width: 156px !important;
+    padding: 10px 14px !important;
+    border-radius: 18px !important;
+    border: 1px solid rgba(0, 255, 136, 0.44) !important;
+    background: linear-gradient(135deg, rgba(0, 255, 136, 0.19), rgba(0, 212, 255, 0.10) 62%, rgba(0, 0, 0, 0.64)) !important;
+    color: #f3fffb !important;
+    box-shadow: 0 14px 32px rgba(0, 0, 0, 0.38), 0 0 24px rgba(0, 255, 136, 0.18) !important;
+    cursor: pointer !important;
+}
+
+.eos-assist-button strong { grid-column: 2; font-weight: 900; font-size: 13px; line-height: 1; }
+.eos-assist-button small { grid-column: 2; color: rgba(226, 255, 247, .72); font-size: 10px; line-height: 1.1; }
+.eos-assist-dot { grid-row: 1 / span 2; width: 10px; height: 10px; border-radius: 999px; background: #16ff98; box-shadow: 0 0 12px rgba(0, 255, 136, .9); }
+
+.eos-assist-panel {
+    position: absolute !important;
+    right: 0 !important;
+    bottom: calc(100% + 12px) !important;
+    width: min(420px, calc(100vw - 36px)) !important;
+    padding: 16px !important;
+    border-radius: 22px !important;
+    border: 1px solid rgba(0, 255, 136, 0.32) !important;
+    background:
+        radial-gradient(circle at 18% 0%, rgba(0, 255, 136, .12), transparent 44%),
+        linear-gradient(180deg, rgba(8, 29, 44, 0.98), rgba(2, 9, 20, 0.98)) !important;
+    color: #f3fffb !important;
+    box-shadow: 0 24px 60px rgba(0,0,0,.52), 0 0 26px rgba(0,255,136,.13) !important;
+    opacity: 0 !important;
+    pointer-events: none !important;
+    transform: translateY(10px) scale(.98) !important;
+    transition: opacity .16s ease, transform .16s ease !important;
+}
+
+.eos-assist-root.eos-assist-open .eos-assist-panel {
+    opacity: 1 !important;
+    pointer-events: auto !important;
+    transform: translateY(0) scale(1) !important;
+}
+
+.eos-assist-head { display: flex; justify-content: space-between; gap: 12px; margin-bottom: 12px; }
+.eos-assist-head strong { display: block; font-size: 16px; font-weight: 950; margin-bottom: 5px; }
+.eos-assist-head span { display: block; color: rgba(226, 245, 255, .76); font-size: 12px; line-height: 1.35; }
+.eos-assist-close { width: 32px; height: 32px; border-radius: 12px; border: 1px solid rgba(0,255,136,.26); background: rgba(0,0,0,.34); color: #fff; cursor: pointer; }
+.eos-assist-steps { display: flex; flex-wrap: wrap; gap: 7px; margin-bottom: 13px; }
+.eos-assist-steps span { padding: 5px 9px; border-radius: 999px; background: rgba(0,255,136,.10); border: 1px solid rgba(0,255,136,.18); color: rgba(237,255,250,.90); font-size: 11px; font-weight: 750; }
+.eos-assist-input-label { display: block; color: rgba(226,245,255,.78); font-size: 11px; margin: 0 0 6px; font-weight: 750; }
+.eos-assist-input-row { display: flex; gap: 8px; }
+.eos-assist-input { flex: 1; min-width: 0; border-radius: 14px; border: 1px solid rgba(98,190,255,.28); background: rgba(0,7,13,.62); color: #f3fffb; padding: 10px 12px; outline: none; }
+.eos-assist-send { border: 0; border-radius: 14px; padding: 0 13px; background: linear-gradient(135deg, #00ff88, #00d4ff); color: #001019; font-weight: 900; cursor: pointer; }
+.eos-assist-answer { margin-top: 12px; padding: 12px 13px; border-radius: 16px; border: 1px solid rgba(0,212,255,.20); background: rgba(0,0,0,.28); color: rgba(238,255,250,.90); font-size: 12px; line-height: 1.42; }
+
+@media (max-width: 720px) {
+    html.eos-app .MuiDrawer-paper,
+    html.eos-app .eos-drawer { padding-left: 68px !important; }
+    html.eos-app .eos-native-drawer-header { left: 8px !important; width: 50px !important; min-width: 50px !important; max-width: 50px !important; }
+    html.eos-app .eos-native-drawer-header > div:first-child { width: 50px !important; min-width: 50px !important; max-width: 50px !important; }
+    html.eos-app .eos-native-drawer-header button.eos-nav-compact-toggle,
+    html.eos-app .eos-native-drawer-header .eos-nav-compact-toggle { width: 40px !important; height: 40px !important; min-width: 40px !important; min-height: 40px !important; }
+    .eos-assist-root { right: 14px !important; bottom: 16px !important; }
+    .eos-assist-button { min-width: 54px !important; width: 54px !important; height: 54px !important; border-radius: 18px !important; grid-template-columns: 1fr !important; padding: 0 !important; place-items: center !important; }
+    .eos-assist-button strong, .eos-assist-button small { display: none !important; }
+    .eos-assist-dot { grid-column: 1; grid-row: 1; width: 14px; height: 14px; }
+}

package/adminWww/index.html

@@ -31,7 +31,7 @@
             rel="stylesheet"
             href="css/leaflet.css"
         />
-        <link rel="stylesheet" href="./css/eos-branding.css?v=26" />
+        <link rel="stylesheet" href="./css/eos-branding.css?v=28" />
         <link
             rel="manifest"
             href="manifest.json"
@@ -154,8 +154,9 @@
       <script type="module" crossorigin src="./assets/index-CQZugZ1z.js"></script>
       <link rel="modulepreload" crossorigin href="./assets/preload-helper-BDBacUwf.js">
       <link rel="modulepreload" crossorigin href="./assets/iobroker_admin__mf_v__runtimeInit__mf_v__-g2X2zhAf.js">
-            <script defer src="./js/eos-branding.js?v=26"></script>
-            <script defer src="./js/eos-security-ui.js?v=26"></script>
+            <script defer src="./js/eos-branding.js?v=28"></script>
+            <script defer src="./js/eos-security-ui.js?v=28"></script>
+            <script defer src="./js/eos-assistant.js?v=28"></script>
     </head>
     <body>
         <noscript>You need to enable JavaScript to run this app.</noscript>

package/adminWww/js/eos-assistant.js

@@ -0,0 +1,203 @@
+(() => {
+    'use strict';
+
+    window.NEXOWATT_EOS_ASSIST_VERSION = 'v27-local-setup-guide';
+
+    const ASSET_BASE = (() => {
+        const script = document.currentScript?.src || document.querySelector('script[src*="eos-assistant.js"]')?.src || window.location.href;
+        return new URL('../', script).href;
+    })();
+    const asset = path => new URL(path.replace(/^\.\//, ''), ASSET_BASE).href;
+    const LOGO = asset('img/eos/nexowatt-192.png');
+    const STORE_KEY = 'nexowatt.eos.assist.open';
+    const state = { checked: false, allowed: true };
+
+    const fetchAssistantPolicy = async () => {
+        if (state.checked) return state.allowed;
+        state.checked = true;
+        try {
+            const url = new URL('eos/security/status', ASSET_BASE).href;
+            const response = await fetch(url, { credentials: 'same-origin', cache: 'no-store' });
+            if (!response.ok) return state.allowed;
+            const json = await response.json();
+            const assistant = json.assistant || {};
+            const enabled = assistant.enabled !== false && json.eosAssistantEnabled !== false;
+            const adminOnly = assistant.adminOnly === true || json.eosAssistantAdminOnly === true;
+            const isAdmin = json.isAdmin === true || json.isAdministrator === true || json.isEosAdminGroup === true;
+            state.allowed = enabled && (!adminOnly || isAdmin);
+        } catch {
+            state.allowed = true;
+        }
+        return state.allowed;
+    };
+
+    const normalize = value => String(value || '')
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+
+    const route = () => {
+        const hash = window.location.hash || '';
+        const text = normalize(document.body?.innerText || '');
+        if (hash.includes('tab-adapters') || /module|adapter/.test(text.slice(0, 4000))) return 'modules';
+        if (hash.includes('tab-instances') || /dienste|instanzen/.test(text.slice(0, 4000))) return 'services';
+        if (hash.includes('tab-logs') || /systemlogs|protokolle|log-grosse/.test(text.slice(0, 4000))) return 'logs';
+        if (hash.includes('tab-users') || /zugange & rechte|benutzer|rollen/.test(text.slice(0, 4000))) return 'rights';
+        if (hash.includes('tab-objects') || /datenpunkte|objekte/.test(text.slice(0, 4000))) return 'objects';
+        if (hash.includes('tab-hosts') || /system-hosts|hosts/.test(text.slice(0, 4000))) return 'hosts';
+        return 'overview';
+    };
+
+    const contextTitle = () => ({
+        modules: 'Module & Adapter',
+        services: 'Dienste & Instanzen',
+        logs: 'Systemlogs',
+        rights: 'Zugänge & Rechte',
+        objects: 'Datenpunkte',
+        hosts: 'System-Hosts',
+        overview: 'EOS Cockpit',
+    }[route()] || 'EOS Cockpit');
+
+    const routeAdvice = () => ({
+        modules: 'Hier installierst und aktualisierst du Module. Prüfe vor einer Installation immer: Zweck, benötigte Instanzen, Version, Abhängigkeiten und ob das Modul zu den geschützten EOS-Komponenten gehört.',
+        services: 'Hier siehst du laufende Dienste. Wichtig sind Status, Speicherverbrauch, Log-Level und ob eine Instanz automatisch startet. Fehlerhafte Dienste zuerst öffnen, Log prüfen, dann gezielt neu starten.',
+        logs: 'Hier erkennst du die Ursache vieler Probleme. Filtere nach Quelle und Level. Wiederholte Warnungen sind meist wichtiger als einzelne Meldungen.',
+        rights: 'Hier steuerst du Rollen und Benutzer. Installateur- und Endkundenrollen sollten keine geschützten EOS-Systemmodule löschen, stoppen oder aktivieren können.',
+        objects: 'Datenpunkte sind die technische Basis. Ändere Rollen, States und Alias-Strukturen nur bewusst, weil Adapter und Visualisierungen davon abhängen.',
+        hosts: 'Hier prüfst du Systemlast, Node.js, npm, Speicher und laufende Prozesse. Bei Updateproblemen zuerst Host-Status und freien Speicher prüfen.',
+        overview: 'Das Cockpit gibt den Überblick. Starte von hier aus mit Modulen, Diensten, Logs oder Rechten, je nachdem ob du einrichten, prüfen oder absichern möchtest.',
+    }[route()] || 'Wähle einen Bereich aus, dann kann EOS Assist dir die nächsten Schritte erklären.');
+
+    const answerFor = question => {
+        const q = normalize(question);
+        const r = route();
+        if (!q) return `Aktueller Bereich: ${contextTitle()}\n\n${routeAdvice()}\n\nDu kannst z. B. fragen: „Wie richte ich Modbus ein?“, „Warum ist ein Dienst rot?“ oder „Welche Rechte braucht der Installateur?“`;
+
+        if (/modbus|wechselrichter|tcp|rs485/.test(q)) {
+            return 'Modbus-Einrichtung:\n1. Modul installieren und Instanz anlegen.\n2. IP/Port oder seriellen Adapter prüfen.\n3. Unit-ID, Registerbereich und Byte-Reihenfolge dokumentieren.\n4. Dienst starten und Systemlogs auf Timeout/CRC prüfen.\n5. Erst wenn Werte stabil laufen, Datenpunkte in EOS Cockpit verwenden.';
+        }
+        if (/shelly|relay|schalter|steckdose/.test(q)) {
+            return 'Shelly-/Schaltmodul-Einrichtung:\n1. Gerät im gleichen Netzwerk erreichbar machen.\n2. Authentifizierung im Gerät setzen, damit keine Warnung wie „not protected via restricted login“ entsteht.\n3. Adapterinstanz konfigurieren und neu starten.\n4. In Datenpunkten prüfen, ob Power, Energy und Relay-State sauber aktualisieren.';
+        }
+        if (/ev|wallbox|laden|ladepunkt|ocpp/.test(q)) {
+            return 'Ladepunkt-/EVCS-Einrichtung:\n1. OCPP/Wallbox-Modul installieren.\n2. Ladepunkt-ID, Endpoint und Authentifizierung prüfen.\n3. Dienst starten und Verbindung im Log kontrollieren.\n4. Danach Ladeleistung, Fahrzeugstatus und Freigabe-Datenpunkte mit dem EOS Energiemanagement verknüpfen.';
+        }
+        if (/backup|backitup|sicherung|restore/.test(q)) {
+            return 'Backup-Empfehlung:\n1. BackItUp bleibt ein geschütztes EOS-Systemmodul.\n2. Vor Updates immer ein Backup starten.\n3. Restore-Ziel und Speicherort prüfen.\n4. Installateur-/Endkundenrollen sollten BackItUp nicht löschen oder deaktivieren dürfen.';
+        }
+        if (/recht|rolle|benutzer|installateur|kunde|admin/.test(q)) {
+            return 'Rechte-Empfehlung:\n1. Administrator: volle Wartung und Systemschutz.\n2. Installateur: Module konfigurieren, aber geschützte Adapter nicht löschen.\n3. Endkunde: Bedienung und Ansicht, keine Systemmodule.\n4. Geschützte Adapter legt der Administrator im EOS-Sicherheitsbereich fest.';
+        }
+        if (/log|fehler|warn|error|timeout|offline/.test(q)) {
+            return 'Fehleranalyse:\n1. In Systemlogs nach Quelle und Level filtern.\n2. Wiederholte Meldungen priorisieren.\n3. Bei Timeout Netzwerk/IP/Port prüfen.\n4. Bei Auth-Warnungen Zugangsdaten im Gerät und Adapter vergleichen.\n5. Danach nur die betroffene Instanz neu starten, nicht das komplette System.';
+        }
+        if (/update|aktualisieren|npm|repository|repo/.test(q)) {
+            return 'Update-Prüfung:\n1. NexoWatt-Repository aktiv setzen.\n2. Version im Repository und npm vergleichen.\n3. Bei EOS Admin: iobroker upgrade eos-admin, danach iobroker upload eos-admin.\n4. Browser mit Strg+F5 neu laden.\n5. Vor größeren Updates Backup erstellen.';
+        }
+        if (/dienst|instanz|start|stop|neustart/.test(q)) {
+            return 'Dienst prüfen:\n1. Status ansehen: grün/läuft, rot/gestoppt, gelb/Warnung.\n2. Speicherverbrauch und Log-Level prüfen.\n3. Bei Fehlern zuerst Log öffnen.\n4. Dann Instanz neu starten.\n5. Wenn der Fehler wiederkommt, Konfiguration und Abhängigkeiten prüfen.';
+        }
+        return `Ich habe deine Frage lokal eingeordnet.\n\nBereich: ${contextTitle()}\n\nEmpfohlene nächsten Schritte:\n1. Ziel klären: installieren, konfigurieren, Fehler suchen oder absichern.\n2. Betroffenes Modul/Dienst auswählen.\n3. Logs und Status prüfen.\n4. Änderung speichern und nur die betroffene Instanz neu starten.\n\nHinweis: Diese erste EOS-Assistenz arbeitet lokal ohne Cloud. Eine echte KI-Anbindung kann später über einen NexoWatt- oder MCP-Dienst ergänzt werden.`;
+    };
+
+    const setOpen = open => {
+        document.documentElement.classList.toggle('eos-assist-open', !!open);
+        try { localStorage.setItem(STORE_KEY, open ? '1' : '0'); } catch { /* ignore */ }
+    };
+
+    const renderAnswer = (panel, question) => {
+        const out = panel.querySelector('.eos-assist-answer');
+        if (out) out.textContent = answerFor(question);
+        const ctx = panel.querySelector('.eos-assist-context');
+        if (ctx) ctx.textContent = contextTitle();
+        const hint = panel.querySelector('.eos-assist-hint');
+        if (hint) hint.textContent = routeAdvice();
+    };
+
+    const ensureAssistant = () => {
+        if (!document.body || document.querySelector('.eos-assist-launcher')) return;
+        if (document.documentElement.classList.contains('eos-login')) return;
+        if (!document.getElementById('app-paper')) return;
+
+        const launcher = document.createElement('button');
+        launcher.type = 'button';
+        launcher.className = 'eos-assist-launcher';
+        launcher.innerHTML = '<span>✦</span><span>EOS Assist</span>';
+        launcher.setAttribute('aria-label', 'EOS Assist öffnen');
+
+        const panel = document.createElement('aside');
+        panel.className = 'eos-assist-panel';
+        panel.setAttribute('aria-label', 'EOS Assist');
+        panel.innerHTML = `
+            <div class="eos-assist-head">
+                <span class="eos-assist-logo"><img src="${LOGO}" alt="NexoWatt EOS" /></span>
+                <span><strong>EOS Assist</strong><small><span class="eos-assist-context"></span> · geführte Einrichtung</small></span>
+                <button type="button" class="eos-assist-close" aria-label="Schließen">×</button>
+            </div>
+            <div class="eos-assist-body">
+                <div class="eos-assist-card"><strong>Aktueller Hinweis</strong><p class="eos-assist-hint"></p></div>
+                <div class="eos-assist-actions">
+                    <button type="button" data-question="Wie richte ich dieses Modul ein?">Modul einrichten</button>
+                    <button type="button" data-question="Wie prüfe ich Fehler in den Logs?">Fehler prüfen</button>
+                    <button type="button" data-question="Welche Rechte braucht der Installateur?">Rechte erklären</button>
+                    <button type="button" data-question="Was muss ich vor einem Update beachten?">Update-Check</button>
+                </div>
+                <div class="eos-assist-input-row">
+                    <input class="eos-assist-input" type="text" placeholder="Frage eingeben, z. B. Modbus einrichten" />
+                    <button type="button" class="eos-assist-send">Fragen</button>
+                </div>
+                <div class="eos-assist-card eos-assist-answer"></div>
+                <div class="eos-assist-foot">Lokale Assistenz ohne Cloud. Für echte KI-Automation kann später ein NexoWatt-Dienst angebunden werden.</div>
+            </div>
+        `;
+
+        document.body.appendChild(launcher);
+        document.body.appendChild(panel);
+        renderAnswer(panel, '');
+
+        launcher.addEventListener('click', () => setOpen(!document.documentElement.classList.contains('eos-assist-open')));
+        panel.querySelector('.eos-assist-close')?.addEventListener('click', () => setOpen(false));
+        panel.querySelector('.eos-assist-send')?.addEventListener('click', () => renderAnswer(panel, panel.querySelector('.eos-assist-input')?.value || ''));
+        panel.querySelector('.eos-assist-input')?.addEventListener('keydown', event => {
+            if (event.key === 'Enter') renderAnswer(panel, event.currentTarget.value || '');
+        });
+        panel.querySelectorAll('button[data-question]').forEach(button => {
+            button.addEventListener('click', () => {
+                const question = button.getAttribute('data-question') || '';
+                const input = panel.querySelector('.eos-assist-input');
+                if (input) input.value = question;
+                renderAnswer(panel, question);
+            });
+        });
+
+        try { if (localStorage.getItem(STORE_KEY) === '1') setOpen(true); } catch { /* ignore */ }
+    };
+
+    const removeOnLogin = () => {
+        if (!document.documentElement.classList.contains('eos-login')) return;
+        document.querySelectorAll('.eos-assist-launcher,.eos-assist-panel').forEach(el => el.remove());
+    };
+
+    const run = () => {
+        removeOnLogin();
+        void fetchAssistantPolicy().then(allowed => {
+            if (!allowed) {
+                document.querySelectorAll('.eos-assist-launcher,.eos-assist-panel').forEach(el => el.remove());
+                return;
+            }
+            ensureAssistant();
+            const panel = document.querySelector('.eos-assist-panel');
+            if (panel) renderAnswer(panel, panel.querySelector('.eos-assist-input')?.value || '');
+        });
+    };
+
+    if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', run, { once: true });
+    else run();
+    window.addEventListener('hashchange', () => setTimeout(run, 80));
+    window.addEventListener('load', () => setTimeout(run, 120), { once: true });
+    new MutationObserver(() => {
+        if (!document.querySelector('.eos-assist-launcher')) run();
+    }).observe(document.documentElement, { childList: true, subtree: true });
+})();

package/adminWww/js/eos-branding.js

@@ -1,7 +1,7 @@
 (() => {
     'use strict';
 
-    window.NEXOWATT_EOS_UI_VERSION = 'v26-header-identity-polish';
+    window.NEXOWATT_EOS_UI_VERSION = 'v27-logo-nav-assist-polish';
 
     const BRAND = 'NexoWatt EOS';
     const EOS_MEANING = 'Energy Operation System';
@@ -72,6 +72,7 @@
             protectedAdapters: ['eos-admin', 'backitup'],
         },
         securityFetchStarted: false,
+        assistOpen: false,
     };
 
     const safe = fn => {
@@ -518,6 +519,26 @@
         }
         if (header) {
             header.classList.add('eos-native-drawer-header');
+            const toggleButton = header.querySelector('button, .MuiIconButton-root, [role="button"]');
+            if (toggleButton && !toggleButton.dataset.eosNavCompactToggle) {
+                toggleButton.dataset.eosNavCompactToggle = 'true';
+                toggleButton.classList.add('eos-nav-compact-toggle');
+                toggleButton.setAttribute('title', 'Navigation kompakt/normal umschalten');
+                toggleButton.setAttribute('aria-label', 'Navigation kompakt/normal umschalten');
+                const toggleCompact = event => {
+                    event.preventDefault();
+                    event.stopPropagation();
+                    if (event.stopImmediatePropagation) event.stopImmediatePropagation();
+                    const compact = !document.documentElement.classList.contains('eos-nav-compact');
+                    document.documentElement.classList.toggle('eos-nav-compact', compact);
+                    safe(() => localStorage.setItem('nexowatt:eosNavCompact', compact ? '1' : '0'));
+                    toggleButton.setAttribute('aria-pressed', compact ? 'true' : 'false');
+                };
+                toggleButton.addEventListener('click', toggleCompact, true);
+                toggleButton.addEventListener('keydown', event => {
+                    if (event.key === 'Enter' || event.key === ' ') toggleCompact(event);
+                }, true);
+            }
             const img = header.querySelector('img');
             if (img) patchImage(img);
             const avatarImg = header.querySelector('.MuiAvatar-img');
@@ -728,6 +749,116 @@
         });
     });
 
+
+    const applyNavCompactPreference = () => safe(() => {
+        const compact = localStorage.getItem('nexowatt:eosNavCompact') === '1';
+        document.documentElement.classList.toggle('eos-nav-compact', compact);
+        document.querySelectorAll('.eos-nav-compact-toggle').forEach(button => {
+            button.setAttribute('aria-pressed', compact ? 'true' : 'false');
+            button.setAttribute('title', compact ? 'Navigation normal anzeigen' : 'Navigation kompakt anzeigen');
+        });
+    });
+
+    const assistContext = () => {
+        const routes = routeInfo();
+        if (routes.adapters) return {
+            title: 'Module einrichten',
+            text: 'Wähle zuerst das passende Modul, prüfe Version und Instanzstatus und öffne dann die Konfiguration über die drei Punkte oder das Werkzeug-Symbol.',
+            steps: ['Modul suchen', 'Instanz anlegen', 'Verbindung testen', 'Datenpunkte prüfen']
+        };
+        if (routes.instances) return {
+            title: 'Dienste prüfen',
+            text: 'Kontrolliere Status, Port, Speicherverbrauch und Logmeldungen. Gestoppte Dienste erst nach Ursache und Abhängigkeiten prüfen.',
+            steps: ['Status ansehen', 'Log öffnen', 'Konfiguration prüfen', 'Dienst neu starten']
+        };
+        if (routes.users) return {
+            title: 'Zugänge & Rechte',
+            text: 'Installateure und Endkunden sollten nur die Module sehen, die sie wirklich bedienen dürfen. Geschützte EOS-Module bleiben Administratoren vorbehalten.',
+            steps: ['Benutzer wählen', 'Rolle zuordnen', 'Rechteprofil setzen', 'Löschschutz prüfen']
+        };
+        if (routeInfo().intro) return {
+            title: 'EOS Cockpit',
+            text: 'Beginne mit Systemstatus, Hosts und gesicherten Basisdiensten. Danach Module Schritt für Schritt freischalten.',
+            steps: ['System prüfen', 'Sicherung prüfen', 'Module planen', 'Rechte vergeben']
+        };
+        return {
+            title: 'EOS Bedienhilfe',
+            text: 'Ich unterstütze dich beim Einrichten, Prüfen und Absichern deiner EOS-Module.',
+            steps: ['Ziel beschreiben', 'Modul auswählen', 'Parameter prüfen', 'Test starten']
+        };
+    };
+
+    const assistAnswer = query => {
+        const q = normalize(query);
+        if (!q) return 'Beschreibe kurz, was eingerichtet werden soll, zum Beispiel: PV, Speicher, Wallbox, Modbus, Backup oder Benutzerrechte.';
+        if (/wallbox|evcs|lade|auto|ocpp/.test(q)) return 'Für Ladepunkte: zuerst OCPP/EVCS-Modul installieren, Verbindung zur Wallbox prüfen, Ladepunkt-ID setzen, danach Datenpunkte für Status, Leistung und Freigabe testen.';
+        if (/pv|solar|wechselrichter|sun2000|fronius|kostal|sma/.test(q)) return 'Für PV/Wechselrichter: IP-Adresse, Modbus/TCP oder Hersteller-API aktivieren, Abfrageintervall moderat setzen und danach Erzeugung, Bezug und Einspeisung in den Datenpunkten prüfen.';
+        if (/speicher|batterie|akku/.test(q)) return 'Für Speicher: Kommunikationsweg prüfen, Lade-/Entladeleistung und SoC-Datenpunkte kontrollieren und Grenzwerte erst setzen, wenn Livewerte plausibel sind.';
+        if (/modbus/.test(q)) return 'Für Modbus: Host/IP, Port 502, Unit-ID und Registertabelle prüfen. Danach erst lesen testen, dann Schreibrechte gezielt freischalten.';
+        if (/mqtt/.test(q)) return 'Für MQTT: Broker-Adresse, Zugangsdaten, Topic-Struktur und TLS prüfen. Danach mit einem Test-Topic starten und erst dann produktive Topics freigeben.';
+        if (/backup|sicherung|restore/.test(q)) return 'Für Sicherung: BackItUp aktiv halten, Zielpfad oder Cloud-Ziel prüfen, Test-Backup starten und Restore-Hinweise dokumentieren.';
+        if (/rechte|benutzer|installateur|kunde|admin/.test(q)) return 'Für Rechte: Benutzer in Rollen trennen. Installateure dürfen konfigurieren, aber geschützte EOS-Systemmodule nicht löschen. Endkunden bekommen nur Bedien- und Leserechte.';
+        if (/fehler|log|offline|404|timeout/.test(q)) return 'Bei Fehlern: zuerst Systemlogs öffnen, betroffene Instanz filtern, letzte Änderung prüfen, Dienst neu starten und danach Port/WebSocket/Repository prüfen.';
+        return 'Vorschlag: Starte mit dem passenden Modul, prüfe die Verbindung, kontrolliere die erzeugten Datenpunkte und sichere danach die Rechte. Für konkrete Hilfe nenne bitte Modulname und Zielgerät.';
+    };
+
+    const ensureEosAssist = () => safe(() => {
+        const hasApp = !!document.getElementById('app-paper');
+        if (!hasApp || isLoginView()) {
+            document.getElementById('eos-assist-root')?.remove();
+            return;
+        }
+        let root = document.getElementById('eos-assist-root');
+        if (!root) {
+            root = document.createElement('section');
+            root.id = 'eos-assist-root';
+            root.className = 'eos-assist-root';
+            document.body.appendChild(root);
+        }
+        const ctx = assistContext();
+        root.classList.toggle('eos-assist-open', !!state.assistOpen);
+        root.innerHTML = `
+            <button class="eos-assist-button" type="button" aria-expanded="${state.assistOpen ? 'true' : 'false'}">
+                <span class="eos-assist-dot"></span><strong>EOS Assist</strong><small>Einrichtungshilfe</small>
+            </button>
+            <div class="eos-assist-panel" role="dialog" aria-label="EOS Assist Einrichtungshilfe">
+                <div class="eos-assist-head">
+                    <div><strong>${ctx.title}</strong><span>${ctx.text}</span></div>
+                    <button type="button" class="eos-assist-close" aria-label="EOS Assist schließen">×</button>
+                </div>
+                <div class="eos-assist-steps">${ctx.steps.map(step => `<span>${step}</span>`).join('')}</div>
+                <label class="eos-assist-input-label">Was möchtest du einrichten?</label>
+                <div class="eos-assist-input-row"><input class="eos-assist-input" placeholder="z. B. Wallbox, PV, Modbus, Rechte..." /><button type="button" class="eos-assist-send">Fragen</button></div>
+                <div class="eos-assist-answer">${assistAnswer('')}</div>
+            </div>
+        `;
+        const openButton = root.querySelector('.eos-assist-button');
+        const closeButton = root.querySelector('.eos-assist-close');
+        const input = root.querySelector('.eos-assist-input');
+        const send = root.querySelector('.eos-assist-send');
+        const answer = root.querySelector('.eos-assist-answer');
+        openButton?.addEventListener('click', event => {
+            event.preventDefault();
+            state.assistOpen = !state.assistOpen;
+            root.classList.toggle('eos-assist-open', state.assistOpen);
+            openButton.setAttribute('aria-expanded', state.assistOpen ? 'true' : 'false');
+            if (state.assistOpen) setTimeout(() => input?.focus(), 40);
+        });
+        closeButton?.addEventListener('click', event => {
+            event.preventDefault();
+            state.assistOpen = false;
+            root.classList.remove('eos-assist-open');
+            openButton?.setAttribute('aria-expanded', 'false');
+        });
+        const ask = () => {
+            if (answer) answer.textContent = assistAnswer(input?.value || '');
+        };
+        send?.addEventListener('click', ask);
+        input?.addEventListener('keydown', event => {
+            if (event.key === 'Enter') ask();
+        });
+    });
+
     const patchDocumentMeta = () => safe(() => {
         document.title = BRAND_LONG;
         const theme = document.querySelector('meta[name="theme-color"]');
@@ -745,6 +876,8 @@
         patchDocumentMeta();
         patchLogin();
         patchShell();
+        applyNavCompactPreference();
+        ensureEosAssist();
         ensureRightsHelper();
         ensurePermissionPresets();
         ensureSettingsDialogClasses();
@@ -762,6 +895,8 @@
         normalizeBadAddressAfterLogin();
         patchLogin();
         patchShell();
+        applyNavCompactPreference();
+        ensureEosAssist();
         ensureRightsHelper();
         ensurePermissionPresets();
         ensureSettingsDialogClasses();

package/adminWww/js/eos-security-ui.js

@@ -1,7 +1,7 @@
 (() => {
     'use strict';
 
-    const VERSION = 'v26-security-visibility-guard';
+    const VERSION = 'v27-security-visibility-guard';
     const LEGACY_ADMIN = 'admin';
     const LEGACY_ADMIN_INSTANCE = 'admin.0';
     const SECURITY_URL = '/nexowatt/security/session';

package/build/main.js

@@ -828,13 +828,8 @@ class Admin extends adapter_core_1.Adapter {
         }
         let changed = false;
         obj.common = obj.common || {};
-        if (options.keepDontDelete) {
-            if (obj.common.dontDelete !== true) {
-                obj.common.dontDelete = true;
-                changed = true;
-            }
-        }
-        else if (obj.common.dontDelete === true && id !== `system.adapter.${EOS_ADMIN_ADAPTER_NAME}`) {
+        // v28: do not use common.dontDelete for EOS protection because it can block adapter upgrades.
+        if (obj.common.dontDelete === true) {
             delete obj.common.dontDelete;
             changed = true;
         }
@@ -870,7 +865,7 @@ class Admin extends adapter_core_1.Adapter {
         const isEosAdmin = adapter === EOS_ADMIN_ADAPTER_NAME;
         const adminOnlyAcl = isEosAdmin || this.shouldApplyAdminOnlyAclToProtectedAdapters();
         let changed = await this.ensureObjectProtectionPolicy(`system.adapter.${adapter}`, {
-            keepDontDelete: isEosAdmin,
+            keepDontDelete: false,
             adminOnlyAcl,
         });
         try {
@@ -880,7 +875,7 @@ class Admin extends adapter_core_1.Adapter {
             });
             for (const row of instances.rows) {
                 changed = (await this.ensureObjectProtectionPolicy(row.id, {
-                    keepDontDelete: isEosAdmin,
+                    keepDontDelete: false,
                     adminOnlyAcl,
                 })) || changed;
             }
@@ -889,7 +884,7 @@ class Admin extends adapter_core_1.Adapter {
             this.log.warn(`Cannot protect instances of adapter "${adapter}": ${e instanceof Error ? e.message : e}`);
         }
         if (changed) {
-            this.log.info(`EOS delete/ACL guard applied to adapter "${adapter}"`);
+            this.log.info(`EOS ACL/UI delete guard applied to adapter "${adapter}"`);
         }
     }
     async ensureLegacyAdminLocked() {