Excel-Dateien werden gelesen -- und drei Fallen dahinter entschaerft

Filipe: "mach doch bitte so dass man alle dateien hoch laden könne auch
excel dateien. gib gas und krieg das hin."

server/workspace-xlsx.js liest .xlsx mit Bordmitteln: Eine .xlsx ist ein
ZIP mit XML darin, und Node kann beides (`zlib.inflateRawSync`). Kein
zusaetzliches Paket fuer eine Datei mit neun Zeilen.

GEMESSEN AN ZWEI ECHTEN BACKSTAGE-AUSGABEN vom 11. und 12.09.2026, die
auf dem Rechner lagen -- nicht an der Dokumentation. Sie haben mir an
drei Stellen widersprochen, und JEDE davon waere sonst ein stiller
Fehler geworden:

1. DER ZEITRAUM. In "Datenzeitraum" steht `2026-09-01 ~ 2026-09-11`.
   `datumLesen` griff sich davon den ersten Tag -- elf Tage Diamanten
   waeren auf den 1. September gebucht worden. Die Zahl steht da, sie
   ist gross, sie sieht richtig aus, und niemand kann spaeter sagen,
   dass elf Tage darin stecken. Neu: `zeitraumLesen`; eine Zeile mit
   einem Zeitraum ueber mehrere Tage wird abgelehnt UND begruendet
   ("Stell in Backstage den Zeitraum auf EINEN Tag"). Ein Zeitraum von
   einem Tag geht durch.

2. DIE EINHEIT. "LIVE-Dauer" enthaelt `86Std. 10Min. 52Sek.`.
   `zahlLesen` ergab daraus `null` -- die Dauer fiel weg. Bei einem
   anderen Trennzeichen waere es schlimmer gewesen: 86 statt 5171,
   Faktor 60 daneben und plausibel. Neu: `dauerLesen`, versteht die
   deutsche und englische Schreibweise, die Uhrzeitform und weiterhin
   die blosse Zahl.

3. DIE DATUMSSPALTE. `/datum|date|tag|day/i` erklaerte "Tage seit dem
   Beitritt" zur Datumsspalte (Wert "65") und traf in der
   Leistungstabelle "Gueltige LIVE-Gehen-Tage" genauso. Jetzt nur noch
   als ganzes Wort, dafuer mit "zeitraum" -- Backstages Spalte wurde
   bisher nur zufaellig gefunden, weil in "Daten" die Silbe "date"
   steckt.

Gefunden hat das keine Ueberlegung, sondern der ganze Weg einmal mit
der echten Datei durchlaufen.

WEITER GEBAUT:
- Titelzeilen werden uebersprungen: "Creator:innen verwalten" hat in
  Zeile 1 nur "Exportiert am :…", die Ueberschriften stehen darunter.
  Die Regel misst (drei gefuellte Felder UND halb so breit wie die
  breiteste Zeile), statt eine feste Zahl zu nehmen.
- Fehlende Zellen verschieben nichts: Eine leere Zelle steht in der
  Datei gar nicht; wer der Reihe nach liest, verrutscht ab dort jede
  Spalte, und die Zeile sieht voll aus.
- Datums-Seriennummern werden nur umgerechnet, wenn das FORMAT es sagt
  (sonst stuende 46271 in der Vorschau). Der Nullpunkt ist an zwei
  nachschlagbaren Werten festgenagelt.
- Der Backstage-Dialog nimmt die Datei jetzt AUCH -- dort gehoert sie
  hin, denn Filipes Ausgabe enthaelt alle Creator auf einmal. Sie fuellt
  das Einfuegefeld; ab da laeuft derselbe Weg wie beim Einfuegen. Keine
  zweite Fassung derselben Regeln.
- Die alte .xls (BIFF, kein ZIP) wird erkannt und bekommt einen Weg
  gezeigt, statt "ging nicht" zu sagen.

NEU: pruef-xlsx.mjs (60) -- baut seine Dateien selbst (ZIP-Schreiber in
helfer-xlsx-bauen.mjs), damit keine Creator-Daten ins Repo wandern und
auch Faelle pruefbar sind, die es als Datei nicht gibt: kaputtes
Verzeichnis, fehlendes Blatt, abgeschnittene Datei. Jeder davon mit
Gegenprobe, dass die heile Datei durchgeht.

