Introduce render gate and chart caching

Replace UI DispatcherTimer polling with a StudySnapshotRenderGate across multiple widgets to queue and apply only the latest analytics snapshot; components updated include StudyDeductionReasonsWidget, StudyEnvironmentWidget, StudyInterruptDensityWidget, StudyNoiseCurveWidget. Add StudySnapshotRenderGate implementation to coordinate rendering and monitoring leases and update subscription/lease lifecycle handling (subscribe/unsubscribe, Acquire/Dispose leases, Clear/Dispose gate). Rewrite chart controls (StudyNoiseCurveChartControl and StudyNoiseDistributionScatterChartControl) to use stable logical-time origins, split series into static vs dynamic tails, add geometry/sample caching, stable jitter/coordinate mapping helpers, and expose internal helpers & counts for testing. Add unit tests (StudyComponentRenderingTests) covering the render gate and chart behaviors (layer counts, logical X mapping, stable jitter, cache rebuild). These changes improve rendering correctness and performance by avoiding redundant renders and enabling deterministic chart layout.
2026-06-20 23:54:26 +08:00 · 2026-05-06 16:00:45 +08:00
parent 68ca532dc0
commit b71687cecd
55 changed files with 4529 additions and 1059 deletions
--- a/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Core/Publishing/PlondsDeltaBuildOptions.cs
+++ b/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Core/Publishing/PlondsDeltaBuildOptions.cs
@@ -11,4 +11,6 @@ public sealed record PlondsDeltaBuildOptions(
    string? BaselineVersion = null,
    string? BaselineTag = null,
    string? BaselinePayloadZip = null,
-    bool IsFullPayload = false);
+    bool IsFullPayload = false,
+    string? StaticOutputRoot = null,
+    string? UpdateBaseUrl = null);
--- a/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Core/Publishing/PlondsDeltaBuilder.cs
+++ b/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Core/Publishing/PlondsDeltaBuilder.cs
@@ -53,7 +53,13 @@ public sealed class PlondsDeltaBuilder
            ? new Dictionary<string, PayloadUtilities.FileFingerprint>(StringComparer.OrdinalIgnoreCase)
            : PayloadUtilities.ScanDirectory(baselineExtractRoot);
        var currentManifest = PayloadUtilities.ScanDirectory(currentExtractRoot);
-        var fileEntries = BuildFileEntries(previousManifest, currentManifest, objectsRoot);
+        var updateBaseUrl = string.IsNullOrWhiteSpace(options.UpdateBaseUrl)
+            ? null
+            : options.UpdateBaseUrl.TrimEnd('/');
+        var repoBaseUrl = string.IsNullOrWhiteSpace(updateBaseUrl)
+            ? null
+            : $"{updateBaseUrl}/repo/sha256";
+        var fileEntries = BuildFileEntries(previousManifest, currentManifest, objectsRoot, repoBaseUrl);

        var updateAssetName = $"update-{options.Platform}.zip";
        var fileMapAssetName = $"plonds-filemap-{options.Platform}.json";
@@ -76,6 +82,7 @@ public sealed class PlondsDeltaBuilder
            ["isFullPayload"] = useFullPayload ? "true" : "false"
        };

+        var generatedAt = DateTimeOffset.UtcNow;
        var component = new ComponentDocument(
            Name: "app",
            Version: options.CurrentVersion,
@@ -95,7 +102,7 @@ public sealed class PlondsDeltaBuilder
            Platform: options.Platform,
            Arch: PayloadUtilities.ResolveArch(options.Platform),
            Channel: options.Channel,
-            GeneratedAt: DateTimeOffset.UtcNow,
+            GeneratedAt: generatedAt,
            Metadata: metadata,
            Components: [component],
            Files: fileEntries);
@@ -103,6 +110,20 @@ public sealed class PlondsDeltaBuilder
        PayloadUtilities.WriteJson(fileMapPath, fileMap);
        _signer.SignFile(fileMapPath, options.PrivateKeyPath, fileMapSignaturePath);

