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.
56 lines
1.9 KiB
Bash
Executable File
56 lines
1.9 KiB
Bash
Executable File
#!/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)."
|