[AZ-484] Multi-source tile storage: source + captured_at

mirror of https://github.com/azaion/satellite-provider.git synced 2026-06-21 19:51:14 +00:00

Add per-source tile rows to support multi-provider imagery (Google
Maps + future UAV). Migration 013 (transactional) introduces
source/captured_at columns, backfills existing rows to
(source='google_maps', captured_at=created_at), and replaces the
4-column unique index with a 5-column index that includes source.

TileRepository:
- ColumnList includes source + captured_at
- GetByTileCoordinatesAsync returns most-recent row across sources
  (ORDER BY captured_at DESC, updated_at DESC, id DESC)
- GetTilesByRegionAsync uses DISTINCT ON to pick the most-recent
  tile per cell, restoring caller-facing row order
- Insert/Update upsert on the new 5-column conflict key

TileSource enum lives in Common.Enums. Snake_case wire format
(google_maps, uav) is enforced by a focused TileSourceTypeHandler
because the generic ToLowerInvariant pattern would emit
"googlemaps", violating contract v1.0.0.

TileService stamps Source=GoogleMaps + CapturedAt=UtcNow on every
new tile. Tile-storage contract is now frozen at v1.0.0.

AC coverage 7/7. New unit + integration tests cover all ACs;
existing 200 unit + 5 smoke tests preserved.

Co-authored-by: Cursor <cursoragent@cursor.com>

This commit is contained in:

Oleksandr Bezdieniezhnykh

2026-05-11 06:21:59 +03:00

parent 5ba58b6c8d

commit 687d6bdd5b

21 changed files with 884 additions and 48 deletions

									
										_docs/02_document/contracts/data-access/tile-storage.md
									
		+1
		-1
	
												View File
												
				@@ -4,7 +4,7 @@

				**Producer task**: AZ-484 — `_docs/02_tasks/todo/AZ-484_multi_source_tile_storage.md`

				**Consumer tasks**: AZ-485 (planned T2 — UAV upload endpoint); future tasks adding additional sources (e.g., SatAR)

				**Version**: 1.0.0

				**Status**: draft (frozen on AZ-484 implementation completion)

				**Status**: frozen

				**Last Updated**: 2026-05-11

				## Purpose