pruef-backstage-import 77 -> 82, dabei zwei Pruefungen GEDREHT: Die
.xlsx bekommt keine Absage mehr, sondern eine Vorschau.

DREI EIGENE FEHLER DABEI, alle von einer Messung gefunden:
- Ich hielt Seriennummer 46264 fuer den 06.09.; es ist der 30.08. Der
  Code hatte recht. Deshalb stehen jetzt zwei nachschlagbare Anker drin.
- Eine Zeile war gruen, weil mein Muster den SPALTENNAMEN
  "Datenzeitraum" traf statt der Begruendung. Jetzt wird auf den Text
  der Ablehnung geprueft.
- Beim Umbau habe ich pruef-backstage-import beschaedigt (ein
  Suchtreffer weiter oben als gemeint) und aus Git zurueckgeholt.

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

server/pruef-backstage-import.mjs

@@ -34,6 +34,7 @@ import { notbremse } from "./helfer-notbremse.mjs";
 notbremse(240_000, "pruef-backstage-import");
 
 const HIER = dirname(fileURLToPath(import.meta.url));
+const { xlsxBauen } = await import("./helfer-xlsx-bauen.mjs");
 const PORT = 4389;
 const BASIS = `http://127.0.0.1:${PORT}`;
 const ordner = mkdtempSync(join(tmpdir(), "ws-backstage-"));
@@ -455,6 +456,63 @@ console.log("\n=== Die Seite ===");
       { path: join(HIER, "pruef-netz-leer.png") });
   }
 
