refactor!: rename the project from Monitor to MoShiro [CI]

Namespaces, assemblies, solution, binaries, images, systemd units, config paths, environment variables, protocol methods and the Linux user are all renamed. Breaking: existing databases, node identities and installed units must be recreated.
2026-10-07 02:03:25 +08:00
1 parent 27ac7fb787
commit 2e146d4da7
@@ -0,0 +1,185 @@
+namespace MoShiro.Backend.Api;
+
+/// <summary>汇总：整个时间段由累加器精确合并得出的值（不是各点的平均）。</summary>
+public sealed record SummaryDto(IReadOnlyDictionary<string, double?> Metrics, IReadOnlyDictionary<string, long> Samples, double Coverage);
+
+public sealed record EdgePartialDto(bool First, bool Last);
+
+public sealed record GapDto(DateTimeOffset From, DateTimeOffset To, string Reason);
+
+public sealed record EventDto(long Id, string? AgentId, string Kind, DateTimeOffset At, string? Detail);
+
+public sealed record TestSummaryDto(string Id, string Plan, string Status, DateTimeOffset RequestedAt, DateTimeOffset? FinishedAt);
+
+public sealed record OverviewLineDto(
+    string Id,
+    string AgentId,
+    string ProbeId,
+    string ProbeName,
+    string Name,
+    IReadOnlyList<string> Labels,
+    bool Online,
+    bool ProbeConnected,
+    int EndpointChanges,
+    SummaryDto Summary,
+    TestSummaryDto? LastTest);
+
+public sealed record OverviewDto(string Range, DateTimeOffset From, DateTimeOffset To, string Step, string Source, bool Degraded, IReadOnlyList<OverviewLineDto> Lines);
+
+/// <summary>列式响应：时间轴 <c>t</c>（Unix 毫秒）只出现一次，<c>values</c> 里每个数组的长度都与 <c>t</c> 相同；没有数据的桶是 null。</summary>
+public sealed record SeriesDto(
+    string LineId,
+    string AgentId,
+    string ProbeId,
+    DateTimeOffset From,
+    DateTimeOffset To,
+    string Step,
+    string Source,
+    bool Live,
+    bool Degraded,
+    IReadOnlyList<long> T,
+    IReadOnlyDictionary<string, double?[]> Values,
+    SummaryDto Summary,
+    EdgePartialDto EdgePartial,
+    IReadOnlyList<GapDto> Gaps,
+    IReadOnlyList<EventDto> Events,
+    IReadOnlyDictionary<string, string> Versions);
+
+public sealed record CompareDto(
+    string Metric,
+    DateTimeOffset From,
+    DateTimeOffset To,
+    string Step,
+    string Source,
+    bool Degraded,
+    IReadOnlyList<long> T,
+    IReadOnlyDictionary<string, double?[]> Values,
+    IReadOnlyDictionary<string, double?> Summary);
+
+public sealed record DistributionBucketDto(double Le, long Count);
+
+public sealed record DistributionDto(string Metric, string Unit, IReadOnlyList<DistributionBucketDto> Buckets, double? P50, double? P95, double? P99, long Count);
+
+public sealed record HeatmapDto(
+    string Metric,
+    string Step,
+    string Source,
+    bool Degraded,
+    IReadOnlyList<long> T,
+    IReadOnlyList<double> Edges,
+    IReadOnlyList<IReadOnlyList<long>> Counts);
+
+/// <summary>一条线路 = 一对（Agent，Probe）；<c>id</c> 是 <c>&lt;agent_id&gt;~&lt;probe_id&gt;</c>。</summary>
+public sealed record LineDto(
+    string Id,
+    string AgentId,
+    string ProbeId,
+    string ProbeName,
+    string Name,
+    IReadOnlyList<string> Labels,
+    bool Online,
+    bool ProbeConnected,
+    DateTimeOffset? DataSince,
+    IReadOnlyList<string> Kinds,
+    TestSummaryDto? LastTest);
+
+public sealed record DimensionDto(string Id, string Label, double Weight, double? Value, double? Score);
+
+public sealed record ScoreDto(double? Score, int Version, bool Estimated, IReadOnlyList<DimensionDto> Dimensions, IReadOnlyList<string> Caveats);
+
+public sealed record TestStepDto(int Index, double TargetMbps, double LossPct, double? JitterP95Ms, double DeliveredMbps);
+
+public sealed record TestResultDto(
+    IReadOnlyDictionary<string, double> Metrics,
+    IReadOnlyDictionary<string, ScoreDto> Scores,
+    IReadOnlyDictionary<string, double?[]> Series,
+    IReadOnlyList<TestStepDto> Steps,
+    IReadOnlyList<string> Caveats);
+
+public sealed record TestDto(
+    string Id,
+    string AgentId,
+    string ProbeId,
+    string Plan,
+    IReadOnlyList<string> Phases,
+    string Status,
+    int? Phase,
+    string? ErrorCode,
+    string Trigger,
+    DateTimeOffset RequestedAt,
+    DateTimeOffset? StartedAt,
+    DateTimeOffset? FinishedAt,
+    TestResultDto? Result);
+
+// ── 目录（由代码注册表生成） ──────────────────────────────────────────
+
+public sealed record ParamDto(string Name, string Type, System.Text.Json.JsonElement Default, double? Min, double? Max, string? Unit, IReadOnlyList<string>? Values, string Description);
+
+public sealed record BlocksDto(string Transport, string Pacer, string Payload, string Behavior, IReadOnlyList<string> Samplers);
+
+public sealed record ColumnDto(string Name, string Type, string Encoding, bool Nullable, string? Role);
+
+public sealed record StreamDto(string Name, IReadOnlyList<ColumnDto> Columns);
+
+public sealed record KindDto(string Id, string Title, string Description, IReadOnlyList<string> Scopes, BlocksDto Blocks, IReadOnlyList<ParamDto> Params, IReadOnlyList<StreamDto> Streams);
+
+public sealed record PhaseDto(string Kind, int DurationS, System.Text.Json.JsonElement Params);
+
+public sealed record PlanDto(string Id, string Title, string Description, IReadOnlyList<PhaseDto> Phases);
+
+public sealed record MetricDto(
+    string Id,
+    string DefinitionId,
+    string Accumulator,
+    string Stat,
+    string Label,
+    string Description,
+    string Unit,
+    string Better,
+    double? Good,
+    double? Poor,
+    string Version,
+    IReadOnlyList<string> From);
+
+public sealed record PresetDto(string Id, string Label, IReadOnlyList<string> Metrics);
+
+public sealed record ModelDto(string Id, string Title, int Version, IReadOnlyList<string> Needs);
+
+public sealed record LiveNodeDto(string Kind, string Id, bool Online, DateTimeOffset At);
+
+public sealed record LiveTestDto(string TestId, string Status, int? Phase, int Phases);
+
+/// <summary>
+/// 主机资源占用（展示页能拿到的全部内容）：只有汇总的数字，<b>没有 CPU 型号、主机名、网卡名，也没有任何 IP 地址</b>。
+/// 这些字段 Agent 根本不采集，所以即使这里写漏了也泄漏不出去。
+/// </summary>
+public sealed record HostDto(
+    double? CpuPercent,
+    long? MemUsed,
+    long? MemTotal,
+    long? DiskUsed,
+    long? DiskTotal,
+    long? NetRxTotal,
+    long? NetTxTotal,
+    long? NetRxBps,
+    long? NetTxBps,
+    long? NetLinkMbps,
+    long? UptimeSeconds,
+    DateTimeOffset At);
+
+/// <summary>一个 Agent 的最新主机状态；<c>stale</c> 表示超过 15 秒没有更新（离线，或者 Agent 关闭了上报）。</summary>
+/// <summary>节点的展示信息：只有系统、架构、国家代码、运营商，没有任何地址；站点打开「显示构建信息」之后还有版本和 tag。</summary>
+public sealed record NodeInfoDto(string Id, string Kind, string? Os, string? OsName, string? Arch, string? Country, string? IspKey, string? IspName, string? Version = null, string? Tag = null);
+
+/// <summary>一个程序的构建信息：版本、tag、提交（短）和构建时间（UTC，ISO 8601）。没设置的是 <c>null</c>。</summary>
+public sealed record BuildDto(string Version, string? Tag, string? Commit, string? BuiltAt);
+
+/// <summary>公开的「关于」：站点没有打开「显示构建信息」时只有 <c>show_build: false</c>。</summary>
+public sealed record AboutDto(bool ShowBuild, BuildDto? Backend);
+
+public sealed record HostItemDto(string AgentId, string Name, bool Online, bool Stale, DateTimeOffset? LastSeenAt, HostDto? Host);
+
+public sealed record LiveHostDto(string AgentId, bool Online, HostDto Host);
+
+/// <summary>主机资源占用的历史（列式，按步长取平均）。</summary>
+public sealed record HostSeriesDto(string AgentId, DateTimeOffset From, DateTimeOffset To, string Step, IReadOnlyList<long> T, IReadOnlyDictionary<string, double?[]> Values);