Files
dogfather-universe/webdesign/sw.js
T
DogFatherGitandClaude Opus 5 e495542fe5 Typografie: Lesebreite begrenzt -- 105 zu breite Absaetze behoben
Gemessen ueber alle Seiten: 105 von 200 Textabsaetzen waren zu breit,
der schlimmste mit 151 Zeichen pro Zeile.

WARUM DAS ZAEHLT

Beim Zeilensprung muss das Auge zurueck an den Zeilenanfang finden. Je
laenger die Zeile, desto haeufiger landet es in der falschen -- man
liest eine Zeile doppelt oder ueberspringt eine und merkt es erst zwei
Saetze spaeter. Der Text ist dann nicht "schwer", er ist schlecht
gesetzt.

Bewaehrt sind 45 bis 75 Zeichen. Das ist der aelteste und
bestbelegte Grundsatz der Typografie ueberhaupt -- jedes ordentlich
gesetzte Buch haelt sich daran.

Jetzt 68 Zeichen fuer Fliesstext, 60 fuer Kleingedrucktes. Die Einheit
ist ch statt Pixel: Damit haengt die Breite an der SCHRIFTGROESSE.
Kleingedrucktes bekommt automatisch einen schmaleren Block, grosse
Schrift einen breiteren -- beide landen bei aehnlich vielen Zeichen.

max-width macht nie etwas breiter. In schmalen Karten und Spalten
aendert sich also nichts; die Regel greift nur dort, wo eine Zeile
wirklich ueber das Lesbare hinauswaechst. Ergebnis: von 105 auf 0.

DREI FEHLER BEIM EINBAU, ALLE VON DER MESSUNG GEFUNDEN

1. Zentrierter Text stand ploetzlich links. Eine Breitenbegrenzung
   zentriert den KASTEN nicht mit -- die Schrift war mittig, ihr Kasten
   klebte am linken Rand, mit 384 Pixeln Luft rechts und null links.
   Gefunden, weil die Pruefung den Abstand links mit dem rechts
   VERGLEICHT, statt nur zu zaehlen, ob zentriert ist.

2. Meine erste Regel deckte nur den Fall ab, dass das ELTERNELEMENT
   zentriert -- nicht den, dass der Absatz es selbst tut.

3. Und dann blieb einer uebrig, bei dem beides stimmte. Ursache: ein
   Inline-Stil "margin:1.2rem 0 0". Die Kurzschreibweise setzt links und
   rechts hart auf 0 und schlaegt jede Stilvorlage. 11 solche Stellen
   ueber fuenf Seiten auf margin-top umgestellt -- gemeint war ohnehin
   immer nur der Abstand nach oben.

Ausnahmen bewusst gesetzt: Nachrichtenblasen tragen ihre Breite schon
selbst, Tabellenzellen und Beschreibungslisten richten sich nach ihrer
Spalte, die Fusszeile ist mehrspaltig und ohnehin schmal.

ALLES GRUEN: Gestaltung 0 Befunde, Designsystem 5, Verwaltung 69,
Portal 32, Widerruf 58, Anfragedetail 20.

Versionsstempel und Cache auf v18.

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-08-23 18:47:34 +02:00

192 lines
7.9 KiB
JavaScript