+  /* ---- DIE BACKSTAGE-AUSGABE ALS DATEI (14.09.2026) ---------------
+     Filipes echte Ausgabe ("Creator:innendaten …xlsx") enthaelt ALLE
+     Creator auf einmal -- sie gehoert hierher und nicht in den
+     Einzel-Import. Nachgebaut wird ihre Form, inklusive der Titelzeile,
+     die "Creator:innen verwalten" ueber die Tabelle setzt. */
+  const netzDatei = xlsxBauen([
+    ["Exportiert am :2026-09-11 13:10:35"],
+    ["Datenzeitraum", "Creator*innen-Anmeldename", "Diamanten", "LIVE-Dauer"],
+    [`${gestern} ~ ${gestern}`, "nova_live", "12.480", "3Std. 4Min."],
+    [`${gestern} ~ ${gestern}`, "Kiro", "3.900", "1Std. 35Min."],
+  ]);
+  await seite.setInputFiles("#netz-datei", {
+    name: "Creator_innendaten.xlsx",
+    mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    buffer: netzDatei,
+  });
+  await seite.waitForTimeout(1800);
+  const ausDatei = await seite.evaluate(() => ({
+    feld: document.getElementById("netz-text")?.value || "",
+    fehler: document.getElementById("netz-fehler")?.textContent || "",
+    vorschau: document.getElementById("netz-vorschau")?.hidden,
+    text: document.getElementById("netz-vorschau")?.textContent || "",
+  }));
+  ok(ausDatei.fehler === "", `die Datei wird angenommen ("${ausDatei.fehler.slice(0, 40)}")`);
+  ok(ausDatei.feld.includes("nova_live") && ausDatei.feld.includes("Datenzeitraum"),
+    "das Einfuegefeld ist danach gefuellt -- ab da derselbe Weg wie beim Einfuegen");
+  ok(!ausDatei.feld.startsWith("Exportiert am"),
+    "die Titelzeile ist weg, die Ueberschrift steht oben");
+  ok(ausDatei.vorschau === false && /zugeordnet/.test(ausDatei.text),
+    `und die Vorschau erscheint von selbst ("${ausDatei.text.slice(0, 45)}…")`);
+
+  /* DER TEUERSTE FALL, gemessen statt vermutet: Ein ZEITRAUM ueber
+     mehrere Tage darf NICHT auf einen Tag geschrieben werden. Genau das
+     steht in Filipes echter Datei (2026-09-01 ~ 2026-09-11), und genau
+     das haette `datumLesen` stillschweigend auf den 1. September
+     gebucht -- elf Tage Diamanten, plausibel und falsch. */
+  const zeitraumDatei = xlsxBauen([
+    ["Datenzeitraum", "Creator*innen-Anmeldename", "Diamanten"],
+    ["2026-09-01 ~ 2026-09-11", "nova_live", "53.679"],
+  ]);
+  await seite.setInputFiles("#netz-datei", {
+    name: "zeitraum.xlsx",
+    mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    buffer: zeitraumDatei,
+  });
+  await seite.waitForTimeout(1800);
+  const spanne = await seite.evaluate(() =>
+    document.getElementById("netz-vorschau")?.textContent || "");
+  ok(spanne.includes("mehrere Tage") && spanne.includes("2026-09-01"),
+    `ein Zeitraum ueber mehrere Tage wird abgelehnt und BEGRUENDET ("${spanne.slice(0, 90)}…")`);
+  ok(!/1 von 1 Zeilen zugeordnet/.test(spanne),
+    "und die Zeile wird NICHT als zugeordnet gezaehlt");
+  if (process.env.SCHIRM) {
+    await seite.locator("#netz-dialog").screenshot(
+      { path: join(HIER, "pruef-netz-zeitraum.png") });
+  }
+
   await seite.click("#netz-zu");
   await seite.waitForTimeout(300);
   /* Gemessen wird SATZ FUER SATZ, nicht der Block. Ein Block, der
@@ -466,61 +524,69 @@ console.log("\n=== Die Seite ===");
   ok(/Backstage/.test(netzSatz),
     "unter den Knöpfen steht dauerhaft, woher die Zahlen kommen");
 
-  /* ---- EINE EXCEL-DATEI IST EINE SACKGASSE MIT WEGWEISER ----------
-     Filipe: "meine excel datei kann ich nicht auswaehlen wieso??"
+  /* ---- EINE EXCEL-DATEI WIRD GELESEN (14.09.2026) -----------------
+     Filipe: "mach doch bitte so dass man alle dateien hoch laden könne
+     auch excel dateien. gib gas und krieg das hin."
 
-     Sie liess sich nicht einmal AUSWAEHLEN -- ausgegraut, ohne ein
-     Wort dazu. Jetzt laesst sie sich waehlen und bekommt eine Antwort,
-     die weiterhilft.
+     HIER STAND DAS GEGENTEIL, und es war richtig: Am 11.09. bekam eine
+     .xlsx eine Absage mit Wegweiser ("nimm den Knopf daneben"). Seit
+     heute wird sie gelesen -- die Pruefung wurde deshalb GEDREHT, nicht
+     geloescht.
 
-     GEPRUEFT WIRD AN EINEM ECHTEN ZIP-KOPF ("PK"), denn genau das ist
-     eine .xlsx. Die Erkennung haengt am INHALT, nicht an der Endung --
-     deshalb heisst die Testdatei hier bewusst ".xlsx" UND traegt den
-     richtigen Kopf; eine Pruefung ueber die Endung waere gruen, ohne
-     die Erkennung je zu beruehren. */
+     GEBAUT WIRD EINE ECHTE DATEI, kein Stueck Text mit ZIP-Anfang. Der
+     erste Entwurf schickte zehn Bytes "PK…" und war gruen, weil der
+     Server "ZIP-Ende fehlt" meldete -- das haette auch bei kaputtem
+     Leser gestimmt. */
+  const xlsxDatei = xlsxBauen([
+    ["Datum", "Creator", "Diamanten", "LIVE-Dauer"],
+    [gestern, "@Nova_Live", "12.480", "3Std. 4Min."],
+    [gestern, "Kiro", "3.900", "1Std. 35Min."],
+  ]);
   await seite.click("#import-oeffnen");
   await seite.waitForTimeout(300);
   await seite.setInputFiles("#datei", {
     name: "backstage.xlsx",
     mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-    buffer: Buffer.from([0x50, 0x4b, 0x03, 0x04, 0x14, 0x00, 0x06, 0x00, 0x08, 0x00]),
+    buffer: xlsxDatei,
   });
