Files
Chronos/src/Titano.Uploader/Sources/SessionGrouper.cs
T
Claude 62c7b0d956 feat(uploader): persisted upload queue, session grouping and queue texts
Per-file states (queued, hashing, uploading, verified, skipped, failed
with reason), batches with their target (auto sessions, sequence, new
sequence), uploader-queue.json persistence with interrupted transfers
resuming as queued, photo scanning of files/folders/card roots, BRIEF
§13 session keys (45 min gap, test shots merged), throughput meter and
culture-aware queue/progress lines.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-02 10:27:12 +00:00

90 lines
4.0 KiB
C#

using System.Globalization;
using System.IO;
using System.Security.Cryptography;
using System.Text;
namespace Titano.Uploader.Sources;
/// <summary>The last session of a source, so later files within the gap join it (watch folders).</summary>
public sealed record SessionContinuation(string Key, DateTime LastCapture);
/// <summary>Session key per input frame (input order) and the session the next batch may continue.</summary>
public sealed record SessionAssignment(IReadOnlyList<string> Keys, SessionContinuation? Last);
/// <summary>
/// Splits frames of one source into shooting sessions with the card-import rules (BRIEF §13): a gap longer than
/// <see cref="Gap"/> starts a session; sessions with fewer than <see cref="MinimumFrames"/> frames (test shots) merge
/// into the previous session, or into the next one when they come first. The server turns each key into a sequence.
/// </summary>
public static class SessionGrouper
{
/// <summary><c>SessionGapMinutes</c> default.</summary>
public static readonly TimeSpan Gap = TimeSpan.FromMinutes(45);
/// <summary><c>MinimumSessionFrames</c> default.</summary>
public const int MinimumFrames = 8;
/// <summary>Groups <paramref name="captureTimes"/>; keys start with <paramref name="sourceTag"/> so sources never collide.</summary>
public static SessionAssignment Assign(IReadOnlyList<DateTime> captureTimes, string sourceTag, SessionContinuation? previous = null)
{
if (captureTimes.Count == 0) return new SessionAssignment([], previous);
var order = Enumerable.Range(0, captureTimes.Count).OrderBy(i => captureTimes[i]).ToArray();
// Split on gaps; a group that continues the previous batch keeps its key and is never "small".
var groups = new List<Group>();
var current = new Group { Continues = previous is not null && (captureTimes[order[0]] - previous.LastCapture).Duration() <= Gap };
for (var n = 0; n < order.Length; n++)
{
var i = order[n];
if (n > 0 && captureTimes[i] - captureTimes[order[n - 1]] > Gap)
{
groups.Add(current);
current = new Group();
}
current.Members.Add(i);
}
groups.Add(current);
var merged = new List<Group>();
foreach (var g in groups)
{
if (merged.Count > 0 && g.Members.Count < MinimumFrames) merged[^1].Members.AddRange(g.Members);
else merged.Add(g);
}
if (merged.Count > 1 && merged[0].Members.Count < MinimumFrames && !merged[0].Continues)
{
merged[0].Members.AddRange(merged[1].Members);
merged.RemoveAt(1);
}
var keys = new string[captureTimes.Count];
string? lastKey = null;
foreach (var g in merged)
{
var first = g.Members.Min(i => captureTimes[i]);
lastKey = g.Continues ? previous!.Key : Key(sourceTag, first);
foreach (var i in g.Members) keys[i] = lastKey;
}
var lastCapture = captureTimes[order[^1]];
if (previous is not null && previous.LastCapture > lastCapture && merged[^1].Continues) lastCapture = previous.LastCapture;
return new SessionAssignment(keys, new SessionContinuation(lastKey!, lastCapture));
}
/// <summary>Short stable tag for a source folder: 8 hex digits of the SHA-256 of its normalised path.</summary>
public static string SourceTag(string root)
{
var normalized = Path.TrimEndingDirectorySeparator(Path.GetFullPath(root)).ToUpperInvariant();
return Convert.ToHexStringLower(SHA256.HashData(Encoding.UTF8.GetBytes(normalized)))[..8];
}
/// <summary><c>{tag}-{yyyyMMdd-HHmmss}</c> of the session's first frame.</summary>
public static string Key(string sourceTag, DateTime firstCapture) =>
sourceTag + "-" + firstCapture.ToString("yyyyMMdd-HHmmss", CultureInfo.InvariantCulture);
private sealed class Group
{
public List<int> Members { get; } = [];
public bool Continues { get; init; }
}
}