/* =====================================================================
sw.js — Service Worker NUR für /webdesign/
Macht den Bereich auf Handy und Computer als App installierbar und
sorgt dafür, dass die Oberfläche auch bei wackeliger Verbindung
sofort da ist.
⚠️ SICHERHEITSENTSCHEIDUNG, DIE HIER DEN AUSSCHLAG GIBT
Der Webdesign-Bereich ist zugangsgeschützt (server/webdesign-gate.js).
Ein Service Worker, der HTML-Seiten zwischenspeichert, würde diesen
Schutz aushebeln: Nach dem Abmelden — oder nachdem jemand anders das
Gerät in die Hand nimmt — lieferte der Zwischenspeicher die geschützten
Seiten samt Preisen, Anfragen und Kundendaten weiterhin aus, ohne dass
der Server je gefragt wird. Genau das ist der klassische Fehler bei
PWAs hinter einer Anmeldung.
Deshalb gilt hier strikt:
- HTML-Seiten werden NIEMALS zwischengespeichert. Immer Netz.
Ist kein Netz da, kommt eine schlichte Offline-Meldung — nicht die
zuletzt gesehene, möglicherweise vertrauliche Seite.
- Zwischengespeichert werden ausschließlich die neutralen Bausteine
unter /assets/ (Stilvorlagen, Skripte, Logo, Icons). Die enthalten
keine Kunden- oder Projektdaten und liegen ohnehin außerhalb der
Zugangsschranke.
- Antworten der API (postfach.dogfather-universe.com) werden
ebenfalls nie zwischengespeichert.
Das kostet Offline-Komfort. Der ist hier aber weniger wert als die
Zusicherung, dass nach dem Schließen der Sitzung wirklich nichts mehr
einsehbar ist.
===================================================================== */
/* Version im Namen: eine Änderung dieser Zeichenkette wirft beim nächsten
Start alle alten Zwischenspeicher weg. Muss bei jeder Änderung an den
Dateien unten hochgezählt werden, sonst hängen Nutzer auf einem alten
Stand fest. */
const CACHE_NAME = "dogfather-webdesign-v18";
/* Bausteine, die die Oberfläche zum Anzeigen braucht. Bewusst KEINE
HTML-Datei in dieser Liste. */
const GRUNDGERUEST = [
"/assets/css/main.css",
"/assets/css/webdesign.css",
"/assets/js/wd-core.js",
"/assets/img/logo-dogfather-transparent.png",
"/assets/img/wd-app-192.png",
"/assets/img/wd-app-512.png",
];
self.addEventListener("install", (ereignis) => {
ereignis.waitUntil(
caches.open(CACHE_NAME).then((speicher) =>
/* addAll bricht komplett ab, wenn EINE Datei fehlt — dann wäre der
Service Worker gar nicht erst installiert und die App nicht
installierbar. Deshalb jede Datei einzeln und Fehler schlucken. */
Promise.all(
GRUNDGERUEST.map((pfad) =>
speicher.add(new Request(pfad, { cache: "reload" })).catch(() => {})
)
)
)
);
/* Sofort übernehmen statt auf das Schließen aller Tabs zu warten —
sonst bleibt nach einem Deploy tagelang die alte Fassung aktiv. */
self.skipWaiting();
});
self.addEventListener("activate", (ereignis) => {
ereignis.waitUntil(
caches.keys()
.then((namen) => Promise.all(
namen.filter((n) => n !== CACHE_NAME).map((n) => caches.delete(n))
))
.then(() => self.clients.claim())
);
});
/* Schlichte Offline-Meldung. Bewusst als erzeugte Antwort statt als
Datei — so kann sie nie mit echtem Seiteninhalt verwechselt werden.
Fünf Sprachen wären hier Überinstrumentierung: der Text erscheint nur
ohne Internet und ist absichtlich sehr kurz gehalten. */
function offlineSeite() {
return new Response(
`<!DOCTYPE html><html lang="de"><head><meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Keine Verbindung</title>
<style>
body{margin:0;min-height:100svh;display:flex;align-items:center;justify-content:center;
background:#05070b;color:#eef4fb;font-family:system-ui,sans-serif;text-align:center;padding:2rem}
.k{max-width:34ch}
h1{font-size:1.4rem;margin:0 0 .6rem}
p{color:#b3c2d4;line-height:1.6;margin:0 0 1.4rem}
button{min-height:48px;padding:.8rem 1.6rem;border:none;border-radius:999px;
background:#7fd0e8;color:#04070c;font-weight:700;font-size:1rem;cursor:pointer}
</style></head><body>
<div class="k">
<h1>Keine Verbindung</h1>
<p>Dogfather Webdesign braucht eine Internetverbindung. Sobald du wieder online bist, geht es normal weiter.</p>
<button onclick="location.reload()">Erneut versuchen</button>
</div></body></html>`,
{ status: 503, headers: { "Content-Type": "text/html; charset=utf-8" } }
);
}
self.addEventListener("fetch", (ereignis) => {
const anfrage = ereignis.request;
// Nur einfache Abrufe. Absendungen (POST) gehen immer direkt ans Netz.
if (anfrage.method !== "GET") return;
const url = new URL(anfrage.url);
// Fremde Server (API, externe Bilder) nie anfassen.
if (url.origin !== self.location.origin) return;
/* --- HTML: immer Netz, niemals zwischenspeichern (siehe Kopf) --- */
const willHtml = anfrage.mode === "navigate" ||
(anfrage.headers.get("accept") || "").includes("text/html");
if (willHtml) {
ereignis.respondWith(
fetch(anfrage).catch(() => offlineSeite())
);
return;
}
/* --- Zugangs-Endpunkte niemals zwischenspeichern --- */
if (url.pathname.startsWith("/webdesign/zugang-")) return;
/* --- Neutrale Bausteine unter /assets/ ---
⚠️ HIER WAR EIN ECHTER FEHLER (gemeldet 22.08.2026: "immer noch so").
Vorher lief das als "stale-while-revalidate": die gespeicherte Fassung
ging sofort raus, im Hintergrund wurde eine frische geholt. Das ist
schnell — bedeutet aber, dass jede Korrektur an CSS oder JavaScript
beim ersten Aufruf UNSICHTBAR bleibt und erst beim zweiten wirkt.
Genau das ist passiert: die Korrektur am gestreckten Logo war auf dem
Server längst live, der Browser hat aber die alte Stilvorlage aus
meinem eigenen Zwischenspeicher angezeigt. Ein Fehler, der wie ein
nicht behobener Fehler aussieht — die unangenehmste Sorte.
Jetzt: erst Netz, Zwischenspeicher nur als Notfallnetz.
Für Stilvorlagen und Skripte ist Richtigkeit wichtiger als die
eingesparten Millisekunden — eine falsche Darstellung kostet mehr
als ein kurzer Ladevorgang. Bilder und Symbole bleiben beim schnellen
Weg: die ändern sich praktisch nie, und wenn doch, bekommen sie einen
neuen Dateinamen. */
if (url.pathname.startsWith("/assets/")) {
const istCodeOderStil = /\.(css|js|mjs)$/i.test(url.pathname);
if (istCodeOderStil) {
// Netz zuerst
ereignis.respondWith(
fetch(anfrage)
.then((antwort) => {
if (antwort && antwort.status === 200 && antwort.type === "basic") {
const kopie = antwort.clone();
caches.open(CACHE_NAME).then((speicher) => speicher.put(anfrage, kopie));
}
return antwort;
})
.catch(() => caches.match(anfrage).then((g) => g || Response.error()))
);
return;
}
// Bilder, Symbole, Schriften: Zwischenspeicher zuerst
ereignis.respondWith(
caches.open(CACHE_NAME).then(async (speicher) => {
const gespeichert = await speicher.match(anfrage);
const ausDemNetz = fetch(anfrage)
.then((antwort) => {
/* Nur vollständige, eigene Antworten ablegen. Teilantworten
(206, z.B. bei Video-Sprüngen) lassen sich nicht sinnvoll
zwischenspeichern und würden den Speicher beschädigen. */
if (antwort && antwort.status === 200 && antwort.type === "basic") {
speicher.put(anfrage, antwort.clone());
}
return antwort;
})
.catch(() => null);
return gespeichert || (await ausDemNetz) || Response.error();
})
);
return;
}
/* Alles Übrige: kein respondWith -> der Browser macht es ganz normal
selbst. Das ist die sicherste Voreinstellung. */
});