Files
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

38 lines
1.7 KiB
Markdown

# Resilience Test Scenarios
## RS-01: API Startup with Database Ready
**Trigger**: Start API container after PostgreSQL is healthy
**Observable**: API responds to HTTP requests
**Pass criterion**: API returns non-5xx response within 60s of container start
## RS-02: Database Migrations on Fresh Start
**Trigger**: Start API against empty database
**Observable**: All 11 migrations execute successfully
**Pass criterion**: API starts without error; all tables exist; schemaversions table has 11 entries
## RS-03: Region Processing Survives Tile Download Failure
**Trigger**: Submit region request where some tiles may fail (rate limit / timeout)
**Observable**: Region either completes (with partial tiles) or is marked "failed"
**Pass criterion**: Status is either "completed" or "failed" (never stuck in "processing" indefinitely); max processing time < 300s
## RS-04: Queue Capacity Limit
**Trigger**: Submit 1001+ region requests rapidly (exceeds capacity 1000)
**Observable**: Queue rejects overflow requests
**Pass criterion**: First 1000 accepted; subsequent requests return error or are dropped; no crash
## RS-05: Concurrent Download Limit Respected
**Trigger**: Submit large region (many tiles) and observe download concurrency
**Observable**: At most MaxConcurrentDownloads (4) HTTP requests to Google Maps simultaneously
**Pass criterion**: No more than 4 concurrent outbound tile requests at any point (behavioral; requires observation or logging)
## RS-06: Route Processing with All Regions Completing
**Trigger**: Create route with requestMaps=true, wait for completion
**Observable**: Route transitions from processing to ready
**Pass criterion**: mapsReady=true; no regions stuck in "processing"