Files
Oleksandr Bezdieniezhnykh 865dfdb3b9
ci/woodpecker/push/01-test Pipeline was successful
ci/woodpecker/push/02-build-push Pipeline was successful
[AZ-794] [AZ-795] [AZ-796] Strict input validation + z/x/y rename
AZ-794: rename inventory wire fields tileZoom/tileX/tileY -> z/x/y
to match the slippy-map URL convention. Contract bumped to v2.0.0.

AZ-795: shared validation infrastructure -- FluentValidation +
ValidationEndpointFilter + GlobalValidatorConfig (camelCase paths).
GlobalExceptionHandler now converts JsonException (UnmappedMember +
JsonRequired) into RFC 7807 ValidationProblemDetails. JSON layer
hardened with UnmappedMemberHandling.Disallow + camelCase naming
policy. New error-shape.md contract.

AZ-796: InventoryRequestValidator covers 9 rules (XOR tiles vs
locationHashes, cap 1000, z 0..22, x/y in slippy bounds, hash
length/charset). 16 unit tests + 16 integration tests + a manual
curl probe script.

Adjacent fixes uncovered by the new strict layer:
- IdempotentPostTests RoutePoint payload corrected to lat/lon
  (the DTO has used JsonPropertyName for ages; previously silently
  ignored under PascalCase fallback).
- TileInventoryTests slippy x/y reduced to fit z=18 bounds.
- docker-compose.yml host port for Postgres moved 5432 -> 5433 to
  avoid sibling-project conflict; appsettings.Development + README
  + AGENTS + architecture + containerization docs aligned.

New coderule (suite + repo): API consumer-facing OpenAPI
descriptions must not contain task IDs, contract filenames, or
version-bump history -- internal change tracking belongs in
commits/contract docs/changelogs. Existing offending descriptions
in Program.cs cleaned up.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-22 10:02:02 +03:00

1.8 KiB

Containerization

Docker Image

Base image: mcr.microsoft.com/dotnet/aspnet:10.0 (was :8.0 through cycle 3 — bumped by AZ-500) Build image: mcr.microsoft.com/dotnet/sdk:10.0 (was :8.0 through cycle 3 — bumped by AZ-500) Build strategy: Multi-stage (restore → build → publish → runtime) Exposed ports: 8080 (HTTP), 8081 (management/metrics)

Container Composition (docker-compose.yml)

Service Image Ports (host:container) Purpose
postgres postgres:16 5433:5432 Database (host port 5433 chosen to avoid conflicts with sibling-project Postgres instances on dev laptops)
api Custom (Dockerfile) 18980:8080, 18981:8081 Application

Volumes

Mount Container Path Purpose
./tiles /app/tiles Tile image storage
./ready /app/ready Output artifacts (CSV, summary, stitched, ZIP)
./logs /app/logs Serilog file output
postgres_data (named) /var/lib/postgresql/data Database persistence

Health Checks

  • PostgreSQL: pg_isready -U postgres (interval 5s, timeout 5s, retries 5)
  • API: depends on postgres health (startup ordering)

Environment Variables

Variable Source Purpose
ASPNETCORE_ENVIRONMENT docker-compose Environment selection
ASPNETCORE_URLS docker-compose Listen address
ConnectionStrings__DefaultConnection docker-compose DB connection string
MapConfig__ApiKey Host env GOOGLE_MAPS_API_KEY Google Maps API key
AZAION_REVISION Build arg (CI_COMMIT_SHA) Git revision tracking

Build Labels (OCI)

  • org.opencontainers.image.revision — Git commit SHA
  • org.opencontainers.image.created — Build timestamp
  • org.opencontainers.image.source — Repository URL