Files
Holzleitner-Lieferservice-App/lib/data/network/holzleitner_api_factory.dart
Dennis Nemec 8cf4045e44 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.
2026-05-14 22:44:51 +02:00

36 lines
1.1 KiB
Dart

import 'package:dio/dio.dart';
import 'package:holzleitner_api/holzleitner_api.dart';
import 'auth_token_provider.dart';
import 'backend_config.dart';
import 'holzleitner_auth_interceptor.dart';
/// Baut den generierten `HolzleitnerApi`-Client mit:
/// * eigener `Dio`-Instanz (Base-URL + Timeouts aus [BackendConfig]),
/// * **ohne** die vier Default-Auth-Interceptors des Generators —
/// stattdessen wird unser [HolzleitnerAuthInterceptor] gehängt.
///
/// Auf diese Weise bleibt die Token-Quelle pluggable
/// ([AuthTokenProvider]), und Phase B (Keycloak OIDC) kann die
/// Provider-Implementierung austauschen, ohne den Rest des Codes
/// anzufassen.
HolzleitnerApi buildHolzleitnerApi({
required BackendConfig config,
required AuthTokenProvider tokenProvider,
}) {
final dio = Dio(
BaseOptions(
baseUrl: config.apiBaseUrl,
connectTimeout: const Duration(seconds: 10),
receiveTimeout: const Duration(seconds: 30),
sendTimeout: const Duration(seconds: 30),
headers: const {'Accept': 'application/json'},
),
);
return HolzleitnerApi(
dio: dio,
interceptors: [HolzleitnerAuthInterceptor(tokenProvider)],
);
}