-  await seite.waitForTimeout(600);
+  await seite.waitForTimeout(1500);
   const xlsx = await seite.evaluate(() => ({
-    text: document.getElementById("import-fehler")?.textContent || "",
+    fehler: document.getElementById("import-fehler")?.textContent || "",
     vorschau: document.getElementById("vorschau")?.hidden,
-    los: document.getElementById("import-los")?.disabled,
-    feld: document.getElementById("datei")?.value || "",
+    text: document.getElementById("vorschau")?.textContent || "",
   }));
-  ok(/Excel/.test(xlsx.text), `es steht da, dass es eine Excel-Datei ist (${xlsx.text.slice(0, 50)}…)`);
-  ok(/Backstage-Tabelle einfügen/.test(xlsx.text),
-    "und welcher Knopf stattdessen hilft");
-  ok(/CSV/.test(xlsx.text), "und wie man sie umspeichert");
-  ok(xlsx.vorschau === true && xlsx.los === true,
-    "es entsteht KEINE Vorschau und der Übernehmen-Knopf bleibt gesperrt");
-  ok(xlsx.feld === "",
-    "und das Feld ist wieder leer -- eine Datei, die nicht geht, bleibt nicht stehen");
-  if (process.env.SCHIRM) {
-    await seite.locator("#import-dialog").screenshot(
-      { path: join(HIER, "pruef-import-excel.png") });
-  }
+  ok(xlsx.fehler === "",
+    `die Excel-Datei wird ohne Absage gelesen ("${xlsx.fehler.slice(0, 50)}")`);
+  ok(xlsx.vorschau === false, "und es entsteht eine Vorschau");
+  ok(xlsx.text.includes("Diamanten") && xlsx.text.includes("LIVE-Dauer"),
+    `die Vorschau nennt die erkannten Spalten ("${xlsx.text.slice(0, 55)}…")`);
 
-  /* GEGENPROBE: Eine echte Text-Tabelle geht durch denselben Weg
-     weiterhin hindurch. Sonst hiesse das oben nur, dass gar nichts
-     mehr eingelesen wird. */
+  /* DIE ALTE .xls IST ETWAS ANDERES -- kein ZIP, sondern BIFF. Sie
+     bekommt weiterhin eine Absage, und die muss WEITERHELFEN. */
+  await seite.setInputFiles("#datei", {
+    name: "alt.xls",
+    mimeType: "application/vnd.ms-excel",
+    buffer: Buffer.from([0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1, 0, 0, 0, 0]),
+  });
+  await seite.waitForTimeout(700);
+  const altText = await seite.evaluate(() =>
+    document.getElementById("import-fehler")?.textContent || "");
+  ok(altText.includes(".xls") && (altText.includes("xlsx") || altText.includes("CSV")),
+    `eine alte .xls bekommt einen Weg gezeigt ("${altText.slice(0, 55)}…")`);
+
+  /* GEGENPROBE: Eine echte Text-Tabelle geht weiterhin durch. */
   await seite.setInputFiles("#datei", {
     name: "tage.csv",
     mimeType: "text/csv",
-    buffer: Buffer.from(`Datum;Diamanten;LIVE-Dauer (Minuten)
-${gestern};1234;90
-`, "utf8"),
+    buffer: Buffer.from("Datum;Diamanten;LIVE-Dauer (Minuten)" + String.fromCharCode(10)
+      + gestern + ";1234;90" + String.fromCharCode(10), "utf8"),
   });
   await seite.waitForTimeout(900);
   const csv = await seite.evaluate(() => ({
     fehler: document.getElementById("import-fehler")?.textContent || "",
     vorschau: document.getElementById("vorschau")?.hidden,
   }));
-  ok(csv.vorschau === false && !/Excel/.test(csv.fehler),
+  ok(csv.vorschau === false && csv.fehler === "",
     `eine CSV kommt weiterhin durch (Vorschau da: ${csv.vorschau === false})`);
   await seite.click("#import-zu");
   await seite.waitForTimeout(250);