Asset Persistence Source Map
Summary
Verified mapping from each persistence concern to its authoritative source path and the documentation page that covers it.
Audience
Backend engineers, database reviewers, architects, QA, support, operations, security reviewers, and product owners.
Overview
Every path below was verified in the local source checkout of the asset-service project. Paths are repository-relative. Documentation for API contracts, events, and operational procedures remains reserved for their dedicated epics.
Persistence source map
| Concern | Authoritative source | Related documentation |
|---|---|---|
| DbContext, model configuration, query filters, outbox mapping | microservices/src/asset-service/Infrastructure/AssetDbContext.cs | DbContext and Object Sets, Entity Mappings, Tenant Isolation |
| Repository, unit of work, tenant context, audit/timeline writers, outbox store, design-time factory | microservices/src/asset-service/Infrastructure/Persistence.cs | Transactions and Save Boundaries, Audit and Timeline Storage |
| Asset aggregate, children, owned collections | microservices/src/asset-service/Domain/Asset/Asset.cs | Asset Storage, Assignment History Storage, Document Reference Storage |
| Value objects | microservices/src/asset-service/Domain/Common/ValueObjects.cs | Value-Object Conversions |
| Enums (status, condition) | microservices/src/asset-service/Domain/Common/Enums.cs | Asset Storage, Data Integrity |
| Repository port | microservices/src/asset-service/Domain/Repositories.cs | Keys and Relationships |
| Write commands, workflow callback idempotency | microservices/src/asset-service/Application/Commands/AssetCommands.cs | Data Integrity, Workflow Reference Storage |
| Document reference commands | microservices/src/asset-service/Application/Commands/DocumentCommands.cs | Document Reference Storage |
| Read queries, clearance | microservices/src/asset-service/Application/Queries/AssetQueries.cs | Query Patterns |
| Compatibility surface | microservices/src/asset-service/Application/Compatibility/AssetCompatService.cs | Compatibility Identity Storage, Query Patterns |
| Outbox relay | microservices/src/asset-service/Messaging/OutboxRelayHostedService.cs | Outbox Storage |
| Migration, designer, model snapshot | microservices/src/asset-service/Infrastructure/Migrations/ | Migrations and Snapshot |
| Development seeding | microservices/src/asset-service/Infrastructure/DevelopmentSeeder.cs | Development Seeding |
| Backfill runner, step, types, validator, audit, source reader | microservices/src/asset-service/Backfill/ | Compatibility Backfill |
| Composition, migration startup, DI | microservices/src/asset-service/Program.cs | Migrations and Snapshot, Persistence Architecture |
| Shared asset contracts | microservices/src/contracts/Events/AssetLifecycleEvents.cs | Outbox Storage |
| Persistence test evidence | microservices/scripts/smoke-asset.ps1 | Database Testing Guide |
Classification
Verified source index for the current checkout.
Requires confirmation
Production ownership and authoritative-source parity with any non-local checkout require confirmation.
Related Articles
See Also
Keywords
- Asset persistence
- Source Map
- Draft database documentation
Source References
microservices/src/asset-service/Infrastructure/AssetDbContext.csmicroservices/src/asset-service/Infrastructure/Persistence.csmicroservices/src/asset-service/Domain/Asset/Asset.csmicroservices/src/asset-service/Backfill/AssetRecordBackfill.cs
Revision Information
- Status: Draft
- Last reviewed: 2026-07-17
- Review cycle: Quarterly