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

Files

T

Oleksandr Bezdieniezhnykh b0fffa6d42 [AZ-284] Autodev baseline + testability refactor

Phase A baseline outputs from /autodev (Steps 1-5):
- Problem & solution docs (_docs/00_problem, _docs/01_solution)
- Codebase documentation (_docs/02_document) incl. architecture,
  module-layout, glossary, system-flows, baseline compliance scan
- Test specs (blackbox, performance, resilience, security, resource,
  traceability matrix)
- Test task decomposition (_docs/02_tasks/todo): AZ-285..AZ-290
- Testability refactor (_docs/04_refactoring/01-testability-refactoring):
  - TC-01 Move DownloadedTileInfoV2 + new ExistingTileInfo to Common.DTO
  - TC-02 Replace dead ISatelliteDownloader API with real signatures
  - TC-03 GoogleMapsDownloaderV2 implements ISatelliteDownloader
  - TC-04 TileService depends on ISatelliteDownloader (mockable)
  - TC-05 DI + endpoints use ISatelliteDownloader
- Test runner scripts (scripts/run-tests.sh, run-performance-tests.sh)
- Autodev state pointer (_docs/_autodev_state.md)

Prepares the codebase for AZ-285..AZ-290 unit/integration test work.

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

2026-05-10 04:44:08 +03:00

3.1 KiB

Raw Blame History

Glossary

Domain Terms

Term	Definition	Source
Tile	A single satellite imagery square (typically 256×256 px) at a specific zoom level and coordinate	modules/services_tile_service.md
Region	A square geographic area defined by center point and size in meters; the unit of work for batch tile downloads	modules/services_region_service.md
Route	An ordered sequence of geographic waypoints with interpolated intermediate points	modules/services_route_service.md
Route Point	A single lat/lon coordinate on a route; either "original" (user-provided waypoint) or "intermediate" (system-generated)	modules/dataaccess_models.md
Geofence	A rectangular geographic boundary (NW + SE corners) used to filter which route points receive map tile coverage	components/05_route_management/description.md
Zoom Level	Google Maps tile resolution level (1–20); higher = more detail, smaller ground coverage per tile	modules/common_configs.md
Stitch	Compositing multiple tiles into a single larger image with optional markers/borders	modules/services_region_service.md
Layer 1	Satellite imagery from external providers (provider-agnostic; first implementation: Google Maps)	user clarification
Layer 2	UAV-captured nadir camera imagery (orthogonal tiles uploaded post-flight)	user clarification
Nadir Camera	Downward-facing camera on a UAV capturing ground imagery during flight	user clarification
GPS-Denied Service	The consuming system: a UAV navigation service operating without GPS, using satellite/UAV imagery for positioning	user clarification
Slippy Map Coordinates	Tile X/Y indices in the Web Mercator projection grid (standard for web map tile servers)	data_model.md
Version	Integer year (e.g., 2025) used to invalidate tile cache when Google Maps imagery is updated	data_model.md

Technical Terms

Term	Definition	Source
Region Request Queue	In-process bounded `Channel<Guid>` that decouples HTTP request submission from background processing	modules/services_region_request_queue.md
Session Token	Provider-specific authentication token (e.g., Google Maps) embedded in tile download URLs; each provider may use different auth mechanisms	modules/services_google_maps_downloader.md
ISatelliteDownloader	Interface abstracting satellite imagery providers; first implementation: Google Maps (GoogleMapsDownloaderV2)	modules/common_interfaces.md
DbUp	.NET library for forward-only SQL schema migrations via numbered embedded scripts	modules/dataaccess_database_migrator.md
Tile Deduplication	Mechanism using DB unique index + ConcurrentDictionary to prevent re-downloading identical tiles	modules/services_google_maps_downloader.md

Abbreviations

Abbrev	Meaning
MGRS	Military Grid Reference System (endpoint planned, currently stub)
UAV	Unmanned Aerial Vehicle
NFR	Non-Functional Requirement
DI	Dependency Injection
DTO	Data Transfer Object
CSV	Comma-Separated Values (tile manifest output format)

3.1 KiB Raw Blame History Unescape Escape

Glossary

Domain Terms

Technical Terms

Abbreviations

3.1 KiB

Raw Blame History