iobroker.shoppingroute 0.4.3 → 0.5.0

package/README.md

@@ -1,45 +1,172 @@
 # ShoppingRoute for ioBroker
 
-![ShoppingRoute](admin/shoppingroute.png)
+<p align="center">
+  <img src="admin/shoppingroute.png" alt="ShoppingRoute" width="160">
+</p>
 
-**Current version: 0.4.0**
+<p align="center">
+  <strong>Smart Alexa shopping lists — sorted by store, product group and your real walking route.</strong>
+</p>
 
-ShoppingRoute sorts Alexa shopping-list entries by market, product group and each store's individual walking route. It assigns visible two-digit keys such as `20> Bananas` and `40> ═════ ALDI ═════`; managed lists must therefore be set to **A–Z** in the Alexa app. ShoppingRoute reuses the local Alexa2 authentication for direct item updates, deletes and batch creates, while Alexa2 list states remain the external change trigger.
+<p align="center">
+  <img src="http://iobroker.live/badges/shoppingroute-installed.svg" alt="ioBroker installations">
+  <img src="http://iobroker.live/badges/shoppingroute-stable.svg" alt="ioBroker stable installations">
+  <a href="https://www.npmjs.com/package/iobroker.shoppingroute"><img src="https://img.shields.io/npm/v/iobroker.shoppingroute.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/iobroker.shoppingroute"><img src="https://img.shields.io/npm/dm/iobroker.shoppingroute.svg" alt="npm downloads"></a>
+  <a href="https://github.com/RaviniZib/ioBroker.shoppingroute/actions/workflows/test-and-release.yml"><img src="https://github.com/RaviniZib/ioBroker.shoppingroute/actions/workflows/test-and-release.yml/badge.svg" alt="Test and Release"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license"></a>
+</p>
 
-## User guide / Bedienungsanleitung
+> **Current version: 0.4.4**  
+> ShoppingRoute is available in the ioBroker **latest** repository.
 
-🇬🇧 [**English user guide**](USER_GUIDE_EN.md)  
-🇩🇪 [**Deutsche Bedienungsanleitung**](BEDIENUNGSANLEITUNG_DE.md)
+## What ShoppingRoute does
 
-## Highlights
+ShoppingRoute turns an ordinary Alexa shopping list into a list that follows the way you actually shop.
 
