mirror of
https://github.com/azaion/satellite-provider.git
synced 2026-06-21 21:31: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>
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
# Module: Tests/SatelliteProvider.IntegrationTests
|
|
|
|
## Purpose
|
|
Console application that runs end-to-end integration tests against a live API instance. Designed to run in Docker alongside the API and PostgreSQL containers.
|
|
|
|
## Public Interface
|
|
|
|
### Test Classes
|
|
- `TileTests` — tile download via lat/lon endpoint
|
|
- `RegionTests` — region request → polling → completion flow
|
|
- `BasicRouteTests` — route creation with intermediate points
|
|
- `ComplexRouteTests` — routes with geofencing
|
|
- `ExtendedRouteTests` — routes with `requestMaps: true` and tile ZIP creation
|
|
|
|
### Supporting Classes
|
|
- `Models.cs` — HTTP response DTOs for deserialization
|
|
- `RouteTestHelpers.cs` — shared utilities (wait-for-completion polling, geofence polygon builders, test data)
|
|
- `Program.cs` — test runner entry point
|
|
|
|
## Internal Logic
|
|
- Makes HTTP calls to the API at `API_URL` environment variable (default: `http://api:8080`)
|
|
- Tests are methods called sequentially from `Program.cs` (not xUnit — plain console app)
|
|
- Poll-based waiting for async operations (region/route completion)
|
|
- Validates response structure, status transitions, file creation
|
|
|
|
## Dependencies
|
|
- No project references (standalone console app)
|
|
- Communicates with the API exclusively via HTTP
|
|
- NuGet: implicit .NET 8 runtime
|
|
|
|
## Consumers
|
|
- `docker-compose.tests.yml` — runs as a container that depends on the API service
|
|
|
|
## Configuration
|
|
- `API_URL` environment variable (set in docker-compose.tests.yml to `http://api:8080`)
|
|
|
|
## External Integrations
|
|
- HTTP to the SatelliteProvider API
|
|
- Reads output files from mounted `./ready/` and `./tiles/` volumes
|
|
|
|
## Security
|
|
None.
|
|
|
|
## Tests
|
|
This IS the integration test suite.
|