docs(xml): fill missing XML doc comments + strip task-tracking refs across src (fixdocs)
Add missing <summary>/<param>/<returns>/<typeparam> tags and switch interface implementations to <inheritdoc/> across 106 files; strip project bookkeeping identifiers (Task NN, #05-TNN, PLAN-04, StoreAndForward-0NN) from shipped code comments while preserving the descriptive rationale. Comment-only: zero code-logic lines changed; solution builds 0/0. Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj
This commit is contained in:
@@ -110,7 +110,7 @@ public class CentralHealthAggregator : BackgroundService, ICentralHealthAggregat
|
||||
// Unknown site — register it as online, awaiting its first
|
||||
// full report. LatestReport and LastReportReceivedAt both stay
|
||||
// null until ProcessReport runs — "no report yet" is an explicit
|
||||
// nullable state, not a year-0001 sentinel the UI must special-case.
|
||||
// nullable state, not a DateTime.MinValue sentinel the UI must special-case.
|
||||
var registered = new SiteHealthState
|
||||
{
|
||||
SiteId = siteId,
|
||||
|
||||
@@ -19,5 +19,6 @@ public interface IHealthReportTransport
|
||||
/// </summary>
|
||||
/// <param name="report">The site health report to send.</param>
|
||||
/// <param name="cancellationToken">Cancels the in-flight send.</param>
|
||||
/// <returns>A task that represents the asynchronous operation.</returns>
|
||||
Task SendAsync(SiteHealthReport report, CancellationToken cancellationToken);
|
||||
}
|
||||
|
||||
@@ -63,11 +63,11 @@ public static class ServiceCollectionExtensions
|
||||
services.AddHostedService(sp => sp.GetRequiredService<CentralHealthAggregator>());
|
||||
services.AddHostedService<CentralHealthReportLoop>();
|
||||
|
||||
// Task 10 (arch-review 04): the central backlog aggregate for the Audit Log
|
||||
// KPI *history*. Only the central node runs the aggregator, so this seam is
|
||||
// registered here; the AuditLogKpiSampleSource resolves it (optional ctor
|
||||
// param) and records the real cross-site backlog instead of the append-only
|
||||
// repository's hardwired zero. Sites leave it unregistered → snapshot fallback.
|
||||
// The central backlog aggregate for the Audit Log KPI *history*. Only the
|
||||
// central node runs the aggregator, so this seam is registered here; the
|
||||
// AuditLogKpiSampleSource resolves it (optional ctor param) and records the
|
||||
// real cross-site backlog instead of the append-only repository's hardwired
|
||||
// zero. Sites leave it unregistered → snapshot fallback.
|
||||
services.AddSingleton<
|
||||
Commons.Interfaces.Kpi.IAuditBacklogProvider,
|
||||
Kpi.CentralHealthAuditBacklogProvider>();
|
||||
|
||||
Reference in New Issue
Block a user