dogfather-universe/workspace/assets/js/holen.js

/* =====================================================================
   holen.js — ein Abruf, und was bei 401 und 404 passiert
   =====================================================================

   ENTSTANDEN AUS EINEM ECHTEN FEHLER (22.09.2026).

   Filipe: „wenn ich auf diese sachen drücke werd ich auf die startseite
   geschickt, scheck das bitte ab." Gemeint waren die Stufen-Knöpfe auf
   der Team-Lage. Nachgestellt im Browser:

       Druck auf „Standard"
       → PUT /workspace/api/teamlage/stufe   404
       → Adresse springt auf /workspace/start.html

   Die Ursache stand in acht Dateien, Zeichen für Zeichen dieselbe:

       if (a.status === 404) { location.assign('/workspace/start.html'); … }

   GEMEINT WAR ETWAS ANDERES ALS GESCHRIEBEN STAND. Die Zeile sollte
   sagen: „Du darfst diese Seite nicht sehen — hier ist der Ausgang."
   Geschrieben stand: „Irgendein Abruf hat 404 geliefert — raus mit
   dir." Eine einzelne Handlung, die nicht klappt, wirft damit den
   Menschen von einer Seite, auf der alles andere in Ordnung ist. Und
   er sieht nicht einmal, was schiefging: Die Meldung wäre auf der
   Seite erschienen, die gerade verschwindet.

   DIE REGEL IST JETZT ENGER, UND ZWAR ABGELEITET STATT GEFLAGGT:
   Ein 404 wirft nur hinaus, solange die Seite noch gar nichts
   bekommen hat — also beim ersten Abruf, mit dem sie sich aufbaut.
   Ab dem Moment, in dem etwas Sinnvolles zurückkam, steht die Seite;
   ein späterer 404 ist die Antwort auf eine Handlung und gehört als
   Satz auf den Bildschirm, nicht als Sprung.

   Eine Kennzeichnung je Aufrufstelle („dieser hier darf rauswerfen")
   wäre die Stelle, die beim nächsten neuen Aufruf vergessen wird.

   WARUM EINE GEMEINSAME DATEI: Es waren acht Kopien. Als die Regel
   sich als falsch herausstellte, hätte man sie achtmal ändern müssen —
   und beim nächsten Mal wieder. Dieselbe Geschichte wie bei
   `.knopf-still`, beim Schalter, bei der Filterleiste, bei
   `.feld-hinweis` und beim Installieren-Knopf.

   401 BLEIBT, WIE ES WAR: Wer abgemeldet ist, kann auf keiner Seite
   irgendetwas tun. Dort ist der Sprung zur Anmeldung die einzige
   sinnvolle Antwort, egal wann er kommt.
   ===================================================================== */
(() => {
  'use strict';

  /* Hat die Seite schon einmal etwas Brauchbares bekommen? Solange
     nicht, ist ein 404 die Auskunft „hierher gehörst du nicht". */
  let stehtSchon = false;

  window.holen = async function holen(pfad, optionen = {}) {
    const a = await fetch(pfad, { credentials: 'same-origin', ...optionen });

    if (a.status === 401) {
      location.assign('/workspace/');
      throw new Error('abgemeldet');
    }

    const art = String(optionen.method || 'GET').toUpperCase();
    if (a.status === 404 && art === 'GET' && !stehtSchon) {
      location.assign('/workspace/start.html');
      throw new Error('nicht erlaubt');
    }

    /* ERST NACH DER PRÜFUNG SETZEN, nicht davor: Sonst gälte schon der
       erste Abruf als „die Seite steht", und der Rauswurf käme nie. */
    if (a.ok) stehtSchon = true;
    return a;
  };

  /* Nur für Prüfungen: den Zustand zurücksetzen, um beide Wege zu
     messen. Im Betrieb ruft das niemand — eine Seite wird geladen und
     fängt dabei von vorn an. */
  window.holen.zuruecksetzen = () => { stehtSchon = false; };
})();