Die Startseite führt die Neuankömmlinge ein

Seit der Inbetriebnahme setzte die Startseite voraus, was gerade nicht hat, wer
sie zum ersten Mal aufruft: geeignete Dateien. Über dem Formular stand die
Tätigkeitsbeschreibung, darunter zwei leere Dateifelder, und wer nie mit
gii-Norm-XML oder einem BGBl-Regelungstext zu tun hatte, konnte das Werkzeug
nicht einmal ausprobieren. Ein zugeklappter Block tritt hinzu, der zwei
durchgerechnete Fälle mit Verweisen auf die amtlichen Fundstellen anbietet.
Zugeklappt kostet er eine Zeile; das Formular bleibt, wo es war.

Angeboten werden ein verkündetes Änderungsgesetz — das UWG nebst dem Dritten
Gesetz zu seiner Änderung (BGBl. 2026 I Nr. 43), neunzehn Befehle an sechs
Normen ohne Rest — und ein Gesetzentwurf — das AGG nebst BT-Drs. 21/6178,
dreiundzwanzig Befehle an vierzehn Normen, einer zur Prüfung markiert. Der
zweite Fall war zunächst als ProdHaftG nebst BT-Drs. 21/4297 gedacht und ist
verworfen: Die Modernisierung löst das Gesetz ab, statt es zu ändern, und ergibt
einen einzigen Befehl an einer einzigen Norm. Ein Beispiel, das nichts zeigt,
ist keines.

Mitausgeliefert wird nichts, und die Seite ruft von sich aus nichts ab; sie
verweist. Die Verweise öffnen ein eigenes Fenster, weil ein im selben Fenster
geöffnetes PDF die bereits gewählten Dateien aus dem Formular nähme. Das
Stilblatt bekommt .einfuehrung im Zuschnitt der übrigen Kästen und keine einzige
neue Farbe, sodass Hell- und Dunkelfassung ohne Zutun stimmen.

Dabei stellte sich heraus, dass gesetze-im-internet.de das Norm-XML gar nicht
als solches ausgibt: Es gibt allein …/<kurz>/xml.zip, der unmittelbare
BJNR….xml-Pfad ist 404. Eine Einführung, die auf die Fundstelle verweist, wäre
ohne Weiteres eine Anleitung zum Entpacken von Hand gewesen. Der Ladepfad nimmt
das Archiv deshalb nun unmittelbar an (ZipAuspacker, vorgeschaltet in
Pipeline.ladeStammgesetz; DateiTyp kennt die Art ZIP). Die Änderungsdokumente
bleiben unberührt — Gesetzblätter und Drucksachen kommen nirgends als Archiv.

Das Format wird von Hand gelesen, und zwar aus einem Grund, der außerhalb der
Browserfassung sinnlos wäre: Von den Archivklassen des JDK trägt dort allein der
Inflater, den InflaterErsatz auf jzlib zurückführt; ZipInputStream, ZipFile und
CRC32 beruhen auf nativen Bindungen, die Web Image nicht kennt. Auch die
Prüfsumme rechnet die Klasse deshalb selbst. Gelesen wird über das
Zentralverzeichnis am Dateiende, nicht über die örtlichen Vorspanne, deren
Größenangaben bei nachgestellten Beschreibern erst hinter den Daten stehen.
Gewählt wird der einzige auf .xml endende Eintrag: Den Gesetzen mit Anlagen legt
die Fundstelle deren Bilddateien mit ins Archiv, es ist also nicht einerlei,
welchen man nimmt. Die ZIP-Signatur wird vor der PDF-Signatur geprüft, weil sie
am ersten Byte verankert ist, während jene ein Vorschaufenster durchsucht — ein
Archiv mit der Zeichenfolge „%PDF-“ in seinen gepackten Daten wäre sonst als PDF
angesprochen worden.

Die Quellenzeile der Synopse nennt weiterhin die angegebene Datei (uwg.zip),
nicht den Eintrag; sie soll den Weg zur Fundstelle zurück beschreiben. Den
Eintragsnamen trägt die ausgepackte Quelle gleichwohl, damit Protokoll und
Ladefehler das Gesetz benennen und nicht seine Verpackung.

Geprüft ist beides gegen die Fundstelle selbst, nicht nur gegen den
Beispielkorpus: 312 Prüfungen laufen durch, darunter acht neue zum Auspacken.
Das unmittelbar bezogene uwg.zip ergibt auf der Befehlszeile mit dem
BGBl-Regelungstext dieselbe Ausfertigung wie die entpackte Fassung — die beiden
unterscheiden sich allein in der Quellenzeile —, und dieselben 19/0/6 ergeben
sich im neu gebauten Wasm-Modul im Browser, ohne eine Beanstandung in der
Konsole. Der Block hält bei 320 Pixeln Breite ohne Überlauf.

Unberührt bleiben pom.xml, deploy/webpaket.sh und die nginx-Vorlage: Da nichts
mitausgeliefert wird, braucht es weder einen zweiten Ressourcen-Block noch neue
MIME-Typen — deren types-Block ersetzt die Zuordnung vollständig und wäre sonst
die Falle gewesen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Change-Id: I5f6566ca89aa5198452b0b29ac5b38da9eb26137

2 files changed, 94 insertions, 2 deletions

