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.
42 lines
1.3 KiB
Dart
42 lines
1.3 KiB
Dart
import 'package:get_it/get_it.dart';
|
|
import 'package:holzleitner_api/holzleitner_api.dart';
|
|
|
|
import 'auth_token_provider.dart';
|
|
import 'backend_config.dart';
|
|
import 'dev_password_grant_token_provider.dart';
|
|
import 'holzleitner_api_factory.dart';
|
|
|
|
/// Registriert das HTTP-/API-Subsystem im globalen GetIt-Locator.
|
|
///
|
|
/// Aufruf bewusst nicht im AppBloc-Lifecycle, sondern in `main()` vor
|
|
/// dem `runApp` — die API-Klassen sind über die gesamte App-Lebensdauer
|
|
/// stabil und brauchen keine Reaktion auf App-Events.
|
|
///
|
|
/// Phase A nutzt die `DevPasswordGrantTokenProvider`-Implementation.
|
|
/// Phase B wird hier den OIDC-PKCE-Provider einhängen und die
|
|
/// Dev-Implementation komplett entfernen.
|
|
void registerNetworking({
|
|
required GetIt locator,
|
|
BackendConfig config = BackendConfig.localDev,
|
|
String testfahrerUsername = 'testfahrer',
|
|
String testfahrerPassword = 'test',
|
|
}) {
|
|
locator.registerSingleton<BackendConfig>(config);
|
|
|
|
locator.registerSingleton<AuthTokenProvider>(
|
|
DevPasswordGrantTokenProvider(
|
|
tokenEndpoint: config.keycloakTokenEndpoint,
|
|
clientId: config.keycloakClientId,
|
|
username: testfahrerUsername,
|
|
password: testfahrerPassword,
|
|
),
|
|
);
|
|
|
|
locator.registerSingleton<HolzleitnerApi>(
|
|
buildHolzleitnerApi(
|
|
config: config,
|
|
tokenProvider: locator<AuthTokenProvider>(),
|
|
),
|
|
);
|
|
}
|