iobroker.shoppingroute 0.1.0-beta.3

package/BETA_LICENSE.md

@@ -0,0 +1,11 @@
+# ShoppingRoute – Closed Beta Terms
+
+Copyright © 2026 RaviniZib. All rights reserved.
+
+This beta may only be installed and privately tested by persons expressly invited by the copyright holder. Testers may provide feedback, bug reports and diagnostics to the developer.
+
+Without prior written permission, redistribution, publication, mirroring, commercial use, incorporation into another adapter/application/service, and distribution of derivative works are prohibited. Copyright, license and attribution notices must not be removed or altered.
+
+Mandatory statutory rights remain unaffected. This beta is provided without warranty and is used at the tester's own risk.
+
+Earlier ShoppingRoute versions that were separately distributed under another license remain governed by the license applicable to those versions.

package/BETA_LICENSE_DE.md

@@ -0,0 +1,17 @@
+# ShoppingRoute – Bedingungen für die geschlossene Beta
+
+Copyright © 2026 RaviniZib. Alle Rechte vorbehalten.
+
+Diese Beta-Version darf ausschließlich von Personen installiert und privat getestet werden, die vom Rechteinhaber ausdrücklich als Betatester eingeladen wurden. Feedback, Fehlerberichte und Diagnoseinformationen dürfen an den Entwickler übermittelt werden.
+
+Ohne vorherige schriftliche Genehmigung ist insbesondere nicht gestattet:
+
+- das Beta-Paket oder Teile davon weiterzugeben, öffentlich bereitzustellen, zu spiegeln, zu verkaufen oder anderweitig Dritten zugänglich zu machen;
+- den Code oder wesentliche Teile der Implementierung in andere Adapter, Programme, Dienste oder kommerzielle Produkte zu übernehmen;
+- abgeleitete Versionen zu veröffentlichen oder weiterzugeben;
+- Copyright-, Lizenz- oder Herkunftshinweise zu entfernen oder zu verändern;
+- die Beta kommerziell zu nutzen.
+
+Gesetzlich zwingende Rechte bleiben unberührt. Die Beta wird ohne Gewährleistung bereitgestellt und auf eigenes Risiko verwendet.
+
+Hinweis: Frühere ShoppingRoute-Versionen, die bereits unter einer anderen Lizenz veröffentlicht wurden, bleiben für diese jeweilige Version unter der damals geltenden Lizenz. Diese Bedingungen gelten für die unter dieser geschlossenen Beta-Lizenz verteilten Versionen.

package/BETA_TESTING.md

@@ -0,0 +1,31 @@
+# Beta testing ioBroker.shoppingroute 0.1.0-beta.3
+
+This beta is intended for a small closed group of testers on different ioBroker/Alexa2 systems.
+
+## Safety
+
+- Dry-Run is enabled by default on new installations.
+- The adapter still never uses `#New`, `#delete` or `completed`.
+- Real sorting writes are blocked when Alexa2/alexa-remote2 write compatibility cannot be confirmed safely.
+- The Alexa app must sort the shopping list by **Oldest to newest**.
+
+## Recommended flow
+
+1. Install the adapter and create an instance.
+2. Verify the Alexa2 instance and list name.
+3. Keep Dry-Run enabled.
+4. Add a few test items through Alexa or the Alexa app.
+5. Inspect `shoppingroute.0.info.lastPlan`.
+6. Inspect `shoppingroute.0.info.compatibility`.
+7. If `info.writeCapability` is `unknown`, set `shoppingroute.0.control.compatibilityTest` to `true` once while at least one active list item exists.
+8. Only when `info.writeCapability` is `source-ok` or `live-ok`, disable Dry-Run for a small real sorting test.
+9. Verify that adding and normally checking off items in the Alexa app still works.
+
+The live test writes the **same visible `value` text** of one existing active item once and waits up to 10 seconds for Alexa2 to acknowledge it. It does not create, delete, complete or visibly rename an item.
+
+For feedback include `info.compatibility`, `info.lastError`, `info.lastPlan` when relevant, and the related ioBroker log lines. Never include tokens or passwords.
+
+
+## API/traffic diagnostics
+
+During testing also monitor `shoppingroute.0.info.traffic`, especially `localChecks`, `sortRuns` and `alexaWrites`. This shows how many local checks and actual Alexa writes a typical household causes. Counters reset daily.