+        if (!string.IsNullOrWhiteSpace(options.StaticOutputRoot) && !string.IsNullOrWhiteSpace(updateBaseUrl))
+        {
+            WriteStaticLayout(
+                options,
+                component,
+                objectsRoot,
+                distributionId,
+                fileMapPath,
+                fileMapSignaturePath,
+                Path.GetFullPath(options.StaticOutputRoot),
+                updateBaseUrl,
+                generatedAt);
+        }
+
        var summary = new PlondsReleasePlatformEntry(
            Platform: options.Platform,
            DistributionId: distributionId,
@@ -135,7 +156,8 @@ public sealed class PlondsDeltaBuilder
    private static List<FileEntryDocument> BuildFileEntries(
        IReadOnlyDictionary<string, PayloadUtilities.FileFingerprint> previousManifest,
        IReadOnlyDictionary<string, PayloadUtilities.FileFingerprint> currentManifest,
-        string objectsRoot)
+        string objectsRoot,
+        string? repoBaseUrl)
    {
        var result = new List<FileEntryDocument>();

@@ -152,12 +174,16 @@ public sealed class PlondsDeltaBuilder
                    Size: current.Size,
                    ObjectPath: null,
                    ObjectKey: null,
+                    ObjectUrl: null,
                    Metadata: null));
                continue;
            }

            var action = previousManifest.ContainsKey(path) ? "replace" : "add";
            var objectPath = PayloadUtilities.CopyObject(current.FullPath, objectsRoot, current.Sha256);
+            var objectUrl = string.IsNullOrWhiteSpace(repoBaseUrl)
+                ? null
+                : $"{repoBaseUrl.TrimEnd('/')}/{objectPath}";
            var metadata = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
            {
                ["mode"] = "file-object"
@@ -174,6 +200,7 @@ public sealed class PlondsDeltaBuilder
                Size: current.Size,
                ObjectPath: objectPath,
                ObjectKey: objectPath,
+                ObjectUrl: objectUrl,
                Metadata: metadata));
        }

@@ -191,12 +218,87 @@ public sealed class PlondsDeltaBuilder
                Size: 0,
                ObjectPath: null,
                ObjectKey: null,
+                ObjectUrl: null,
                Metadata: null));
        }

        return result;
    }

+    private static void WriteStaticLayout(
+        PlondsDeltaBuildOptions options,
+        ComponentDocument component,
+        string objectsRoot,
+        string distributionId,
+        string fileMapPath,
+        string fileMapSignaturePath,
+        string staticOutputRoot,
+        string updateBaseUrl,
+        DateTimeOffset generatedAt)
+    {
+        var repoRoot = Path.Combine(staticOutputRoot, "repo", "sha256");
+        var manifestRoot = Path.Combine(staticOutputRoot, "manifests", distributionId);
+        var distributionRoot = Path.Combine(staticOutputRoot, "meta", "distributions");
+        var channelRoot = Path.Combine(staticOutputRoot, "meta", "channels", options.Channel, options.Platform);
+
+        CopyDirectory(objectsRoot, repoRoot);
+        Directory.CreateDirectory(manifestRoot);
+        File.Copy(fileMapPath, Path.Combine(manifestRoot, "plonds-filemap.json"), overwrite: true);
+        File.Copy(fileMapSignaturePath, Path.Combine(manifestRoot, "plonds-filemap.json.sig"), overwrite: true);
+
+        var fileMapUrl = $"{updateBaseUrl}/manifests/{Uri.EscapeDataString(distributionId)}/plonds-filemap.json";
+        var distribution = new DistributionDocument(
+            DistributionId: distributionId,
+            Version: options.CurrentVersion,
+            SourceVersion: options.BaselineVersion ?? "0.0.0",
+            Channel: options.Channel,
+            Platform: options.Platform,
+            Arch: PayloadUtilities.ResolveArch(options.Platform),
+            PublishedAt: generatedAt,
+            FileMapUrl: fileMapUrl,
+            FileMapSignatureUrl: fileMapUrl + ".sig",
+            Components: [component],
+            InstallerMirrors: [],
+            Capabilities: ["file-object"],
+            Metadata: new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
+            {
+                ["protocol"] = "PLONDS",
+                ["releaseTag"] = options.CurrentTag,
+                ["baselineTag"] = options.BaselineTag ?? string.Empty,
+                ["baselineVersion"] = options.BaselineVersion ?? "0.0.0",
+                ["targetVersion"] = options.CurrentVersion,
+                ["isFullPayload"] = options.IsFullPayload ? "true" : "false"
+            });
+
+        var latest = new LatestPointerDocument(
+            DistributionId: distributionId,
+            Version: options.CurrentVersion,
+            Channel: options.Channel,
+            Platform: options.Platform,
+            PublishedAt: generatedAt);
+
+        PayloadUtilities.WriteJson(Path.Combine(distributionRoot, distributionId + ".json"), distribution);
+        PayloadUtilities.WriteJson(Path.Combine(channelRoot, "latest.json"), latest);
+    }
+
+    private static void CopyDirectory(string sourceDir, string destinationDir)
+    {
+        Directory.CreateDirectory(destinationDir);
+        foreach (var directory in Directory.EnumerateDirectories(sourceDir, "*", SearchOption.AllDirectories))
+        {
+            var relativePath = Path.GetRelativePath(sourceDir, directory);
+            Directory.CreateDirectory(Path.Combine(destinationDir, relativePath));
+        }
+
+        foreach (var file in Directory.EnumerateFiles(sourceDir, "*", SearchOption.AllDirectories))
+        {
+            var relativePath = Path.GetRelativePath(sourceDir, file);
+            var destinationPath = Path.Combine(destinationDir, relativePath);
+            Directory.CreateDirectory(Path.GetDirectoryName(destinationPath)!);
+            File.Copy(file, destinationPath, overwrite: true);
+        }
+    }
+
    private sealed record FileMapDocument(
        string FormatVersion,
        string DistributionId,
@@ -224,5 +326,35 @@ public sealed class PlondsDeltaBuilder
        long Size,
        string? ObjectPath,
        string? ObjectKey,
+        string? ObjectUrl,
        IReadOnlyDictionary<string, string>? Metadata);
