mirror of
https://github.com/ajisaacs/OpenNest.git
synced 2026-10-27 09:21:05 -04:00
ajandClaude Opus 5.5
af6975b9f1
The desktop needs a cross-platform way to read and save sets and to turn one into nests before any UI is built on it. RemoteDrawingSetStore covers every /api/sets route with the library client's checks and conflict handling. SetReleasePlan groups a set by material, grade, thickness, units and cut type without I/O, so the release dialog can preview refusals (duplicate names, drawings without material) before anything is created. SetReleaseSession builds every group's nest through LibraryDrawingInsert before uploading any, so a refusal leaves nothing on the server; uploads then never cancel mid-flight, a lost reply is reconciled by the nest's client-allocated id, and the release is posted only when every chosen nest exists, with a same-id retry when that post fails. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
52 lines
3.1 KiB
C#
52 lines
3.1 KiB
C#
namespace OpenNest.Data;
|
|
|
|
/// <summary>
|
|
/// Drawing sets and their releases on the nest server (<c>/api/sets</c>). Kept apart from
|
|
/// <see cref="IDrawingLibrary"/> so browsing and inserting drawings do not depend on sets.
|
|
/// <see cref="RemoteDrawingSetStore"/> is the only production implementation.
|
|
/// </summary>
|
|
public interface IDrawingSetStore
|
|
{
|
|
/// <summary>One bounded page of sets matching the query, without their members.</summary>
|
|
Task<DrawingSetPage> QueryAsync(DrawingSetQuery query, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// The current record, including an archived one, with every member joined to its
|
|
/// drawing's current library record; null for an unknown id.
|
|
/// </summary>
|
|
Task<DrawingSetRecord?> GetAsync(Guid id, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>One page of immutable revisions without members, newest first, or null for an unknown id.</summary>
|
|
Task<DrawingSetPage?> GetRevisionsAsync(Guid id, int offset = 0,
|
|
int limit = DrawingLibraryRules.DefaultRevisionLimit, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>One revision with its members, or null when the set or revision is unknown.</summary>
|
|
Task<DrawingSetRecord?> GetRevisionAsync(Guid id, int revision, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>Sets whose current revision contains the drawing, by name, or null for an unknown drawing.</summary>
|
|
Task<DrawingSetPage?> GetSetsContainingAsync(Guid drawingId, int offset = 0,
|
|
int limit = DrawingLibraryRules.DefaultRevisionLimit, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>Stores revision 1 under the caller-allocated <c>record.Id</c>.</summary>
|
|
Task<DrawingSetRecord> CreateAsync(DrawingSetRecord record, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>Saves the next revision when <paramref name="expectedRevision"/> is current.</summary>
|
|
Task<DrawingSetRecord> UpdateAsync(Guid id, DrawingSetRecord record, int expectedRevision,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
Task<DrawingSetRecord> ArchiveAsync(Guid id, int expectedRevision, CancellationToken cancellationToken = default);
|
|
|
|
Task<DrawingSetRecord> RestoreAsync(Guid id, int expectedRevision, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>Records a release whose nests already exist, under the caller-allocated <c>release.Id</c>.</summary>
|
|
Task<SetReleaseRecord> PostReleaseAsync(Guid setId, SetReleaseRecord release,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>One page of the set's releases with their nests, newest first, or null for an unknown set.</summary>
|
|
Task<SetReleasePage?> GetReleasesAsync(Guid setId, int offset = 0,
|
|
int limit = DrawingLibraryRules.DefaultRevisionLimit, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>The release a nest came from, or null when it came from none (or is unknown).</summary>
|
|
Task<SetReleaseRecord?> GetReleaseForNestAsync(Guid nestId, CancellationToken cancellationToken = default);
|
|
}
|