package/BETA_TESTING_DE.md

@@ -0,0 +1,53 @@
+# Beta-Test ioBroker.shoppingroute 0.1.0-beta.3
+
+Diese Beta ist für eine kleine geschlossene Testgruppe gedacht. Sie soll auf unterschiedlichen ioBroker-/Alexa2-Systemen prüfen, ob Einlesen, Erkennung, Sortierplanung und Alexa-`value`-Updates zuverlässig funktionieren.
+
+## Sicherheitsregeln
+
+- **Dry-Run ist bei Neuinstallationen standardmäßig EIN.**
+- Der Adapter verwendet weiterhin niemals `#New`, `#delete` oder `completed`.
+- Echte Sortier-Schreibzugriffe werden in der Beta zusätzlich blockiert, wenn die Alexa2/alexa-remote2-Schreibkompatibilität nicht sicher bestätigt werden konnte.
+- Die Alexa-App muss für die betreffende Einkaufsliste auf **Älteste bis neueste** gestellt sein.
+
+## Empfohlener Testablauf
+
+1. Adapter installieren und Instanz anlegen.
+2. Alexa2-Instanz und Listenname prüfen.
+3. Dry-Run eingeschaltet lassen.
+4. Einige Testartikel über Alexa oder die Alexa-App hinzufügen.
+5. `shoppingroute.0.info.lastPlan` kontrollieren.
+6. `shoppingroute.0.info.compatibility` kontrollieren.
+7. Wenn `info.writeCapability` den Wert `unknown` hat, bei mindestens einem aktiven Listeneintrag `shoppingroute.0.control.compatibilityTest` einmal auf `true` setzen.
+8. Erst wenn `info.writeCapability` `source-ok` oder `live-ok` zeigt, Dry-Run für einen kleinen echten Sortiertest ausschalten.
+9. Zunächst mit wenigen Einträgen testen und prüfen, ob Hinzufügen und normales Abhaken in der Alexa-App weiter funktionieren.
+
+## Kompatibilitätstest
+
+Der Live-Test schreibt **denselben sichtbaren `value`-Text** eines vorhandenen aktiven Eintrags erneut. Er legt keinen Eintrag an, löscht keinen, hakt keinen ab und benennt sichtbar nichts um. Der Test wartet bis zu 10 Sekunden auf die Bestätigung von Alexa2.
+
+Mögliche Werte von `info.writeCapability`:
+
+- `source-ok` – die bekannte fehlerhafte `version`-Query wurde nicht gefunden und die korrigierte Schreibweise ist vorhanden; echte Sortier-Schreibzugriffe sind freigegeben.
+- `live-ok` – der Live-Kompatibilitätstest wurde bestätigt; echte Sortier-Schreibzugriffe sind freigegeben.
+- `known-bug` – die bekannte fehlerhafte `alexa-remote2`-Query wurde erkannt; echte Sortier-Schreibzugriffe sind blockiert.
+- `live-failed` – der Live-Test wurde nicht bestätigt; echte Sortier-Schreibzugriffe sind blockiert.
+- `unknown` – die installierte Implementierung konnte nicht eindeutig erkannt werden; echte Sortier-Schreibzugriffe bleiben blockiert, bis der Live-Test erfolgreich war.
+
+## Feedback
+
+Für einen Fehlerbericht bitte mindestens mitsenden:
+
+- Inhalt von `shoppingroute.0.info.compatibility`
+- Inhalt von `shoppingroute.0.info.lastError`
+- Inhalt von `shoppingroute.0.info.lastPlan`, wenn die Reihenfolge falsch ist
+- relevante ioBroker-Logzeilen
+- welche Alexa2-Instanz und welche Einkaufsliste verwendet wird
+- ob die Alexa-App auf **Älteste bis neueste** steht
+- kurze Beschreibung der erwarteten und tatsächlichen Reihenfolge
+
+Tokens, Passwörter oder andere Zugangsdaten dürfen niemals in einem Fehlerbericht stehen.
+
+
+## API-/Traffic-Diagnose
+
+Während des Tests bitte auch `shoppingroute.0.info.traffic` beobachten. Entscheidend sind insbesondere `localChecks`, `sortRuns` und `alexaWrites`. Damit lässt sich beurteilen, wie viele lokale Prüfungen und tatsächliche Alexa-Schreibzugriffe ein typischer Haushalt verursacht. Die Zähler werden täglich zurückgesetzt.

