Bilder: der Cache-Brecher haengt am Foto statt an der Startzeit

Beide Oberflaechen haengten Date.now() an jede Bildadresse - richtig
gegen ein veraltetes Foto (31 Tage Cache-Vorgabe unter /local/), aber die
Adresse aendert sich damit bei JEDEM Start, der Zwischenspeicher greift
zwischen zwei Starts also nie. Mit dem Vorladen waeren das 5,3 MB je
Start gewesen.

bilder.staende() liefert jetzt den Zeitstempel je Datei, veroeffentlicht
an sensor.audi_dashboard_app_version; eine Bildadresse aendert sich damit
genau dann, wenn das Foto ein anderes ist. Ein fehlendes Foto bekommt 0
(dann loest sich auch ein gespeicherter 404 von selbst auf), ein Backend
ohne Staende faellt auf das bisherige Verhalten zurueck, und Upload wie
Loeschen veroeffentlichen sofort neu.

Die App merkt sich den letzten Stand im Browserspeicher: sie malt ihren
ersten Bildschirm, bevor die Versionsangabe eintrifft - ohne das
Gedaechtnis trug genau dieser Durchlauf noch die Startzeit und holte das
Uebersichtsfoto doch wieder bei jedem Start.

Live gemessen: Neuladen ohne Aenderung 5.328.771 Bytes Inhalt bei 0 Bytes
uebertragen; ein per touch geaendertes Foto wird neu geholt (513.403
Bytes), die anderen nicht; App-Start ohne eine einzige Adresse mit
Startzeit.

Co-Authored-By: Claude Opus 5 <[email protected]>

custom_components/audi_dashboard/frontend/audi-dashboard-app.js

