8cf4045e44
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.
49 lines
1.8 KiB
Dart
49 lines
1.8 KiB
Dart
/// Endpoint-Konfiguration für das Rust-Backend.
|
|
///
|
|
/// Dies ist eine Übergangs-Konfiguration für Phase A der
|
|
/// Backend-Migration. Sie wird in Phase D durch eine umfassendere
|
|
/// `LocalDocuFrameConfiguration`-Ablösung ersetzt (oder die bestehende
|
|
/// Konfiguration wird erweitert).
|
|
///
|
|
/// **Werte für lokale Entwicklung:**
|
|
/// * iOS-Simulator + macOS-Host: `http://127.0.0.1:3000`
|
|
/// * Android-Emulator: `http://10.0.2.2:3000`
|
|
/// * Echtes Gerät im LAN: `http://<host-IP>:3000`
|
|
///
|
|
/// Default ist iOS-Simulator-tauglich. Für Android-Build vor dem
|
|
/// Compile umstellen — eine Auto-Erkennung pro Platform kommt mit der
|
|
/// Phase-D-Config.
|
|
class BackendConfig {
|
|
const BackendConfig({
|
|
required this.apiBaseUrl,
|
|
required this.keycloakTokenEndpoint,
|
|
required this.keycloakClientId,
|
|
});
|
|
|
|
/// Basis-URL der Rust-API (kein abschließender Slash).
|
|
final String apiBaseUrl;
|
|
|
|
/// Vollständiger Token-Endpoint des Keycloak-Realms — Format:
|
|
/// `{issuer}/protocol/openid-connect/token`.
|
|
final String keycloakTokenEndpoint;
|
|
|
|
/// Public-Client-Id, die das Backend als `audience` erwartet
|
|
/// (aktuell `holzleitner-app`).
|
|
final String keycloakClientId;
|
|
|
|
/// Default-Konfiguration für lokale Entwicklung gegen das
|
|
/// Docker-Compose-Setup (Postgres + Keycloak + Backend).
|
|
///
|
|
/// **Achtung Hostname:** Keycloak prägt das `iss`-Claim des Tokens
|
|
/// aus dem Hostnamen der Token-Endpoint-URL. Das Backend erwartet
|
|
/// `iss = http://localhost:8080/realms/holzleitner`, deshalb hier
|
|
/// `localhost` statt `127.0.0.1`. Auf Android-Emulator entsprechend
|
|
/// `10.0.2.2` setzen.
|
|
static const BackendConfig localDev = BackendConfig(
|
|
apiBaseUrl: 'http://localhost:3000',
|
|
keycloakTokenEndpoint:
|
|
'http://localhost:8080/realms/holzleitner/protocol/openid-connect/token',
|
|
keycloakClientId: 'holzleitner-app',
|
|
);
|
|
}
|