package/LICENSE

@@ -0,0 +1,17 @@
+ShoppingRoute Closed Beta License 1.0
+Copyright (c) 2026 RaviniZib. All rights reserved.
+
+Permission is granted only to persons expressly invited by the copyright holder to install and use this beta version for private testing and to provide feedback.
+
+Without prior written permission from the copyright holder, you may not:
+- redistribute, publish, mirror, sell, sublicense or otherwise make the software or beta package available to third parties;
+- use the software or any substantial part of it in another adapter, application, service or commercial product;
+- create or distribute derivative works based on this beta version;
+- remove or alter copyright, license or attribution notices;
+- use the software for commercial purposes.
+
+Reverse engineering solely for the purpose of reproducing, extracting or reusing the implementation in another product is not permitted to the extent allowed by applicable law. Mandatory statutory rights remain unaffected.
+
+THE SOFTWARE IS A BETA VERSION AND IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. USE IS AT YOUR OWN RISK.
+
+This license applies to ShoppingRoute versions distributed under this license. Earlier versions that were separately distributed under another license remain governed by the license applicable to those versions.

package/README.md

@@ -0,0 +1,86 @@
+# ioBroker.shoppingroute
+
+<p align="center">
+  <img src="admin/shoppingroute.png" width="190" alt="ShoppingRoute logo">
+</p>
+
+**Development status: 0.1.0-beta.3 – closed beta**
+
+`ioBroker.shoppingroute` sorts existing Alexa shopping-list entries by **store** and by the **configured walking route inside each store**, while keeping the original Alexa app as the only shopping app.
+
+## Core concept
+
+The Alexa app must be configured to sort the shopping list by **Oldest to newest**.
+
+The adapter reads active Alexa list items, sorts the existing item IDs by `createdDateTime`, independently sorts the visible product texts by **market → category route → product**, and redistributes only the `value` texts across the existing IDs.
+
+### Safety invariant
+
+This adapter never uses:
+
+- `#New`
+- `#delete`
+- `completed`
+
+It therefore does not create, delete or complete Alexa list entries.
+
+## Current beta features
+
+- configurable Alexa2 instance and list name
+- Dry-Run enabled by default
+- unlimited market/main-category configuration
+- market aliases, e.g. `Aldi,Aldi Nord`
+- separate category walking route for every market
+- central product-group catalogue; product and route assignments use dynamic drop-downs
+- product catalogue with aliases, category and optional default market
+- optional priority market for all products without an explicit or product-specific default market
+- deterministic precedence: explicit market → product default → priority market → fallback market
+- explicit phrases such as `Bananen von Aldi` / `Bananen bei Aldi`
+- quantity-aware recognition while keeping the visible Alexa text unchanged
+- heuristic category guess for unknown products
+- automatic learning of unknown products into the product catalogue, also while Dry-Run is active
+- priority market is not frozen into automatically learned product defaults
+- ambiguous unknown `von/bei <name>` suffixes are intentionally left for manual review
+- safe abort/recalculate when active IDs change while sorting
+- diagnostic states and complete sorting plan as JSON
+
+German documentation: [README_DE.md](README_DE.md)
+
+
+## Beta safety check in 0.1.0-beta.1
+
+The beta inspects the installed Alexa2/alexa-remote2 update path for the known malformed `?version =...` query. Real sorting writes are allowed only when `info.writeCapability` is `source-ok` or `live-ok`. They are blocked for `known-bug`, `live-failed` and `unknown`; Dry-Run remains available.
+
+If the status is `unknown`, run `shoppingroute.0.control.compatibilityTest` once while at least one active list item exists. The test writes the same visible `value` again and waits for Alexa2 to acknowledge it. It does not create, delete, complete or visibly rename an item. See [BETA_TESTING.md](BETA_TESTING.md).
+
+## Important Alexa2 compatibility note
+
+During development in August 2026, the tested `alexa-remote2` version contained a malformed version query in `updateListItem` (`?version =...`). Public release of this adapter should require an upstream-fixed Alexa2/alexa-remote2 version. End users must not be required to patch `node_modules` manually.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Repository target: `https://github.com/RaviniZib/ioBroker.shoppingroute`
+
+## License
+
+Closed Beta License 1.0 © 2026 RaviniZib – see LICENSE
+
+
+### Admin UI since 0.0.4
+
+Fallback market and Priority market are dynamic drop-downs built from active markets. Product default market and route market use the same market drop-downs. Dynamic market and product-group options are alphabetically sorted. The Product, Product group and Default market columns in the product catalogue are sortable from their headers; equal groups retain alphabetical product order.
+
+
+## API/traffic diagnostics
+
+ShoppingRoute is event-driven on the local ioBroker Alexa list state and does not add its own cloud polling. Closed-beta diagnostics count local list checks, planned changes, real sorting runs and actual Alexa `value` writes. Daily counters are exposed under `shoppingroute.0.info.*Today`, with the combined record in `shoppingroute.0.info.traffic`. These are operation counters, not byte-volume measurements.
+
+## Closed tester package
+
+`npm run beta:package` creates a separate tester package without TypeScript sources, tests, GitHub workflow files or source maps. Runtime JavaScript is additionally obfuscated. Testers therefore do not need access to the private development repository.