-- multiple Alexa lists with per-list priority markets
-- global, per-list and temporary market priorities
-- market aliases and common market-name variants
-- optional automatically managed market headings such as `═════ ALDI ═════`
-- optional cross-market consolidation using a minimum-item threshold; explicit market requests are never moved
-- configurable product groups and store-specific routes
-- product catalogue with aliases, preferred and available markets
-- quantity parser for digits, number words, packs, half-kilo and `6x` forms
-- duplicate-resistant product learning
+Instead of keeping items only in the order Alexa received them, the adapter can assign them to stores, product groups and a configurable walking route inside each store. It uses visible two-digit prefixes such as `20> Bananas` and optional market headings such as `40> ═════ ALDI ═════`.
+
+That means a list can automatically become something like:
+
+```text
+10> Apples
+20> Bananas
+30> Bread
+40> ═════ ALDI ═════
+50> Milk
+60> Cheese
+70> Coffee
+```
+
+Managed Alexa lists must be set to **A–Z** in the Alexa app. ShoppingRoute then controls the effective order through its prefixes.
+
+ShoppingRoute reuses the local authentication of the ioBroker **Alexa2** adapter for direct item updates, deletions and batch creation. Alexa2 list states remain the external change trigger.
+
+**Service / manufacturer reference:** ShoppingRoute works with Amazon Alexa shopping lists. Amazon documents Alexa lists as a customer feature of the Alexa ecosystem; customers can access Alexa shopping and to-do lists through the Alexa app, Amazon app and Amazon retail site. See the [official Amazon Alexa developer documentation](https://www.developer.amazon.com/en-US/docs/alexa/ask-overviews/deprecated-features.html#list-skills-and-alexa-shopping-and-to-do-lists).
+
+## Documentation
+
+Choose your language:
+
+- 🇬🇧 **English:** [User guide](USER_GUIDE_EN.md)
+- 🇩🇪 **Deutsch:** [Bedienungsanleitung](BEDIENUNGSANLEITUNG_DE.md) · [Ausführliche README](README_DE.md)
+
+Community and support:
+
+- 🧪 [ioBroker tester forum – ShoppingRoute v0.4.4](https://forum.iobroker.net/topic/85510/test-adapter-shoppingroute-v0.4.4)
+- 🐞 [GitHub issues](https://github.com/RaviniZib/ioBroker.shoppingroute/issues)
+
+The Admin interface itself supports all 11 standard ioBroker Admin languages.
+
+## Main features
+
+- dedicated **ShoppingRoute management page** in the ioBroker sidebar for shopping list, products, markets, product groups, routes, lists and review items
+- catalogue changes are persisted at runtime and do not require an adapter restart
+- market names are always stored in **UPPERCASE**, regardless of how they are entered, with all references normalized consistently
+- defensive protection against accidental catalogue resets during Admin/update flows
+
+### Store and route based sorting
+
+- configurable stores and store aliases
+- individual walking route for every store
+- product groups with independent sort order
+- preferred and available markets per product
+- global, per-list and temporary priority markets
+- optional market headings such as `═════ ALDI ═════`
+- optional cross-market consolidation using a minimum-item threshold
+- explicit market requests are never moved to another store
+
+### Smart product handling
+
+- product catalogue with aliases
+- duplicate-resistant learning
 - review queue for unknown products
-- automatic/review/off learning modes
+- automatic, review and off learning modes
 - category and alias suggestions
-- sorting preview before writes
-- incremental `00>`–`99>` prefix sorting with gap-preserving inserts and suffix-only rebuilds
-- direct Amazon responses plus one final list read as write confirmation
+- quantity parsing for digits, number words, packs, half-kilo expressions and `6x` forms
+- manual per-item market and position overrides
+
+### Alexa-safe list updates
+
+- incremental `00>`–`99>` prefix sorting
+- gap-preserving inserts to avoid unnecessary rewrites
+- suffix-only rebuilds when a numeric gap is exhausted
+- direct Amazon responses used to confirm operations
+- final direct list read for verification
+- exclusive transaction handling to prevent overlapping writes
+- recovery journal for interrupted operations
 - API Safe Mode with configurable write-rate limiting
+- bounded Alexa callbacks and polling with backoff
+
+### Admin and diagnostics
+
+- interactive current shopping-list view
+- drag & drop plus touch-friendly controls
+- sorting preview before writes
 - local-only shopping statistics
-- configuration backup/restore
+- configuration backup and restore
 - shareable market-route profiles
-- privacy-safe diagnostic/feedback report
+- privacy-safe diagnostic and feedback report
 - Alexa2/alexa-remote2 direct-session diagnostics
 - Dry Run safety mode
 
-See `README_DE.md` for the detailed German documentation.
+## Requirements
+
+- ioBroker with **Admin 8 or newer**
+- **js-controller 7.1.0 or newer**
+- a working ioBroker **Alexa2** adapter instance
+- the Alexa shopping list managed by ShoppingRoute must be sorted **A–Z** in the Alexa app
+
+## How it works
+
+1. Alexa2 reports a shopping-list change to ioBroker.
+2. ShoppingRoute reads the affected list and normalizes the item names.
+3. Products are matched against aliases, product groups and market assignments.
+4. The adapter builds the best market and route plan.
+5. Only the required list changes are written back to Amazon.
+6. The final remote list is read again and verified.
+
+The browser-based Admin interface never receives Alexa or Amazon credentials.
+
+## Privacy and safety
+
+ShoppingRoute does not require its own Amazon login. It reuses the locally stored Alexa2 session and does not log authentication secrets.
+
+Statistics are stored locally. The feedback report is designed to be privacy-safe, and Dry Run can be used to inspect planned changes without modifying the shopping list.
+
+## Installation
+
+Install ShoppingRoute from the ioBroker **Adapters** page while using the **latest** repository.
+
+After installation:
+
+1. create an instance of ShoppingRoute,
+2. select/configure the Alexa shopping list,
+3. define markets and product groups,
+4. configure the walking route for each store,
+5. set the managed Alexa list to **A–Z**,
+6. start with **Dry Run** if you want to inspect the result before enabling writes.
+
+For all configuration details, see the [English user guide](USER_GUIDE_EN.md) or the [German user guide](BEDIENUNGSANLEITUNG_DE.md).
+
+## Feedback and support
+
+ShoppingRoute is still young, so real-world feedback is especially valuable.
+
+Please use the [ioBroker tester thread](https://forum.iobroker.net/topic/85510/test-adapter-shoppingroute-v0.4.4) for general testing feedback and the [GitHub issue tracker](https://github.com/RaviniZib/ioBroker.shoppingroute/issues) for reproducible bugs or feature requests.
 
 ## Changelog
 
+### 0.5.0 (2026-10-05)
+- Add a dedicated ShoppingRoute management page in the ioBroker sidebar with a fixed header and direct management of shopping list, products, markets, product groups, routes, lists and review queue.
+- Persist large catalogue data outside normal instance configuration so catalogue edits no longer require an adapter restart.
+- Add defensive recovery and regression coverage for the destructive Admin/default reset reported in issue #59, including a successful real-instance reproduction test.
+- Normalize every market name to UPPERCASE on create, rename, load and save, and update market references consistently.
+- Refine the management UI with a stable sticky header, logo and shaded/zebra list blocks.
+
+### 0.4.4 (2026-09-25)
+- (RaviniZib) Use `No Market` for new fallback-market defaults, add all 11 admin languages to the backup utility, and remove six unused translation keys. Existing market names, routes and product data remain unchanged.
+
 ### 0.4.3 (2026-09-25)
 - (RaviniZib) Route Alexa callback timeouts through ioBroker-managed timers so stalled callbacks stay bounded without plain Node.js `setTimeout()` calls in adapter source.
 - (RaviniZib) Keep `common.news` within the seven entries supported by the repository builder.

package/README_DE.md

@@ -2,7 +2,7 @@
 
 ![ShoppingRoute](admin/shoppingroute.png)
 
-**Aktuelle Version: 0.4.0**
+**Aktuelle Version: 0.5.0**
 
 ShoppingRoute sortiert Alexa-Einkaufslisteneinträge nach Markt, Produktgruppe und dem individuellen Laufweg durch den jeweiligen Markt. Dazu vergibt es sichtbare zweistellige Schlüssel wie `20> Bananen` und `40> ═════ ALDI ═════`; verwaltete Listen müssen deshalb in der Alexa-App auf **A–Z** stehen. ShoppingRoute übernimmt lokal die Alexa2-Authentifizierung für direkte Updates, Deletes und Batch-Creates; Alexa2-Listenstates bleiben die Triggerquelle für externe Änderungen.
 
@@ -13,6 +13,11 @@ ShoppingRoute sortiert Alexa-Einkaufslisteneinträge nach Markt, Produktgruppe u
 
 ## Funktionen
 
+- eigene **ShoppingRoute-Verwaltungsseite** in der ioBroker-Seitenleiste für Einkaufsliste, Artikel, Märkte, Produktgruppen, Laufwege, Listen und Prüfung
+- Katalogänderungen werden zur Laufzeit gespeichert und benötigen keinen Adapter-Neustart
+- Marktnamen werden unabhängig von der Eingabe automatisch in **GROSSBUCHSTABEN** gespeichert; alle Marktverweise werden konsistent mit normalisiert
+- Schutz vor versehentlichem Zurücksetzen großer Katalogdaten durch Admin-/Update-Vorgänge
+
 - mehrere Alexa-Einkaufslisten mit eigenem Prioritätsmarkt
 - globale, listenbezogene und temporäre Marktpriorität
 - Markt-Aliase und automatische Erkennung häufiger Marktvarianten
@@ -73,6 +78,16 @@ ShoppingRoute wird unter der **[MIT-Lizenz](LICENSE)** veröffentlicht. Frühere
 
 ## Changelog
 
+### 0.5.0 (2026-10-05)
+- Neue eigenständige ShoppingRoute-Verwaltungsseite in der ioBroker-Seitenleiste mit fester Kopfzeile sowie Einkaufsliste, Artikel-, Markt-, Produktgruppen-, Laufweg-, Listen- und Prüfverwaltung.
+- Große Katalogdaten werden außerhalb der normalen Instanzkonfiguration als Laufzeitdaten gespeichert; Änderungen benötigen keinen Adapter-Neustart mehr.
+- Schutzmechanismus und Regressionstests verhindern den in Issue #59 beobachteten Rückfall auf Paket-Standarddaten; zusätzlich auf einer realen ioBroker-Instanz geprüft.
+- Marktnamen werden beim Anlegen, Umbenennen, Laden und Speichern immer in GROSSBUCHSTABEN normalisiert; Marktverweise werden konsistent mitgezogen.
+- Überarbeitete Verwaltungsoberfläche mit festem Header, Logo und dezenter Block-/Zebra-Darstellung.
+
+### 0.4.4 (2026-09-25)
+- (RaviniZib) `No Market` als Standard-Ausweichmarkt für neue Konfigurationen, Backup-Seite in allen 11 Admin-Sprachen und sechs ungenutzte Übersetzungsschlüssel entfernt. Vorhandene Marktnamen, Laufwege und Produktdaten bleiben unverändert.
+
 ### 0.4.3 (2026-09-25)
 - Alexa-Callback-Timeouts verwenden jetzt ioBroker-verwaltete Timer; hängende Aufrufe bleiben damit begrenzt, ohne nacktes Node.js-`setTimeout()` im Adapter-Quellcode.
 - `common.news` wird auf die vom Repository-Builder unterstützten sieben Einträge begrenzt.

package/admin/backup-i18n.js

@@ -0,0 +1,281 @@
+'use strict';
+
+// Standalone backup utility: keep its translations separate from JSON Config keys.
+(() => {
+    const translations = {
+    "de": {
+        "configTitle": "Komplette Konfiguration",
+        "configText": "Alle ShoppingRoute-Einstellungen direkt als JSON-Datei sichern oder aus einer Sicherungsdatei wiederherstellen.",
+        "downloadConfig": "↓ Sicherung herunterladen",
+        "uploadConfig": "↑ Sicherung wiederherstellen",
+        "marketTitle": "Marktprofil teilen",
+        "marketText": "Einen einzelnen Markt mit seinem Laufweg herunterladen oder ein Marktprofil aus einer JSON-Datei importieren.",
+        "downloadMarket": "↓ Marktprofil herunterladen",
+        "uploadMarket": "↑ Marktprofil importieren",
+        "loading": "Marktprofile werden geladen …",
+        "noMarkets": "Keine Marktprofile vorhanden",
+        "backupDownloaded": "Sicherung wurde heruntergeladen.",
+        "profileDownloaded": "Marktprofil wurde heruntergeladen.",
+        "configImportStarted": "Sicherung wurde übergeben. ShoppingRoute übernimmt die Konfiguration und startet anschließend neu.",
+        "profileImportStarted": "Marktprofil wurde übergeben und wird von ShoppingRoute übernommen.",
+        "invalidBackup": "Die gewählte Datei ist keine gültige JSON-Sicherung.",
+        "invalidProfile": "Die gewählte Datei ist kein gültiges ShoppingRoute-Marktprofil.",
+        "noInstance": "ShoppingRoute-Instanz konnte nicht ermittelt werden.",
+        "connectionError": "Verbindung zu ioBroker konnte nicht hergestellt werden.",
+        "exportError": "Sicherung konnte nicht erstellt werden.",
+        "profileError": "Marktprofile konnten nicht geladen werden.",
+        "title": "ShoppingRoute – Sicherung / Teilen",
+        "genericMarket": "Markt"
+    },
+    "en": {
+        "configTitle": "Complete configuration",
+        "configText": "Download all ShoppingRoute settings directly as a JSON file or restore them from a backup file.",
+        "downloadConfig": "↓ Download backup",
+        "uploadConfig": "↑ Restore backup",
+        "marketTitle": "Share market profile",
+        "marketText": "Download one market with its walking route or import a market profile from a JSON file.",
+        "downloadMarket": "↓ Download market profile",
+        "uploadMarket": "↑ Import market profile",
+        "loading": "Loading market profiles …",
+        "noMarkets": "No market profiles available",
+        "backupDownloaded": "Backup downloaded.",
+        "profileDownloaded": "Market profile downloaded.",
+        "configImportStarted": "Backup submitted. ShoppingRoute will apply the configuration and restart afterwards.",
+        "profileImportStarted": "Market profile submitted and will be applied by ShoppingRoute.",
+        "invalidBackup": "The selected file is not a valid JSON backup.",
+        "invalidProfile": "The selected file is not a valid ShoppingRoute market profile.",
+        "noInstance": "ShoppingRoute instance could not be determined.",
+        "connectionError": "Could not connect to ioBroker.",
+        "exportError": "Backup could not be created.",
+        "profileError": "Market profiles could not be loaded.",
+        "title": "ShoppingRoute – Backup / Share",
+        "genericMarket": "Market"
+    },
+    "es": {
+        "configTitle": "Configuración completa",
+        "configText": "Descargue todos los ajustes de ShoppingRoute como archivo JSON o restáurelos desde una copia de seguridad.",
+        "downloadConfig": "↓ Descargar copia de seguridad",
+        "uploadConfig": "↑ Restaurar copia de seguridad",
+        "marketTitle": "Compartir perfil de tienda",
+        "marketText": "Descargue una tienda con su recorrido o importe un perfil de tienda desde un archivo JSON.",
+        "downloadMarket": "↓ Descargar perfil de tienda",
+        "uploadMarket": "↑ Importar perfil de tienda",
+        "loading": "Cargando perfiles de tienda …",
+        "noMarkets": "No hay perfiles de tienda disponibles",
+        "backupDownloaded": "Copia de seguridad descargada.",
+        "profileDownloaded": "Perfil de tienda descargado.",
+        "configImportStarted": "Copia de seguridad enviada. ShoppingRoute aplicará la configuración y se reiniciará.",
+        "profileImportStarted": "Perfil de tienda enviado. ShoppingRoute lo aplicará.",
+        "invalidBackup": "El archivo seleccionado no es una copia de seguridad JSON válida.",
+        "invalidProfile": "El archivo seleccionado no es un perfil de tienda de ShoppingRoute válido.",
+        "noInstance": "No se pudo determinar la instancia de ShoppingRoute.",
+        "connectionError": "No se pudo conectar con ioBroker.",
+        "exportError": "No se pudo crear la copia de seguridad.",
+        "profileError": "No se pudieron cargar los perfiles de tienda.",
+        "title": "ShoppingRoute – Copias de seguridad / Compartir",
+        "genericMarket": "Tienda"
+    },
+    "fr": {
+        "configTitle": "Configuration complète",
+        "configText": "Téléchargez tous les paramètres de ShoppingRoute dans un fichier JSON ou restaurez-les depuis une sauvegarde.",
+        "downloadConfig": "↓ Télécharger la sauvegarde",
+        "uploadConfig": "↑ Restaurer une sauvegarde",
+        "marketTitle": "Partager un profil de magasin",
+        "marketText": "Téléchargez un magasin avec son parcours ou importez un profil de magasin depuis un fichier JSON.",
+        "downloadMarket": "↓ Télécharger le profil de magasin",
+        "uploadMarket": "↑ Importer un profil de magasin",
+        "loading": "Chargement des profils de magasin …",
+        "noMarkets": "Aucun profil de magasin disponible",
+        "backupDownloaded": "Sauvegarde téléchargée.",
+        "profileDownloaded": "Profil de magasin téléchargé.",
+        "configImportStarted": "Sauvegarde transmise. ShoppingRoute appliquera la configuration puis redémarrera.",
+        "profileImportStarted": "Profil de magasin transmis. ShoppingRoute va l’appliquer.",
+        "invalidBackup": "Le fichier sélectionné n’est pas une sauvegarde JSON valide.",
+        "invalidProfile": "Le fichier sélectionné n’est pas un profil de magasin ShoppingRoute valide.",
+        "noInstance": "Impossible de déterminer l’instance ShoppingRoute.",
+        "connectionError": "Impossible de se connecter à ioBroker.",
+        "exportError": "Impossible de créer la sauvegarde.",
+        "profileError": "Impossible de charger les profils de magasin.",
+        "title": "ShoppingRoute – Sauvegarde / Partage",
+        "genericMarket": "Magasin"
+    },
+    "it": {
+        "configTitle": "Configurazione completa",
+        "configText": "Scarica tutte le impostazioni di ShoppingRoute come file JSON o ripristinale da un backup.",
+        "downloadConfig": "↓ Scarica backup",
+        "uploadConfig": "↑ Ripristina backup",
+        "marketTitle": "Condividi profilo del negozio",
+        "marketText": "Scarica un negozio con il suo percorso o importa un profilo del negozio da un file JSON.",
+        "downloadMarket": "↓ Scarica profilo del negozio",
+        "uploadMarket": "↑ Importa profilo del negozio",
+        "loading": "Caricamento dei profili dei negozi …",
+        "noMarkets": "Nessun profilo del negozio disponibile",
+        "backupDownloaded": "Backup scaricato.",
+        "profileDownloaded": "Profilo del negozio scaricato.",
+        "configImportStarted": "Backup inviato. ShoppingRoute applicherà la configurazione e si riavvierà.",
+        "profileImportStarted": "Profilo del negozio inviato. ShoppingRoute lo applicherà.",
+        "invalidBackup": "Il file selezionato non è un backup JSON valido.",
+        "invalidProfile": "Il file selezionato non è un profilo del negozio ShoppingRoute valido.",
+        "noInstance": "Impossibile determinare l’istanza ShoppingRoute.",
+        "connectionError": "Impossibile connettersi a ioBroker.",
+        "exportError": "Impossibile creare il backup.",
+        "profileError": "Impossibile caricare i profili dei negozi.",
+        "title": "ShoppingRoute – Backup / Condivisione",
+        "genericMarket": "Negozio"
+    },
+    "nl": {
+        "configTitle": "Volledige configuratie",
+        "configText": "Download alle ShoppingRoute-instellingen als JSON-bestand of herstel ze vanuit een back-up.",
+        "downloadConfig": "↓ Back-up downloaden",
+        "uploadConfig": "↑ Back-up herstellen",
+        "marketTitle": "Winkelprofiel delen",
+        "marketText": "Download een winkel met de bijbehorende looproute of importeer een winkelprofiel uit een JSON-bestand.",
+        "downloadMarket": "↓ Winkelprofiel downloaden",
+        "uploadMarket": "↑ Winkelprofiel importeren",
+        "loading": "Winkelprofielen laden …",
+        "noMarkets": "Geen winkelprofielen beschikbaar",
+        "backupDownloaded": "Back-up gedownload.",
+        "profileDownloaded": "Winkelprofiel gedownload.",
+        "configImportStarted": "Back-up verzonden. ShoppingRoute past de configuratie toe en start daarna opnieuw.",
+        "profileImportStarted": "Winkelprofiel verzonden. ShoppingRoute zal het toepassen.",
+        "invalidBackup": "Het geselecteerde bestand is geen geldige JSON-back-up.",
+        "invalidProfile": "Het geselecteerde bestand is geen geldig ShoppingRoute-winkelprofiel.",
+        "noInstance": "De ShoppingRoute-instantie kon niet worden bepaald.",
+        "connectionError": "Verbinding met ioBroker is mislukt.",
+        "exportError": "De back-up kon niet worden gemaakt.",
+        "profileError": "De winkelprofielen konden niet worden geladen.",
+        "title": "ShoppingRoute – Back-up / Delen",
+        "genericMarket": "Winkel"
+    },
+    "pt": {
+        "configTitle": "Configuração completa",
+        "configText": "Transfira todas as definições do ShoppingRoute como ficheiro JSON ou restaure-as a partir de uma cópia de segurança.",
+        "downloadConfig": "↓ Transferir cópia de segurança",
+        "uploadConfig": "↑ Restaurar cópia de segurança",
+        "marketTitle": "Partilhar perfil de loja",
+        "marketText": "Transfira uma loja com o respetivo percurso ou importe um perfil de loja a partir de um ficheiro JSON.",
+        "downloadMarket": "↓ Transferir perfil de loja",
+        "uploadMarket": "↑ Importar perfil de loja",
+        "loading": "A carregar perfis de loja …",
+        "noMarkets": "Não existem perfis de loja disponíveis",
+        "backupDownloaded": "Cópia de segurança transferida.",
+        "profileDownloaded": "Perfil de loja transferido.",
+        "configImportStarted": "Cópia de segurança enviada. O ShoppingRoute aplicará a configuração e reiniciará.",
+        "profileImportStarted": "Perfil de loja enviado. O ShoppingRoute irá aplicá-lo.",
+        "invalidBackup": "O ficheiro selecionado não é uma cópia de segurança JSON válida.",
+        "invalidProfile": "O ficheiro selecionado não é um perfil de loja ShoppingRoute válido.",
+        "noInstance": "Não foi possível determinar a instância do ShoppingRoute.",
+        "connectionError": "Não foi possível ligar ao ioBroker.",
+        "exportError": "Não foi possível criar a cópia de segurança.",
+        "profileError": "Não foi possível carregar os perfis de loja.",
+        "title": "ShoppingRoute – Cópia de segurança / Partilha",
+        "genericMarket": "Loja"
+    },
+    "pl": {
+        "configTitle": "Pełna konfiguracja",
+        "configText": "Pobierz wszystkie ustawienia ShoppingRoute jako plik JSON lub przywróć je z kopii zapasowej.",
+        "downloadConfig": "↓ Pobierz kopię zapasową",
+        "uploadConfig": "↑ Przywróć kopię zapasową",
+        "marketTitle": "Udostępnij profil sklepu",
+        "marketText": "Pobierz sklep wraz z trasą zakupów lub zaimportuj profil sklepu z pliku JSON.",
+        "downloadMarket": "↓ Pobierz profil sklepu",
+        "uploadMarket": "↑ Importuj profil sklepu",
+        "loading": "Ładowanie profili sklepów …",
+        "noMarkets": "Brak dostępnych profili sklepów",
+        "backupDownloaded": "Pobrano kopię zapasową.",
+        "profileDownloaded": "Pobrano profil sklepu.",
+        "configImportStarted": "Przesłano kopię zapasową. ShoppingRoute zastosuje konfigurację i uruchomi się ponownie.",
+        "profileImportStarted": "Przesłano profil sklepu. ShoppingRoute go zastosuje.",
+        "invalidBackup": "Wybrany plik nie jest prawidłową kopią zapasową JSON.",
+        "invalidProfile": "Wybrany plik nie jest prawidłowym profilem sklepu ShoppingRoute.",
+        "noInstance": "Nie udało się ustalić instancji ShoppingRoute.",
+        "connectionError": "Nie udało się połączyć z ioBroker.",
+        "exportError": "Nie udało się utworzyć kopii zapasowej.",
+        "profileError": "Nie udało się załadować profili sklepów.",
+        "title": "ShoppingRoute – Kopia zapasowa / Udostępnianie",
+        "genericMarket": "Sklep"
+    },
+    "ru": {
+        "configTitle": "Полная конфигурация",
+        "configText": "Скачайте все настройки ShoppingRoute в виде файла JSON или восстановите их из резервной копии.",
+        "downloadConfig": "↓ Скачать резервную копию",
+        "uploadConfig": "↑ Восстановить резервную копию",
+        "marketTitle": "Поделиться профилем магазина",
+        "marketText": "Скачайте профиль магазина с маршрутом или импортируйте профиль из файла JSON.",
+        "downloadMarket": "↓ Скачать профиль магазина",
+        "uploadMarket": "↑ Импортировать профиль магазина",
+        "loading": "Загрузка профилей магазинов …",
+        "noMarkets": "Нет доступных профилей магазинов",
+        "backupDownloaded": "Резервная копия скачана.",
+        "profileDownloaded": "Профиль магазина скачан.",
+        "configImportStarted": "Резервная копия передана. ShoppingRoute применит конфигурацию и перезапустится.",
+        "profileImportStarted": "Профиль магазина передан. ShoppingRoute применит его.",
+        "invalidBackup": "Выбранный файл не является корректной резервной копией JSON.",
+        "invalidProfile": "Выбранный файл не является корректным профилем магазина ShoppingRoute.",
+        "noInstance": "Не удалось определить экземпляр ShoppingRoute.",
+        "connectionError": "Не удалось подключиться к ioBroker.",
+        "exportError": "Не удалось создать резервную копию.",
+        "profileError": "Не удалось загрузить профили магазинов.",
+        "title": "ShoppingRoute – Резервная копия / Обмен",
+        "genericMarket": "Магазин"
+    },
+    "uk": {
+        "configTitle": "Повна конфігурація",
+        "configText": "Завантажте всі налаштування ShoppingRoute у файлі JSON або відновіть їх із резервної копії.",
+        "downloadConfig": "↓ Завантажити резервну копію",
+        "uploadConfig": "↑ Відновити резервну копію",
+        "marketTitle": "Поділитися профілем магазину",
+        "marketText": "Завантажте профіль магазину з маршрутом або імпортуйте профіль із файлу JSON.",
+        "downloadMarket": "↓ Завантажити профіль магазину",
+        "uploadMarket": "↑ Імпортувати профіль магазину",
+        "loading": "Завантаження профілів магазинів …",
+        "noMarkets": "Немає доступних профілів магазинів",
+        "backupDownloaded": "Резервну копію завантажено.",
+        "profileDownloaded": "Профіль магазину завантажено.",
+        "configImportStarted": "Резервну копію передано. ShoppingRoute застосує конфігурацію та перезапуститься.",
+        "profileImportStarted": "Профіль магазину передано. ShoppingRoute застосує його.",
+        "invalidBackup": "Вибраний файл не є коректною резервною копією JSON.",
+        "invalidProfile": "Вибраний файл не є коректним профілем магазину ShoppingRoute.",
+        "noInstance": "Не вдалося визначити екземпляр ShoppingRoute.",
+        "connectionError": "Не вдалося підключитися до ioBroker.",
+        "exportError": "Не вдалося створити резервну копію.",
+        "profileError": "Не вдалося завантажити профілі магазинів.",
+        "title": "ShoppingRoute – Резервна копія / Обмін",
+        "genericMarket": "Магазин"
+    },
+    "zh-cn": {
+        "configTitle": "完整配置",
+        "configText": "将所有 ShoppingRoute 设置下载为 JSON 文件，或从备份文件恢复。",
+        "downloadConfig": "↓ 下载备份",
+        "uploadConfig": "↑ 恢复备份",
+        "marketTitle": "分享商店配置",
+        "marketText": "下载包含购物路线的商店配置，或从 JSON 文件导入商店配置。",
+        "downloadMarket": "↓ 下载商店配置",
+        "uploadMarket": "↑ 导入商店配置",
+        "loading": "正在加载商店配置 …",
+        "noMarkets": "没有可用的商店配置",
+        "backupDownloaded": "备份已下载。",
+        "profileDownloaded": "商店配置已下载。",
+        "configImportStarted": "备份已提交。ShoppingRoute 将应用配置并重新启动。",
+        "profileImportStarted": "商店配置已提交，ShoppingRoute 将应用该配置。",
+        "invalidBackup": "所选文件不是有效的 JSON 备份。",
+        "invalidProfile": "所选文件不是有效的 ShoppingRoute 商店配置。",
+        "noInstance": "无法确定 ShoppingRoute 实例。",
+        "connectionError": "无法连接到 ioBroker。",
+        "exportError": "无法创建备份。",
+        "profileError": "无法加载商店配置。",
+        "title": "ShoppingRoute – 备份 / 分享",
+        "genericMarket": "商店"
+    }
+};
+
+    function resolveLanguage(value) {
+        const locale = String(value || '').trim().toLowerCase().replace(/_/g, '-');
+        if (Object.prototype.hasOwnProperty.call(translations, locale)) return locale;
+        const base = locale.split('-')[0];
+        if (base === 'zh') return 'zh-cn';
+        return Object.prototype.hasOwnProperty.call(translations, base) ? base : 'en';
+    }
+
+    window.ShoppingRouteBackupI18n = { translations, resolveLanguage };
+})();