azaion/satellite-provider

Fork 0

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

Files

T

Oleksandr Bezdieniezhnykh e3cd388577

ci/woodpecker/push/01-test Pipeline was successful

Details

ci/woodpecker/push/02-build-push Pipeline was successful

Details

[AZ-487] [AZ-488] docs: cycle 2 doc sync (task mode)

Step 13 (Update Docs) for cycle 2. Most cross-cutting docs were
already updated during Step 10 (architecture.md, glossary.md,
components/03_tile_downloader, modules/api_program.md, data_model.md,
contracts/api/uav-tile-upload.md). This commit completes the remaining
module-level + module-layout updates and writes the cycle-2 ripple log.

* modules/common_configs.md: + UavQualityConfig section and
  appsettings-section row (UavQuality).
* modules/common_dtos.md: + UavTileMetadata, UavTileBatchMetadataPayload,
  UavTileBatchUploadResponse, UavTileUploadResultItem, UavTileUploadStatus,
  UavTileRejectReasons (closed enumeration v1.0.0).
* module-layout.md: refresh Common (+ UavQualityConfig + UAV DTOs),
  TileDownloader (+ UavTileQualityGate, UavTileUploadHandler, +
  SixLabors.ImageSharp 3.1.11 PackageReference), and WebApi (+
  Authentication/*, DTOs/UavTileBatchUploadRequest, + JwtBearer 8.0.21
  PackageReference). Updates the "Last Updated" stamp to cycle 2.
* modules/tests_unit.md: replace the obsolete "only a dummy test"
  description; add cycle-2 AZ-487 / AZ-488 test classes
  (AuthenticationServiceCollectionExtensionsTests, JwtTokenFactoryTests,
  UavTileQualityGateTests, UavTileUploadHandlerTests, UavTileFilePathTests,
  PermissionsRequirementTests) + new ProjectReference / package
  references.
* modules/tests_integration.md: + JwtIntegrationTests, UavUploadTests
  (incl. wall-clock-seeded coordinate counter rationale from the Step 11
  fix), and the StubAndErrorContractTests update for the removed 501
  stub.
* ripple_log_cycle2.md (new): cycle-2 reverse-dependency scan results
  showing every importer of the new symbols resolves inside the three
  already-updated components (WebApi, TileDownloader, Common). No
  unexpected ripple, no heuristic fallback needed.

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

2026-05-12 00:04:05 +03:00

6.1 KiB

Raw Blame History

Cycle 2 — Documentation Ripple Log

Cycle: 2 (AZ-487 JWT validation baseline + AZ-488 UAV tile upload) Generated by: /document skill (task mode) during autodev Step 13 Resolution method: Grep --type cs against every new symbol introduced by the two tasks. C# using-based import analysis (SatelliteProvider.Api.Authentication, SatelliteProvider.Common.Configs.UavQualityConfig, the AZ-488 UavTile* DTOs, and the new IUavTileQualityGate / IUavTileUploadHandler interfaces). No static-analyzer (NDepend, etc.) was used — the search surface is small enough that a literal usage scan is exhaustive.

Directly-changed source files (cycle 2)

SatelliteProvider.Api/Program.cs (AZ-487 middleware + Authorize, AZ-488 endpoint rewire + Kestrel/FormOptions limits)
SatelliteProvider.Api/Authentication/AuthenticationServiceCollectionExtensions.cs (AZ-487, new)
SatelliteProvider.Api/Authentication/PermissionsRequirement.cs (AZ-488, new — also defines PermissionsAuthorizationHandler + SatellitePermissions)
SatelliteProvider.Api/DTOs/UavTileBatchUploadRequest.cs (AZ-488, new)
SatelliteProvider.Api/DTOs/UploadImageRequest.cs (AZ-488, deleted — legacy 501-stub DTO)
SatelliteProvider.Api/appsettings.json (AZ-487 Jwt section, AZ-488 UavQuality section)
SatelliteProvider.Common/Configs/UavQualityConfig.cs (AZ-488, new)
SatelliteProvider.Common/DTO/UavTileMetadata.cs (AZ-488, new — incl. UavTileBatchMetadataPayload)
SatelliteProvider.Common/DTO/UavTileBatchUploadResponse.cs (AZ-488, new — incl. UavTileUploadResultItem, UavTileUploadStatus, UavTileRejectReasons)
SatelliteProvider.Services.TileDownloader/UavTileQualityGate.cs (AZ-488, new — incl. IUavTileQualityGate)
SatelliteProvider.Services.TileDownloader/UavTileUploadHandler.cs (AZ-488, new — incl. IUavTileUploadHandler)
SatelliteProvider.Services.TileDownloader/TileDownloaderServiceCollectionExtensions.cs (AZ-488, updated to register the new services)
SatelliteProvider.Services.TileDownloader/SatelliteProvider.Services.TileDownloader.csproj (AZ-488, added SixLabors.ImageSharp 3.1.11)
SatelliteProvider.Tests/SatelliteProvider.Tests.csproj (AZ-487 JwtBearer, AZ-488 ImageSharp; new ProjectReference to SatelliteProvider.Api for the Authentication tests)
SatelliteProvider.IntegrationTests/* (AZ-487 JwtTestHelpers, AZ-488 UavUploadTests + multipart helpers; runner Program.cs invokes both suites)

Importer scan results

Symbol	Importer count	Importer files	Component touched
`AuthenticationServiceCollectionExtensions.AddSatelliteJwt`	2	`SatelliteProvider.Api/Program.cs`, `SatelliteProvider.Tests/Authentication/AuthenticationServiceCollectionExtensionsTests.cs`	WebApi, Tests (unit)
`PermissionsRequirement` / `PermissionsAuthorizationHandler` / `SatellitePermissions`	2	`SatelliteProvider.Api/Program.cs`, `SatelliteProvider.Tests/Authentication/PermissionsRequirementTests.cs`	WebApi, Tests (unit)
`UavTileBatchUploadRequest`	1	`SatelliteProvider.Api/Program.cs`	WebApi
`UavQualityConfig`	4	`Program.cs`, `UavTileQualityGate.cs`, `UavTileUploadHandler.cs`, `UavTileQualityGateTests.cs`	WebApi, TileDownloader, Tests (unit)
`UavTileMetadata` / `UavTileBatchMetadataPayload`	3	`Program.cs`, `UavTileUploadHandler.cs`, integration `UavUploadTests` (via JSON only)	WebApi, TileDownloader, Tests (integration)
`UavTileBatchUploadResponse` / `UavTileUploadResultItem` / `UavTileUploadStatus` / `UavTileRejectReasons`	4	`Program.cs`, `UavTileQualityGate.cs`, `UavTileUploadHandler.cs`, `UavUploadTests` (integration deserialization)	WebApi, TileDownloader, Tests (integration)
`IUavTileQualityGate` / `UavTileQualityGate`	3	`UavTileUploadHandler.cs` (consumer), `TileDownloaderServiceCollectionExtensions.cs` (DI registration), `UavTileQualityGateTests.cs`	TileDownloader, Tests (unit)
`IUavTileUploadHandler` / `UavTileUploadHandler`	2	`Program.cs` (consumer via DI), `TileDownloaderServiceCollectionExtensions.cs`	WebApi, TileDownloader

Doc refresh decisions

All importers land inside three components that already received targeted updates during Step 10 (Implement) and this Step 13:

WebApi — _docs/02_document/modules/api_program.md updated during AZ-487/AZ-488 implementation (endpoint table, DTOs, DI, handler, config, security). Re-verified during Step 13; no further edits required this pass.
TileDownloader — _docs/02_document/components/03_tile_downloader/description.md updated during implementation (UavTileQualityGate + UavTileUploadHandler service sections). Re-verified Step 13; no further edits required.
Common — _docs/02_document/modules/common_configs.md (added UavQualityConfig) and _docs/02_document/modules/common_dtos.md (added UAV DTOs + reject-reason enum) updated in this Step-13 pass.

System-level docs also updated during implementation: architecture.md (Architecture Vision + Security Architecture + ADR-004 per-source layout), glossary.md (UAV + reject-reason terms), data_model.md (per-source file_path semantics), contracts/api/uav-tile-upload.md v1.0.0 (new frozen contract).

Step-13 additions to module-layout.md: Public API lines for Common (UavQualityConfig + UAV DTOs), TileDownloader (UavTileQualityGate, UavTileUploadHandler + ImageSharp PackageReference), and WebApi (Authentication/*, DTOs/UavTileBatchUploadRequest.cs, JwtBearer PackageReference). Tests module docs (tests_unit.md, tests_integration.md) refreshed with the new cycle-2 test classes; the obsolete "only a dummy test" claim in tests_unit.md was corrected.

No-ripple components

These components were NOT touched by cycle-2 changes and require no doc update:

DataAccess — no new symbols imported; ITileRepository.InsertAsync is consumed unchanged.
RegionProcessing — no imports against cycle-2 symbols.
RouteManagement — no imports against cycle-2 symbols.

Parse-failure / heuristic notes

None — every symbol resolved via direct Grep. No fallback heuristic was needed.

6.1 KiB Raw Blame History