Notification API Source Map
Summary
One authoritative traceability table from API documentation topic to verified source file. Every file listed exists in the reviewed repository.
Audience
Engineers, architects, QA, support and security reviewers.
Reference Content
The verified reference material for this topic is set out in the sections below.
Native service sources
| Topic | Source file |
|---|---|
| All 15 resource endpoints, route groups, request DTOs | microservices/src/notification-service/Api/NotificationEndpoints.cs |
| Startup, middleware order, health mapping, Swagger, service-info mapping | microservices/src/notification-service/Program.cs |
| Entities returned directly on the wire | microservices/src/notification-service/Domain/NotificationEntities.cs |
| Persistence context used directly by handlers; absence of a global tenant filter | microservices/src/notification-service/Infrastructure/NotificationDbContext.cs |
| Dispatcher invoked by the retry and dispatch endpoints | microservices/src/notification-service/Application/NotificationDispatcher.cs |
| Template rendering used by the template test endpoint | microservices/src/notification-service/Application/TemplateEngine.cs |
| Channel sender resolution used by the template test live-send path | microservices/src/notification-service/Channels/ChannelSenderRegistry.cs |
| Event envelope constructed by the dispatch hook | microservices/src/notification-service/Messaging/NotificationEventEnvelope.cs |
| Consumer that processes events published by the publish hook | microservices/src/notification-service/Messaging/NotificationEventConsumer.cs |
| Retry bounds applied during endpoint-triggered retry | microservices/src/notification-service/Application/RetryPolicy.cs |
| Application abstractions injected into handlers | microservices/src/notification-service/Application/Abstractions.cs |
| Manual request collection | microservices/src/notification-service/notification-service.http |
Shared platform sources
| Topic | Source file |
|---|---|
| Service-information endpoint mapped at the service root | microservices/src/shared-kernel/Extensions/EndpointRouteBuilderExtensions.cs |
| Correlation identifier resolution, request items and response header | microservices/src/shared-kernel/Middleware/CorrelationIdMiddleware.cs |
| Response envelope and service-info payload | microservices/src/contracts/Common/ApiResponse.cs |
| Observability registration invoked at startup | microservices/src/shared-kernel/Extensions/ObservabilityExtensions.cs |
Gateway sources
| Topic | Source file |
|---|---|
| Feature toggle, owned prefixes, generated prefix routes, shadow route, clusters, route-source header | microservices/src/gateway-api/Program.cs |
| Self-service aggregation endpoints that read notification data | microservices/src/gateway-api/EssEndpoints.cs |
Compatibility sources
| Topic | Source file |
|---|---|
| Six authorized notification operations, ownership enforcement, notification DTO | Controllers/NotificationsController.cs |
| Four authorized template operations and four template DTOs | Controllers/NotificationTemplatesController.cs |
Frontend sources
| Topic | Source file |
|---|---|
| Notification list, read and read-all calls against the legacy paths; navigation permission hints | UI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx |
| Employee notification page consuming the legacy paths | UI/salary-ui/apps/client-hrms-portal/src/pages/NotificationsPage.tsx |
| Template administration page consuming the legacy template path | UI/salary-ui/apps/client-hrms-portal/src/pages/admin/NotificationTemplateManagementPage.tsx |
| Operations dashboard reading the native statistics, failed-queue and audit paths | UI/salary-ui/apps/client-hrms-portal/src/dashboard/dashboardApi.ts |
| Self-service notification view consuming the gateway aggregation route | UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx |
| Route registration for the notification views | UI/salary-ui/apps/client-hrms-portal/src/App.tsx |
Verification sources
| Topic | Source file |
|---|---|
| Smoke coverage of 15 native endpoints, direct and broker modes, gateway shadow exercise | microservices/scripts/smoke-notification.ps1 |
Classification
Verified source map.
Requires confirmation
None — every entry was confirmed to exist in the reviewed repository.
Related Articles
See Also
Keywords
- Notification API
- Source Map
- Draft API documentation
Source References
microservices/src/notification-service/Api/NotificationEndpoints.csmicroservices/src/notification-service/Program.csmicroservices/src/gateway-api/Program.csmicroservices/src/gateway-api/EssEndpoints.csControllers/NotificationsController.csControllers/NotificationTemplatesController.csmicroservices/scripts/smoke-notification.ps1
Revision Information
- Status: Draft
- Last reviewed: 2026-07-21
- Review cycle: Quarterly