Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,146 @@
# Apple App Store Rules — Briefing fuer HiveGrid (B2B-SaaS-CRM, Stand Mai 2026)
Kontext: HiveGrid ist ein B2B-SaaS-CRM (Multi-Tenant) fuer Handwerksbetriebe. Web-App ist Hauptzugang. Nativer Wrapper (Capacitor/React Native) fuer App-Store-Praesenz erwogen. Subscriptions zahlt der Betrieb extern (Web/Rechnung), Endnutzer (Monteure/Buero) loggen sich nur ein.
---
## 1. In-App Purchases (IAP) — fuer HiveGrid NICHT Pflicht (bedingt)
- **Grundregel 3.1.1:** Digitale Goods/Services in der App muessen via Apple-IAP (15-30% Provision) verkauft werden.
- **Relevante Ausnahme — Guideline 3.1.3(c) "Enterprise Services":** Wenn die App ausschliesslich an Organisationen/Gruppen fuer deren Mitarbeiter verkauft wird (typisches B2B-SaaS-Modell), darf extern abgerechnet werden. HiveGrid faellt klar darunter.
- **Zusaetzlich 3.1.3(b) "Multiplatform Services":** Login fuer eine bereits ausserhalb der App (Web) erworbene Subscription ist erlaubt — solange die App **keinen Link, Button oder Hinweis enthaelt, der auf externe Bezahlung steert**.
- **Was in der App NICHT erlaubt ist (ausserhalb EU/USA):** Pricing-Pages, "Upgrade your plan"-Buttons, Links zur Web-Bezahlung, "Sign up at hivegrid.cloud"-Hinweise. Nur reiner Login-Screen ist sicher.
- **EU-DMA-Update (Juni 2025):** In der EU duerfen Apps inzwischen aktiv auf externe Bezahloptionen verlinken (Core Technology Commission 5%, optionales Modell). Fuer HiveGrid **nicht relevant**, da gar keine Consumer-Bezahlung in der App stattfindet — die DMA-Lockerung betrifft primaer Apps die selbst IAP umgehen wollen.
- **Fazit:** Nicht-Pflicht, sofern strikt nur Login + App-Funktionen, keinerlei Pricing-/Upsell-Inhalte. Reject-Risiko bei jedem "Subscribe"-Hinweis.
Quellen:
- [App Review Guidelines (Apple)](https://developer.apple.com/app-store/review/guidelines/)
- [Apple Forum: 3.1.3(c) Enterprise Services](https://developer.apple.com/forums/thread/666450)
- [Forum-Thread: B2B SaaS Reject 3.1.1](https://developer.apple.com/forums/thread/811018)
- [iOS IAP Compliance Guide 2025 (Twinr)](https://twinr.dev/blogs/ios-in-app-purchase-compliance/)
- [DMA Update Juni 2025 (RevenueCat)](https://www.revenuecat.com/blog/growth/apple-eu-dma-update-june-2025/)
---
## 2. Sign in with Apple — fuer HiveGrid NICHT Pflicht (bedingt)
- **Grundregel 4.8:** Wer Drittanbieter-Login (Google, Facebook, Microsoft) als **primaeren** Auth-Mechanismus anbietet, MUSS Sign in with Apple gleichwertig anbieten.
- **Klare Ausnahme:** "Education, enterprise, or business apps that require the user to sign in with an existing education or enterprise account" — also genau HiveGrids Modell (Mitarbeiter logged sich mit Firma-Credentials ein).
- **Weitere Ausnahme:** Apps die ausschliesslich eigene Account-Systeme nutzen (Email + Passwort) brauchen kein Sign in with Apple.
- **Knifflig:** Wenn HiveGrid auch Google/Microsoft-OAuth fuer "regulaere" Endnutzer (nicht nur SSO via Tenant) anbietet, koennte ein Reviewer das als "primaeres Auth" werten. Dann **doch Pflicht**.
- **Magic-Link/Email-Only:** Reicht aus, um die Anforderung zu umgehen — keine Apple-Login-Pflicht.
- **Fazit:** Nicht-Pflicht, wenn HiveGrid den Login als "Enterprise/Tenant-Login" framed. Pflicht, wenn Google-OAuth als allgemeiner Consumer-Login angeboten wird.
Quellen:
- [WorkOS: Sign in with Apple 2025](https://workos.com/blog/apple-app-store-authentication-sign-in-with-apple-2025)
- [Apple Forum: Is SIWA mandatory?](https://developer.apple.com/forums/thread/124006)
- [Apple Developer Docs: Authenticating with SIWA](https://developer.apple.com/documentation/signinwithapple/authenticating-users-with-sign-in-with-apple)
---
## 3. Face ID / Touch ID Integration
- **Apple stellt keine Pflicht** zu Biometrie-Login. Es ist optional, aber dringend empfohlen fuer eine "app-like experience" (s. Punkt 5 / Guideline 4.2).
- **Capacitor:** Plugins wie `@aparajita/capacitor-biometric-auth` oder `capacitor-face-id` wrappen Apples `LocalAuthentication`-Framework. Integration: ~1-2 Tage. Kein Problem mit Apple Review.
- **React Native:** `react-native-keychain` + `expo-local-authentication` (bei Expo) — vergleichbar simpel.
- **Echt nativ (Swift):** Direkt `LocalAuthentication.framework`, ~paar Stunden Aufwand.
- **Apple-Anforderungen:** `NSFaceIDUsageDescription` im Info.plist (Pflicht-String warum Face ID genutzt wird), Fallback-Mechanismus (PIN/Passwort) muss existieren.
- **Fazit:** Nicht-Pflicht. Mit Capacitor problemlos machbar (~1-2 Tage). Hilft enorm gegen Guideline 4.2 Reject (s.u.).
Quellen:
- [Apple Dev: LocalAuthentication](https://developer.apple.com/documentation/localauthentication/logging-a-user-into-your-app-with-face-id-or-touch-id)
- [Capacitor Biometric Auth Plugin](https://github.com/aparajita/capacitor-biometric-auth)
---
## 4. Sonstige Huerden fuer B2B-SaaS-CRM
### 4.1 Account-Loeschung in der App — PFLICHT seit 30.06.2022 (Guideline 5.1.1(v))
- Jede App mit Account-Erstellung muss In-App-Loeschung anbieten — auch wenn Account ausserhalb erstellt wurde.
- Deaktivieren reicht nicht, alle Personendaten muessen geloescht werden.
- Ausnahme fuer "highly regulated industries" (5.1.1(ix)) — Handwerk **faellt nicht** darunter.
- Praktisch: Settings-Screen mit "Konto loeschen"-Button, der Backend-Endpoint anstoesst. Fuer Multi-Tenant: kann sein dass nur "Mitarbeiter aus Tenant entfernen" gemeint ist, aber Apple ist da streng — User-eigene Daten muessen weg.
- [Apple: Account deletion](https://developer.apple.com/support/offering-account-deletion-in-your-app/)
### 4.2 Privacy Manifest — PFLICHT seit 01.05.2024
- `PrivacyInfo.xcprivacy` muss alle gesammelten Daten + Drittanbieter-SDK-APIs deklarieren.
- Apple lehnt 12% der Submissions in Q1 2025 wegen fehlerhafter Manifests ab.
- Capacitor/Expo-Communities haben i.d.R. fertige Manifests — trotzdem pruefen.
- App Tracking Transparency (ATT) Prompt nur wenn echtes Tracking stattfindet — fuer ein internes B2B-Tool i.d.R. nicht noetig.
- [Apple Privacy Manifest Docs](https://developer.apple.com/documentation/bundleresources/privacy-manifest-files)
### 4.3 TestFlight & Sandbox
- Internal Testing: 100 Tester, sofort verfuegbar, keine Apple-Pruefung.
- External Testing: 10.000 Tester, **erfordert App-Review** (leichter als Production, ~1-2 Tage).
- Sandbox-Accounts fuer IAP-Tests in App Store Connect anlegen — fuer HiveGrid nicht relevant da kein IAP.
### 4.4 Typische Reject-Gruende fuer B2B-Apps
1. **Guideline 2.1 (App Completeness):** ~40% aller Rejects. Reviewer kann nicht einloggen → bricht ab. **Demo-Account in Review Notes ist kritisch.**
2. **Guideline 4.2 (Minimum Functionality):** "Webview-Wrapper" (s. Punkt 5).
3. **Guideline 3.1.1 (IAP):** Schon ein "Upgrade auf Pro"-Button im UI loest Reject aus.
4. **Guideline 5.1.1 (Privacy):** Fehlende Account-Loeschung, kein Privacy-Manifest, fehlende Privacy-Policy-URL.
5. **Guideline 2.3 (Metadata):** Screenshots zeigen Features die in der App nicht funktionieren.
Quellen:
- [NextNative: App Store Review Guidelines 2025](https://nextnative.dev/blog/app-store-review-guidelines)
- [Twinr: Rejection Reasons 2025](https://twinr.dev/blogs/apple-app-store-rejection-reasons-2025/)
- [RevenueCat: Ultimate Guide to Rejections](https://www.revenuecat.com/blog/growth/the-ultimate-guide-to-app-store-rejections/)
---
## 5. Capacitor vs React Native vs Expo vs nativ — und Guideline 4.2
- **Apple ist agnostisch ggue. Framework**, aber sehr empfindlich gegenueber "Webview-Wrappern" ohne nativen Mehrwert (Guideline 4.2 "Minimum Functionality").
- **Was sicher rejected wird:** Pure WebView, die nur die mobile Website laedt, ohne native Features.
- **Was 2026 minimal verlangt wird (Best Practice, nicht alle gleichzeitig):**
- Native Navigation (kein Hamburger-Menue im Webview)
- Push Notifications (echt genutzt — nicht nur "registriert")
- Mind. ein Device-Feature: Kamera (Foto vom Auftrag), Biometrie (Login), Geolocation (Einsatzort), Offline-Mode (mind. teilweise)
- App-Icons, Splash-Screens, vernuenftige Tab-Bar
- **Capacitor:** Webview-basiert aber mit nativen Plugins. Gut geeignet, wenn Web-App schon existiert (HiveGrid-Fall). Reject-Risiko **nur**, wenn Native Features fehlen — Framework selbst ist kein Problem.
- **React Native:** Native UI-Components, leichter durch 4.2 zu kommen, aber doppelter Code-Aufwand vs. Capacitor.
- **Expo:** React-Native + Managed Workflow + EAS Build. 2026 die beliebteste Variante fuer kleinere Teams. Privacy Manifest weitgehend automatisiert.
- **Echt nativ (Swift/SwiftUI):** Maximale Akzeptanz, ~3-5x Aufwand vs. Capacitor.
- **Empfehlung 2026:** Capacitor ist OK fuer HiveGrid, **wenn** mindestens 2-3 native Features (Push, Biometrie, Kamera fuer Auftrags-Fotos) implementiert werden.
Quellen:
- [Mobiloud: Webview App Rejection](https://www.mobiloud.com/blog/app-store-review-guidelines-webview-wrapper)
- [iOS Submission Guide: 4.2](https://iossubmissionguide.com/guideline-4-2-minimum-functionality/)
- [Capacitor vs React Native 2025](https://nextnative.dev/blog/capacitor-vs-react-native)
---
## 6. Google Play Store — deutlich einfacher
- **Keine Sign-in-with-Google-Pflicht** analog zu Apples SIWA.
- **Account-Loeschung** ebenfalls Pflicht seit Mai 2024 — aber Google akzeptiert auch externe Loesch-URL (Apple verlangt In-App).
- **In-App-Billing:** Theoretisch aehnliche Regel, aber in der Praxis weniger streng durchgesetzt fuer B2B. Seit Epic-vs-Google (Okt 2025, USA) duerfen externe Bezahllinks in den USA frei verwendet werden. EU: External Offers Program seit 2025.
- **Webview-Apps:** Google ist toleranter — "Minimum Functionality"-Aequivalent (Spam Policy) wird selten gegen B2B-Wrapper gezueckt.
- **Data Safety Form** (analog Privacy Manifest) — etwas einfacher als Apples Manifest.
- **Fazit:** Google Play ist klar einfacher. Tipp: Erst Google Play launchen (lower risk), dann Apple.
Quellen:
- [Google Play External Billing 2025](https://solidgate.com/blog/external-billing-google-play/)
- [Android SaaS Subscriptions Guide 2025](https://dev.to/krlz/android-saas-app-with-subscriptions-complete-2025-guide-52ak)
---
## Empfehlungen fuer HiveGrid
1. **IAP komplett vermeiden:** App nur mit Login-Screen starten. **Keine** Pricing-, Upgrade-, "Plan waehlen"-Inhalte in der App. Subscription-Mgmt strikt im Web-Dashboard. Im App-Store-Listing als "B2B Enterprise Tool" positionieren — Reviewer-Hinweis in den App Review Notes: "Enterprise SaaS, sold directly to organizations, all payments handled outside the app per Guideline 3.1.3(c)".
2. **Sign in with Apple sparen:** Login-Screen sollte als "Firma-Login" auftreten (z.B. "Mit Firma-Account anmelden"). Wenn Google/Microsoft-OAuth, dann als "Enterprise SSO" framen, nicht als allgemeiner Consumer-Login. Magic-Link/Email-Only ist die sicherste Variante zum Umgehen.
3. **Capacitor + native Features:** Mind. 3 native Funktionen: Push Notifications (Auftrag-Updates fuer Monteure), Biometrie-Login (Face ID), Kamera (Fotos vom Einsatz). Damit ist 4.2 sicher gepasst.
4. **Account-Loeschung jetzt einplanen:** Endpoint im Backend, Settings-Screen "Konto loeschen" — auch fuer Multi-Tenant. Loescht User-Personendaten, behaelt anonymisiert was rechtlich noetig ist (Audit-Trail).
5. **Privacy Manifest sauber:** `PrivacyInfo.xcprivacy` mit allen Capacitor-Plugin-Reasons. Privacy-Policy-URL im App Store Connect setzen.
6. **Reviewer-Demo-Account vorbereiten:** Dedizierter Tenant "apple-review" mit Mitarbeiter-Login, Beispieldaten, **immer** in App Review Notes mitliefern. Reduziert 2.1-Reject-Risiko massiv.
7. **Launch-Strategie:** Erst Google Play (niedrigere Huerde, schneller Feedback) → dann Apple. Bei Apple unbedingt mit TestFlight (External Testing) ein paar Wochen vor Production-Submit testen — gleiches Review-Team, niedrigerer Stress.
---
**Unklarheit (ehrlich):** Ob ein Reviewer Google-OAuth als "Enterprise SSO" (kein SIWA noetig) oder als "Consumer Social Login" (SIWA Pflicht) wertet, ist Einzelfall. Im Zweifel SIWA mit-implementieren — Aufwand ~1 Tag.