iobroker.eos-admin 7.9.26 → 7.9.27

package/admin/jsonConfig.json5

@@ -165,6 +165,26 @@
                     newLine: true,
                     label: 'Disable Assistent',
                     sx: 12,
+                },
+                eosAssistantEnabled: {
+                    type: 'checkbox',
+                    newLine: true,
+                    label: 'EOS Assist anzeigen',
+                    help: 'Zeigt die lokale Bedienungsassistenz für Einrichtung, Adapter, Dienste, Logs und Rechte in der EOS-Oberfläche an.',
+                    xs: 12,
+                    sm: 12,
+                    md: 6,
+                    lg: 4,
+                },
+                eosAssistantAdminOnly: {
+                    type: 'checkbox',
+                    label: 'EOS Assist nur für Administratoren',
+                    help: 'Wenn aktiv, sehen Installateur- und Endkundenbenutzer den EOS Assist nicht.',
+                    hidden: '!data.eosAssistantEnabled',
+                    xs: 12,
+                    sm: 12,
+                    md: 6,
+                    lg: 4,
                 }
             },
         },

package/adminWww/css/eos-branding.css

@@ -2448,3 +2448,313 @@ html.eos-app .MuiAppBar-root .MuiToolbar-root img[alt*="user" i] {
     }
 }
 