@@ -365,11 +365,33 @@ const BILDER = [
 const GALERIE = BILDER.filter((b) => !b.nurStatus);
 let bild = 0;
 const SEITE_WINTER = { label: "Auto Seite mit Winterrädern", datei: "seitenansicht-winter.webp" };
-// Bei jedem Hochladen/Löschen eines Fahrzeugfotos hochgezählt und als
-// Query-Parameter an alle bilder/-URLs gehängt (siehe bildInfo()
-// unten) - ohne das würde der Browser nach einem Upload weiter das alte Bild
-// oder den zwischenzeitlich gecachten 404 unter derselben URL zeigen.
+/* Der Stand eines Fahrzeugfotos, als Anhaengsel an seiner Adresse.
+
+   Home Assistant liefert /local/ mit 31 Tagen Cache-Vorgabe aus; ohne
+   wechselndes Anhaengsel zeigt der Browser nach einem Upload weiter das alte
+   Bild oder den zwischenzeitlich gespeicherten 404.
+
+   Bis zum 04.09.2026 stand hier `Date.now()` - eine Adresse, die sich bei
+   JEDEM Start aendert. Der Zwischenspeicher griff damit zwischen zwei Starts
+   nie, und mit dem Vorladen aller Fotos waeren das 5,3 MB je Start gewesen.
+   Jetzt kommt der Zeitstempel jeder Datei vom Backend (bilder.staende(),
+   veroeffentlicht an sensor.audi_dashboard_app_version): er aendert sich
+   genau dann, wenn das Foto wirklich ein anderes ist.
+
+   bildVersion bleibt als Rueckfall fuer ein Backend, das die Staende noch
+   nicht mitliefert - dann ist das Verhalten wie zuvor. */
+let BILD_STAENDE = null;
 let bildVersion = Date.now();
+function bildStand(datei) {
+  if (!BILD_STAENDE) return bildVersion;
+  // 0 heisst: dieses Foto gibt es nicht. Sobald es hochgeladen wird,
+  // aendert sich die Adresse von selbst - auch ein gespeicherter 404
+  // loest sich damit auf.
+  return BILD_STAENDE[datei] ?? 0;
+}
+function bildAdresse(datei) {
+  return `/local/bilder/${datei}?v=${bildStand(datei)}`;
+}
 
 /* Platzhalter statt kaputtem Bild-Symbol: bei Ladefehler (Bilder aus §7a
    noch nicht vorhanden) wird die Bildfläche durch ein generisches Symbol
@@ -499,9 +521,9 @@ async function bildVerkleinern(datei) {
 function bildInfo(i) {
   const b = BILDER[i];
   if (b.name === "Seitenansicht" && CAR.reifen.aktiv === "Winter") {
-    return { label: SEITE_WINTER.label, datei: SEITE_WINTER.datei, src: `/local/bilder/${SEITE_WINTER.datei}?v=${bildVersion}` };
+    return { label: SEITE_WINTER.label, datei: SEITE_WINTER.datei, src: bildAdresse(SEITE_WINTER.datei) };
   }
-  return { label: b.label, datei: b.datei, src: `/local/bilder/${b.datei}?v=${bildVersion}` };
+  return { label: b.label, datei: b.datei, src: bildAdresse(b.datei) };
 }
 /* Alle Fahrzeugfotos einmal vorab holen UND dekodieren.
 
@@ -516,12 +538,17 @@ function bildInfo(i) {
    konkurriert, und nur einmal je Bildstand. */
 let bilderVorgeladen = null;
 function bilderVorladen() {
-  if (bilderVorgeladen === bildVersion) return;
-  bilderVorgeladen = bildVersion;
+  const dateien = [...BILDER.map((b) => b.datei), SEITE_WINTER.datei];
+  // Kennung ueber alle Staende: solange sich kein Foto geaendert hat,
+  // laeuft das Vorladen kein zweites Mal - und der Browser holt die Bilder
+  // beim naechsten Start aus seinem eigenen Zwischenspeicher.
+  const kennung = dateien.map(bildStand).join(",");
+  if (bilderVorgeladen === kennung) return;
+  bilderVorgeladen = kennung;
   const starten = () => {
-    for (const datei of [...BILDER.map((b) => b.datei), SEITE_WINTER.datei]) {
+    for (const datei of dateien) {
       const img = new Image();
-      img.src = `/local/bilder/${datei}?v=${bildVersion}`;
+      img.src = bildAdresse(datei);
       // Ein nicht hochgeladenes Foto ist der Normalfall - still schlucken.
       if (img.decode) img.decode().catch(() => {});
     }
@@ -2181,7 +2208,7 @@ function vSicherheit() {
   /* C6: Draufsicht oben, grüne Sammelmeldung, dann die vier Sammelzeilen -
      dieselbe Reihenfolge wie der Fahrzeugstatus in der myAudi-App. */
   return `
-  <div class="szene bleed schmal"><div class="carbox">${bildMitPlatzhalter(`/local/bilder/draufsicht.webp?v=${bildVersion}`, "draufsicht.webp", "Draufsicht", "carfix klein")}</div></div>
+  <div class="szene bleed schmal"><div class="carbox">${bildMitPlatzhalter(bildAdresse("draufsicht.webp"), "draufsicht.webp", "Draufsicht", "carfix klein")}</div></div>
   <div class="tile" style="display:flex;align-items:center;gap:12px;padding:16px 20px">
     ${statusKreis(g)}
     <span style="font-size:15px;color:var(--fg)">${esc(sammelText)}</span>
@@ -3842,7 +3869,7 @@ function vReifen() {
           </div>
         </div>
         <div data-bildklick="${radDatei}">
-          ${bildMitPlatzhalter(`/local/bilder/${radDatei}?v=${bildVersion}`, radDatei, radLabel, "radbild")}
+          ${bildMitPlatzhalter(bildAdresse(radDatei), radDatei, radLabel, "radbild")}
         </div>
       </div>
       ${kmOffen === k ? `
@@ -6786,6 +6813,9 @@ async function datenLaden(erzwingen) {
     LETZTER_DATENSATZ = versionState.attributes.daten
       ? versionState.attributes.daten.letzter_datensatz ?? null
       : null;
+    BILD_STAENDE = versionState.attributes.daten
+      ? versionState.attributes.daten.bildstaende ?? null
+      : null;
   }
   if (entitaetenState && entitaetenState.attributes) ENTITAETEN = entitaetenState.attributes.daten;