Platform Telemetry

All admin notification emails are sent through the IAdminNotificationEmailService interface, which follows this pattern:

1. Retrieve all active admin email addresses from the adminnotificationemailaddresses table
2. Build a styled HTML email body with the operation details (all user input is HTML-encoded to prevent XSS)
3. Queue the email in the emailstosend table with IsSent = false
4. The EmailSender background service picks up queued emails and delivers them

Notifications are fire-and-forget by design. If a notification fails to queue, the operation still succeeds and a warning is logged. This ensures that email delivery issues never block user operations.

The following pages in the Client Web application are instrumented with activity logging:

Activity logging is exposed through a clean service interface with convenience methods for each activity type:

public interface IActivityLogEntryService
{
    Task LogActivityAsync(ulong accountId, string activityType, string activityName,
        string? activityDetail = null, string? pageContext = null,
        string appSource = "ClientWeb");

    Task LogPageViewAsync(ulong accountId, string pageName,
        string appSource = "ClientWeb");

    Task LogLinkClickAsync(ulong accountId, string linkName,
        string? url = null, string? pageContext = null,
        string appSource = "ClientWeb");

    Task LogOperationAsync(ulong accountId, string operationName,
        string? detail = null, string? pageContext = null,
        string appSource = "ClientWeb");

    Task<IEnumerable<ActivityLogEntry>> GetByAccountIdAsync(
        ulong accountId, int limit = 50);

    Task<IEnumerable<ActivityLogEntry>> GetByAccountIdAndTypeAsync(
        ulong accountId, string activityType, int limit = 50);

    Task<ActivityLogStats> GetActivityLogStatsAsync();

    Task<(List<ActivityLogEntry> items, int totalCount)> GetActivityLogWithFilterAsync(
        ulong? accountId = null, string? activityType = null,
        string? appSource = null, DateTime? fromDate = null,
        DateTime? toDate = null, string? searchText = null,
        int pageSize = 20, int pageNumber = 1);

    Task<List<(ulong AccountId, int Count)>> GetTopAccountsByActivityAsync(
        int top, DateTime sinceDate);
}

All logging calls are fire-and-forget using _ = ActivityLogService.LogPageViewAsync(...) to ensure that logging never blocks or slows down the user experience. If a log entry fails to write, the user's operation is unaffected.