Notification UI and Operations Source Map
Summary
One authoritative traceability table from UI and operations topic to verified source file. Every file listed exists in the reviewed repository.
Audience
Engineers, QA, support, DevOps engineers and architects.
Reference Content
The verified reference material for this topic is set out in the sections below.
Frontend — screens
| Topic | Source file |
|---|---|
| Employee inbox: filters, text categorisation, pull-to-refresh, mark read, action-URL handling, empty and error states | UI/salary-ui/apps/client-hrms-portal/src/pages/NotificationsPage.tsx |
| Header bell and drawer, 60-second polling, unread badge, mark all read, navigation entries and permission hints | UI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsx |
| Template administration: master-detail, draft editing, channel toggles, preview, reset modal, placeholder hint | UI/salary-ui/apps/client-hrms-portal/src/pages/admin/NotificationTemplateManagementPage.tsx |
| Notification Center console: four parallel loads, failed and audit panels, retry action, mixed template columns | UI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsx |
| Routes, protected-page wrapper and the employee-aware audience split | UI/salary-ui/apps/client-hrms-portal/src/App.tsx |
| Self-service notification list variant | UI/salary-ui/apps/client-hrms-portal/src/ess/EssPages.tsx |
| Super-admin re-export of the template screen | UI/salary-ui/apps/super-admin-portal/src/pages/admin/NotificationTemplateManagementPage.tsx |
Frontend — dashboard
| Topic | Source file |
|---|---|
| Notification statistics, failed and audit source fetches with per-source fallbacks | UI/salary-ui/apps/client-hrms-portal/src/dashboard/dashboardApi.ts |
| Notification KPI tiles, unavailable-state handling and the quick-action link | UI/salary-ui/apps/client-hrms-portal/src/dashboard/DashboardPages.tsx |
Backend — operations
| Topic | Source file |
|---|---|
| Startup sequence, migration guard, seeding invocation, middleware order, health and service-info mapping, provider selection | microservices/src/notification-service/Program.cs |
| Every configuration option, its default and grouping | microservices/src/notification-service/Application/NotificationOptions.cs |
| Committed configuration sections and development defaults | microservices/src/notification-service/appsettings.json |
| Broker connection settings and shared exchange name | microservices/src/shared-kernel/Messaging/RabbitMqOptions.cs |
| Consumer connect-retry loop, bound-to-queue and failure log lines, acknowledgement behavior | microservices/src/notification-service/Messaging/NotificationEventConsumer.cs |
| Duplicate, stale and delivery-failure log statements; audit stage writes | microservices/src/notification-service/Application/NotificationDispatcher.cs |
| Logging provider configuration, tracing setup, conditional exporters, absence of metrics | microservices/src/shared-kernel/Extensions/ObservabilityExtensions.cs |
| Service-information endpoint and response envelope | microservices/src/shared-kernel/Extensions/EndpointRouteBuilderExtensions.cs |
| Diagnostic and test endpoints, retry endpoint, statistics projection | microservices/src/notification-service/Api/NotificationEndpoints.cs |
| Template resolution order used in troubleshooting | microservices/src/notification-service/Application/TemplateEngine.cs |
| Preference enforcement without any write path | microservices/src/notification-service/Application/PreferenceEvaluator.cs |
| Supported event types and channel-override resolution | microservices/src/notification-service/Application/EventNotificationResolver.cs |
| Seeded default templates | microservices/src/notification-service/Seed/DefaultTemplateSeeder.cs |
| Local run ports | microservices/src/notification-service/Properties/launchSettings.json |
Backend — legacy surfaces
| Topic | Source file |
|---|---|
| Legacy notification endpoints the inbox and bell consume, merged sources and ownership enforcement | Controllers/NotificationsController.cs |
| Legacy template endpoints the administration screen consumes | Controllers/NotificationTemplatesController.cs |
Verification and utilities
| Topic | Source file |
|---|---|
| Smoke script parameters, direct and broker modes, gateway options | microservices/scripts/smoke-notification.ps1 |
| Manual request collection | microservices/src/notification-service/notification-service.http |
Classification
Verified source map.
Requires confirmation
None — every entry was confirmed to exist in the reviewed repository.
Related Articles
See Also
Keywords
- Notification database
- Source Map
- Draft database documentation
Source References
UI/salary-ui/apps/client-hrms-portal/src/pages/NotificationsPage.tsxUI/salary-ui/apps/client-hrms-portal/src/pages/admin/NotificationTemplateManagementPage.tsxUI/salary-ui/apps/client-hrms-portal/src/components/AppLayout.tsxUI/salary-ui/apps/client-hrms-portal/src/pages/admin/OperationsAdminPages.tsxUI/salary-ui/apps/client-hrms-portal/src/App.tsxUI/salary-ui/apps/client-hrms-portal/src/dashboard/dashboardApi.tsmicroservices/src/notification-service/Program.csmicroservices/src/notification-service/Application/NotificationOptions.csmicroservices/src/notification-service/Messaging/NotificationEventConsumer.csControllers/NotificationsController.csmicroservices/scripts/smoke-notification.ps1
Revision Information
- Status: Draft
- Last reviewed: 2026-07-21
- Review cycle: Quarterly