satellite-provider/_docs/02_document/ripple_log_cycle1.md

Ripple Log — Cycle 1 (AZ-484)

Generated by document/SKILL.md Task mode, Step 0.5 (Import-Graph Ripple).

Cycle scope

• AZ-484 — Multi-source tile storage schema

Changed source identifiers (Step 0)

• SatelliteProvider.DataAccess.Migrations.013_AddTileSourceAndCapturedAt.sql (DDL — not a C# import target)
• SatelliteProvider.Common.Enums.TileSource (new)
• SatelliteProvider.Common.Enums.TileSourceConverter (new)
• SatelliteProvider.DataAccess.Models.TileEntity (added Source, CapturedAt; Source typed as string per L-001 workaround)
• SatelliteProvider.DataAccess.Repositories.TileRepository (ColumnList, GetByTileCoordinatesAsync, GetTilesByRegionAsync, InsertAsync, UpdateAsync)
• SatelliteProvider.DataAccess.TypeHandlers.EnumStringTypeHandler (registration list — net-zero after the L-001 pivot)
• SatelliteProvider.Services.TileDownloader.TileService.BuildTileEntity (stamps Source + CapturedAt)

Reverse-dependency analysis (Step 0.5)

Tooling: Grep over the C# tree for using SatelliteProvider.Common.Enums, TileSource, TileEntity, ITileRepository references.

Direct importers of the changed identifiers (already in the AZ-484 changeset)

• SatelliteProvider.DataAccess/Models/TileEntity.cs — imports Common.Enums (uses TileSourceConverter.GoogleMapsWireValue const for the field default)
• SatelliteProvider.Services.TileDownloader/TileService.cs — imports Common.Enums (calls TileSourceConverter.ToWireValue(TileSource.GoogleMaps))
• SatelliteProvider.Tests/TileServiceTests.cs, TileSourceConverterTests.cs, RepositoryRefactorTests.cs, EnumStringTypeHandlerTests.cs
• SatelliteProvider.IntegrationTests/MigrationTests.cs

All of the above were edited and their tests were re-run as part of AZ-484 itself; no documentation ripple is required for them.

Indirect importers requiring doc refresh

The only consumers that touch TileEntity as a type (not as a column-aware contract) are:

• SatelliteProvider.Services.TileDownloader/GoogleMapsDownloaderV2.cs — accepts IEnumerable<TileEntity> for the cache-skip parameter. No doc ripple: the downloader treats TileEntity as an opaque cache token; the new Source / CapturedAt columns are not accessed by the downloader.
• Program.cs (WebApi) — calls ITileRepository.GetByTileCoordinatesAsync and InsertAsync. No doc ripple to api_program.md: the endpoint contract did not change (response DTO TileMetadata is unaffected by AZ-484; Source and CapturedAt are not currently projected to the public API).
• RegionService / RegionProcessingService — call ITileService methods, not ITileRepository directly. No doc ripple: the ITileService method signatures are unchanged; the most-recent-across-sources read rule is fully enforced inside TileRepository and is invisible to region/route consumers.

Refreshed-anyway docs (within the immediate scope)

The following docs were refreshed during this Update Docs step because they describe the storage layer or its direct boundary, and AZ-484 changed the substantive content even though import graphs alone would not have triggered them:

• _docs/02_document/modules/dataaccess_tile_repository.md — interface signatures (FindExistingTileAsync removal, AZ-484 selection rule, 5-col UPSERT key); changed by direct edit (in scope)
• _docs/02_document/modules/dataaccess_models.md — TileEntity field list (Source as string + L-001 note, CapturedAt); changed by direct edit (in scope)
• _docs/02_document/modules/dataaccess_migrator.md — migration count 11 → 13, entries for 012 and 013; changed by direct edit (in scope)
• _docs/02_document/modules/services_tile_service.md — DownloadAndStoreTilesAsync selection rule + UPSERT semantics, BuildTileEntity source stamping, Common.Enums dependency; changed by direct edit (in scope)
• _docs/02_document/modules/tests_integration.md — MigrationTests AZ-484 method list; changed by direct edit (in scope)
• _docs/02_document/components/03_tile_downloader/description.md — upstream dependency list (Common.Enums), tile-metadata caching strategy now reads "append-by-source per cell"; changed by direct edit (in scope)
• _docs/02_document/components/02_data_access/description.md — ITileRepository table (FindExistingTileAsync row removed; AZ-484 annotations on Get/Insert), Queries table (UPSERT key now 5-col + source), Caveats (UPSERT semantics, L-001 note, contract pointer); changed by direct edit (in scope)
• _docs/02_document/data_model.md — tiles table columns (source, captured_at added; version / maps_version flagged vestigial), Indexes section (replaced unique key entry, added selection-rule + UPSERT contract notes), Migration History (012, 013); changed by direct edit (in scope)
• _docs/02_document/module-layout.md — Common Public API list (TileSourceConverter already present; updated DataAccess "Imports from" 5 → 6 sites including Models/TileEntity; new Common/Enums subsection with the L-001 guidance); changed by direct edit (in scope)
• _docs/02_document/architecture.md, _docs/02_document/glossary.md, _docs/02_document/contracts/data-access/tile-storage.md — already updated during the AZ-484 implementation batch (see batch_25_cycle1_report.md)

Heuristic mode flag

Not used. Direct Grep over the C# tree was sufficient — no parser failure, no fall-back to directory-proximity scanning.

Summary

• Direct importers in AZ-484 changeset: 7 (already updated as part of the implementation)
• Indirect importers requiring NO doc ripple: 3 (GoogleMapsDownloaderV2, Program.cs, RegionService chain)
• In-scope refresh-anyway docs: 10 (listed above)
• Out-of-scope ripple-only docs: 0