2 Commits

Author	SHA1	Message	Date
Oleksandr Bezdieniezhnykh	909f69cb3a	[AZ-505] Tile inventory endpoint + HTTP/2 + Leaflet covering index ... Production code: - POST /api/satellite/tiles/inventory (XOR body, 5000-cap, most-recent-per-location_hash select, present/absent shaping). - Kestrel HttpProtocols.Http1AndHttp2 on every listener (AC-5). - Migration 015 creates tiles_leaflet_path covering index over (location_hash, captured_at DESC, updated_at DESC, id DESC) INCLUDE (file_path, source); drops superseded idx_tiles_location_hash. - TileRepository.GetByTileCoordinatesAsync rewired to filter by location_hash (Index Only Scan via tiles_leaflet_path). - TileRepository.GetTilesByLocationHashesAsync added with Npgsql- direct ANY($1::uuid[]) binding (Dapper IEnumerable expansion is incompatible with the array form). - Uuidv5.LocationHashForTile centralises the UUIDv5(TileNamespace, "{z}/{x}/{y}") formula — single source of truth for the cross-repo invariant (gps-denied-onboard parity). Contracts: - New: contracts/api/tile-inventory.md v1.0.0. - Bumped: contracts/data-access/tile-storage.md to v2.0.0 (joint ownership by AZ-503-foundation + AZ-505: schema + covering index + GetByTileCoordinatesAsync rewrite). Tests: - TileInventoryTests covers AC-1, AC-2 (DB-level), AC-4, AC-6. - Http2MultiplexingTests covers AC-5 (20 concurrent multiplexed GETs over h2c via SocketsHttpHandler + AppContext Http2Unencrypted switch). - LeafletPathIndexOnlyTests covers AC-3 (EXPLAIN (ANALYZE, BUFFERS) asserts Index Only Scan over tiles_leaflet_path with heap_blocks=0). Docs: - architecture.md, system-flows.md, data_model.md, module-layout.md, glossary.md, modules/api_program.md, modules/dataaccess_tile_repository.md, components/02_data_access/description.md all updated to reference the v2.0.0 tile-storage contract + new tile-inventory contract + AC-7. Reports: - batch_01_cycle6_report.md, batch_01_cycle6_review.md, implementation_completeness_cycle6_report.md (PASS), implementation_report_tile_inventory_cycle6.md. Task spec moved todo/ -> done/. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-12 21:16:37 +03:00
Oleksandr Bezdieniezhnykh	c646aa93e2	[AZ-503] Tile identity → UUIDv5 + integer UPSERT (foundation) ... Foundation half of original AZ-503 (split during /autodev step 10 batch 2 on user choice; deferred work moved to AZ-505 with a Blocks link). Adds deterministic tile identity (UUIDv5 over (z, x, y, source, flight_id)) shared cross-repo with gps-denied-onboard via the pinned TileNamespace 5b8d0c2e-7f1a-4d3b-9c5e-1f3a8e7d2b6c, switches the tiles UPSERT key from floats to integers with per-flight separation, plumbs FlightId through UavTileMetadata + handler, and writes UAV evidence to per-flight on-disk directories so two flights at the same (z, x, y) coexist. - Common: pure-C# RFC 9562 Uuidv5 (no third-party dep) + FlightId DTO field; 10 Python-reference unit vectors verify byte parity. - DataAccess: migration 014 adds flight_id (uuid NULL), location_hash (uuid NOT NULL, backfilled via session-scoped pg_temp.uuidv5), content_sha256 (bytea NULL), legacy_id (uuid NULL = preserves pre-AZ-503 random id one cycle); drops idx_tiles_unique_location_source (AZ-484) and adds idx_tiles_unique_identity keyed on (tile_zoom, tile_x, tile_y, tile_size_meters, source, COALESCE(flight_id, '00000000-...'::uuid)) + idx_tiles_location_hash. - TileRepository: ColumnList + UPSERT updated; id never updated on conflict (preserves AC-2 idempotence). UpdateAsync extended. - Services: TileService and UavTileUploadHandler compute deterministic Id + LocationHash + ContentSha256 before insert; UAV file path becomes ./tiles/uav/{flight_id or 'none'}/{z}/{x}/{y}.jpg. - Tests: Uuidv5Tests (10 reference vectors), UavTileFilePathTests (per-flight + anonymous paths), UavTileUploadHandlerTests (AC-2, AC-3, AC-7, AC-11 unit-level), UavUploadTests (AC-3 + AC-4 integration: multi-flight DB coexistence with shared location_hash + distinct file_path; float-different lat/lon collapse to 1 row), MigrationTests (column shape, idx_tiles_unique_identity supersedes AZ-484 index, deterministic backfill). - IntegrationTests project references Common to reuse Uuidv5 in raw SQL seeds. - AZ-488 MultiSourceCoexistence seed fixed to populate location_hash (otherwise migration 014's NOT NULL constraint fails). ACs covered: AC-1, AC-2, AC-3, AC-4, AC-7, AC-8, AC-11. ACs deferred to AZ-505: AC-5, AC-6, AC-9, AC-10, AC-12. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-12 17:07:35 +03:00