chore: update build artifacts for v1.4.14

feat: immediate api refresh on flag, fix timestamp fallback (v1.4.14)
chore: update build artifacts for v1.4.13
2026-02-24 15:31:48 +01:00 · 2026-02-24 15:31:48 +01:00 · 2026-02-24 13:24:50 +01:00 · 2026-02-24 13:24:09 +01:00 · 2026-02-24 13:20:03 +01:00 · 2026-02-24 13:19:38 +01:00
19 changed files with 2568 additions and 142 deletions
--- a/.agent/rules/rules.md
+++ b/.agent/rules/rules.md
@@ -26,16 +26,15 @@ trigger: always_on
 - **Interaction**: Be proactive, concise, and helpful. Focus on code value.

 ## 4. Development Standards
-**Tech Stack:**
- **Container**: Docker-based application.
- **Config**: Configurable port.
-
 **Coding Style:**
 - **Typing**: Strict typing where applicable.
 - **Comments**: Concise, English.
 - **Frontend/UX**: 
    - Priority on Usability.
    - **MANDATORY**: Tooltips/Help texts for all interactions.
+- **Versioning**:
+    - version.txt has to be increased for any implemented features or fixed bugs)
+    - a change summary has to be documented in changelog.md 

 ## 5. Agentic Workflow & Artifacts
 **Core Philosophy**: Plan first, act second.
@@ -48,3 +47,10 @@ trigger: always_on
 ## 6. Workspace Scopes
 - **Browser**: Allowed for documentation and safe browsing. No automated logins without permission.
 - **Terminal**: No `rm -rf`. Run tests (`pytest` etc.) after logic changes.
+
+## 7. Requirements-Konsistenz 📋
+Alle umgesetzten Anforderungen müssen mit `REQUIREMENTS.md` übereinstimmen.
+1.  **Vor der Umsetzung prüfen**: Passt die neue Anforderung zu den bestehenden Requirements?
+2.  **Fehlende Requirements**: Wenn eine umzusetzende Anforderung in `REQUIREMENTS.md` fehlt, muss dies im **Implementation Plan** explizit dokumentiert und freigegeben werden.
+3.  **Widersprüche**: Wenn eine neue Anforderung im Widerspruch zu bestehenden Requirements steht, muss dies im **Implementation Plan** als ⚠️ Warning hervorgehoben werden.
+4.  **Nach Freigabe**: Bei Genehmigung des Implementation Plans muss `REQUIREMENTS.md` entsprechend erweitert oder korrigiert werden (neue ID, Version, Beschreibung). Obsolet gewordene Requirements werden nicht aus `REQUIREMENTS.md` gelöscht sondern nur als durchgestrichen markiert und ein Kommentar mit dem Grund hinzugefügt.
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Kantine Wrapper Bookmarklet (v1.2.0)
+# Kantine Wrapper Bookmarklet 

 Ein intelligentes Bookmarklet für die Mitarbeiter-Kantine der Bessa App. Dieses Skript erweitert die Standardansicht um eine **Wochenübersicht**, Kostenkontrolle und verbesserte Usability.

--- a/REQUIREMENTS.md
+++ b/REQUIREMENTS.md
@@ -2,55 +2,95 @@

 ## 1. Einleitung
 ### 1.1 Zweck des Systems
