docs(share): Ablauf eines Domainwechsels als Reihenfolge

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

docs/share-links.md

@@ -57,6 +57,30 @@ Beide müssen eine gültige `assetlinks.json` ausliefern. Das ist keine Feinheit
 toter Host blockiert also auch den funktionierenden. Sobald die alte Domain abgeschaltet wird, das
 APK deshalb ohne `novasonicHost2` neu bauen.
 
+### Ablauf eines Umzugs
+
+1. **Neue Domain aufsetzen**, Web-App und `/.well-known/assetlinks.json` dort erreichbar machen.
+   Die alte Domain bleibt vorerst unverändert online.
+2. **APK mit beiden Hosts bauen** (`-PnovasonicHost=neu -PnovasonicHost2=alt`) und installieren.
+   Ab jetzt öffnen Links beider Adressen in der App.
+3. **In der App die „NovaSonic Web-Adresse" auf die neue Domain umstellen.** Neu geteilte Links
+   zeigen ab sofort dorthin, alte funktionieren weiter.
+4. **Warten**, bis auf allen Geräten das neue APK läuft.
+5. **Alte Domain abschalten** — und danach das APK ohne `novasonicHost2` neu bauen.
+
+Schritt 5 nicht vergessen: Android verifiziert die Domains bei jeder Installation neu, und auf
+Android 11 und älter genügt ein einziger nicht erreichbarer Host, damit die Verifikation komplett
+fehlschlägt. Bereits verifizierte Installationen laufen zwar weiter, aber die nächste Neuinstallation
+hätte gar keine funktionierenden App Links mehr.
+
+Zwei weitere Fallen:
+
+- **Signaturschlüssel muss derselbe bleiben.** Ein anders signiertes APK lässt sich nur nach
+  Deinstallation installieren — und die nimmt die Offline-Downloads mit.
+- **Alte Links nach der Abschaltung** öffnen nur dann noch etwas, wenn die alte Domain auf die neue
+  weiterleitet. Dann landen sie allerdings im Browser statt in der App, weil Android eine
+  Weiterleitung nicht erneut an die App übergibt.
+
 Wildcards (`*.example.com`) sind für App Links nicht dokumentiert und werden hier bewusst nicht
 verwendet — die Verifikation läuft pro Host.