+
+/* === NexoWatt EOS v27: black logo plate + safe compact navigation =========
+   The horizontal rail must never disappear completely. The collapse control is
+   used as a two-stage compact toggle and gets its own non-overlapping left slot. */
+html.eos-app .eos-brand-badge {
+    grid-template-columns: 78px minmax(172px, 1fr) 12px !important;
+    min-width: 332px !important;
+    width: 332px !important;
+    padding-left: 6px !important;
+    background:
+        radial-gradient(circle at 39px 31px, rgba(0, 255, 136, 0.18), transparent 46px),
+        linear-gradient(135deg, rgba(0, 36, 28, 0.86), rgba(2, 9, 20, 0.95) 62%, rgba(0, 0, 0, 0.82)) !important;
+}
+
+html.eos-app .eos-brand-badge-mark {
+    width: 66px !important;
+    height: 66px !important;
+    min-width: 66px !important;
+    min-height: 66px !important;
+    transform: translateY(-2px) !important;
+    border-radius: 23px !important;
+    background:
+        radial-gradient(circle at 50% 44%, rgba(0, 255, 136, 0.11), rgba(0, 13, 14, 0.86) 47%, rgba(0, 0, 0, 0.98) 100%) !important;
+    border: 1px solid rgba(97, 255, 213, 0.70) !important;
+    outline: 1px solid rgba(0, 0, 0, 0.82) !important;
+    box-shadow:
+        inset 0 0 0 1px rgba(255, 255, 255, 0.035),
+        inset 0 0 28px rgba(0, 255, 136, 0.12),
+        0 0 0 3px rgba(0, 0, 0, 0.42),
+        0 0 22px rgba(0, 255, 136, 0.46),
+        0 0 46px rgba(0, 212, 255, 0.13) !important;
+}
+
+html.eos-app .eos-brand-badge-logo {
+    width: 58px !important;
+    height: 58px !important;
+    min-width: 58px !important;
+    min-height: 58px !important;
+    transform: translateY(-1px) !important;
+    filter:
+        brightness(2.28)
+        contrast(1.22)
+        saturate(1.50)
+        drop-shadow(0 0 1px rgba(245, 255, 252, 0.96))
+        drop-shadow(0 0 11px rgba(0, 255, 136, 0.86))
+        drop-shadow(0 0 23px rgba(0, 212, 255, 0.28)) !important;
+}
+
+/* Dedicated collapse/compact slot: left of the horizontal menu, no overlap with
+   the first menu action. The native full-close action is intercepted in JS. */
+html.eos-app .MuiDrawer-paper,
+html.eos-app .eos-drawer {
+    position: fixed !important;
+    padding-left: 82px !important;
+}
+
+html.eos-app .eos-native-drawer-header {
+    position: absolute !important;
+    left: 12px !important;
+    top: 8px !important;
+    right: auto !important;
+    bottom: auto !important;
+    flex: 0 0 58px !important;
+    width: 58px !important;
+    min-width: 58px !important;
+    max-width: 58px !important;
+    margin: 0 !important;
+    z-index: 4 !important;
+    background: linear-gradient(145deg, rgba(0, 255, 136, 0.17), rgba(0, 25, 32, 0.88)) !important;
+    border: 1px solid rgba(0, 255, 136, 0.42) !important;
+    box-shadow: 0 10px 24px rgba(0, 0, 0, 0.34), inset 0 0 18px rgba(0, 255, 136, 0.10) !important;
+}
+
+html.eos-app .eos-native-drawer-header button,
+html.eos-app .eos-native-drawer-header .MuiIconButton-root,
+html.eos-app .eos-native-drawer-header [role="button"] {
+    width: 46px !important;
+    height: 46px !important;
+    min-width: 46px !important;
+    min-height: 46px !important;
+    border-radius: 16px !important;
+    background: rgba(0, 0, 0, 0.28) !important;
+    border: 1px solid rgba(0, 255, 136, 0.24) !important;
+}
+
+html.eos-app .eos-native-drawer-header button::after,
+html.eos-app .eos-native-drawer-header .MuiIconButton-root::after,
+html.eos-app .eos-native-drawer-header [role="button"]::after {
+    content: 'kompakt';
+    position: absolute;
+    left: 50%;
+    bottom: -13px;
+    transform: translateX(-50%);
+    font-size: 7px;
+    font-weight: 800;
+    line-height: 1;
+    letter-spacing: .06em;
+    text-transform: uppercase;
+    color: rgba(208, 255, 239, .62);
+    pointer-events: none;
+}
+
+html.eos-nav-compact .eos-native-drawer-header button::after,
+html.eos-nav-compact .eos-native-drawer-header .MuiIconButton-root::after,
+html.eos-nav-compact .eos-native-drawer-header [role="button"]::after {
+    content: 'menü';
+}
+
+html.eos-app .eos-scroll-nav,
+html.eos-app .MuiDrawer-paper .MuiList-root {
+    margin-left: 0 !important;
+    padding-left: 0 !important;
+}
+
+/* Stronger removal of the native logout tile in the horizontal rail. */
+html.eos-app .eos-hidden-logout,
+html.eos-app .eos-hidden-logout *,
+html.eos-app .MuiDrawer-paper a[href*="logout"],
+html.eos-app .MuiDrawer-paper button[aria-label*="logout" i],
+html.eos-app .MuiDrawer-paper button[aria-label*="abmelden" i] {
+    display: none !important;
+    visibility: hidden !important;
+    opacity: 0 !important;
+    pointer-events: none !important;
+}
+
+/* Compact mode keeps the rail visible but reduces the menu to icon buttons. */
+html.eos-nav-compact.eos-app .MuiDrawer-paper,
+html.eos-nav-compact.eos-app .eos-drawer {
+    height: 66px !important;
+    min-height: 66px !important;
+    max-height: 66px !important;
+    padding-top: 6px !important;
+    padding-bottom: 6px !important;
+    padding-left: 78px !important;
+}
+
+html.eos-nav-compact.eos-app .eos-native-drawer-header {
+    top: 6px !important;
+    width: 54px !important;
+    min-width: 54px !important;
+    max-width: 54px !important;
+    height: 52px !important;
+    min-height: 52px !important;
+}
+
+html.eos-nav-compact.eos-app .eos-native-drawer-header button,
+html.eos-nav-compact.eos-app .eos-native-drawer-header .MuiIconButton-root,
+html.eos-nav-compact.eos-app .eos-native-drawer-header [role="button"] {
+    width: 42px !important;
+    height: 42px !important;
+    min-width: 42px !important;
+    min-height: 42px !important;
+}
+
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiListItemButton-root,
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiButtonBase-root.MuiListItemButton-root {
+    width: 54px !important;
+    min-width: 54px !important;
+    max-width: 54px !important;
+    height: 50px !important;
+    min-height: 50px !important;
+    padding: 0 !important;
+    justify-content: center !important;
+    gap: 0 !important;
+}
+
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiListItemIcon-root {
+    min-width: 0 !important;
+    margin: 0 !important;
+    display: inline-flex !important;
+    justify-content: center !important;
+}
+
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiListItemText-root,
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiListItemButton-root .MuiTypography-root,
+html.eos-nav-compact.eos-app .MuiDrawer-paper .MuiListItemButton-root span:not(.MuiBadge-badge) {
+    max-width: 0 !important;
+    width: 0 !important;
+    min-width: 0 !important;
+    opacity: 0 !important;
+    overflow: hidden !important;
+    margin: 0 !important;
+    padding: 0 !important;
+}
+
+html.eos-nav-compact.eos-app #app-paper,
+html.eos-nav-compact.eos-app main,
+html.eos-nav-compact.eos-app .MuiContainer-root {
+    /* content keeps its normal vertical rhythm; the rail is still present */
+}
+
+@media (max-width: 1220px) {
+    html.eos-app .eos-brand-badge {
+        min-width: 88px !important;
+        width: 88px !important;
+        padding-left: 7px !important;
+    }
+    html.eos-app .eos-brand-badge-mark {
+        background: radial-gradient(circle at 50% 44%, rgba(0, 255, 136, 0.10), rgba(0, 0, 0, 0.98) 70%) !important;
+    }
+    html.eos-app .MuiDrawer-paper,
+    html.eos-app .eos-drawer {
+        padding-left: 74px !important;
+    }
+    html.eos-app .eos-native-drawer-header {
+        left: 9px !important;
+    }
+}
+
+/* === NexoWatt EOS v27: local setup assistant ============================== */
+.eos-assist-launcher {
+    position: fixed;
+    right: 24px;
+    bottom: 24px;
+    z-index: 1900;
+    height: 54px;
+    min-width: 54px;
+    border: 1px solid rgba(0, 255, 136, .55);
+    border-radius: 18px;
+    background: linear-gradient(135deg, #00ff88, #00d4ff);
+    color: #02101d;
+    font-weight: 950;
+    letter-spacing: .02em;
+    box-shadow: 0 16px 34px rgba(0,0,0,.42), 0 0 26px rgba(0,255,136,.28);
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    gap: 9px;
+    padding: 0 16px;
+}
+
+.eos-assist-launcher span:first-child { font-size: 21px; }
+
+.eos-assist-panel {
+    position: fixed;
+    right: 24px;
+    bottom: 88px;
+    z-index: 1901;
+    width: min(430px, calc(100vw - 32px));
+    max-height: min(720px, calc(100vh - 116px));
+    display: none;
+    flex-direction: column;
+    border-radius: 24px;
+    overflow: hidden;
+    border: 1px solid rgba(0,255,136,.42);
+    background:
+        radial-gradient(circle at 18% 0%, rgba(0,255,136,.16), transparent 38%),
+        linear-gradient(180deg, rgba(8, 30, 45, .98), rgba(2, 9, 20, .98));
+    box-shadow: 0 26px 72px rgba(0,0,0,.58), 0 0 34px rgba(0,255,136,.14);
+    color: var(--eos-text);
+}
+
+.eos-assist-open .eos-assist-panel { display: flex; }
+
+.eos-assist-head {
+    display: grid;
+    grid-template-columns: 48px 1fr 40px;
+    gap: 12px;
+    align-items: center;
+    padding: 16px;
+    border-bottom: 1px solid rgba(0,255,136,.22);
+    background: rgba(0,0,0,.22);
+}
+
+.eos-assist-logo {
+    width: 48px;
+    height: 48px;
+    border-radius: 16px;
+    display: grid;
+    place-items: center;
+    background: #000;
+    border: 1px solid rgba(111,255,215,.62);
+    box-shadow: inset 0 0 18px rgba(0,255,136,.12), 0 0 18px rgba(0,255,136,.24);
+}
+.eos-assist-logo img { width: 42px; height: 42px; object-fit: contain; filter: brightness(1.9) saturate(1.35) drop-shadow(0 0 8px rgba(0,255,136,.65)); }
+
+.eos-assist-head strong { display:block; font-size: 16px; font-weight: 950; }
+.eos-assist-head small { display:block; margin-top: 3px; color: rgba(226,246,255,.70); font-weight: 700; letter-spacing: .03em; }
+.eos-assist-close { border:0; background: rgba(255,255,255,.06); color: #fff; border-radius: 14px; height: 40px; cursor:pointer; font-size:20px; }
+
+.eos-assist-body { padding: 15px; overflow: auto; display:flex; flex-direction:column; gap: 12px; }
+.eos-assist-card { border-radius: 18px; border: 1px solid rgba(123,204,255,.16); background: rgba(3,15,26,.70); padding: 13px; }
+.eos-assist-card strong { color: #efffff; }
+.eos-assist-card p { margin: 7px 0 0; color: rgba(226,246,255,.76); line-height: 1.42; }
+.eos-assist-actions { display:grid; grid-template-columns: 1fr 1fr; gap: 8px; }
+.eos-assist-actions button,
+.eos-assist-send {
+    border: 1px solid rgba(0,255,136,.30);
+    background: rgba(0,255,136,.09);
+    color: #eefcff;
+    border-radius: 13px;
+    min-height: 38px;
+    font-weight: 800;
+    cursor: pointer;
+}
+.eos-assist-actions button:hover,
+.eos-assist-send:hover { background: rgba(0,255,136,.16); }
+.eos-assist-input-row { display:grid; grid-template-columns: 1fr 84px; gap: 8px; }
+.eos-assist-input { min-height: 40px; border-radius: 14px; border: 1px solid rgba(123,204,255,.22); background: rgba(2,9,20,.78); color: #fff; padding: 0 12px; outline: none; }
+.eos-assist-answer { white-space: pre-line; font-size: 13px; line-height: 1.45; color: rgba(237,251,255,.90); }
+.eos-assist-answer ul { margin: 8px 0 0 18px; padding: 0; }
+.eos-assist-answer li { margin: 4px 0; }
+.eos-assist-foot { color: rgba(226,246,255,.55); font-size: 11px; padding-top: 2px; }
+
+@media (max-width: 760px) {
+    .eos-assist-launcher { right: 14px; bottom: 14px; padding: 0 12px; }
+    .eos-assist-panel { right: 14px; bottom: 78px; }
+    .eos-assist-actions { grid-template-columns: 1fr; }
+}

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=27" />
         <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=27"></script>
+            <script defer src="./js/eos-security-ui.js?v=27"></script>
+            <script defer src="./js/eos-assistant.js?v=27"></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-header-logo-nav-assist';
 
     const BRAND = 'NexoWatt EOS';
     const EOS_MEANING = 'Energy Operation System';
@@ -490,6 +490,44 @@
         removeLogoutButton();
     };
 
+    const NAV_COMPACT_KEY = 'nexowatt.eos.navCompact';
+
+    const setNavCompact = value => safe(() => {
+        const active = !!value;
+        document.documentElement.classList.toggle('eos-nav-compact', active);
+        window.localStorage && window.localStorage.setItem(NAV_COMPACT_KEY, active ? '1' : '0');
+    });
+
+    const restoreNavCompact = () => safe(() => {
+        const saved = window.localStorage && window.localStorage.getItem(NAV_COMPACT_KEY);
+        if (saved === '1') document.documentElement.classList.add('eos-nav-compact');
+        if (saved === '0') document.documentElement.classList.remove('eos-nav-compact');
+    });
+
+    const bindCompactNavToggle = header => safe(() => {
+        if (!header) return;
+        restoreNavCompact();
+        const controls = Array.from(header.querySelectorAll('button, .MuiIconButton-root, [role="button"]'));
+        controls.forEach(control => {
+            if (control.dataset.eosCompactToggleBound === '1') return;
+            control.dataset.eosCompactToggleBound = '1';
+            control.setAttribute('title', 'Menü kompakt/erweitert anzeigen');
+            control.setAttribute('aria-label', 'Menü kompakt/erweitert anzeigen');
+            const toggle = event => {
+                event.preventDefault();
+                event.stopPropagation();
+                if (event.stopImmediatePropagation) event.stopImmediatePropagation();
+                setNavCompact(!document.documentElement.classList.contains('eos-nav-compact'));
+                scheduleFullPatch(0);
+                return false;
+            };
+            control.addEventListener('click', toggle, true);
+            control.addEventListener('keydown', event => {
+                if (event.key === 'Enter' || event.key === ' ') toggle(event);
+            }, true);
+        });
+    });
+
     const hideNativeLogoutNav = () => safe(() => {
         const candidates = Array.from(document.querySelectorAll('.MuiDrawer-paper a, .MuiDrawer-paper button, .MuiDrawer-paper .MuiListItem-root, .MuiDrawer-paper .MuiListItemButton-root, .MuiDrawer-paper [role=\"button\"]'));
         candidates.forEach(el => {
@@ -518,6 +556,7 @@
         }
         if (header) {
             header.classList.add('eos-native-drawer-header');
+            bindCompactNavToggle(header);
             const img = header.querySelector('img');
             if (img) patchImage(img);
             const avatarImg = header.querySelector('.MuiAvatar-img');
@@ -820,6 +859,7 @@
     });
 
     forceLoginGlobals();
+    restoreNavCompact();
     if (document.readyState === 'loading') {
         document.addEventListener('DOMContentLoaded', () => {
             fullPatch();

package/build/lib/web.js

@@ -491,6 +491,14 @@ class Web {
             legacyAdminAdapter: 'admin',
             legacyAdminInstance: 'admin.0',
             protectedAdapters: this.getEosProtectedAdapterNames(),
+            eosAssistantEnabled: this.settings.eosAssistantEnabled !== false,
+            eosAssistantMode: this.settings.eosAssistantMode || 'local',
+            eosAssistantAdminOnly: this.settings.eosAssistantAdminOnly === true,
+            assistant: {
+                enabled: this.settings.eosAssistantEnabled !== false,
+                mode: this.settings.eosAssistantMode || 'local',
+                adminOnly: this.settings.eosAssistantAdminOnly === true,
+            },
         });
     }
 
@@ -721,6 +729,10 @@ class Web {
                         hideLegacyAdminFromNonAdmins: true,
                         restrictProtectedAdapterControls: true,
                         protectedAdapters: ['eos-admin'],
+                        eosAssistantEnabled: true,
+                        eosAssistantMode: 'local',
+                        eosAssistantAdminOnly: false,
+                        assistant: { enabled: true, mode: 'local', adminOnly: false },
                     });
                 });
             };

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "eos-admin",
-    "version": "7.9.26",
+    "version": "7.9.27",
     "titleLang": {
       "en": "NexoWatt EOS Admin",
       "de": "NexoWatt EOS Admin",
@@ -18,6 +18,10 @@
     "connectionType": "local",
     "dataSource": "push",
     "news": {
+      "7.9.27": {
+        "en": "Visual and usability update: logo gets a black high-contrast background, the horizontal navigation collapse control becomes a safe compact toggle, and EOS Assist adds guided setup help for modules and adapters.",
+        "de": "Optik- und Bedienupdate: Logo mit schwarzem Kontrast-Hintergrund, der Navigationspfeil schaltet nur noch eine sichere Kompaktansicht, und EOS Assist ergänzt geführte Hilfe für Module und Adapter."
+      },
       "7.9.26": {
         "en": "Visual polish: strengthened the NexoWatt EOS header logo and improved account-name contrast in the top bar.",
         "de": "Optischer Feinschliff: NexoWatt-EOS-Headerlogo deutlicher sichtbar und Kontoname in der oberen Leiste kontrastreicher."
@@ -325,7 +329,10 @@
       }
     ],
     "eosAdminOnlyGroup": "system.group.administrator",
-    "eosApplyAdminOnlyAclToProtectedAdapters": true
+    "eosApplyAdminOnlyAclToProtectedAdapters": true,
+    "eosAssistantEnabled": true,
+    "eosAssistantMode": "local",
+    "eosAssistantAdminOnly": false
   },
   "notifications": [
     {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "iobroker.eos-admin",
   "description": "NexoWatt EOS Admin standalone interface for Energy Operation System",
-  "version": "7.9.26",
+  "version": "7.9.27",
   "contributors": [
     "bluefox <dogafox@gmail.com>",
     "apollon77",