Asset Reference Source Map

Summary

This page maps the authoritative source files behind Asset Management, grouped by concern. Backend paths are rooted under the asset-service (or the relevant shared project), and frontend paths under the client HRMS portal. Each row gives the path, its purpose, the authoritative topics it governs, and the related documentation page.

Audience

Developers tracing behavior to code, QA engineers locating the source of a rule, and solution architects verifying provenance.

Reference Content

Frontend routes and pages

Path	Purpose	Authoritative topics	Related doc
UI/salary-ui/apps/client-hrms-portal/src/App.tsx	Route registration	Routes, legacy redirect	Route Reference
UI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx	Navigation and gates	Nav keys, feature gates	Route Reference
UI/salary-ui/apps/client-hrms-portal/src/pages/hr/HrOperationsPage.tsx	Admin assets tab	Admin view	Route Reference
UI/salary-ui/apps/client-hrms-portal/src/pages/ess/EssPages.tsx	ESS assets view	Self-service view	Route Reference
UI/salary-ui/apps/client-hrms-portal/src/pages/dashboard/DashboardPages.tsx	Dashboard surfaces	Dashboard entry	Route Reference
UI/salary-ui/apps/client-hrms-portal/src/utils/ProtectedRoute.tsx	Route guard	Visibility prefix rules	Permissions Matrix

API endpoints

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Api/AssetEndpoints.cs	Native endpoints	/asset/* surface	API Summary
microservices/src/asset-service/Api/AssetCompatEndpoints.cs	Compatibility endpoints	/api/hr-operations/* surface	API Summary
microservices/src/asset-service/Api/EndpointResults.cs	Result shaping	Response envelopes	API Summary

Domain

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Domain/Asset/Asset.cs	Aggregate root	Transitions, guards	Status Reference
microservices/src/asset-service/Domain/Asset/AssetDomainEvents.cs	Domain events	Six events	Event Summary
microservices/src/asset-service/Domain/Common/Enums.cs	Enums	Statuses, conditions	Status Reference
microservices/src/asset-service/Domain/Common/ValueObjects.cs	Value objects	Identity validation	Validation Catalog
microservices/src/asset-service/Domain/Common/DomainPrimitives.cs	Primitives	Shared domain types	Asset Terminology

Application

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Application/Commands/AssetCommands.cs	Commands	Application rules	Validation Catalog
microservices/src/asset-service/Application/WorkflowIntegration.cs	Workflow flow	Managed vs direct	Integration Reference
microservices/src/asset-service/Application/DocumentIntegration.cs	Document flow	Document refs	Integration Reference
microservices/src/asset-service/Application/Mappings.cs	Mapping	DTO mapping	API Summary
microservices/src/asset-service/Application/Dtos.cs	DTOs	Contracts	API Summary

Persistence

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Infrastructure/AssetDbContext.cs	EF context	Filters, indexes	Database Summary
microservices/src/asset-service/Infrastructure/Persistence.cs	Persistence wiring	Repositories	Database Summary
microservices/src/asset-service/Infrastructure/DevelopmentSeeder.cs	Seed data	Dev seed	Database Summary
microservices/src/asset-service/Infrastructure/Migrations/*	Migrations	Schema evolution	Database Summary

Messaging

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Messaging/OutboxRelayHostedService.cs	Relay	Outbox relay	Event Summary
microservices/src/shared-kernel/Messaging/OutboxProcessor.cs	Processor	Outbox processing	Event Summary
microservices/src/shared-kernel/Outbox/OutboxMessage.cs	Message	Outbox record	Event Summary

Integrations

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Infrastructure/WorkflowServiceClient.cs	Workflow client	Outbound workflow	Integration Reference
microservices/src/asset-service/Infrastructure/DocumentServiceClient.cs	Document client	Outbound document	Integration Reference
microservices/src/asset-service/Infrastructure/AssetDocumentGateway.cs	Document gateway	Reference/bytes split	Integration Reference

Contracts and gateway

Path	Purpose	Authoritative topics	Related doc
microservices/src/contracts/Events/AssetLifecycleEvents.cs	Event contracts	Six contracts, payload	Event Summary
microservices/src/gateway-api/Program.cs	Gateway	Reverse proxy, ESS composition	Integration Reference
microservices/src/gateway-api/EssEndpoints.cs	ESS composition	Labor-id filter	Permissions Matrix

Compatibility, backfill, and smoke

Path	Purpose	Authoritative topics	Related doc
microservices/src/asset-service/Application/Compatibility/AssetCompatContracts.cs	Compat contracts	Monolith shape	API Summary
microservices/src/asset-service/Backfill/AssetBackfillCli.cs	Backfill CLI	ETL entry	Consolidated Limitations
microservices/src/asset-service/Backfill/AssetBackfillRunner.cs	Backfill runner	ETL run	Consolidated Limitations
microservices/src/asset-service/Backfill/AssetBackfillValidator.cs	Backfill validator	ETL validation	Consolidated Limitations
microservices/src/asset-service/Backfill/AssetRecordBackfill.cs	Backfill record	Legacy mapping	Consolidated Limitations
microservices/src/asset-service/scripts/smoke-asset.ps1	Smoke tests	Coverage	Implementation Maturity

Source References

• microservices/src/asset-service/Domain/Asset/Asset.cs
• microservices/src/asset-service/Api/AssetEndpoints.cs
• UI/salary-ui/apps/client-hrms-portal/src/App.tsx

Related Articles

• Reference Overview
• API Summary
• Database Summary

See Also

• Technical README
• API endpoint catalog

Keywords

asset source map, source files, provenance, code map, authoritative sources

Revision Information

• Status: Draft
• Last reviewed: 2026-07-17
• Review cycle: Quarterly