mirror of
https://github.com/azaion/gps-denied-onboard.git
synced 2026-06-21 08:31:13 +00:00
Oleksandr Bezdieniezhnykh
b12db61444
Implements the AZ-263 / E-BOOT initial structure task:
- Python src/-layout package `gps_denied_onboard/` with per-component
interface stubs (14 components), type-only DTOs under `_types/`,
shared helpers under `helpers/` (R14 LightGlue ownership), structured
JSON logging, runtime composition root with env-var fail-fast gate,
healthcheck module shared by Docker and CI smoke.
- CMake top-level + `cmake/{build_options,dependencies,strategies}.cmake`
with the BUILD_* per-binary flags (ADR-002) and pinned external git
refs for OKVIS2 / VINS-Mono / GTSAM / FAISS / OpenCV >=4.12.0.
- Three Dockerfiles (companion-tier1, operator-tooling,
mock-suite-sat-service) + two compose files (dev + Tier-1 test).
- Four GitHub Actions workflows: ci.yml (lint/unit/integration/dual
binary build/SBOM diff/security), ci-tier2.yml (self-hosted Jetson
AC-bound NFTs), release.yml, cve-rescan.yml.
- Two CI gate scripts: `ci/sbom_diff.py` (deployment SBOM subset +
R02 exclusion), `ci/opencv_pin_gate.py` (>=4.12.0 enforcement,
D-CROSS-CVE-1).
- Alembic-driven Postgres 16 initial migration `0001_initial.py`
mirroring satellite-provider tiles + flights + sector_classifications
+ manifests + engine_cache_entries (data_model.md s 2).
- Tier-1 test scaffolding: 95 passing unit tests covering every AC,
per-component smoke tests, structured logging JSON output check,
env-var gate check, healthcheck import check. Two CI-gated tests
(cmake configure, actionlint) skip locally with explicit reasons.
- Batch report + code review report under `_docs/03_implementation/`.
Verdict: PASS_WITH_WARNINGS (two Low findings, both informational).
Co-authored-by: Cursor <cursoragent@cursor.com>
33 lines
954 B
Python
33 lines
954 B
Python
"""C6 `TileStore` + `DescriptorIndex` Protocols.
|
|
|
|
Concrete impl: `PostgresFilesystemStore` (Postgres mirror + filesystem mmap +
|
|
FAISS HNSW). See `_docs/02_document/components/08_c6_tile_cache/`.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Iterable
|
|
from typing import Protocol
|
|
|
|
from gps_denied_onboard._types.tile import Tile, TileRecord
|
|
|
|
|
|
class TileStore(Protocol):
|
|
"""Tile metadata + body store (mirrors satellite-provider; cached locally)."""
|
|
|
|
def get(self, tile_id: str) -> Tile | None: ...
|
|
|
|
def query_by_lat_lon(
|
|
self, lat: float, lon: float, zoom: int, radius_m: float
|
|
) -> Iterable[TileRecord]: ...
|
|
|
|
def put(self, record: TileRecord) -> None: ...
|
|
|
|
|
|
class DescriptorIndex(Protocol):
|
|
"""Vector index over tile descriptors (FAISS HNSW concrete impl)."""
|
|
|
|
def add(self, tile_id: str, descriptor) -> None: ...
|
|
|
|
def search(self, descriptor, top_k: int) -> Iterable[tuple[str, float]]: ...
|