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.
This commit is contained in:
Dennis Nemec
2026-05-14 22:44:51 +02:00
parent 456fb59668
commit 8cf4045e44
222 changed files with 19350 additions and 0 deletions

64
tool/smoke_test_api.dart Normal file
View File

@ -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}');
}
}