rinkplanner/docs/beta-onboarding.md
torsten cde2ec4012 feat: Website auf geschlossene Beta umstellen
Die Download-Buttons sind weg, die Seite wirbt für die geschlossene Beta.
Jeder CTA öffnet eine vorbereitete Mail an kontakt@programmschmiede.de, mit
Plattform im Betreff und im Text; die direkten Build-URLs stehen nicht mehr
öffentlich.

- drei Beta-Schritte über dem Download-Bereich (CSS + Template)
- Hero, Nav und Download-Karten auf „Beta-Zugang anfragen“ umgestellt
- Hinweis auf Android-APK auf Anfrage, Signatur- und Backup-Warnung
- docs/beta-onboarding.md beschreibt Ablauf und Antwort-Mail
- tools/publish_beta_build.sh lädt Builds nach /rinkplanner/beta/<version>/
  und gibt die Links bzw. eine Mailvorlage aus
2026-11-15 18:51:17 +01:00

157 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Beta-Onboarding (geschlossene Beta)
Ablauf für Test-Builds: Besucher fragen per Mail an, du antwortest mit einem
direkten Link, der Tester installiert und gibt Feedback. Kein Formular, kein
Login, keine Datenbank.
## 1. Website
`rinkplanner.programmschmiede.de` zeigt keine Download-Buttons mehr, sondern
**„Beta-Zugang anfragen“**. Der Button öffnet eine vorbereitete Mail an
`kontakt@programmschmiede.de` – pro Plattform mit passendem Betreff und
Plattform-Zeile im Text. Die direkten Build-URLs stehen nicht auf der Seite.
## 2. Build veröffentlichen
Nach dem Bauen:
```bash
./tools/export_macos_installer.sh # build/macos/rinkplanner-setup.dmg
./tools/export_windows_installer.sh # build/windows/rinkplanner-setup.exe
./tools/export_android.sh debug # build/android/rinkplanner-debug.apk
```
Dann:
```bash
./tools/publish_beta_build.sh # Beta + Update-Kopien hochladen
```
Das Script:
- liest die Version aus `rinkplanner/project.godot`,
- lädt die vorhandenen Builds nach `rinkplanner/beta/<version>/`,
- lädt macOS/Windows zusätzlich nach `rinkplanner/download/` (dort zeigt
`version.json` hin, damit der In-App-Updater weiter funktioniert),
- gibt die Links aus und schreibt sie nach `build/beta-links.txt`.
Fehlt `build/macos/rinkplanner-setup.dmg`, übernimmt das Script die
veröffentlichte DMG **derselben Version** aus `/rinkplanner/download/` und
prüft die SHA-256. So ist der macOS-Link auch ohne Mac vollständig. Auf einem
Mac baut `--build-macos` das DMG vorher neu:
```bash
./tools/publish_beta_build.sh --beta-only --build-macos
```
Mit `--no-live-macos` wird die Übernahme abgeschaltet; dann wird nur
veröffentlicht, was lokal gebaut wurde.
Der Beta-Ordner ist **deterministisch**:
```
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-setup.dmg
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-setup.exe
https://programmschmiede.de/rinkplanner/beta/0.4.0/rinkplanner-debug.apk
```
Kein FTP-Client, kein Suchen nach dem neuesten Zufallsordner. Die Version
steht in `project.godot`; bei einem neuen Build die Version erhöhen, dann
stimmt der Ordner.
### Nur Links anzeigen
```bash
./tools/publish_beta_build.sh --no-upload
```
### Nur den Beta-Ordner hochladen
```bash
./tools/publish_beta_build.sh --beta-only
```
Damit bleiben die öffentlichen Update-Dateien unter `/download/` unangetastet.
## 3. Antwort-Mail
```bash
./tools/publish_beta_build.sh --mail macos
```
Gibt eine komplette Mailvorlage mit Link und Installationshinweisen aus.
Analog `--mail windows`, `--mail android` oder `--mail all`.
Wenn eine Datei lokal fehlt, markiert das Script den Link als
„(nicht gebaut)“ und warnt bei `--mail`. Dann keinen toten Link verschicken.
## 4. Tester-Liste
Eine einfache Tabelle reicht, keine CRM-Software:
| Datum | Name | E-Mail | Plattform | Build | Beta-Hinweis zugesagt | Feedback |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| 2026-11-14 | … | … | macOS | 0.4.0 | ja | … |
Nach der Beta löschen. Keine Adressen ohne Einwilligung in einen Newsletter
übernehmen.
## 5. Was die Mail zusagt
- Testversion, keine Gewähr, Küren vorher sichern.
- macOS ad-hoc signiert, nicht notarisiert (Rechtsklick → Öffnen).
- Windows unsigniert (SmartScreen → „Weitere Informationen“ → „Trotzdem
ausführen“).
- Android Debug-Signatur (Sideloading erlauben).
- Feedback per Mail; optional Einladung in den Kür-Hub.
## 6. Android-APK installieren (Tester)
Weder Play Store noch Entwickleroptionen sind nötig. Der Tester lädt die APK
und erlaubt einmalig „Unbekannte Apps“ für den Browser bzw. Dateimanager.
1. Link in Chrome öffnen und die APK herunterladen (ca. 33 MB).
2. Download-Benachrichtigung antippen oder Chrome → Downloads → APK.
3. Falls Android blockt: „Einstellungen“ im Dialog → „Unbekannte Apps
installieren“ → Chrome (oder „Dateien“) erlauben → zurück → Installieren.
4. Play Protect: „Weitere Details“ → „Trotzdem installieren“.
5. Installieren → Öffnen.
Auf Samsung (Galaxy Tab S9+): Einstellungen → Apps → Spezieller Zugriff →
Unbekannte Apps installieren → Chrome/Dateien → zulassen. Der Dialog beim
Öffnen der APK führt meist direkt dorthin.
Entwickleroptionen und USB-Debugging braucht nur, wer die APK per
`adb install` vom Rechner aus installiert. Für den Link im Browser ist das
nicht nötig.
Die APK ist debug-signiert. Updates müssen mit demselben Debug-Keystore
gebaut werden, sonst verlangt Android eine Neuinstallation (Datenverlust).
Für eine längere Beta ist ein eigener Release-Keystore sinnvoll.
Der Play Store ist nicht zwingend. „Internal Testing“ wäre der komfortablere,
aber aufwändigere Weg: Play-Console-Konto, AAB, Signierung und Richtlinien.
## 7. Wichtig: Update-Kanal nicht schützen
`version.json` und `/rinkplanner/download/` bleiben öffentlich. Der
In-App-Updater kann keine Zugangsdaten eingeben; Basic Auth auf diesem Pfad
würde Updates mit HTTP 401 abbrechen. Der geschützte Teil ist die
**Onboarding-Mail**, nicht die Update-URL.
Der Beta-Ordner `/rinkplanner/beta/` ist nicht verlinkt, aber auch nicht
zugangsgeschützt. Wenn ein Link weitergegeben wird: neuen Build mit neuer
Version bauen, neuen Ordner veröffentlichen, alten Ordner löschen. Für eine
geschlossene Beta mit persönlicher Einladung ist das ausreichend.
## 8. Aufräumen
Alte Beta-Ordner nach einigen Releases löschen:
```
rinkplanner/beta/0.4.0/
rinkplanner/beta/0.5.0/
```
Die jeweils aktuelle Version steht in `project.godot` und in
`build/beta-links.txt`.