Skip to content

docs(handbook): Download / Test access section (#spec-downloads)#691

Merged
TaprootFreak merged 1 commit into
stagingfrom
docs/handbook-downloads-section
Jun 4, 2026
Merged

docs(handbook): Download / Test access section (#spec-downloads)#691
TaprootFreak merged 1 commit into
stagingfrom
docs/handbook-downloads-section

Conversation

@TaprootFreak
Copy link
Copy Markdown
Contributor

Was

Neue Handbook-Sektion „Download / Test-Zugang" (#spec-downloads), die die drei öffentlichen Test-/Download-Zugänge der RealUnit-App an einem Ort bündelt — direkt neben „Rechtsdokumente" (#spec-legal-downloads) und „Aufgaben" (#spec-tasks). Damit stehen die aktuell gültigen Tester-Links dauerhaft im Handbook statt nur in einer Mail.

Closes #690

Inhalt

Drei Einträge, je mit Plattform-Name, kurzer Install-Beschreibung, Link, „🔗 Link kopieren"-Button und QR-Code:

Zugang Link
Apple TestFlight (öffentlicher Tester-Link) https://testflight.apple.com/join/xpAAwseS
Google Play — Offener Test https://play.google.com/apps/testing/swiss.realunit.app
Android APK (Direkt-Download, alle Releases) https://github.com/RealUnitCH/app/releases

Umsetzung

  • Neue <details id="spec-downloads">-Sektion + Nav-Eintrag „D Download / Test", Styling/Card-Chrome + Copy-Button analog zu den bestehenden Sektionen.
  • QR-Code je Link als selbst-enthaltenes Inline-SVG (kein externer Request, kein Build-Schritt) — Tester können den Link direkt vom Desktop-Handbook scannen. Die SVGs wurden generiert und per Decode-Round-Trip gegen die Soll-URLs verifiziert.
  • Der gemeinsame Copy-Link-Handler bekommt ein optionales data-copy-url-Attribut: solche Buttons kopieren die echte Store-/Download-URL (statt eines Handbook-Deep-Links) und lassen die URL-Leiste unverändert. Bestehende data-target-Buttons bleiben unverändert.
  • Rein statisches HTML. Die Sektion liegt außerhalb der BEGIN/END-Blöcke der Generatoren (store-listing, legal-downloads) → die Handbook-Workflows greifen ohne Anpassung.

Lokal verifiziert

  • assemble-handbook-store-listing.py + assemble-handbook-legal.py erzeugen keinen Diff (Sync-Gates grün)
  • assemble-handbook-screenshots.sh → 52 Screenshots (unverändert)
  • docker build -f Dockerfile.handbook erfolgreich
  • ✅ Container-Smoke: /healthz = 200, /de/ = 401 (Auth-Wall aktiv), Sektion im ausgelieferten /de/index.html vorhanden; Image-index.html identisch zum Working-Tree
  • ✅ HTML tag-balance OK, keine doppelten IDs, Inline-Scripts node --check OK
  • ✅ QR-Codes dekodieren korrekt zurück zu den drei URLs

Bundle the three public tester/download entry points in one handbook
section next to the legal-downloads and tasks sections, so the currently
valid links live in the handbook instead of only in a mail:

- Apple TestFlight (public tester link)
- Google Play open test
- Android APK (GitHub releases, direct download)

Each entry carries the platform name, a short install description, the
link itself, a copy button, and a self-contained inline-SVG QR code so
testers can scan the link straight off the desktop handbook.

The shared copy-link handler gains an optional data-copy-url attribute:
buttons carrying it copy that URL verbatim (instead of the handbook
deep-link) and leave the URL bar untouched. Existing data-target buttons
are unaffected.

Static HTML only — placed outside the BEGIN/END store-listing and
legal-downloads generator blocks, so the sync gates and the handbook
image build stay untouched (verified locally: both generators are
no-ops on the new file, docker build + container smoke pass).

Closes #690
@TaprootFreak TaprootFreak marked this pull request as ready for review June 4, 2026 13:51
@TaprootFreak TaprootFreak merged commit d538fbc into staging Jun 4, 2026
12 checks passed
@TaprootFreak TaprootFreak deleted the docs/handbook-downloads-section branch June 4, 2026 14:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant