mirror of
https://github.com/azaion/satellite-provider.git
synced 2026-06-21 18:11:14 +00:00
Oleksandr Bezdieniezhnykh
b0fffa6d42
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>
116 lines
4.9 KiB
Markdown
116 lines
4.9 KiB
Markdown
# Blackbox Test Scenarios
|
|
|
|
## BT-01: Single Tile Download
|
|
|
|
**Trigger**: GET /api/satellite/tiles/latlon?Latitude=47.461747&Longitude=37.647063&ZoomLevel=18
|
|
**Precondition**: Tile not in cache
|
|
**Expected**: HTTP 200; JSON with zoomLevel=18, tileSizePixels=256, imageType="jpg", filePath matching pattern `tiles/18/*/...`
|
|
**Pass criterion**: All fields present and correct values
|
|
|
|
## BT-02: Tile Cache Reuse
|
|
|
|
**Trigger**: Same GET as BT-01 repeated
|
|
**Precondition**: BT-01 completed (tile now cached)
|
|
**Expected**: HTTP 200; same tile ID returned; no new file created
|
|
**Pass criterion**: tile.Id matches first request's tile.Id
|
|
|
|
## BT-03: Region Request (200m, zoom 18, no stitch)
|
|
|
|
**Trigger**: POST /api/satellite/request with lat=47.461747, lon=37.647063, sizeMeters=200, zoomLevel=18, stitchTiles=false
|
|
**Expected**: HTTP 200 immediately; status transitions: pending → processing → completed
|
|
**Pass criterion**: Final status="completed"; csvFilePath non-empty; summaryFilePath non-empty; tilesDownloaded + tilesReused > 0
|
|
**Timeout**: 240s
|
|
|
|
## BT-04: Region Request (400m, zoom 17, no stitch)
|
|
|
|
**Trigger**: POST /api/satellite/request with lat=47.461747, lon=37.647063, sizeMeters=400, zoomLevel=17, stitchTiles=false
|
|
**Expected**: Same as BT-03
|
|
**Pass criterion**: Same as BT-03
|
|
**Timeout**: 240s
|
|
|
|
## BT-05: Region with Stitching (500m, zoom 18)
|
|
|
|
**Trigger**: POST /api/satellite/request with lat=47.461747, lon=37.647063, sizeMeters=500, zoomLevel=18, stitchTiles=true
|
|
**Expected**: Completes with stitched image generated
|
|
**Pass criterion**: status="completed"; stitched image file exists and size > 1024 bytes
|
|
**Timeout**: 240s
|
|
|
|
## BT-06: Simple Route Creation (2 points)
|
|
|
|
**Trigger**: POST /api/satellite/route with 2 waypoints (48.276067,37.384458) → (48.270740,37.374029), regionSize=500, zoom=18
|
|
**Expected**: Route created with interpolated intermediate points
|
|
**Pass criterion**: totalPoints > 2; every point spacing ≤ 200m; first point type="original"; last point type="original"; intermediates type="intermediate"
|
|
|
|
## BT-07: Route Retrieval by ID
|
|
|
|
**Trigger**: GET /api/satellite/route/{id} after BT-06
|
|
**Expected**: Same route returned with all points
|
|
**Pass criterion**: route.Id matches; points count matches creation response
|
|
|
|
## BT-08: Route with Map Processing
|
|
|
|
**Trigger**: POST /api/satellite/route with requestMaps=true, 2 points, regionSize=300
|
|
**Expected**: Route maps processed, stitched image and CSV created
|
|
**Pass criterion**: mapsReady=true; stitchedImagePath non-empty; csvFilePath non-empty; stitched image > 1024 bytes
|
|
**Timeout**: 180s
|
|
|
|
## BT-09: Route with Tiles ZIP
|
|
|
|
**Trigger**: POST /api/satellite/route with requestMaps=true, createTilesZip=true, 2 points
|
|
**Expected**: ZIP file created with tiles
|
|
**Pass criterion**: tilesZipPath non-empty; ZIP > 1024 bytes; ZIP entry count = unique tiles in CSV; entries start with "tiles/"; path has ≥5 parts (directory structure preserved)
|
|
**Timeout**: 180s
|
|
|
|
## BT-10: Complex Route (10 points, maps)
|
|
|
|
**Trigger**: POST /api/satellite/route with 10 waypoints, requestMaps=true, regionSize=300
|
|
**Expected**: All points interpolated; map tiles processed
|
|
**Pass criterion**: mapsReady=true; uniqueTileCount ≥ 10; stitched image > 1024 bytes
|
|
**Timeout**: 240s
|
|
|
|
## BT-11: Route with Geofences (10 points + 2 rectangles)
|
|
|
|
**Trigger**: POST /api/satellite/route with 10 waypoints + 2 geofence polygons, requestMaps=true
|
|
**Expected**: Geofence regions created and processed
|
|
**Pass criterion**: mapsReady=true; uniqueTileCount ≥ 10; stitched image > 1024 bytes; geofence regions linked to route
|
|
**Timeout**: 240s
|
|
|
|
## BT-12: Extended Route (20 points, maps)
|
|
|
|
**Trigger**: POST /api/satellite/route with 20 waypoints in separate geographic area, requestMaps=true
|
|
**Expected**: Large route processed completely
|
|
**Pass criterion**: mapsReady=true; uniqueTileCount ≥ 20; stitched image > 1024 bytes
|
|
**Timeout**: 360s
|
|
|
|
## Negative Scenarios
|
|
|
|
## BT-N01: Invalid Coordinates (out of range)
|
|
|
|
**Trigger**: GET /api/satellite/tiles/latlon?Latitude=91&Longitude=181&ZoomLevel=18
|
|
**Expected**: Error response
|
|
**Pass criterion**: HTTP 4xx or error in response body
|
|
|
|
## BT-N02: Invalid Zoom Level
|
|
|
|
**Trigger**: GET /api/satellite/tiles/latlon?Latitude=47.46&Longitude=37.64&ZoomLevel=25
|
|
**Expected**: Error response
|
|
**Pass criterion**: HTTP 4xx or error indicating invalid zoom
|
|
|
|
## BT-N03: Route with < 2 Points
|
|
|
|
**Trigger**: POST /api/satellite/route with only 1 point
|
|
**Expected**: Validation error
|
|
**Pass criterion**: HTTP 400 or validation error message
|
|
|
|
## BT-N04: Geofence with Invalid Coordinates (0,0)
|
|
|
|
**Trigger**: POST /api/satellite/route with geofence NW=(0,0) SE=(0,0)
|
|
**Expected**: Validation error
|
|
**Pass criterion**: Error message mentioning coordinates cannot be (0,0)
|
|
|
|
## BT-N05: Geofence with Inverted Corners
|
|
|
|
**Trigger**: POST /api/satellite/route with geofence NW.lat < SE.lat
|
|
**Expected**: Validation error
|
|
**Pass criterion**: Error message about northWest latitude > southEast latitude
|