diff --git a/src/main/resources/eu/mulk/aendggner/web/index.html b/src/main/resources/eu/mulk/aendggner/web/index.html
index 4bdaa05..56fd88b 100644
--- a/src/main/resources/eu/mulk/aendggner/web/index.html
+++ b/src/main/resources/eu/mulk/aendggner/web/index.html
@@ -34,13 +34,66 @@
       </p>
     </noscript>
 
+    <details class="einfuehrung">
+      <summary>Noch keine Dateien? Zwei Beispiele zum Ausprobieren</summary>
+
+      <p>
+        Das Werkzeug braucht zweierlei: das <strong>Stammgesetz</strong> in seiner geltenden
+        Fassung und das <strong>Änderungsdokument</strong>, das es ändert. Beides liegt bei den
+        amtlichen Stellen bereit.
+      </p>
+
+      <ol>
+        <li>Die beiden Dateien eines Beispiels herunterladen.</li>
+        <li>Sie in die Felder darunter eintragen — das xml.zip so, wie es kommt, ohne Entpacken.</li>
+        <li>„Synopse erzeugen“ drücken.</li>
+      </ol>
+
+      <dl class="beispiele">
+        <dt>Verkündetes Änderungsgesetz — Gesetz gegen den unlauteren Wettbewerb</dt>
+        <dd>
+          Stammgesetz:
+          <a href="https://www.gesetze-im-internet.de/uwg_2004/xml.zip"
+             target="_blank" rel="noopener noreferrer">UWG (xml.zip, 22 KB)</a><br>
+          Änderung:
+          <a href="https://www.recht.bund.de/bgbl/1/2026/43/regelungstext.pdf?__blob=publicationFile&amp;v=1"
+             target="_blank" rel="noopener noreferrer">Drittes Gesetz zur Änderung des UWG,
+            BGBl. 2026 I Nr. 43 (PDF, 0,3 MB)</a><br>
+          <span class="hint">19 Befehle an 6 Normen, nichts manuell zu prüfen.</span>
+        </dd>
+
+        <dt>Gesetzentwurf — Allgemeines Gleichbehandlungsgesetz</dt>
+        <dd>
+          Stammgesetz:
+          <a href="https://www.gesetze-im-internet.de/agg/xml.zip"
+             target="_blank" rel="noopener noreferrer">AGG (xml.zip, 14 KB)</a><br>
+          Änderung:
+          <a href="https://dserver.bundestag.de/btd/21/061/2106178.pdf"
+             target="_blank" rel="noopener noreferrer">Zweites Gesetz zur Änderung des AGG,
+            BT-Drs. 21/6178 (PDF, 0,5 MB)</a><br>
+          <span class="hint">
+            23 Befehle an 14 Normen, einer zur manuellen Prüfung markiert. Zeigt zugleich, was
+            gälte, wenn der Entwurf so beschlossen würde — der Begründungsteil dahinter erzeugt
+            keine Befehle.
+          </span>
+        </dd>
+      </dl>
+
+      <p class="hint">
+        Die Verweise führen zu gesetze-im-internet.de, recht.bund.de und dserver.bundestag.de. Das
+        Werkzeug ruft dort nichts von sich aus ab: Es sieht nur die Dateien, die Sie ihm im Formular
+        übergeben.
+      </p>
+    </details>
+
     <form id="synopse-formular">
       <div class="field">
         <label for="stamm">Stammgesetz</label>
         <input type="file" id="stamm" name="stamm" required>
         <p class="hint">
-          gii-Norm-XML von gesetze-im-internet.de, oder — für Landesrecht — die konsolidierte
-          Fassung aus dem Landesportal (PDF oder Klartext).
+          gii-Norm-XML von gesetze-im-internet.de — auch als heruntergeladenes xml.zip, ohne
+          Entpacken —, oder für Landesrecht die konsolidierte Fassung aus dem Landesportal (PDF
+          oder Klartext).
         </p>
       </div>
 
diff --git a/src/main/resources/eu/mulk/aendggner/web/style.css b/src/main/resources/eu/mulk/aendggner/web/style.css
index ac3b8ee..c9d6db1 100644
--- a/src/main/resources/eu/mulk/aendggner/web/style.css
+++ b/src/main/resources/eu/mulk/aendggner/web/style.css
@@ -121,6 +121,45 @@ button:hover {
   font-size: 0.875rem;
 }
 
+/* Zugeklappt eine Zeile, damit das Formular oben bleibt; aufgeklappt im Zuschnitt der
+   übrigen Kästen. */
+.einfuehrung {
+  margin: 0 0 1.75rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  font-size: 0.875rem;
+}
+
+.einfuehrung summary {
+  font-weight: bold;
+  color: var(--accent);
+  cursor: pointer;
+}
+
+.einfuehrung > :not(summary) {
+  margin: 0.75rem 0 0;
+}
+
+.einfuehrung ol {
+  padding-left: 1.25rem;
+}
+
+.einfuehrung dt {
+  font-weight: bold;
+  margin-top: 0.75rem;
+}
+
+.einfuehrung dd {
+  margin: 0.25rem 0 0;
+}
+
+/* Der Erläuterungssatz unter einem Beispiel steht als span in der dd und braucht deshalb
+   eigene Absatzbildung. */
+.einfuehrung .hint {
+  display: block;
+}
+
 .disclaimer {
   margin-top: 2rem;
   padding: 1rem;