-Das System dient als Wrapper und Erweiterung für das Bessa Web-Shop-Portal der Knapp-Kantine (https://web.bessa.app/knapp-kantine). Es ermöglicht den Benutzern, Menüpläne einzusehen, Buchungen automatisiert vorzunehmen und Menüdaten persistent für den öffentlichen Zugriff bereitzustellen, ohne dass jeder Betrachter eigene Zugangsdaten benötigt.
+Das System dient als Erweiterung für das Bessa Web-Shop-Portal der Knapp-Kantine (https://web.bessa.app/knapp-kantine). Es verbessert die Benutzererfahrung durch eine übersichtliche Wochenansicht, vereinfachte Bestellvorgänge, Kostentransparenz und proaktive Benachrichtigungen.

 ### 1.2 High-Level-Scope
-Das System umfasst einen automatisierten Scraper, eine API zur Datenbereitstellung, einen persistenten Dateispeicher für erfasste Menüs und ein Frontend-Dashboard zur Visualisierung der Kantinen-Wochenpläne.
+Das System umfasst die Darstellung von Menüplänen in einer Wochenübersicht, die Verwaltung von Bestellungen und Stornierungen, ein Benachrichtigungssystem für Verfügbarkeitsänderungen, personalisierte Menü-Highlights sowie ein automatisches Update-Management.

 ## 2. Funktionale Anforderungen

-| ID | Anforderung (Satzschablone nach Chris Rupp) | Priorität |
-|:---|:---|:---|
-| **Auth & Sessions** | | |
-| FR-001 | Das System muss dem Benutzer die Möglichkeit bieten, sich mit Mitarbeiternummer und Passwort am Bessa-Backend anzumelden. | Hoch |
-| FR-002 | Sobald ein Benutzer erfolgreich angemeldet ist, muss das System eine Session-ID erzeugen und die resultierenden Cookies verschlüsselt für 2 Stunden vorhalten. | Hoch |
-| FR-003 | Das System muss die Zugangsdaten (Mitarbeiternummer/Passwort) unmittelbar nach der Verwendung durch den Scraper verwerfen und darf diese nicht dauerhaft speichern. | Hoch |
-| **Scraper & Datenextraktion** | | |
-| FR-004 | Das System muss in der Lage sein, den wöchentlichen Menüplan (Montag bis Freitag) automatisiert von der Bessa-Webseite zu extrahieren. | Hoch |
-| FR-005 | Wenn ein Tag bereits eine Buchung enthält, muss das System den Navigationspfad so anpassen, dass dennoch alle verfügbaren Menüoptionen (M1F, M2F, etc.) extrahiert werden können. | Mittel |
-| FR-006 | Das System muss für jedes extrahierte Gericht den Namen, die Beschreibung, den Preis und den Status (verfügbar/nicht verfügbar/ bestellt) erfassen. | Hoch |
-| **Datenhaltung & Zugriff** | | |
-| FR-007 | Das System muss erfolgreich gescrapte Menüpläne in einer persistenten JSON-Datei (`data/menus.json`) speichern. | Hoch |
-| FR-008 | Das System muss unauthentifizierten Benutzern den Zugriff auf bereits im Speicher befindliche Menüdaten ermöglichen (Public Access). | Mittel |
-| FR-009 | Falls keine Daten im persistenten Speicher vorhanden sind, muss das System einen nicht authentifizierten Benutzer die Möglichkeit bieten sich anzumelden, um den Speicher zu initialisieren. | Hoch |
-| **Dashboard & UI** | | |
-| FR-010 | Das System muss dem Benutzer eine intuitive Wochenansicht des Menüplans im Browser darstellen. | Mittel |
-| FR-011 | Wenn ein Scraper-Vorgang aktiv ist, muss das System den Status (Fortschritt, aktuelle Aktion) in Echtzeit visualisieren. | Niedrig |
-| **Buchungsfunktion** | | |
-| FR-012 | Wenn der Benutzer authentifiziert ist, soll das System eine Bestellung für ein  Menü ermöglichen. | Mittel |
-| FR-013 | Wenn der Benutzer authentifiziert ist, soll das System ein bereits bestelltes Menü zu stornieren. | Mittel |
-| **Menu Flagging & Notifications** | | |
-| FR-014 | Das System muss authentifizierten Benutzern ermöglichen, nicht bestellbare Menüs (deren Cutoff noch nicht erreicht ist) zu markieren ("flaggen"). | Mittel |
-| FR-015 | Das System soll die Statusprüfung für geflaggte Menüs auf verbundene Clients verteilen (Distributed Polling), um die Last zu minimieren. Der Server orchestriert, welcher Client wann welche Menüs prüft. | Mittel |
-| FR-016 | Bei Statusänderung auf "verfügbar" muss das System den Benutzer benachrichtigen (Systembenachrichtigung). | Mittel |
-| FR-017 | Geflaggte und ausverkaufte Menüs müssen im UI mit einem gelben Glow hervorgehoben werden. | Mittel |
-| FR-018 | Geflaggte und verfügbare Menüs müssen im UI mit einem grünen Glow hervorgehoben werden. | Mittel |
-| FR-019 | Wenn die Bestell-Cutoff-Zeit erreicht ist, muss das System das Flag automatisch entfernen. | Mittel |
+| ID | Anforderung (Satzschablone nach Chris Rupp) | Priorität | Seit |
+|:---|:---|:---|:---|
+| **Authentifizierung & Zugang** | | | |
+| FR-001 | Das System muss dem Benutzer die Möglichkeit bieten, sich mit Mitarbeiternummer und Passwort anzumelden. | Hoch | v1.0.1 |
+| FR-002 | Das System muss eine bestehende Bessa-Session erkennen und automatisch wiederverwenden, um eine erneute Anmeldung zu vermeiden. | Hoch | v1.0.1 |
+| FR-003 | Das System darf keine Zugangsdaten dauerhaft speichern. Die Authentifizierung muss sitzungsbasiert sein. | Hoch | v1.0.1 |
+| FR-004 | Dem Benutzer muss angezeigt werden, ob und als wer er angemeldet ist (Vorname, Name oder ID). | Mittel | v1.0.1 |
+| FR-005 | Nicht authentifizierte Benutzer müssen die Menüdaten einsehen können (eingeschränkter Lesezugriff). | Mittel | v1.0.1 |
+| FR-006 | Das System muss eine explizite Logout-Funktion bereitstellen, die alle sitzungsbezogenen Daten entfernt. | Mittel | v1.0.1 |
+| **Menüanzeige** | | | |
+| FR-010 | Das System muss dem Benutzer alle verfügbaren Tagesmenüs einer Woche gleichzeitig in einer Übersicht darstellen. | Hoch | v1.0.1 |
+| FR-011 | Das System muss dem Benutzer die Navigation zwischen der aktuellen und der kommenden Woche ermöglichen. | Mittel | v1.0.1 |
+| FR-012 | Für jedes Gericht müssen Name, Beschreibung, Preis und Verfügbarkeitsstatus angezeigt werden. | Hoch | v1.0.1 |
+| FR-013 | Bereits bestellte Menüs müssen visuell von nicht bestellten unterscheidbar sein (farbliche Markierung, Badge). | Mittel | v1.0.1 |
+| FR-014 | Die Tageskarten-Header müssen den Bestellstatus des Tages farblich signalisieren (bestellt / bestellbar / nicht bestellbar). | Niedrig | v1.0.1 |
+| FR-015 | Bestellte Menü-Codes (z.B. M1, M2) müssen als Badges im Tageskarten-Header angezeigt werden. | Niedrig | v1.0.1 |
+| FR-016 | Am heutigen Tag müssen bestellte Menüs an erster Stelle sortiert werden. | Niedrig | v1.0.1 |
+| FR-017 | Wenn keine Menüdaten für eine Woche vorliegen, muss ein aussagekräftiger Leertext angezeigt werden. | Niedrig | v1.0.1 |
+| **Daten-Aktualisierung** | | | |
+| FR-020 | Wenn Menüdaten geladen werden, muss der Fortschritt dem Benutzer in Echtzeit angezeigt werden (Fortschrittsbalken, Statustext). | Niedrig | v1.0.1 |
+| FR-021 | Das System muss bereits geladene Menüdaten zwischenspeichern, um bei erneutem Aufruf sofort eine Übersicht anzeigen zu können. | Mittel | v1.0.1 |
+| FR-022 | Das System muss dem Benutzer die Möglichkeit bieten, die Menüdaten manuell neu zu laden. | Niedrig | v1.0.1 |
+| FR-023 | Der Zeitpunkt der letzten Aktualisierung muss für den Benutzer sichtbar sein. | Niedrig | v1.0.1 |
+| FR-024 | Das System darf beim Start keinen automatischen API-Refresh durchführen, wenn der Cache frisch (< 1 Stunde) und Daten für die aktuelle Kalenderwoche vorhanden sind. | Mittel | v1.3.1 |
+| **Bestellfunktion** | | | |
+| FR-030 | Authentifizierte Benutzer müssen ein verfügbares Menü direkt aus der Übersicht bestellen können. | Hoch | v1.0.1 |
+| FR-031 | Authentifizierte Benutzer müssen eine bestehende Bestellung direkt aus der Übersicht stornieren können. | Hoch | v1.0.1 |
+| FR-032 | Nach Bestellschluss (Cutoff-Zeit) dürfen keine neuen Bestellungen oder Stornierungen für diesen Tag möglich sein. | Hoch | v1.0.1 |
+| FR-033 | Es muss möglich sein, dasselbe Menü mehrfach zu bestellen. Bei Mehrfachbestellungen muss die Anzahl angezeigt werden. | Niedrig | v1.0.1 |
+| **Kostentransparenz & Bestellhistorie** | | | |
+| FR-040 | Das System muss die Gesamtkosten aller Bestellungen einer Woche automatisch berechnen und anzeigen. | Mittel | v1.1.0 |
+| FR-041 | Das System muss dem Benutzer eine Bestellhistorie (gruppiert nach Monat und KW) mit Fortschrittsanzeige auf Abruf in einem Modal bereitstellen. Die Historie muss über ein lokales Delta-Caching verfügen, um Ladezeiten zu minimieren. | Mittel | v1.4.0 (Update v1.4.7) |
+| **Bestell-Countdown** | | | |
+| FR-050 | Das System muss vor Bestellschluss einen visuell hervorgehobenen Countdown anzeigen. | Mittel | v1.1.0 |
+| **Menü-Flagging & Benachrichtigungen** | | | |
+| FR-060 | Authentifizierte Benutzer müssen ausverkaufte Menüs zur Beobachtung markieren können ("flaggen"). | Mittel | v1.0.1 |
+| FR-061 | Das System muss geflaggte Menüs periodisch auf Verfügbarkeitsänderungen prüfen. | Mittel | v1.0.1 |
+| FR-062 | Bei Statusänderung eines geflaggten Menüs auf „verfügbar" muss der Benutzer benachrichtigt werden (In-App + Systembenachrichtigung). | Mittel | v1.0.1 |
+| FR-063 | Geflaggte Menüs müssen im UI visuell hervorgehoben werden (gelber Glow bei ausverkauft, grüner Glow bei verfügbar). | Mittel | v1.0.1 |
+| FR-064 | Wenn die Bestell-Cutoff-Zeit erreicht ist, muss das System ein Flag automatisch entfernen. | Mittel | v1.0.1 |
+| **Personalisierung: Smart Highlights** | | | |
+| FR-070 | Benutzer müssen Schlagwörter (Tags) definieren können, nach denen Menüs automatisch visuell hervorgehoben werden. | Mittel | v1.1.0 |
+| FR-071 | Die Hervorhebung muss anhand von Menüname und Beschreibung erfolgen (Substring-Matching, case-insensitive). | Niedrig | v1.1.0 |
+| FR-072 | Hervorgehobene Menüs müssen ein Tag-Badge mit dem matchenden Schlagwort anzeigen. | Niedrig | v1.2.4 |
+| FR-073 | Die Nächste-Woche-Navigation muss die Anzahl der dort gefundenen Highlights als Badge anzeigen. | Niedrig | v1.2.5 |
+| FR-080 | Das System muss einen hellen und einen dunklen Darstellungsmodus (Light/Dark Theme) unterstützen. | Niedrig | v1.0.1 |
+| FR-081 | Die Theme-Präferenz des Benutzers muss persistent gespeichert werden. | Niedrig | v1.0.1 |
+| FR-082 | Das System muss beim erstmaligen Laden die Betriebssystem-Präferenz für das Farbschema berücksichtigen. | Niedrig | v1.0.1 |
+| **Header UI & Navigation** | | | |
+| FR-090 | Die Hauptnavigation (Wochen-Toggles) muss linksbündig neben dem App-Titel positioniert sein. | Niedrig | v1.5.0 |
+| FR-091 | Ein dynamisches Alarm-Icon im Header muss den Überwachungsstatus geflaggter Menüs anzeigen (Gelb=Überwachung aktiv aber kein Menü verfügbar, Grün=Mindestens ein Menü verfügbar, Versteckt=keine Flags). Der Tooltip muss den Zeitpunkt der letzten Prüfung als relativen String (z.B. "vor 4 Min.") enthalten. | Mittel | v1.5.0 (Update v1.4.10) |
+| FR-092 | Sobald über den Daten-Refresh erstmals Menüdaten für die Nächste Woche geladen werden, muss der entsprechende Navigation-Button animiert und farblich (Gelb) hervorgehoben werden. Zusätzlich muss einmalig ein Hinweis eingeblendet werden. Bei Klick auf den Button muss die Hervorhebung erlöschen. | Mittel | v1.6.0 |
+| **Benutzer-Feedback** | | | |
+| FR-090 | Alle benutzerrelevanten Aktionen (Bestellung, Stornierung, Fehler) müssen durch nicht-blockierende Benachrichtigungen (Toasts) bestätigt werden. | Mittel | v1.0.1 |
+| FR-091 | Bei einem Verbindungsfehler muss ein Fehlerdialog mit Fallback-Link zur Originalseite angezeigt werden. | Mittel | v1.0.1 |
+| **Nächste-Woche-Badge** | | | |
+| FR-100 | Die Navigation zur nächsten Woche muss ein Badge anzeigen, das den Überblick über den Bestellstatus der kommenden Woche visualisiert (bestellt / bestellbar / gesamt). | Niedrig | v1.0.1 |
+| **Update-Management** | | | |
+| FR-110 | Das System muss periodisch prüfen, ob eine neuere Version verfügbar ist. | Niedrig | v1.0.3 |
+| FR-111 | Bei Verfügbarkeit einer neueren Version muss ein diskreter Indikator im Header angezeigt werden. | Niedrig | v1.0.3 |
+| FR-112 | Benutzer müssen eine Versionsliste mit Installationslinks einsehen können (Versionsmenü). | Niedrig | v1.3.0 |
+| FR-113 | Es muss möglich sein, zu einer älteren Version zurückzukehren (Downgrade). | Niedrig | v1.3.0 |
+| FR-114 | Ein Dev-Mode muss es ermöglichen, zwischen stabilen Releases und Entwicklungs-Tags umzuschalten. | Niedrig | v1.3.0 |
+| FR-115 | Das Versionsmenü muss Links zur Erstellung von Feature-Requests und Bug-Reports auf GitHub enthalten. | Niedrig | v1.4.4 |
+
 ## 3. Nicht-funktionale Anforderungen

 | Kategorie (ISO 25010) | ID | Anforderung | Zielwert/Metrik |
 |:---|:---|:---|:---|
-| **Performance** | NFR-001 | Antwortzeit der API für gecachte Daten | < 200 ms (95. Perzentil) |
-| **Performance** | NFR-007 | Polling-Effizienz & Token-Nutzung | Kein System-Token verfügbar. Polling muss über authentifizierte User-Clients erfolgen. Der Server muss die Anfragen so verteilen, dass redundante Abfragen vermieden werden. |
-| **Performance** | NFR-002 | Dauer eines vollständigen Scrape-Vorgangs (exkl. Navigation) | < 30 Sekunden pro Woche |
-| **Sicherheit** | NFR-003 | Speicherung von Zugangsdaten | 0 (keine dauerhafte Speicherung von Passwörtern) |
-| **Sicherheit** | NFR-004 | Session-Sicherheit | HttpOnly Cookies für die Kommunikation zwischen Frontend und Backend |
-| **Wartbarkeit** | NFR-005 | Testabdeckung der Scraper-Logik | Alle Kern-Selektoren müssen durch Debug-HTML-Dumps verifizierbar sein |
-| **Benutzbarkeit** | NFR-006 | Mobile Responsiveness | Dashboard muss auf Viewports ab 320px Breite fehlerfrei nutzbar sein |
+| **Performance** | NFR-001 | Die Darstellung bereits gecachter Daten muss ohne spürbare Verzögerung erfolgen. | < 200 ms (UI-Rendering) |
+| **Performance** | NFR-002 | Das Polling für geflaggte Menüs darf die reguläre Nutzung nicht beeinträchtigen. | Intervall ≥ 5 Minuten |
+| **Sicherheit** | NFR-003 | Es dürfen keine Zugangsdaten dauerhaft gespeichert werden. | 0 (keine persistente Speicherung von Passwörtern) |
+| **Sicherheit** | NFR-004 | Auth-Tokens müssen sitzungsbasiert gespeichert werden und bei Schließen des Browsers verfallen. | sessionStorage |
+| **Benutzbarkeit** | NFR-005 | Die Oberfläche muss auf mobilen Geräten fehlerfrei nutzbar sein. | Viewports ab 320px Breite |
+| **Benutzbarkeit** | NFR-006 | Alle interaktiven Elemente müssen Tooltips oder Hilfetexte bieten. | 100% Coverage |
+| **Benutzbarkeit** | NFR-007 | Die Benutzeroberfläche muss vollständig in deutscher Sprache sein. | Vollständige Lokalisierung |
+| **Wartbarkeit** | NFR-008 | Die Build-Artefakte müssen durch automatisierte Tests validiert werden. | Build-Tests + Logik-Tests |

 ## 4. Technische Randbedingungen
-*   **Architektur**: Node.js Backend mit Express (API + Static Serving) und Vanilla JS Frontend.
-*   **Engine**: Direkte API-Integration (Reverse Engineering der Bessa API) für maximale Performance und Zuverlässigkeit.
-*   **Datenspeicher**: Dateibasierter JSON-Store für persistente Daten + In-Memory Caching.
-*   **Schnittstellen**: REST API (`/api/bookings`, `/api/status`, `/api/order`).
-*   **Runtime**: Node.js Umgebung, Docker-ready.
+*   **Deployment**: Das System wird als Bookmarklet ausgeliefert, das auf der Bessa-Webseite ausgeführt wird.
+*   **Datenquelle**: Direkte Integration mit der Bessa REST-API (`api.bessa.app/v1`).
+*   **Datenhaltung**: Clientseitig via `localStorage` (Menü-Cache, Flags, Highlights, Theme) und `sessionStorage` (Auth-Token).
+*   **Build**: Bash-basiertes Build-Script, das Bookmarklet-URL, Standalone-HTML und Installer-Seite generiert.
+*   **Versionierung**: SemVer, verwaltet über GitHub Releases/Tags.
+*   **Tests**: Python-basierte Build-Tests (`python3`) + Node.js-basierte Logik-Tests.
--- a/pycache/test_build.cpython-312-pytest-9.0.2.pyc
+++ b/pycache/test_build.cpython-312-pytest-9.0.2.pyc
--- a/bessa_orders_debug.json
+++ b/bessa_orders_debug.json
@@ -0,0 +1 @@
+{"next":null,"previous":null,"results":[]}
--- a/build-bookmarklet.sh
+++ b/build-bookmarklet.sh
@@ -25,8 +25,9 @@ if [ ! -f "$CSS_FILE" ]; then echo "ERROR: $CSS_FILE not found"; exit 1; fi
 if [ ! -f "$JS_FILE" ]; then echo "ERROR: $JS_FILE not found"; exit 1; fi

 CSS_CONTENT=$(cat "$CSS_FILE")
+
 # Inject version into JS
-JS_CONTENT=$(cat "$JS_FILE" | sed "s/{{VERSION}}/$VERSION/g")
+JS_CONTENT=$(cat "$JS_FILE" | sed "s|{{VERSION}}|$VERSION|g")

 # === 1. Build standalone HTML (for local testing/dev) ===
 cat > "$DIST_DIR/kantine-standalone.html" << HTMLEOF
@@ -170,7 +171,7 @@ cat > "$DIST_DIR/install.html" << INSTALLEOF
    </div>

    <div style="text-align: center; margin-top: 40px; color: #5c6b7f; font-size: 0.8rem;">
-        <p>Powered by <strong>Kaufi-Kitchen</strong> 👨‍🍳</p>
+        <p>Powered by <strong>Kaufis-Kitchen</strong> 👨‍🍳</p>
    </div>


@@ -265,3 +266,5 @@ if [ $TEST_EXIT -ne 0 ]; then
    exit 1
 fi
 echo "✅ All build tests passed."
+
+
--- a/changelog.md
+++ b/changelog.md
@@ -1,3 +1,69 @@
+## v1.4.14
+- 🐛 **Bugfix**: Alarmglocke versteckt sich jetzt zuverlässig auch auf Endgeräten mit CSS Konflikten 
+- 🚀 **Feature**: Sofortige API-Aktualisierung (Refresh) bei Aktivierung eines Menüalarms
+- ⚡ **Optimierung**: "Unbekannt" im letzten Refresh-Zeitpunkt wird abgefangen und zeigt initial "gerade eben"
+
+## v1.4.13 (2026-02-24)
+- **Fix**: Die Farben der Glocke funktionieren nun verlässlich, da CSS-Variablen durch direkte Hex-Codes ersetzt wurden.
+
+## v1.4.12 (2026-02-24)
+- **Fix**: Das Glocken-Icon sollte nun endgültig versteckt bleiben, wenn keine Benachrichtigungen aktiv sind (CSS-Kollision mit `.hidden` behoben).
+
+## v1.4.11 (2026-02-24)
+- **Feature**: Das Versionsmenü prüft nun im Hintergrund direkt beim Öffnen nach neuen Versionen und aktualisiert die Liste automatisch, selbst wenn eine veraltete Liste noch im Cache liegt.
+
+## v1.4.10 (2026-02-24)
+- **Fix**: Die Farben der Benachrichtigungs-Glocke wurden korrigiert: Sie ist nun gelb, während man auf ein Menü wartet, und wird grün, sobald eines verfügbar ist.
+
+## v1.4.9 (2026-02-24)
+- **Fix**: Das Glocken-Icon für Benachrichtigungen wird nun direkt beim Start (wenn Daten aus dem lokalen Cache geladen werden) korrekt angezeigt.
+
+## v1.4.8 (2026-02-24)
+- **Fix**: Die Benachrichtigungs-Glocke wird nun korrekt in Gelb dargestellt, wenn beobachtete Menüs verfügbar sind.
+- **Tools**: Fehler in Testskript behoben, der den CI/CD Build verlangsamt hat.
+
+## v1.4.7 (2026-02-24)
+- **Performance**: Die Bestellhistorie nutzt nun einen inkrementellen Delta-Cache anstatt immer alle Seiten von der API herunterzuladen, was die Ladezeiten für Vielbesteller enorm reduziert.
+
+## v1.4.6 (2026-02-24)
+- **Fix**: Die Umrandung für bereits bestellte Menüs der vergangenen Tage ist nun ebenfalls einheitlich violett statt blau.
+
+## v1.4.5 (2026-02-24)
+- **Fix**: Doppelten Scrollbalken in der Versionen-Liste entfernt.
+
+## v1.4.4 (2026-02-24)
+- **Feature**: Das Versionsmenü enthält nun direkte Links zu GitHub, um Fehler zu melden oder neue Features vorzuschlagen.
+
+## v1.4.3 (2026-02-24)
+- **Fix**: Der Rahmen des "Heute Bestellt" Menüs ist nun konsequent violett (passend zum Glow-Effekt).
+
+## v1.4.2 (2026-02-23)
+- **Fix**: Das "Heute Bestellt" Menü leuchtet nun stimmig im Design-Violett statt Blau.
+- **Fix**: Abfangen des GitHub API Rate Limit (403) im Versionsdialog mit einer freundlicheren Fehlermeldung, da der User-Agent im Browser nicht manuell gesetzt werden darf.
+
+## v1.4.1 (2026-02-22)
+- **UX Verbesserungen**: Bestellhistorie gruppiert nach Jahren und Monaten mittels einklappbarem Akkordeon. Monatssummen integriert und Stati farblich abgehoben (Offen, Abgeschlossen, Storniert).
+
+## v1.4.0 (2026-02-22)
+- **Feature**: Bestellhistorie per Knopfdruck abrufbar. Übersichtliche Darstellung, gruppiert nach Monaten und Kalenderwochen, inklusive Stornos. 📜✨
+
+## v1.3.2 (2026-02-19)
+- **Fix**: Falsche Anzahl an Highlight-Menüs im "Nächste Woche"-Badge korrigiert (zählte alle Menüs statt nur Highlights). 🐛
+
+## v1.3.1 (2026-02-17)
+- **Feature**: Smart Cache – API-Refresh beim Start wird übersprungen wenn Daten für die aktuelle KW vorhanden und Cache < 1h alt ist. ⚡
+
+## v1.3.0 (2026-02-16)
+- **Feature**: GitHub Release Management 📦
+  - Version-Menü: Klick auf Versionsnummer zeigt alle verfügbaren Versionen
+  - Dev-Mode Toggle: Zwischen Releases (stabil) und Tags (dev) wechseln
+  - Downgrade-Support: Jede Version hat einen eigenen Installer-Link
+  - Update-Check nutzt jetzt die GitHub API statt `version.txt`
+  - GitHub PAT für höheres API-Rate-Limit (5000/h)
+  - SemVer-Check: Update-Icon nur bei wirklich neuerer Version
+
+## v1.2.9 (2026-02-16)
+
 ## v1.2.8 (2026-02-16)
 - **Debug**: Weiteres Logging (Fetch-Status, Start-Log) zur Fehlersuche. 🔎

--- a/cors_server.py
+++ b/cors_server.py
@@ -0,0 +1,10 @@
+import http.server
+import socketserver
+
+class CORSRequestHandler(http.server.SimpleHTTPRequestHandler):
+    def end_headers(self):
+        self.send_header('Access-Control-Allow-Origin', '*')
+        super().end_headers()
+
+with socketserver.TCPServer(("127.0.0.1", 8080), CORSRequestHandler) as httpd:
+    httpd.serve_forever()
--- a/dist/bookmarklet-payload.js
+++ b/dist/bookmarklet-payload.js
--- a/dist/bookmarklet.txt
+++ b/dist/bookmarklet.txt
--- a/dist/install.html
+++ b/dist/install.html
--- a/dist/kantine-standalone.html
+++ b/dist/kantine-standalone.html
--- a/kantine.js
+++ b/kantine.js
@@ -19,6 +19,11 @@
    const MENU_ID = 7;
    const POLL_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes

+    // === GitHub Release Management ===
+    const GITHUB_REPO = 'TauNeutrino/kantine-overview';
+    const GITHUB_API = `https://api.github.com/repos/${GITHUB_REPO}`;
+    const INSTALLER_BASE = `https://htmlpreview.github.io/?https://github.com/${GITHUB_REPO}/blob`;
+
    // === State ===
    let allWeeks = [];
    let currentWeekNumber = getISOWeek(new Date());
@@ -66,9 +71,16 @@
                    <div class="brand">
                        <span class="material-icons-round logo-icon">restaurant_menu</span>
                        <div class="header-left">
-                            <h1>Kantinen Übersicht <small style="font-size: 0.6em; opacity: 0.7; font-weight: 400;">{{VERSION}}</small></h1>
+                            <h1>Kantinen Übersicht <small class="version-tag" style="font-size: 0.6em; opacity: 0.7; font-weight: 400; cursor: pointer;" title="Klick für Versionsmenü">{{VERSION}}</small></h1>
                            <div id="last-updated-subtitle" class="subtitle"></div>
                        </div>
+                        <div class="nav-group" style="margin-left: 1rem;">
+                            <button id="btn-this-week" class="nav-btn active">Diese Woche</button>
+                            <button id="btn-next-week" class="nav-btn">Nächste Woche</button>
+                        </div>
+                        <button id="alarm-bell" class="icon-btn hidden" aria-label="Benachrichtigungen" title="Keine beobachteten Menüs" style="margin-left: -0.5rem;">
+                            <span class="material-icons-round" id="alarm-bell-icon" style="color:var(--text-secondary); transition: color 0.3s;">notifications</span>
+                        </button>
                    </div>
                    <div class="header-center-wrapper">
                        <div id="header-week-info" class="header-week-info"></div>
@@ -78,13 +90,12 @@
                        <button id="btn-refresh" class="icon-btn" aria-label="Menüdaten aktualisieren" title="Menüdaten neu laden">
                            <span class="material-icons-round">refresh</span>
                        </button>
+                        <button id="btn-history" class="icon-btn" aria-label="Bestellhistorie" title="Bestellhistorie">
+                            <span class="material-icons-round">receipt_long</span>
+                        </button>
                        <button id="btn-highlights" class="icon-btn" aria-label="Persönliche Highlights verwalten" title="Persönliche Highlights verwalten">
                            <span class="material-icons-round">label</span>
                        </button>
-                        <div class="nav-group">
-                            <button id="btn-this-week" class="nav-btn active">Diese Woche</button>
-                            <button id="btn-next-week" class="nav-btn">Nächste Woche</button>
-                        </div>
                        <button id="theme-toggle" class="icon-btn" aria-label="Toggle Theme">
                            <span class="material-icons-round theme-icon">light_mode</span>
                        </button>
@@ -168,6 +179,63 @@
                </div>
            </div>

+            <div id="history-modal" class="modal hidden">
+                <div class="modal-content history-modal-content">
+                    <div class="modal-header">
+                        <h2>Bestellhistorie</h2>
+                        <button id="btn-history-close" class="icon-btn" aria-label="Close">
+                            <span class="material-icons-round">close</span>
+                        </button>
+                    </div>
+                    <div class="modal-body">
+                        <div id="history-loading" class="hidden">
+                            <p id="history-progress-text" style="text-align: center; margin-bottom: 1rem; color: var(--text-secondary);">Lade Historie...</p>
+                            <div class="progress-container">
+                                <div class="progress-bar">
+                                    <div id="history-progress-fill" class="progress-fill"></div>
+                                </div>
+                            </div>
+                        </div>
+                        <div id="history-content">
+                            <!-- Dynamically populated -->
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <div id="version-modal" class="modal hidden">
+                <div class="modal-content">
+                    <div class="modal-header">
+                        <h2>📦 Versionen</h2>
+                        <button id="btn-version-close" class="icon-btn" aria-label="Close">
+                            <span class="material-icons-round">close</span>
+                        </button>
+                    </div>
+                    <div class="modal-body">
+                        <div style="margin-bottom: 1rem;">
+                            <strong>Aktuell:</strong> <span id="version-current">{{VERSION}}</span>
+                        </div>
+                        <div class="dev-toggle">
+                            <label style="display:flex;align-items:center;gap:8px;cursor:pointer;">
+                                <input type="checkbox" id="dev-mode-toggle">
+                                <span>Dev-Mode (alle Tags anzeigen)</span>
+                            </label>
+                        </div>
+                        <div id="version-list-container" style="margin-top:1rem; max-height: 250px; overflow-y: auto;">
+                            <p style="color:var(--text-secondary);">Lade Versionen...</p>
+                        </div>
+                        <div style="margin-top: 1.5rem; padding-top: 1rem; border-top: 1px solid var(--border-color); display: flex; flex-direction: column; gap: 0.75rem; font-size: 0.9em;">
+                            <a href="https://github.com/TauNeutrino/kantine-overview/issues" target="_blank" rel="noopener noreferrer" style="color: var(--primary-color); text-decoration: none; display: flex; align-items: center; gap: 0.5rem;" title="Melde einen Fehler auf GitHub">
+                                <span class="material-icons-round" style="font-size: 1.2em;">bug_report</span> Fehler melden
+                            </a>
+                            <a href="https://github.com/TauNeutrino/kantine-overview/discussions/categories/ideas" target="_blank" rel="noopener noreferrer" style="color: var(--primary-color); text-decoration: none; display: flex; align-items: center; gap: 0.5rem;" title="Schlage ein neues Feature auf GitHub vor">
+                                <span class="material-icons-round" style="font-size: 1.2em;">lightbulb</span> Feature vorschlagen
+                            </a>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
            <main class="container">
                <div id="last-updated-banner" class="banner hidden">
                    <span class="material-icons-round">update</span>
@@ -205,20 +273,52 @@
        const btnAddTag = document.getElementById('btn-add-tag');
        const tagInput = document.getElementById('tag-input');

-        btnHighlights.addEventListener('click', () => {
-            highlightsModal.classList.remove('hidden');
-            renderTagsList();
-            tagInput.focus();
+        // History Modal
+        const btnHistory = document.getElementById('btn-history');
+        const historyModal = document.getElementById('history-modal');
+        const btnHistoryClose = document.getElementById('btn-history-close');
+
+        btnHistory.addEventListener('click', () => {
+            if (!authToken) {
+                loginModal.classList.remove('hidden');
+                return;
+            }
+            historyModal.classList.remove('hidden');
+            fetchFullOrderHistory();
        });

-        btnHighlightsClose.addEventListener('click', () => {
-            highlightsModal.classList.add('hidden');
+        btnHistoryClose.addEventListener('click', () => {
+            historyModal.classList.add('hidden');
        });

        window.addEventListener('click', (e) => {
+            if (e.target === historyModal) historyModal.classList.add('hidden');
            if (e.target === highlightsModal) highlightsModal.classList.add('hidden');
        });

+        // Version Menu
+        const versionTag = document.querySelector('.version-tag');
+        const versionModal = document.getElementById('version-modal');
+        const btnVersionClose = document.getElementById('btn-version-close');
+
+        if (versionTag) {
+            versionTag.addEventListener('click', (e) => {
+                e.preventDefault();
+                e.stopPropagation();
+                openVersionMenu();
+            });
+        }
+
+        if (btnVersionClose) {
+            btnVersionClose.addEventListener('click', () => {
+                versionModal.classList.add('hidden');
+            });
+        }
+
+        window.addEventListener('click', (e) => {
+            if (e.target === versionModal) versionModal.classList.add('hidden');
+        });
+
        btnAddTag.addEventListener('click', () => {
            const tag = tagInput.value;
            if (addHighlightTag(tag)) {
@@ -265,6 +365,7 @@
        });

        btnNextWeek.addEventListener('click', () => {
+            btnNextWeek.classList.remove('new-week-available');
            if (displayMode !== 'next-week') {
                displayMode = 'next-week';
                btnNextWeek.classList.add('active');
@@ -460,6 +561,276 @@
        }
    }

+    // === History Modal Flow ===
+    let fullOrderHistoryCache = null;
+
+    async function fetchFullOrderHistory() {
+        const historyLoading = document.getElementById('history-loading');
+        const historyContent = document.getElementById('history-content');
+        const progressFill = document.getElementById('history-progress-fill');
+        const progressText = document.getElementById('history-progress-text');
+
+        // Check local storage cache (we still use memory cache if available)
+        let localCache = [];
+        if (fullOrderHistoryCache) {
+            localCache = fullOrderHistoryCache;
+        } else {
+            const ls = localStorage.getItem('kantine_history_cache');
+            if (ls) {
+                try {
+                    localCache = JSON.parse(ls);
+                    fullOrderHistoryCache = localCache;
+                } catch (e) {
+                    console.warn('History cache parse error', e);
+                }
+            }
+        }
+
+        // Show cached version immediately if we have one
+        if (localCache.length > 0) {
+            renderHistory(localCache);
+        }
+
+        if (!authToken) return;
+
+        // Start background delta sync
+        if (localCache.length === 0) {
+            historyContent.innerHTML = '';
+            historyLoading.classList.remove('hidden');
+        }
+
+        progressFill.style.width = '0%';
+        progressText.textContent = localCache.length > 0 ? 'Suche nach neuen Bestellungen...' : 'Lade Bestellhistorie...';
+        if (localCache.length > 0) historyLoading.classList.remove('hidden');
+
+        let nextUrl = localCache.length > 0
+            ? `${API_BASE}/user/orders/?venue=${VENUE_ID}&ordering=-created&limit=5`
+            : `${API_BASE}/user/orders/?venue=${VENUE_ID}&ordering=-created&limit=50`;
+        let fetchedOrders = [];
+        let totalCount = 0;
+        let requiresFullFetch = localCache.length === 0;
+        let deltaComplete = false;
+
+        try {
+            while (nextUrl && !deltaComplete) {
+                const response = await fetch(nextUrl, { headers: apiHeaders(authToken) });
+                if (!response.ok) throw new Error(`Fetch failed: ${response.status}`);
+
+                const data = await response.json();
+
+                if (data.count && totalCount === 0) {
+                    totalCount = data.count;
+                }
+
+                const results = data.results || [];
+
+                for (const order of results) {
+                    // Check if we hit an order that is already in our cache AND has the exact same state/update time
+                    // Bessa returns 'updated' timestamp, we can use it to determine if anything changed
+                    const existingOrderIndex = localCache.findIndex(cached => cached.id === order.id);
+
+                    if (!requiresFullFetch && existingOrderIndex !== -1) {
+                        const existingOrder = localCache[existingOrderIndex];
+                        // If order exists and wasn't updated since our cache, we've reached the point 
+                        // where everything older is already correctly cached.
+                        // order.updated is an ISO string like "2025-02-18T10:30:15.123456Z"
+                        if (existingOrder.updated === order.updated && existingOrder.order_state === order.order_state) {
+                            deltaComplete = true;
+                            break;
+                        }
+                    }
+                    fetchedOrders.push(order);
+                }
+
+                // Update progress
+                if (!deltaComplete && requiresFullFetch) {
+                    if (totalCount > 0) {
+                        const pct = Math.round((fetchedOrders.length / totalCount) * 100);
+                        progressFill.style.width = `${pct}%`;
+                        progressText.textContent = `Lade Bestellung ${fetchedOrders.length} von ${totalCount}...`;
+                    } else {
+                        progressText.textContent = `Lade Bestellung ${fetchedOrders.length}...`;
+                    }
+                } else if (!deltaComplete) {
+                    progressText.textContent = `${fetchedOrders.length} neue/geänderte Bestellungen gefunden...`;
+                }
+
+                nextUrl = deltaComplete ? null : data.next;
+            }
+
+            // Merge fetched orders with cache
+            if (fetchedOrders.length > 0) {
+                // We have new/updated orders. We need to merge them into the cache.
+                // 1. Create a map of the existing cache for quick ID lookup
+                const cacheMap = new Map(localCache.map(o => [o.id, o]));
+
+                // 2. Update/Insert the newly fetched orders
+                for (const order of fetchedOrders) {
+                    cacheMap.set(order.id, order); // Overwrites existing, or adds new
+                }
+
+                // 3. Convert back to array and sort by created date (descending)
+                const mergedOrders = Array.from(cacheMap.values());
+                mergedOrders.sort((a, b) => new Date(b.created) - new Date(a.created));
+
+                fullOrderHistoryCache = mergedOrders;
+                try {
+                    localStorage.setItem('kantine_history_cache', JSON.stringify(mergedOrders));
+                } catch (e) {
+                    console.warn('History cache write error', e);
+                }
+
+                // Render the updated history
+                renderHistory(fullOrderHistoryCache);
+            }
+
+        } catch (error) {
+            console.error('Error in history sync:', error);
+            if (localCache.length === 0) {
+                historyContent.innerHTML = `<p style="color:var(--error-color);text-align:center;">Fehler beim Laden der Historie.</p>`;
+            } else {
+                showToast('Hintergrund-Synchronisation fehlgeschlagen', 'error');
+            }
+        } finally {
+            historyLoading.classList.add('hidden');
+        }
+    }
+
+    function renderHistory(orders) {
+        const content = document.getElementById('history-content');
+        if (!orders || orders.length === 0) {
+            content.innerHTML = '<p style="text-align:center;color:var(--text-secondary);padding:20px;">Keine Bestellungen gefunden.</p>';
+            return;
+        }
+
+        // Group by Year -> Month -> Week Number (KW)
+        const groups = {};
+
+        orders.forEach(order => {
+            const d = new Date(order.date);
+            const y = d.getFullYear();
+            const m = d.getMonth();
+            const monthKey = `${y}-${m.toString().padStart(2, '0')}`;
+            const monthName = d.toLocaleString('de-AT', { month: 'long' }); // Only month name
+
+            const kw = getISOWeek(d);
+
+            if (!groups[y]) {
+                groups[y] = { year: y, months: {} };
+            }
+            if (!groups[y].months[monthKey]) {
+                groups[y].months[monthKey] = { name: monthName, year: y, monthIndex: m, count: 0, total: 0, weeks: {} };
+            }
+            if (!groups[y].months[monthKey].weeks[kw]) {
+                groups[y].months[monthKey].weeks[kw] = { label: `KW ${kw}`, items: [], count: 0, total: 0 };
+            }
+
+            const items = order.items || [];
+            items.forEach(item => {
+                const itemPrice = parseFloat(item.price || order.total || 0);
+                groups[y].months[monthKey].weeks[kw].items.push({
+                    date: order.date,
+                    name: item.name || 'Menü',
+                    price: itemPrice,
+                    state: order.order_state // 9 is cancelled, 5 is active, 8 is completed
+                });
+
+                if (order.order_state !== 9) {
+                    groups[y].months[monthKey].weeks[kw].count++;
+                    groups[y].months[monthKey].weeks[kw].total += itemPrice;
+                    groups[y].months[monthKey].count++;
+                    groups[y].months[monthKey].total += itemPrice;
+                }
+            });
+        });
+
+        // Generate HTML 
+        const sortedYears = Object.keys(groups).sort((a, b) => b - a);
+        let html = '';
+
+        sortedYears.forEach(yKey => {
+            const yearGroup = groups[yKey];
+            html += `<div class="history-year-group">
+                <h2 class="history-year-header">${yearGroup.year}</h2>`;
+
+            const sortedMonths = Object.keys(yearGroup.months).sort((a, b) => b.localeCompare(a));
+
+            sortedMonths.forEach(mKey => {
+                const monthGroup = yearGroup.months[mKey];
+
+                html += `<div class="history-month-group">
+                    <div class="history-month-header" tabindex="0" role="button" aria-expanded="false">
+                        <div style="display:flex; flex-direction:column; gap:4px;">
+                            <span>${monthGroup.name}</span>
+                            <div class="history-month-summary">
+                                <span>${monthGroup.count} Bestellungen &bull; <strong>€${monthGroup.total.toFixed(2)}</strong></span>
+                            </div>
+                        </div>
+                        <span class="material-icons-round">expand_more</span>
+                    </div>
+                    <div class="history-month-content">`;
+
+                const sortedKWs = Object.keys(monthGroup.weeks).sort((a, b) => parseInt(b) - parseInt(a));
+
+                sortedKWs.forEach(kw => {
+                    const week = monthGroup.weeks[kw];
+                    html += `<div class="history-week-group">
+                        <div class="history-week-header">
+                            <strong>${week.label}</strong>
+                            <span>${week.count} Bestellungen &bull; <strong>€${week.total.toFixed(2)}</strong></span>
+                        </div>`;
+
+                    week.items.forEach(item => {
+                        const dateObj = new Date(item.date);
+                        const dayStr = dateObj.toLocaleDateString('de-AT', { weekday: 'short', day: '2-digit', month: '2-digit' });
+
+                        let statusBadge = '';
+                        if (item.state === 9) {
+                            statusBadge = '<span class="history-item-status">Storniert</span>';
+                        } else if (item.state === 8) {
+                            statusBadge = '<span class="history-item-status">Abgeschlossen</span>';
+                        } else {
+                            statusBadge = '<span class="history-item-status">Übertragen</span>';
+                        }
+
+                        html += `
+                        <div class="history-item ${item.state === 9 ? 'history-item-cancelled' : ''}">
+                            <div style="font-size: 0.85rem; color: var(--text-secondary);">${dayStr}</div>
+                            <div class="history-item-details">
+                                <span class="history-item-name">${escapeHtml(item.name)}</span>
+                                <div>${statusBadge}</div>
+                            </div>
+                            <div class="history-item-price ${item.state === 9 ? 'history-item-price-cancelled' : ''}">€${item.price.toFixed(2)}</div>
+                        </div>`;
+                    });
+                    html += `</div>`;
+                });
+                html += `</div></div>`; // Close month-content and month-group
+            });
+            html += `</div>`; // Close year-group
+        });
+
+        content.innerHTML = html;
+
+        // Bind Accordion Click Events via JS
+        const monthHeaders = content.querySelectorAll('.history-month-header');
+        monthHeaders.forEach(header => {
+            header.addEventListener('click', () => {
+                const parentGroup = header.parentElement;
+                const isOpen = parentGroup.classList.contains('open');
+
+                // Toggle current
+                if (isOpen) {
+                    parentGroup.classList.remove('open');
+                    header.setAttribute('aria-expanded', 'false');
+                } else {
+                    parentGroup.classList.add('open');
+                    header.setAttribute('aria-expanded', 'true');
+                }
+            });
+        });
+    }
+
    // === Place Order ===
    async function placeOrder(date, articleId, name, price, description) {
        if (!authToken) return;
@@ -521,6 +892,7 @@

            if (response.ok || response.status === 201) {
                showToast(`Bestellt: ${name}`, 'success');
+                fullOrderHistoryCache = null; // Clear memory cache so next history open triggers delta sync
                await fetchOrders();
            } else {
                const data = await response.json();
@@ -550,6 +922,7 @@

            if (response.ok) {
                showToast(`Storniert: ${name}`, 'success');
+                fullOrderHistoryCache = null; // Clear memory cache so next history open triggers delta sync
                await fetchOrders();
            } else {
                const data = await response.json();
@@ -566,20 +939,146 @@
        localStorage.setItem('kantine_flags', JSON.stringify([...userFlags]));
    }

+    async function refreshFlaggedItems() {
+        if (userFlags.size === 0) return;
+        const token = authToken || GUEST_TOKEN;
+        const datesToFetch = new Set();
+
+        for (const flagId of userFlags) {
+            const [dateStr] = flagId.split('_');
+            datesToFetch.add(dateStr);
+        }
+
+        let updated = false;
+        for (const dateStr of datesToFetch) {
+            try {
+                const resp = await fetch(`${API_BASE}/venues/${VENUE_ID}/menu/${MENU_ID}/${dateStr}/`, {
+                    headers: apiHeaders(token)
+                });
+                if (!resp.ok) continue;
+                const data = await resp.json();
+                const menuGroups = data.results || [];
+                let dayItems = [];
+                for (const group of menuGroups) {
+                    if (group.items && Array.isArray(group.items)) {
+                        dayItems = dayItems.concat(group.items);
+                    }
+                }
+
+                // Update allWeeks in memory
+                for (let week of allWeeks) {
+                    if (!week.days) continue;
+                    let dayObj = week.days.find(d => d.date === dateStr);
+                    if (dayObj) {
+                        dayObj.items = dayItems.map(item => {
+                            const isUnlimited = item.amount_tracking === false;
+                            const hasStock = parseInt(item.available_amount) > 0;
+                            return {
+                                id: `${dateStr}_${item.id}`,
+                                articleId: item.id,
+                                name: item.name || 'Unknown',
+                                description: item.description || '',
+                                price: parseFloat(item.price) || 0,
+                                available: isUnlimited || hasStock,
+                                availableAmount: parseInt(item.available_amount) || 0,
+                                amountTracking: item.amount_tracking !== false
+                            };
+                        });
+                        updated = true;
+                    }
+                }
+            } catch (e) {
+                console.error('Error refreshing flag date', dateStr, e);
+            }
+        }
+
+        if (updated) {
+            saveMenuCache();
+            updateLastUpdatedTime(new Date().toISOString());
+            updateAlarmBell();
+            renderVisibleWeeks();
+        }
+    }
+
+    function updateAlarmBell() {
+        const bellBtn = document.getElementById('alarm-bell');
+        const bellIcon = document.getElementById('alarm-bell-icon');
+        if (!bellBtn || !bellIcon) return;
+
+        if (userFlags.size === 0) {
+            bellBtn.classList.add('hidden');
+            bellBtn.style.display = 'none';
+            bellIcon.style.color = 'var(--text-secondary)';
+            bellIcon.style.textShadow = 'none';
+            return;
+        }
+
+        bellBtn.classList.remove('hidden');
+        bellBtn.style.display = 'inline-flex';
+
+        // Check if any flagged item is available
+        let anyAvailable = false;
+        for (const wk of allWeeks) {
+            if (!wk.days) continue;
+            for (const d of wk.days) {
+                if (!d.items) continue;
+                for (const item of d.items) {
+                    if (item.available && userFlags.has(item.id)) {
+                        anyAvailable = true;
+                        break;
+                    }
+                }
+                if (anyAvailable) break;
+            }
+            if (anyAvailable) break;
+        }
+
+        let lastUpdatedStr = localStorage.getItem('kantine_last_updated');
+        let timeStr = 'gerade eben'; // Fallback instead of Unbekannt
+        if (!lastUpdatedStr) {
+            lastUpdatedStr = new Date().toISOString();
+            localStorage.setItem('kantine_last_updated', lastUpdatedStr);
+        }
+
+        const lastUpdated = new Date(lastUpdatedStr);
+        const diffMs = Date.now() - lastUpdated.getTime();
+        const diffMins = Math.floor(diffMs / 60000);
+        if (diffMins < 1) timeStr = 'gerade eben';
+        else if (diffMins < 60) timeStr = `vor ${diffMins} Min.`;
+        else timeStr = `vor ${Math.floor(diffMins / 60)} Std.`;
+
+        bellBtn.title = `Zuletzt geprüft: ${timeStr}`;
+
+        if (anyAvailable) {
+            bellIcon.style.color = '#10b981'; // green / success
+            bellIcon.style.textShadow = '0 0 10px rgba(16, 185, 129, 0.4)';
+        } else {
+            bellIcon.style.color = '#f59e0b'; // yellow / warning
+            bellIcon.style.textShadow = '0 0 10px rgba(245, 158, 11, 0.4)';
+        }
+    }
+
    function toggleFlag(date, articleId, name, cutoff) {
        const id = `${date}_${articleId}`;
+        let flagAdded = false;
        if (userFlags.has(id)) {
            userFlags.delete(id);
            showToast(`Flag entfernt für ${name}`, 'success');
        } else {
            userFlags.add(id);
+            flagAdded = true;
            showToast(`Benachrichtigung aktiviert für ${name}`, 'success');
            if (Notification.permission === 'default') {
                Notification.requestPermission();
            }
        }
        saveFlags();
+        updateAlarmBell();
        renderVisibleWeeks();
+
+        if (flagAdded) {
+            refreshFlaggedItems();
+        }
    }

    // FR-019: Auto-remove flags whose cutoff has passed
@@ -727,12 +1226,15 @@
        try {
            const cached = localStorage.getItem(CACHE_KEY);
            const cachedTs = localStorage.getItem(CACHE_TS_KEY);
+            console.log(`[Cache] localStorage: key=${!!cached} (${cached ? cached.length : 0} chars), ts=${cachedTs}`);
            if (cached) {
                allWeeks = JSON.parse(cached);
                currentWeekNumber = getISOWeek(new Date());
                currentYear = new Date().getFullYear();
+                console.log(`[Cache] Parsed ${allWeeks.length} weeks:`, allWeeks.map(w => `KW${w.weekNumber}/${w.year} (${(w.days || []).length} days)`));
                renderVisibleWeeks();
                updateNextWeekBadge();
+                updateAlarmBell();
                if (cachedTs) updateLastUpdatedTime(cachedTs);
                console.log('Loaded menu from cache');
                return true;
@@ -743,6 +1245,31 @@
        return false;
    }

+    // FR-024: Check if cache is fresh enough to skip API refresh
+    function isCacheFresh() {
+        const cachedTs = localStorage.getItem(CACHE_TS_KEY);
+        if (!cachedTs) {
+            console.log('[Cache] No timestamp found');
+            return false;
+        }
+
+        // Condition 1: Cache < 1 hour old
+        const ageMs = Date.now() - new Date(cachedTs).getTime();
+        const ageMin = Math.round(ageMs / 60000);
+        if (ageMs > 60 * 60 * 1000) {
+            console.log(`[Cache] Stale: ${ageMin}min old (max 60)`);
+            return false;
+        }
+
+        // Condition 2: Data for current week exists
+        const thisWeek = getISOWeek(new Date());
+        const thisYear = getWeekYear(new Date());
+        const hasCurrentWeek = allWeeks.some(w => w.weekNumber === thisWeek && w.year === thisYear && w.days && w.days.length > 0);
+
+        console.log(`[Cache] Age: ${ageMin}min, looking for KW${thisWeek}/${thisYear}, found: ${hasCurrentWeek}`);
+        return hasCurrentWeek;
+    }
+
    // === Menu Data Fetching (Direct from Bessa API) ===
    async function loadMenuDataFromAPI() {
        const loading = document.getElementById('loading');
@@ -920,6 +1447,7 @@
            updateAuthUI(); // This will trigger fetchOrders if logged in
            renderVisibleWeeks();
            updateNextWeekBadge();
+            updateAlarmBell();

            progressMessage.textContent = 'Fertig!';
            setTimeout(() => progressModal.classList.add('hidden'), 500);
@@ -940,17 +1468,39 @@
    }

    // === Last Updated Display ===
+    let lastUpdatedTimestamp = null;
+    let lastUpdatedIntervalId = null;
+
    function updateLastUpdatedTime(isoTimestamp) {
        const subtitle = document.getElementById('last-updated-subtitle');
        if (!isoTimestamp) return;
+        lastUpdatedTimestamp = isoTimestamp;
        try {
            const date = new Date(isoTimestamp);
            const timeStr = date.toLocaleTimeString('de-DE', { hour: '2-digit', minute: '2-digit' });
            const dateStr = date.toLocaleDateString('de-DE', { day: '2-digit', month: '2-digit' });
-            subtitle.textContent = `Aktualisiert: ${dateStr} ${timeStr}`;
+            const ago = getRelativeTime(date);
+            subtitle.textContent = `Aktualisiert: ${dateStr} ${timeStr} (${ago})`;
        } catch (e) {
            subtitle.textContent = '';
        }
+        // Auto-refresh relative time every minute
+        if (!lastUpdatedIntervalId) {
+            lastUpdatedIntervalId = setInterval(() => {
+                if (lastUpdatedTimestamp) updateLastUpdatedTime(lastUpdatedTimestamp);
+            }, 60 * 1000);
+        }
+    }
+
+    function getRelativeTime(date) {
+        const diffMs = Date.now() - date.getTime();
+        const diffMin = Math.floor(diffMs / 60000);
+        if (diffMin < 1) return 'gerade eben';
+        if (diffMin === 1) return 'vor 1 min.';
+        if (diffMin < 60) return `vor ${diffMin} min.`;
+        const diffH = Math.floor(diffMin / 60);
+        if (diffH === 1) return 'vor 1 Std.';
+        return `vor ${diffH} Std.`;
    }

    // === Toast Notification ===
@@ -1039,7 +1589,9 @@
            if (nextWeekData && nextWeekData.days) {
                nextWeekData.days.forEach(day => {
                    day.items.forEach(item => {
-                        if (checkHighlight(item.name) || checkHighlight(item.description)) {
+                        const nameMatches = checkHighlight(item.name);
+                        const descMatches = checkHighlight(item.description);
+                        if (nameMatches.length > 0 || descMatches.length > 0) {
                            highlightCount++;
                        }
                    });
@@ -1053,6 +1605,14 @@
                badge.classList.add('has-highlights');
            }

+            // FR-092: Highlight Next Week Button when new data arrives
+            const storageKey = `kantine_notified_nextweek_${nextYear}_${nextWeek}`;
+            if (!localStorage.getItem(storageKey)) {
+                localStorage.setItem(storageKey, 'true');
+                btnNextWeek.classList.add('new-week-available');
+                showToast('Neue Menüdaten für nächste Woche verfügbar!', 'info');
+            }
+
        } else if (badge) {
            badge.remove();
        }
@@ -1411,39 +1971,82 @@
        return card;
    }

-    // === Version Check (periodic, every hour) ===
+    // === GitHub Release Management ===
+
+    // Semver comparison: returns true if remote > local
+    function isNewer(remote, local) {
+        if (!remote || !local) return false;
+        const r = remote.replace(/^v/, '').split('.').map(Number);
+        const l = local.replace(/^v/, '').split('.').map(Number);
+        for (let i = 0; i < Math.max(r.length, l.length); i++) {
+            if ((r[i] || 0) > (l[i] || 0)) return true;
+            if ((r[i] || 0) < (l[i] || 0)) return false;
+        }
+        return false;
+    }
+
+    // GitHub API headers
+    function githubHeaders() {
+        return { 'Accept': 'application/vnd.github.v3+json' };
+    }
+
+    // Fetch versions from GitHub (releases or tags)
+    async function fetchVersions(devMode) {
+        const endpoint = devMode
+            ? `${GITHUB_API}/tags?per_page=20`
+            : `${GITHUB_API}/releases?per_page=20`;
+
+        const resp = await fetch(endpoint, { headers: githubHeaders() });
+        if (!resp.ok) {
+            if (resp.status === 403) {
+                throw new Error('API Rate Limit erreicht (403). Bitte später erneut versuchen.');
+            }
+            throw new Error(`GitHub API ${resp.status}`);
+        }
+        const data = await resp.json();
+
+        // Normalize to common format: { tag, name, url, body }
+        return data.map(item => {
+            const tag = devMode ? item.name : item.tag_name;
+            return {
+                tag,
+                name: devMode ? tag : (item.name || tag),
+                url: `${INSTALLER_BASE}/${tag}/dist/install.html`,
+                body: item.body || ''
+            };
+        });
+    }
+
+    // Periodic update check (runs on init + every hour)
    async function checkForUpdates() {
-        console.log('[Kantine] Starting update check...');
        const currentVersion = '{{VERSION}}';
-        const versionUrl = 'https://raw.githubusercontent.com/TauNeutrino/kantine-overview/main/version.txt';
-        const installerUrl = 'https://htmlpreview.github.io/?https://github.com/TauNeutrino/kantine-overview/blob/main/dist/install.html';
+        const devMode = localStorage.getItem('kantine_dev_mode') === 'true';

        try {
-            console.log(`[Kantine] Fetching ${versionUrl}...`);
-            const resp = await fetch(versionUrl, { cache: 'no-cache' });
-            console.log(`[Kantine] Fetch status: ${resp.status}`);
+            const versions = await fetchVersions(devMode);
+            if (!versions.length) return;

-            if (!resp.ok) {
-                console.warn(`[Kantine] Version Check HTTP Error: ${resp.status}`);
-                return;
-            }
-            const remoteVersion = (await resp.text()).trim();
+            // Cache for version menu
+            localStorage.setItem('kantine_version_cache', JSON.stringify({
+                timestamp: Date.now(), devMode, versions
+            }));

-            console.log(`[Kantine] Version Check: Local [${currentVersion}] vs Remote [${remoteVersion}]`);
+            const latest = versions[0].tag;
+            console.log(`[Kantine] Version Check: Local [${currentVersion}] vs Latest [${latest}] (${devMode ? 'dev' : 'stable'})`);

-            if (!remoteVersion || remoteVersion === currentVersion) return;
+            if (!isNewer(latest, currentVersion)) return;

-            console.log(`[Kantine] Update verfügbar: ${remoteVersion}`);
+            console.log(`[Kantine] Update verfügbar: ${latest}`);

            // Show 🆕 icon in header (only once)
            const headerTitle = document.querySelector('.header-left h1');
            if (headerTitle && !headerTitle.querySelector('.update-icon')) {
                const icon = document.createElement('a');
                icon.className = 'update-icon';
-                icon.href = installerUrl;
+                icon.href = versions[0].url;
                icon.target = '_blank';
                icon.innerHTML = '🆕';
-                icon.title = `Update verfügbar: ${remoteVersion} — Klick zum Installieren`;
+                icon.title = `Update: ${latest} — Klick zum Installieren`;
                icon.style.cssText = 'margin-left:8px;font-size:1em;text-decoration:none;cursor:pointer;vertical-align:middle;';
                headerTitle.appendChild(icon);
            }
@@ -1452,6 +2055,106 @@
        }
    }

+    // Open Version Menu modal
+    function openVersionMenu() {
+        const modal = document.getElementById('version-modal');
+        const container = document.getElementById('version-list-container');
+        const devToggle = document.getElementById('dev-mode-toggle');
+        const currentVersion = '{{VERSION}}';
+
+        if (!modal) return;
+        modal.classList.remove('hidden');
+
+        // Set current version display
+        const cur = document.getElementById('version-current');
+        if (cur) cur.textContent = currentVersion;
+
+        // Init dev toggle
+        const devMode = localStorage.getItem('kantine_dev_mode') === 'true';
+        devToggle.checked = devMode;
+
+        // Load versions (from cache or fresh)
+        async function loadVersions(forceRefresh) {
+            const dm = devToggle.checked;
+            container.innerHTML = '<p style="color:var(--text-secondary);">Lade Versionen...</p>';
+
+            function renderVersionsList(versions) {
+                if (!versions || !versions.length) {
+                    container.innerHTML = '<p style="color:var(--text-secondary);">Keine Versionen gefunden.</p>';
+                    return;
+                }
+
+                container.innerHTML = '<ul class="version-list"></ul>';
+                const list = container.querySelector('.version-list');
+
+                versions.forEach(v => {
+                    const isCurrent = v.tag === currentVersion;
+                    const isNew = isNewer(v.tag, currentVersion);
+                    const li = document.createElement('li');
+                    li.className = 'version-item' + (isCurrent ? ' current' : '');
+
+                    let badge = '';
+                    if (isCurrent) badge = '<span class="badge-current">✓ Installiert</span>';
+                    else if (isNew) badge = '<span class="badge-new">⬆ Neu!</span>';
+
+                    let action = '';
+                    if (!isCurrent) {
+                        action = `<a href="${v.url}" target="_blank" class="install-link" title="${v.tag} installieren">Installieren</a>`;
+                    }
+
+                    li.innerHTML = `
+                        <div class="version-info">
+                            <strong>${v.tag}</strong>
+                            ${badge}
+                        </div>
+                        ${action}
+                    `;
+                    list.appendChild(li);
+                });
+            }
+
+            try {
+                // 1. Show cached versions immediately if available
+                const cachedRaw = localStorage.getItem('kantine_version_cache');
+                let cached = null;
+                if (cachedRaw) {
+                    try { cached = JSON.parse(cachedRaw); } catch (e) { }
+                }
+
+                if (cached && cached.devMode === dm && cached.versions) {
+                    renderVersionsList(cached.versions);
+                }
+
+                // 2. Fetch fresh versions in background (or foreground if no cache)
+                const liveVersions = await fetchVersions(dm);
+
+                // Compare with cache to see if we need to re-render
+                const liveVersionsStr = JSON.stringify(liveVersions);
+                const cachedVersionsStr = cached ? JSON.stringify(cached.versions) : '';
+
+                if (liveVersionsStr !== cachedVersionsStr) {
+                    localStorage.setItem('kantine_version_cache', JSON.stringify({
+                        timestamp: Date.now(), devMode: dm, versions: liveVersions
+                    }));
+                    renderVersionsList(liveVersions);
+                }
+
+            } catch (e) {
+                container.innerHTML = `<p style="color:#e94560;">Fehler: ${e.message}</p>`;
+            }
+        }
+
+        loadVersions(false);
+
+        // Dev toggle handler
+        devToggle.onchange = () => {
+            localStorage.setItem('kantine_dev_mode', devToggle.checked);
+            // Clear cache to force refresh when mode changes
+            localStorage.removeItem('kantine_version_cache');
+            loadVersions(true);
+        };
+    }
+
    // === Order Countdown ===
    function updateCountdown() {
        const now = new Date();
@@ -1577,13 +2280,19 @@
    updateAuthUI();
    cleanupExpiredFlags();

-    // Load cached data first for instant UI, then refresh from API
+    // Load cached data first for instant UI, refresh only if stale (FR-024)
    const hadCache = loadMenuCache();
    if (hadCache) {
-        // Hide loading spinner since cache is shown
        document.getElementById('loading').classList.add('hidden');
-    }
+        if (!isCacheFresh()) {
+            console.log('Cache stale or incomplete – refreshing from API');
            loadMenuDataFromAPI();
+        } else {
+            console.log('Cache fresh & complete – skipping API refresh');
+        }
+    } else {
+        loadMenuDataFromAPI();
+    }

    // Auto-start polling if already logged in
    if (authToken) {
--- a/mock-data.js
+++ b/mock-data.js
@@ -128,8 +128,31 @@
        // Orders endpoint
        if (urlStr.includes('/user/orders/') && (!options || options.method === 'GET' || !options.method)) {
            console.log('[MOCK] Returning mock orders');
+            // Formatter for history mapping
+            const mappedOrders = mockOrders.map(o => ({
+                id: o.id,
+                date: `${o.date}T10:00:00Z`,
+                order_state: o.status === 'cancelled' ? 9 : 5,
+                total: o.price || '6.50',
+                items: [{
+                    article: o.article,
+                    name: o.article_name,
+                    price: o.price || '6.50',
+                    amount: 1
+                }]
+            }));
+
+            // Handle lazy load / pagination if requesting full history
+            if (urlStr.includes('limit=50')) {
                return Promise.resolve(new Response(JSON.stringify({
-                results: mockOrders
+                    count: mappedOrders.length,
+                    next: null,
+                    results: mappedOrders
+                }), { status: 200, headers: { 'Content-Type': 'application/json' } }));
+            }
+
+            return Promise.resolve(new Response(JSON.stringify({
+                results: mappedOrders
            }), { status: 200, headers: { 'Content-Type': 'application/json' } }));
        }

--- a/release.sh
+++ b/release.sh
@@ -0,0 +1,58 @@
+#!/bin/bash
+# release.sh - Deploys a new version of the Kantine Wrapper
+
+# Ensure we're in the script directory
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
+cd "$SCRIPT_DIR"
+
+# Ensure tests have run and artifacts exist
+if [ ! -d "$SCRIPT_DIR/dist" ]; then
+    echo "❌ Error: dist folder missing. Please run build-bookmarklet.sh first"
+    exit 1
+fi
+
+# Get current version
+VERSION=$(cat "version.txt" | tr -d '\n\r ')
+
+# Validate that version is set
+if [ -z "$VERSION" ]; then
+    echo "❌ Error: Could not determine version from version.txt"
+    exit 1
+fi
+
+echo "=== Kantine Bookmarklet Releaser ($VERSION) ==="
+
+# Check for uncommitted changes (excluding dist/)
+if ! git diff-index --quiet HEAD -- ":(exclude)dist"; then
+    echo "⚠️ Warning: You have uncommitted changes in the working directory."
+    echo "Please commit your code changes before running the release script."
+    exit 1
+fi
+
+echo "=== Committing build artifacts ==="
+git add "dist/"
+git commit -m "chore: update build artifacts for $VERSION" --allow-empty
+
+echo ""
+echo "=== Tagging $VERSION ==="
+if git rev-parse "$VERSION" >/dev/null 2>&1; then
+    git tag -f "$VERSION"
+    echo "🔄 Tag $VERSION moved to current commit."
+else
+    git tag "$VERSION"
+    echo "✅ Created tag: $VERSION"
+fi
+
+echo ""
+echo "=== Pushing to remotes ==="
+# Determine remote targets: Assume 'origin' for primary, optionally 'github'
+git push origin HEAD
+git push origin --force tag "$VERSION"
+
+# If a remote named 'github' exists, push tags there too
+if git remote | grep -q "^github$"; then
+    git push github --force tag "$VERSION"
+fi
+
+echo "🎉 Successfully released version $VERSION!"
+exit 0
--- a/style.css
+++ b/style.css
@@ -186,6 +186,32 @@ body {
    color: white;
 }

+/* Notification state for Next Week */
+.nav-btn.new-week-available {
+    animation: goldPulse 2s infinite;
+    border-color: #f59e0b;
+    color: var(--accent-color);
+}
+
+.nav-btn.new-week-available.active {
+    color: white;
+}
+
+@keyframes goldPulse {
+    0% {
+        box-shadow: 0 0 0 0 rgba(245, 158, 11, 0.7);
+    }
+
+    70% {
+        box-shadow: 0 0 0 10px rgba(245, 158, 11, 0);
+    }
+
+    100% {
+        box-shadow: 0 0 0 0 rgba(245, 158, 11, 0);
+    }
+}
+
+
 /* Badge for nav buttons (day count indicator) */
 .nav-badge {
    background-color: var(--error-color);
@@ -437,7 +463,6 @@ body {

 .modal-content {
    background: var(--bg-card);
-    /* Changed from --surface */
    width: 90%;
    max-width: 400px;
    border-radius: 16px;
@@ -446,6 +471,174 @@ body {
    animation: modalSlide 0.3s ease-out;
 }

+/* History Modal specific */
+.history-modal-content {
+    max-width: 600px;
+    max-height: 85vh;
+    display: flex;
+    flex-direction: column;
+}
+
+.history-modal-content .modal-body {
+    overflow-y: auto;
+    padding: 0;
+    /* Padding is handled by inner elements */
+}
+
+/* History Styles */
+.history-year-group {
+    margin-bottom: 16px;
+}
+
+.history-year-header {
+    background: var(--bg-card);
+    padding: 12px 20px;
+    margin: 0;
+    font-size: 1.2rem;
+    font-weight: 700;
+    color: var(--text-primary);
+    border-bottom: 2px solid var(--border-color);
+    position: sticky;
+    top: 0;
+    z-index: 12;
+}
+
+.history-month-group {
+    border-bottom: 1px solid var(--border-color);
+}
+
+.history-month-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 14px 20px;
+    margin: 0;
+    font-size: 1.05rem;
+    font-weight: 600;
+    color: var(--text-primary);
+    background: var(--bg-body);
+    cursor: pointer;
+    transition: background 0.2s;
+}
+
+.history-month-header:hover {
+    background: var(--border-color);
+    /* Slight hover effect */
+}
+
+.history-month-summary {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    font-size: 0.95rem;
+    color: var(--text-secondary);
+}
+
+.history-month-content {
+    display: none;
+    /* Collapsed by default */
+    background: var(--bg-card);
+}
+
+.history-month-group.open .history-month-content {
+    display: block;
+    /* Expanded when open class is present */
+}
+
+.history-month-group.open .history-month-header .material-icons-round {
+    transform: rotate(180deg);
+}
+
+.history-month-header .material-icons-round {
+    transition: transform 0.3s;
+    font-size: 20px;
+}
+
+.history-week-group {
+    padding: 12px 20px;
+    border-bottom: 1px dashed var(--border-color);
+}
+
+.history-week-group:last-child {
+    border-bottom: none;
+}
+
+.history-week-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: var(--text-secondary);
+    margin-bottom: 10px;
+}
+
+.history-week-summary {
+    font-size: 0.85rem;
+    font-weight: 500;
+    background: rgba(100, 116, 139, 0.1);
+    padding: 4px 10px;
+    border-radius: 12px;
+}
+
+.history-items {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.history-item {
+    display: grid;
+    grid-template-columns: 50px 1fr auto;
+    align-items: center;
+    gap: 12px;
+    padding: 10px 12px;
+    background: var(--bg-body);
+    border-radius: 8px;
+    border: 1px solid var(--border-color);
+}
+
+.history-item-date {
+    font-size: 0.85rem;
+    color: var(--text-secondary);
+    font-weight: 500;
+}
+
+.history-item-details {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+
+.history-item-name {
+    font-size: 0.95rem;
+    font-weight: 500;
+    color: var(--text-primary);
+}
+
+.history-item-price {
+    font-weight: 600;
+    color: var(--text-primary);
+}
+
+.history-item-status {
+    font-size: 0.8rem;
+    font-weight: 600;
+    color: var(--text-primary);
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+
+.history-item-cancelled {
+    opacity: 0.5;
+    filter: grayscale(1);
+}
+
+.history-item-price-cancelled {
+    text-decoration: line-through;
+    color: var(--text-secondary);
+}
+
@keyframes modalSlide {
    from {
        transform: translateY(20px);
@@ -608,7 +801,7 @@ body {
    /* No opacity/filter here - fully visible */
    background: var(--bg-card);
    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
-    border: 1px solid var(--accent-color);
+    border: 1px solid #8b5cf6;
    border-radius: 8px;
    padding: 1rem;
    margin: 0 -1rem 1.5rem -1rem;
@@ -617,8 +810,8 @@ body {
 }

 .menu-item.today-ordered {
-    border: 2px solid var(--accent-color);
-    box-shadow: 0 0 20px rgba(96, 165, 250, 0.4);
+    border: 2px solid #8b5cf6;
+    box-shadow: 0 0 20px rgba(139, 92, 246, 0.4);
    border-radius: 8px;
    padding: 1rem;
    margin: 0 -1rem 1.5rem -1rem;
@@ -630,15 +823,15 @@ body {

@keyframes pulse-glow {
    0% {
-        box-shadow: 0 0 15px rgba(96, 165, 250, 0.3);
+        box-shadow: 0 0 15px rgba(139, 92, 246, 0.3);
    }

    50% {
-        box-shadow: 0 0 25px rgba(96, 165, 250, 0.6);
+        box-shadow: 0 0 25px rgba(139, 92, 246, 0.6);
    }

    100% {
-        box-shadow: 0 0 15px rgba(96, 165, 250, 0.3);
+        box-shadow: 0 0 15px rgba(139, 92, 246, 0.3);
    }
 }

@@ -1413,3 +1606,123 @@ body {
    font-size: 1.1em;
    color: var(--accent-color);
 }
+
+/* === Version Menu === */
+.version-tag {
+    cursor: pointer;
+    transition: opacity 0.2s ease, text-decoration 0.2s ease;
+}
+
+.version-tag:hover {
+    opacity: 1 !important;
+    text-decoration: underline;
+}
+
+.version-list {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+}
+
+.version-item {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 10px 14px;
+    border-radius: 8px;
+    margin-bottom: 4px;
+    transition: background 0.2s;
+}
+
+.version-item:hover {
+    background: rgba(100, 116, 139, 0.08);
+}
+
+.version-item.current {
+    background: rgba(2, 154, 168, 0.1);
+    border: 1px solid rgba(2, 154, 168, 0.25);
+}
+
+[data-theme="dark"] .version-item:hover {
+    background: rgba(255, 255, 255, 0.05);
+}
+
+[data-theme="dark"] .version-item.current {
+    background: rgba(96, 165, 250, 0.12);
+    border: 1px solid rgba(96, 165, 250, 0.25);
+}
+
+.version-info {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+}
+
+.badge-current {
+    font-size: 0.75rem;
+    font-weight: 600;
+    color: var(--success-color);
+    padding: 2px 8px;
+    border-radius: 4px;
+    background: rgba(5, 150, 105, 0.1);
+}
+
+.badge-new {
+    font-size: 0.75rem;
+    font-weight: 600;
+    color: #029aa8;
+    padding: 2px 8px;
+    border-radius: 4px;
+    background: rgba(2, 154, 168, 0.1);
+}
+
+[data-theme="dark"] .badge-new {
+    color: #60a5fa;
+    background: rgba(96, 165, 250, 0.12);
+}
+
+.install-link {
+    font-size: 0.8rem;
+    font-weight: 500;
+    padding: 4px 12px;
+    border-radius: 6px;
+    background: rgba(2, 154, 168, 0.1);
+    color: #029aa8;
+    text-decoration: none;
+    border: 1px solid rgba(2, 154, 168, 0.25);
+    transition: all 0.2s;
+    white-space: nowrap;
+}
+
+.install-link:hover {
+    background: rgba(2, 154, 168, 0.2);
+    border-color: rgba(2, 154, 168, 0.4);
+}
+
+[data-theme="dark"] .install-link {
+    color: #60a5fa;
+    background: rgba(96, 165, 250, 0.12);
+    border: 1px solid rgba(96, 165, 250, 0.25);
+}
+
+[data-theme="dark"] .install-link:hover {
+    background: rgba(96, 165, 250, 0.2);
+    border-color: rgba(96, 165, 250, 0.4);
+}
+
+.dev-toggle {
+    padding: 10px 14px;
+    border-radius: 8px;
+    background: rgba(100, 116, 139, 0.05);
+    border: 1px solid var(--border-color);
+}
+
+.dev-toggle input[type="checkbox"] {
+    accent-color: #029aa8;
+    width: 16px;
+    height: 16px;
+}
+
+[data-theme="dark"] .dev-toggle input[type="checkbox"] {
+    accent-color: #60a5fa;
+}
--- a/test_logic.js
+++ b/test_logic.js
@@ -101,6 +101,25 @@ try {
        console.log("✅ Static Analysis Passed: 'appendChild(icon)' found.");
    }

+    // Check for GitHub Release Management functions
+    const checks = [
+        [/GITHUB_API/, 'GITHUB_API constant'],
+        [/function\s+fetchVersions/, 'fetchVersions function'],
+        [/function\s+isNewer/, 'isNewer function'],
+        [/function\s+openVersionMenu/, 'openVersionMenu function'],
+        [/kantine_dev_mode/, 'dev-mode localStorage key'],
+        [/function\s+isCacheFresh/, 'isCacheFresh function'],
+        [/limit=5/, 'Delta fetch limit parameter']
+    ];
+
+    for (const [regex, label] of checks) {
+        if (!regex.test(code)) {
+            console.error(`❌ Static Analysis Failed: '${label}' not found.`);
+            process.exit(1);
+        }
+    }
+    console.log("✅ Static Analysis Passed: All GitHub Release Management functions found.");
+
    // Check dynamic logic usage
    // Note: Since we mock fetch to fail for menu data, the app might perform error handling.
    // We just want to ensure it doesn't CRASH (exit code) and that our specific feature logic ran.
--- a/tests/test_dom.js
+++ b/tests/test_dom.js
@@ -0,0 +1,49 @@
+const fs = require('fs');
+const jsdom = require('jsdom');
+const { JSDOM } = jsdom;
+
+const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        .hidden { display: none !important; }
+        .icon-btn { display: inline-flex; }
+    </style>
+</head>
+<body>
+    <button id="alarm-bell" class="icon-btn hidden">
+        <span id="alarm-bell-icon" style="color:var(--text-secondary);"></span>
+    </button>
+</body>
+</html>
+`;
+
+const jsCode = fs.readFileSync('kantine.js', 'utf8').replace('(function () {', '').replace(/}\)\(\);$/, '');
+
+const dom = new JSDOM(html, { runScripts: "dangerously" });
+global.window = dom.window;
+global.document = window.document;
+global.localStorage = { getItem: () => '[]', setItem: () => {} };
+global.sessionStorage = { getItem: () => null };
+
+global.showToast = () => {};
+global.saveFlags = () => {};
+global.renderVisibleWeeks = () => {};
+// Mock missing browser features if needed
+global.Notification = { permission: 'default', requestPermission: () => {} };
+
+try {
+    dom.window.eval(jsCode);
+    console.log("Initial Bell Classes:", window.document.getElementById('alarm-bell').className);
+    
+    // Add flag
+    dom.window.eval("userFlags.add('2026-02-24_123'); updateAlarmBell();");
+    console.log("After Add:", window.document.getElementById('alarm-bell').className);
+    
+    // Remove flag
+    dom.window.eval("userFlags.delete('2026-02-24_123'); updateAlarmBell();");
+    console.log("After Remove:", window.document.getElementById('alarm-bell').className);
+} catch (e) {
+    console.error(e);
+}
--- a/version.txt
+++ b/version.txt
@@ -1 +1 @@
-v1.2.8
+v1.4.14
Author	SHA1	Message	Date
Kantine Wrapper	a0ef6e631e	chore: update build artifacts for v1.4.14	2026-02-24 15:31:48 +01:00
Kantine Wrapper	d895a5fb7c	feat: immediate api refresh on flag, fix timestamp fallback (v1.4.14)	2026-02-24 15:31:48 +01:00
Kantine Wrapper	fd765a74c0	chore: update build artifacts for v1.4.13	2026-02-24 13:24:50 +01:00
Kantine Wrapper	1f184fab8b	fix: replace css variables with direct hex colors for alarm bell	2026-02-24 13:24:09 +01:00
Kantine Wrapper	b6c7c66027	chore: update build artifacts for v1.4.12	2026-02-24 13:20:03 +01:00
Kantine Wrapper	33bb87d7f4	fix: enforce hidden state and default color of alarm bell	2026-02-24 13:19:38 +01:00
Kantine Wrapper	d4a8a47ccd	chore: update build artifacts for v1.4.11	2026-02-24 13:11:09 +01:00
Kantine Wrapper	8e8c93410b	feat: background refresh for version menu	2026-02-24 13:11:02 +01:00
Kantine Wrapper	cca59bcace	chore: update build artifacts for v1.4.10	2026-02-24 13:05:53 +01:00
Kantine Wrapper	432bbcb6f2	build: separate release logic into release.sh	2026-02-24 13:05:46 +01:00
Kantine Wrapper	accdccf897	docs: sync REQUIREMENTS.md with latest features	2026-02-24 13:00:16 +01:00
Kantine Wrapper	7fc8c6f1e0	dist files for v1.4.10 built	2026-02-24 12:59:19 +01:00
Kantine Wrapper	0eb14a1869	dist files for v1.4.9 built	2026-02-24 12:56:53 +01:00
Kantine Wrapper	c841954c5d	dist files for v1.4.8 built	2026-02-24 12:44:07 +01:00
Kantine Wrapper	320c4066f3	dist files for v1.4.7 built	2026-02-24 12:43:35 +01:00
Kantine Wrapper	cda74e65db	dist files for v1.4.7 built	2026-02-24 12:32:44 +01:00
Kantine Wrapper	d1a19b043d	dist files for v1.4.6 built	2026-02-24 11:11:15 +01:00
Kantine Wrapper	8c4de96432	dist files for v1.4.5 built	2026-02-24 10:52:53 +01:00
Kantine Wrapper	ce7d8a3de5	dist files for v1.4.4 built	2026-02-24 10:46:06 +01:00
Kantine Wrapper	0309f488bd	dist files for v1.4.4 built	2026-02-24 10:46:00 +01:00
Kantine Wrapper	d82762430f	dist files for v1.4.3 built	2026-02-24 10:26:59 +01:00
Kantine Wrapper	54e5ada03d	dist files for v1.4.3 built	2026-02-24 08:37:52 +01:00
Kantine Wrapper	136fe7d355	dist files for v1.4.2 built	2026-02-23 08:24:51 +01:00
Kantine Wrapper	f5b3635773	dist files for v1.4.1 built	2026-02-22 22:18:41 +01:00
Kantine Wrapper	bff8669cd7	dist files for v1.4.0 built	2026-02-22 22:14:32 +01:00
Kantine Wrapper	008462e304	dist files for v1.4.0 built	2026-02-22 22:02:09 +01:00
Kantine Wrapper	9237e911d2	dist files for v1.4.0 built	2026-02-22 21:57:53 +01:00
Kantine Wrapper	5bb0e01136	dist files for v1.4.0 built	2026-02-22 21:53:16 +01:00
Kantine Wrapper	f19827ae91	dist files for v1.4.0 built	2026-02-22 21:40:41 +01:00
Kantine Wrapper	4c55e34bc1	dist files for v1.3.2 built	2026-02-19 20:45:18 +01:00
Kantine Wrapper	08ee2a2d0f	dist files for v1.3.1 built	2026-02-17 21:33:09 +01:00
Kantine Wrapper	314728f6d0	dist files for v1.3.1 built	2026-02-17 21:31:25 +01:00
Kantine Wrapper	ea4e0d151f	dist files for v1.3.1 built	2026-02-17 21:25:55 +01:00
Kantine Wrapper	b928b90728	dist files for v1.3.1 built	2026-02-17 21:17:40 +01:00
Kantine Wrapper	9b1f0e2fd3	v1.3.1: Smart Cache vereinfacht (KW-Check + 1h Alter), Build-Script auto-commit+push	2026-02-17 21:17:34 +01:00
Kantine Wrapper	05bc06660c	docs: Add warning about force-pushing when moving an existing git tag.	2026-02-17 21:04:11 +01:00
Kantine Wrapper	20957c3582	chore: corrected README	2026-02-17 20:49:28 +01:00
Michael Kaufmann	fe86e68aca	v1.3.1: Smart Cache Strategy + REQUIREMENTS.md überarbeitet - Feature: isCacheFresh() – initialer API-Refresh nur wenn Cache >1h alt oder <5 Arbeitstage abgedeckt (FR-024) - REQUIREMENTS.md komplett überarbeitet: lösungsneutral, alle Features dokumentiert, Versions-Spalte - Build-Script: Git-Tag wird bei Rebuild auf aktuellen Commit verschoben (git tag -f) - Neue Regel 7: Requirements-Konsistenz im Implementation Plan - test_logic.js: statischer Check für isCacheFresh	2026-02-17 20:38:53 +01:00
Michael Kaufmann	4dbd6c930f	feat: Expand and refine the system's purpose, scope, and functional/non-functional requirements, adding new categories like smart highlights and update management.	2026-02-17 18:06:57 +01:00
Michael Kaufmann	ad4cfaf4ec	feat: GitHub Release Management v1.3.0 - Version menu, dev-mode, downgrade support	2026-02-16 23:39:41 +01:00
Michael Kaufmann	441198dd8d	fix(update): use semver check to prevent update icon on dev/newer versions	2026-02-16 23:19:41 +01:00