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/fetch_openapi_generator.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+#
+# Lädt die openapi-generator-cli.jar von Maven Central nach
+# tool/openapi-generator-cli.jar. Idempotent — überspringt, wenn schon da.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+JAR="${SCRIPT_DIR}/openapi-generator-cli.jar"
+VERSION="7.10.0"
+
+if [[ -f "${JAR}" ]]; then
+    echo "→ JAR existiert bereits unter ${JAR}"
+    exit 0
+fi
+
+echo "→ Lade openapi-generator-cli ${VERSION} ..."
+curl -sL \
+    "https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/${VERSION}/openapi-generator-cli-${VERSION}.jar" \
+    -o "${JAR}"
+echo "✓ ${JAR}"

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)."

tool/smoke_test_api.dart

@@ -0,0 +1,64 @@
+/// Smoke-Test für den generierten Holzleitner-API-Client.
+///
+/// Läuft als reines Dart-Script (kein Flutter-Engine nötig):
+///
+///   dart run tool/smoke_test_api.dart
+///
+/// Voraussetzungen:
+///   * Backend läuft unter http://127.0.0.1:3000
+///   * Keycloak läuft unter http://127.0.0.1:8080
+///   * Testfahrer (PN 1001) ist im Keycloak-Realm angelegt
+///
+/// Was getestet wird:
+///   1. /health (ohne Auth)
+///   2. /me/cars (mit Auth via DevPasswordGrantTokenProvider)
+library;
+
+import 'package:dio/dio.dart';
+import 'package:hl_lieferservice/data/network/backend_config.dart';
+import 'package:hl_lieferservice/data/network/dev_password_grant_token_provider.dart';
+import 'package:hl_lieferservice/data/network/holzleitner_api_factory.dart';
+
+Future<void> main() async {
+  const config = BackendConfig.localDev;
+
+  // Health geht ohne Auth — wir nutzen die generierte API-Klasse trotzdem,
+  // um zu zeigen, dass der Aufruf-Pfad funktioniert.
+  print('---- 1) GET /health ----');
+  final tokenProvider = DevPasswordGrantTokenProvider(
+    tokenEndpoint: config.keycloakTokenEndpoint,
+    clientId: config.keycloakClientId,
+    username: 'testfahrer',
+    password: 'test',
+  );
+  final api = buildHolzleitnerApi(
+    config: config,
+    tokenProvider: tokenProvider,
+  );
+
+  try {
+    final health = await api.getHealthApi().health();
+    print('  OK: ${health.data?.length ?? 0} bytes  →  ${health.data}');
+  } on DioException catch (e) {
+    print('  FEHLER: ${e.message}');
+    print('  Response: ${e.response?.data}');
+    return;
+  }
+
+  print('\n---- 2) GET /me/cars (mit Bearer-Token) ----');
+  try {
+    final response = await api.getCarsApi().listMyCars();
+    final cars = response.data?.cars;
+    if (cars == null) {
+      print('  OK: leerer Body');
+      return;
+    }
+    print('  OK: ${cars.length} Fahrzeug(e)');
+    for (final c in cars) {
+      print('    • ${c.id}  ${c.plate}  active=${c.active}');
+    }
+  } on DioException catch (e) {
+    print('  FEHLER: ${e.message}');
+    print('  Response: ${e.response?.data}');
+  }
+}