+
+    private sealed record DistributionDocument(
+        string DistributionId,
+        string Version,
+        string SourceVersion,
+        string Channel,
+        string Platform,
+        string Arch,
+        DateTimeOffset PublishedAt,
+        string FileMapUrl,
+        string FileMapSignatureUrl,
+        IReadOnlyList<ComponentDocument> Components,
+        IReadOnlyList<InstallerMirrorDocument> InstallerMirrors,
+        IReadOnlyList<string> Capabilities,
+        IReadOnlyDictionary<string, string>? Metadata);
+
+    private sealed record LatestPointerDocument(
+        string DistributionId,
+        string Version,
+        string Channel,
+        string Platform,
+        DateTimeOffset PublishedAt);
+
+    private sealed record InstallerMirrorDocument(
+        string Platform,
+        string? Url,
+        string? FileName,
+        string? Sha256,
+        long Size);
 }
--- a/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Tool/Program.cs
+++ b/PenguinLogisticsOnlineNetworkDistributionSystem/src/Plonds.Tool/Program.cs
@@ -135,7 +135,9 @@ internal static class PlondsCli
            BaselineVersion: Get(options, "baseline-version"),
            BaselineTag: Get(options, "baseline-tag"),
            BaselinePayloadZip: Get(options, "baseline-zip"),
-            IsFullPayload: bool.TryParse(Get(options, "is-full-payload", "false"), out var isFullPayload) && isFullPayload));
+            IsFullPayload: bool.TryParse(Get(options, "is-full-payload", "false"), out var isFullPayload) && isFullPayload,
+            StaticOutputRoot: Get(options, "static-output-dir"),
+            UpdateBaseUrl: Get(options, "update-base-url")));

        Console.WriteLine($"Built PLONDS delta for {result.Platform}: {result.UpdateArchivePath}");
        Console.WriteLine(result.FileMapPath);
@@ -211,7 +213,7 @@ internal static class PlondsCli
    {
        Console.WriteLine("PLONDS Tool");
        Console.WriteLine("  pack-payload --source-dir <dir> --output-zip <file>");
-        Console.WriteLine("  build-delta --platform <platform> --current-version <v> --current-tag <tag> --current-zip <file> --output-dir <dir> --private-key <pem> [--baseline-tag <tag>] [--baseline-version <v>] [--baseline-zip <file>] [--is-full-payload]");
+        Console.WriteLine("  build-delta --platform <platform> --current-version <v> --current-tag <tag> --current-zip <file> --output-dir <dir> --private-key <pem> [--baseline-tag <tag>] [--baseline-version <v>] [--baseline-zip <file>] [--is-full-payload] [--static-output-dir <dir>] [--update-base-url <url>]");
        Console.WriteLine("  build-index --release-tag <tag> --version <v> --platform-summaries-dir <dir> --output-dir <dir> --private-key <pem> [--channel <channel>]");
        Console.WriteLine("  build-ddss --release-tag <tag> --assets-dir <dir> --output-dir <dir> --private-key <pem> --repository <owner/repo> [--s3-base-url <url>]");
        Console.WriteLine("  sign --manifest <file> --private-key <pem> [--output <file>]");