Phase A: generierter Dart-Client + DI-Foundation für Rust-Backend

OpenAPI-Generator-Setup:
- tool/generate_api_client.sh: Direkter Aufruf der openapi-generator-cli.jar
  (Java-CLI statt Dart-build_runner-Integration — vermeidet die
  analyzer-/source_gen-Version-Hölle mit json_serializable)
- tool/fetch_openapi_generator.sh: lädt die JAR (29 MB) nach (gitignored)
- openapi/holzleitner.json: Snapshot der Backend-Spec für reproduzierbare
  Generation
- packages/holzleitner_api/: generiertes Dart-Sub-Package (built_value +
  dio), per path-dep im Haupt-pubspec eingehängt

Netzwerk-Layer (lib/data/network/):
- BackendConfig: API- und Keycloak-Endpoints für Local-Dev (localhost
  wegen Keycloak-iss-Claim).
- AuthTokenProvider-Schnittstelle.
- DevPasswordGrantTokenProvider: Phase-A-Provider via Keycloak
  password-grant, Token-Caching mit Expiry-Check (Phase B ersetzt das
  durch flutter_appauth PKCE).
- HolzleitnerAuthInterceptor: dynamischer Bearer-Inject pro Request.
- HolzleitnerApiFactory: baut die generierte HolzleitnerApi-Klasse
  mit unserem Interceptor statt der vier Default-Auth-Interceptors.
- network_locator.registerNetworking(): get_it-Setup, in main() vor
  runApp() aufgerufen.

Clean-Arch-Scaffolding (lib/data/, lib/domain/):
- Verzeichnisstruktur für Phase C+D angelegt (mapper/, repository/,
  entity/, repository/) — befüllt sich in den Folge-Phasen.

Smoke-Test:
- tool/smoke_test_api.dart ruft /health (ungeschützt) und /me/cars
  (mit Bearer) via generiertem Client — grün gegen lokales Backend.

tool/generate_api_client.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+#
+# Erzeugt den Dart/Dio-Client für das Holzleitner-Rust-Backend aus
+# openapi/holzleitner.json.
+#
+# Voraussetzungen:
+#   * Java 11+ (auf macOS: brew install openjdk@21)
+#   * tool/openapi-generator-cli.jar (~29 MB, kann via
+#     `tool/fetch_openapi_generator.sh` nachgeladen werden — derzeit
+#     ist die JAR im Repo eingecheckt für reproduzierbare Builds)
+#
+# Aufruf vom Projekt-Root:
+#   ./tool/generate_api_client.sh
+#
+# Output:
+#   packages/holzleitner_api/   (eigenes Dart-Sub-Package)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+JAR="${SCRIPT_DIR}/openapi-generator-cli.jar"
+SPEC="${PROJECT_ROOT}/openapi/holzleitner.json"
+OUT="${PROJECT_ROOT}/packages/holzleitner_api"
+
+if [[ ! -f "${JAR}" ]]; then
+    echo "→ JAR fehlt — lade nach via tool/fetch_openapi_generator.sh"
+    bash "${SCRIPT_DIR}/fetch_openapi_generator.sh"
+fi
+if [[ ! -f "${SPEC}" ]]; then
+    echo "Error: OpenAPI-Spec nicht gefunden unter ${SPEC}" >&2
+    echo "  → Backend starten und neu ziehen:" >&2
+    echo "    curl http://127.0.0.1:3000/openapi.json | jq . > openapi/holzleitner.json" >&2
+    exit 1
+fi
+
+echo "→ Generiere Dart-Client nach ${OUT}"
+
+# `dart-dio` erzeugt einen sauberen Client auf Basis von dio + Built Value.
+# Wir setzen pubName/pubAuthor, damit das Sub-Package gleich einen
+# klaren Namen hat. `wrapper: none` unterdrückt unnötiges Wrapping.
+java -jar "${JAR}" generate \
+    --input-spec "${SPEC}" \
+    --generator-name dart-dio \
+    --output "${OUT}" \
+    --additional-properties=\
+pubName=holzleitner_api,\
+pubAuthor=Holzleitner_GmbH,\
+pubDescription="Generierter_Dart-Client_fuer_das_Holzleitner-Rust-Backend",\
+nullableFields=true,\
+serializationLibrary=built_value
+
+echo "✓ Fertig. Code unter ${OUT}/lib"
+echo "  Im Hauptpaket: flutter pub get  (greift via path-dep zu)."