 Oleksandr Bezdieniezhnykh
|
72a06edab0
|
[AZ-489] C12 FlightsApiClient + offline JSON loader + bbox helper
ADR-010 primary cold-start path now has a real source for the cache bbox
and the takeoff origin. Single concrete strategy (`HttpxFlightsApiClient`)
behind a `@runtime_checkable` Protocol; offline JSON fallback (`load_flight_file`)
shares the same DTO shape per FAC-INV-1.
* `flights_api/interface.py` — `FlightsApiClient` Protocol + `FlightDto`
+ `WaypointDto` + `WaypointObjective` / `WaypointSource` enums (plain
frozen-slotted dataclasses, matching project's LatLonAlt / PoseEstimate
pattern).
* `flights_api/errors.py` — 8-class hierarchy under `FlightsApiError`.
* `flights_api/_parser.py` — shared JSON validator: range checks, lat/lon
bounds, contiguous ordinals, finite floats, enum membership.
* `flights_api/bbox.py` — `bbox_from_waypoints` envelopes lat/lon and
inflates by a horizontal-distance buffer via WgsConverter ENU
round-trip (NOT degree-space); `takeoff_origin_from_flight` passes
waypoints[0] through unrounded.
* `flights_api/file_loader.py` — orjson-backed offline loader.
* `flights_api/httpx_client.py` — concrete client with ONE retry on
transient 5xx + connect errors; token redaction at every log site;
test-injectable transport + sleep.
* `runtime_root/c12_factory.py` — `build_flights_api_client(config)`;
re-exported from `runtime_root/__init__.py`. OperatorToolServices
aggregate intentionally deferred to AZ-328 per scope discipline.
* `pyproject.toml` — `httpx>=0.28,<1.0` added (chosen over `requests`
for native `MockTransport` testing).
Tests: 28 cases across AC-1..AC-18 plus extras (malformed JSON,
negative buffer, zero buffer, missing top-level fields, negative
ordinal, empty-flight takeoff). Full repo run: 713 passed, 2 skipped.
Co-authored-by: Cursor <cursoragent@cursor.com>
|
2026-05-12 01:28:49 +03:00 |
|