Final commit.

lib/data/network/backend_config.dart

@@ -53,4 +53,44 @@ class BackendConfig {
     keycloakClientId: 'holzleitner-app',
     keycloakRedirectUrl: 'holzleitner://oauth2redirect',
   );
+
+  /// Konfiguration für USB-Tunnel via `adb reverse` — gedacht für Tests in
+  /// fremden Netzwerken, in denen das Gerät den Mac nicht über eine LAN-IP
+  /// erreicht. Alles zeigt auf `localhost`; der Traffic wird über den
+  /// USB-Bus zum Host getunnelt.
+  ///
+  /// **Setup vor dem Start (Gerät per USB angesteckt):**
+  /// ```
+  /// adb reverse tcp:3000 tcp:3000   # Rust-API
+  /// adb reverse tcp:8080 tcp:8080   # Keycloak
+  /// ```
+  ///
+  /// **Backend-Voraussetzungen**, damit das OIDC-Login funktioniert:
+  /// * Backend-Env `KEYCLOAK_ISSUER_URL=http://localhost:8080/realms/holzleitner`
+  ///   (muss exakt mit [keycloakIssuerUrl] matchen, sonst 401 `invalid issuer`).
+  /// * Keycloak muss den Issuer als `localhost` ausgeben — z. B. via
+  ///   `KC_HOSTNAME_URL=http://localhost:8080` (oder Frontend-URL im Realm),
+  ///   sonst prägt es den Container-Hostnamen ins `iss`-Claim.
+  /// * Der `holzleitner://oauth2redirect`-Redirect bleibt unverändert (das
+  ///   Custom-Scheme ist netzwerk-unabhängig).
+  ///
+  /// Aktivieren ohne Code-Edit:
+  /// ```
+  /// flutter run --dart-define=HL_BACKEND=usb
+  /// ```
+  static const BackendConfig usbReverse = BackendConfig(
+    apiBaseUrl: 'http://localhost:3000',
+    keycloakIssuerUrl: 'http://localhost:8080/realms/holzleitner',
+    keycloakClientId: 'holzleitner-app',
+    keycloakRedirectUrl: 'holzleitner://oauth2redirect',
+  );
+
+  /// Wählt die Config anhand des Compile-Time-Flags `HL_BACKEND`:
+  /// * `usb` → [usbReverse] (adb-reverse-Tunnel über localhost)
+  /// * sonst → [localDev] (LAN-IP, Default)
+  ///
+  /// So muss für einen Netzwerkwechsel nur das Build-Flag gesetzt werden,
+  /// nicht der Quellcode angefasst.
+  static const BackendConfig fromEnvironment =
+      String.fromEnvironment('HL_BACKEND') == 'usb' ? usbReverse : localDev;
 }