package/README_DE.md

@@ -0,0 +1,243 @@
+# ioBroker.shoppingroute
+
+<p align="center">
+  <img src="admin/shoppingroute.png" width="190" alt="ShoppingRoute logo">
+</p>
+
+**Entwicklungsstand: 0.1.0-beta.3 – geschlossene Beta**
+
+`ioBroker.shoppingroute` sortiert eine vorhandene Alexa-Einkaufsliste nach **Einkaufsmarkt** und dem **individuellen Laufweg durch den jeweiligen Markt**. Die originale Alexa-App bleibt die einzige App für den Einkauf und die Artikel werden dort weiterhin ganz normal abgehakt.
+
+## Grundidee
+
+Alexa vergibt für jeden Listeneintrag eine ID und einen Erstellungszeitpunkt. Wenn die Alexa-App auf **„Älteste bis neueste“** eingestellt ist, können diese vorhandenen IDs als feste Listenplätze verwendet werden.
+
+Der Adapter:
+
+1. liest ausschließlich die **aktiven** Einträge aus `alexa2.x.Lists.<LISTE>.json`,
+2. sortiert die vorhandenen IDs nach `createdDateTime` von alt nach neu,
+3. analysiert unabhängig davon die Artikelnamen,
+4. sortiert die Artikel nach **Markt → Laufweg/Kategorie → Artikelname**,
+5. schreibt ausschließlich die sichtbaren `value`-Texte auf die bereits vorhandenen IDs zurück.
+
+### Harte Sicherheitsregel
+
+Der Adapter verwendet **niemals**:
+
+- `#New`
+- `#delete`
+- `completed`
+
+Er legt also selbst keine Alexa-Listeneinträge an, löscht keine und hakt keine ab.
+
+## Alexa-App vorbereiten
+
+In der Alexa-App für die Einkaufsliste einstellen:
+
+**Sortieren nach → Älteste bis neueste**
+
+Ohne diese Einstellung kann die App ihre eigene A–Z-Sortierung über die vom Adapter erzeugte Reihenfolge legen.
+
+## Beispiele
+
+### Markt explizit nennen
+
+Sprachbefehl sinngemäß:
+
+`Alexa, setze Bananen von Aldi auf die Einkaufsliste.`
+
+Der sichtbare Eintrag bleibt:
+
+`Bananen von Aldi`
+
+Intern erkennt der Adapter:
+
+- Artikel: `Bananen`
+- Markt: `ALDI`
+- Kategorie: `Obst/Gemüse`
+
+### Mengenangaben
+
+Auch folgende Einträge bleiben sichtbar unverändert:
+
+- `3 Bananen von Aldi`
+- `2 Packungen Eier von Penny`
+- `500 Gramm Hackfleisch von Lidl`
+
+Die Menge wird nur für die Artikelerkennung ausgeblendet, niemals aus dem Alexa-Text entfernt.
+
+### Prioritätsmarkt
+
+Optional kann ein **Prioritätsmarkt** festgelegt werden. Damit muss der bevorzugte Markt nicht bei jedem Artikel mitgesprochen werden.
+
+Beispiel mit `Prioritätsmarkt = LIDL`:
+
+- `Milch` → LIDL
+- `Bananen` → LIDL
+- `Cola von Rewe` → REWE
+- hat `Katzenfutter` im Artikelstamm den Standardmarkt ALDI → ALDI
+
+Die Reihenfolge der Marktentscheidung ist verbindlich:
+
+**ausdrücklich genannter Markt → Artikel-Standardmarkt → Prioritätsmarkt → Fallback-Markt**
+
+Der Prioritätsmarkt wird beim automatischen Lernen eines Artikels **nicht** als fester Standardmarkt gespeichert. Ein späterer Wechsel des Prioritätsmarkts wirkt dadurch auch auf bereits gelernte Artikel ohne eigenen Standardmarkt.
+
+## Konfiguration
+
+### Allgemein
+
+- Alexa2-Instanz, z. B. `alexa2.0`
+- Listenname, normalerweise `SHOP`
+- Dry-Run
+- unbekannte Artikel automatisch lernen
+- Wartezeit nach Listenänderungen
+- Pause zwischen Alexa-`value`-Updates
+- Fallback-Hauptkategorie/Markt
+- Prioritätsmarkt, z. B. `LIDL` (optional)
+
+### Märkte / Hauptkategorien
+
+Beliebig viele Märkte können angelegt und in eine Reihenfolge gebracht werden.
+
+Beispiel:
+
+1. ALDI
+2. PENNY
+3. LIDL
+4. REWE
+5. Ohne Markt
+
+Aliase ermöglichen z. B. `Aldi` und `Aldi Nord` für denselben Markt.
+
+### Produktgruppen
+
+Produktgruppen wie `Obst/Gemüse`, `TK-Produkte`, `Milchprodukte` oder `Nonfood` werden zentral in einem eigenen Reiter gepflegt. In **Artikel** und **Laufwege** werden Produktgruppen nicht mehr frei eingetippt, sondern aus dieser Liste per Pulldown ausgewählt. Nach Änderungen an den Produktgruppen die Konfiguration speichern, damit die Auswahllisten neu geladen werden.
+
+### Laufwege
+
+Jeder Markt bekommt eine eigene Kategorienreihenfolge.
+
+Beispiel ALDI:
+
+1. Obst/Gemüse
+2. Brot/Gebäck
+3. Fleisch/Fisch
+4. Wurst/Salate/Teigwaren
+5. Milchprodukte
+6. Konserven
+7. Getränke
+8. TK-Produkte
+9. Nonfood
+
+PENNY kann eine vollständig andere Reihenfolge besitzen.
+
+### Artikelstamm
+
+Pro Artikel können gepflegt werden:
+
+- Name
+- Aliase
+- Kategorie
+- Standardmarkt
+
+Ein ausdrücklich genannter Markt (`Bananen von Penny`) hat Vorrang vor dem Standardmarkt des Artikels.
+
+## Unbekannte Artikel und automatisches Lernen
+
+Nicht im Artikelstamm vorhandene Artikel werden nicht blockiert. Ab 0.0.2 können sie automatisch in den Artikelstamm übernommen werden. Dabei wird eine Kategorie heuristisch vorgeschlagen; ein globaler Prioritätsmarkt wird **nicht** als fester Artikel-Standardmarkt gespeichert.
+
+Dry-Run verhindert ausschließlich Alexa-Schreibzugriffe. Das Lernen neuer Artikel darf weiterhin stattfinden, damit sich der Artikelstamm gefahrlos aufbauen lässt.
+
+Nicht automatisch gelernte unbekannte Artikel werden nach
+
+`shoppingroute.0.info.unknownItems`
+
+geschrieben. Neu gelernte Artikel stehen zusätzlich unter
+
+`shoppingroute.0.info.lastLearnedItems`.
+
+Ein unbekannter Text mit einem nicht erkannten Suffix wie `35 Sushi von Ukuhama` wird aus Sicherheitsgründen nicht automatisch als Produkt `Sushi von Ukuhama` gelernt. `Ukuhama` könnte ein noch nicht angelegter Markt oder auch eine Marke sein. Solche Einträge übernehmen deshalb auch **nicht** den Prioritätsmarkt, sondern bleiben im Fallback-Markt und zur manuellen Klärung in `info.unknownItems`.
+
+## Verhalten während des Einkaufs
+
+Wenn während einer laufenden Umsortierung ein Artikel hinzugefügt oder abgehakt wird, erkennt der Adapter die geänderte Menge aktiver IDs, bricht den aktuellen Durchlauf ab und berechnet die Liste anschließend neu.
+
+Es werden außerdem nur Plätze beschrieben, deren Text sich tatsächlich ändern muss.
+
+## Datenpunkte
+
+- `info.connection`
+- `info.activeItems`
+- `info.lastSort`
+- `info.lastError`
+- `info.lastPlan`
+- `info.unknownItems`
+- `info.lastLearnedItems`
+- `info.writeCapability`
+- `info.compatibility`
+- `info.lastCompatibilityTest`
+- `control.enabled`
+- `control.sortNow`
+- `control.compatibilityTest`
+
+`info.lastPlan` ist besonders für den Dry-Run gedacht und zeigt vor dem echten Schreiben exakt, welcher Text auf welche vorhandene Alexa-ID geschrieben würde.
+
+## Dry-Run
+
+Neue Installationen starten standardmäßig mit **Dry-Run = EIN**.
+
+Damit wird die Sortierung vollständig berechnet und protokolliert, aber Alexa wird nicht verändert. Erst wenn das Ergebnis plausibel ist, sollte Dry-Run in der Adapterkonfiguration deaktiviert werden.
+
+
+## Beta-Sicherheitsprüfung ab 0.1.0-beta.1
+
+Vor echten Alexa-Schreibzugriffen prüft die Beta den installierten Alexa2/alexa-remote2-Pfad auf den bekannten `updateListItem`-Fehler. Das Ergebnis steht in `shoppingroute.0.info.writeCapability` und ausführlich in `shoppingroute.0.info.compatibility`.
+
+Bei `source-ok` oder `live-ok` sind echte Sortier-Schreibzugriffe freigegeben. Bei `known-bug`, `live-failed` oder `unknown` werden sie blockiert; Dry-Run funktioniert weiterhin. Ist der Status `unknown`, kann mit mindestens einem aktiven Listeneintrag `shoppingroute.0.control.compatibilityTest` einmal auf `true` gesetzt werden. Der Test schreibt ausschließlich denselben sichtbaren `value` erneut und verändert den sichtbaren Artikelnamen nicht.
+
+Eine Schritt-für-Schritt-Anleitung für Tester steht in [BETA_TESTING_DE.md](BETA_TESTING_DE.md).
+
+## Aktueller Alexa2-Hinweis
+
+Während der Entwicklung im August 2026 wurde in einer verwendeten `alexa-remote2`-Version ein Fehler beim Aktualisieren von Listeneinträgen gefunden. In `updateListItem` war die Versions-Query als
+
+`?version =${options.version}`
+
+statt
+
+`?version=${options.version}`
+
+gebildet. In der Testinstallation musste dieser Fehler korrigiert werden, bevor `value`/`completed`-Updates von Amazon akzeptiert wurden.
+
+**Für eine öffentliche Release-Version von shoppingroute ist ein upstream behobener Alexa2/alexa-remote2-Stand Voraussetzung.** Nutzer sollen später keine Dateien in `node_modules` manuell verändern müssen.
+
+## Entwicklungsinstallation
+
+Das Repository ist zunächst für Tests über GitHub vorgesehen. Nach dem Push auf GitHub kann es in ioBroker im Expertenmodus über die benutzerdefinierte GitHub-/URL-Installation installiert werden.
+
+Vor einem späteren offiziellen Release folgen mindestens:
+
+- Test auf mehreren ioBroker-Systemen
+- Prüfung der Admin-JSONConfig
+- Kompatibilitätstest mit aktuellen Alexa2-Versionen
+- npm-Veröffentlichung
+- Antrag für das ioBroker-Latest-Repository
+
+## Lizenz
+
+Closed Beta License 1.0 © 2026 RaviniZib – siehe LICENSE
+
+
+### Admin-Oberfläche ab 0.0.4
+
+Fallback-Markt und Prioritätsmarkt werden als Pulldown aus den aktiven Märkten angeboten. Auch Standardmarkt im Artikelstamm und Markt im Laufweg sind Pulldowns. Dynamische Markt- und Produktgruppenlisten werden alphabetisch sortiert. Im Artikelstamm können die Spalten Artikel, Produktgruppe und Standardmarkt über den Spaltenkopf sortiert werden; innerhalb gleicher Gruppen bleibt die alphabetische Artikelreihenfolge erhalten.
+
+
+## API-/Traffic-Diagnose
+
+ShoppingRoute arbeitet ereignisgesteuert auf dem lokalen ioBroker-Datenpunkt der Alexa-Liste und führt kein eigenes Cloud-Polling durch. Für die geschlossene Beta zählt der Adapter deshalb getrennt lokale Listenprüfungen, geplante Änderungen, echte Sortierläufe und tatsächliche Alexa-`value`-Schreibzugriffe. Die Tageswerte stehen unter `shoppingroute.0.info.*Today`, die Gesamtübersicht unter `shoppingroute.0.info.traffic`. Die Werte sind Vorgangszähler und keine Messung des übertragenen Byte-Volumens.
+
+## Geschlossenes Testerpaket
+
+Für externe Betatester kann mit `npm run beta:package` ein separates Paket erzeugt werden. Das Entwicklungsprojekt selbst bleibt mit `private: true` gegen versehentliches Veröffentlichen geschützt; nur das erzeugte Tester-Tarball ist für eine bewusste Veröffentlichung mit dem npm `beta`-Tag freigegeben. Dieses enthält keine TypeScript-Quellen, keine Tests, keine GitHub-Workflow-Dateien und keine Source-Maps. Das zur Laufzeit benötigte JavaScript wird zusätzlich obfuskiert. Das private Entwicklungsrepository ist dafür nicht erforderlich.