feat(app): workspace projects whose home is a server, pushed and pulled like this PC's archive
Owner review 2, R8, phase 5b (client part), ported onto the final phase 5a.
A Chronos Server with the "projects" capability is now the home of
workspace projects. A server sequence is edited in the workspace like a
local one, not inside the library, and its versions sync with the server
"like git".
- Data: ServerProjectHome is an IProjectHome over ChronosClient.
- These are HomeUnavailableException, so the workspace shows Offline: a
server out of reach, an expired sign-in, a 503 (lease, offline archive,
projects_unreadable), a 409 folder_in_use, and a server without projects.
- 404 sequence/project/version and refused names are ProjectException;
other refusals keep their meaning.
- A deleted project's head is 404 project, so final 5a's HeadAsync NotFound
rule reads it as Gone. The original 5b's IsLiveAsync and
WorkspaceStatus.Gone are dropped. IProjectHome gains rename and delete.
- Data: WorkspaceJobs.CopyFromServer downloads into the workspace, through
the desktop's session, the proxies of one frames version (or the
thumbnails standing in for them), with the aliases of the server's
conversions. It is rebuilt on final 5a's copy handler:
- the copy:frame:fv:folder checkpoint, EnsureSpace (from the server's proxy
sizes), WritingMedia, and the cancelled-copy clean-up;
- the editor's current file is never overwritten;
- each file is hashed as it arrives and checked on disk, four at a time.
It never writes this PC's archive. Originals are still refused until 5c.
- Data: SyncAgent passes on the server's projectChanged events, and after a
lost event stream it reports that changes may have been missed.
- App: SyncHost gives the server home over one session client. The Server
screen offers Open in workspace, disabled with its reason on older
servers, whose sequences keep opening with proxies.
- App: Edit opens or checks out server projects with final 5a's refusals:
unreadable copies, a disabled damaged or newer Main, a refused folder. The
"sequence left the index" refusal now applies only to projects of this
PC's archive.
- App: the picker and the chip follow projectChanged (Server newer, Not on
server). Every state, conflict, delete, remove and failure text uses its
".Server" form when one exists (WorkspaceText.ForHome). That includes 5a's
newer-format conflict, the save conflict, the taken-values toast, Gone and
version-too-large.
- App: a render of a server project first offers to send what is not on the
server, then renders the version the server holds. Offline, Gone, Damaged
and missing media hold the render. Analyses and renders run as server jobs
(ServerJobs, shared with RemoteSequenceSource).
- Pruning keeps final 5a's rule: a version is pruned only after HoldsAsync
reads it back.
- Strings in en and it; ARCHITECTURE, DECISIONS and CHANGELOG.
Tests:
- ServerProjectHome error mapping, using a fake handler.
- Against the in-process server:
- two workspaces on one project: fast-forward, replay and merge, keep mine,
take server, save both, restore;
- the copy job verifying, resuming and following new frames;
- a project deleted on the server (Gone from its head; a push sends
nothing);
- an offline server.
- SyncAgent project events.
- App tests for the host, the project menu and renders of a server home.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e2ecc409a3
commit
26bab759fe
48 files changed
+3243
-409
No files matched your search
@@ -13,11 +13,21 @@ public sealed record HomeSequence(BundleArchive Archive, BundleSequence Sequence
|
||||
|
||||
/// <summary>
|
||||
/// Where a sequence's projects live (owner review 2, R8): the side a workspace pushes to and pulls from, "like git". This
|
||||
/// PC's archive is one (<see cref="ArchiveProjectHome"/>); a server is the other (phase 5b). Every call may throw
|
||||
/// <see cref="HomeUnavailableException"/> when the home cannot be reached, and <see cref="ProjectException"/> when it refuses.
|
||||
/// PC's archive is one (<see cref="ArchiveProjectHome"/>); a server is the other (<see cref="ServerProjectHome"/>, phase
|
||||
/// 5b). Every call may throw <see cref="HomeUnavailableException"/> when the home cannot be reached, and
|
||||
/// <see cref="ProjectException"/> when it refuses.
|
||||
/// </summary>
|
||||
public interface IProjectHome
|
||||
{
|
||||
/// <summary>Gives a project another name (1–60 characters, unique among the sequence's live projects whatever the case).</summary>
|
||||
/// <exception cref="ProjectException">Unknown project, or the name is invalid or taken.</exception>
|
||||
Task<SequenceProject> RenameAsync(Guid projectId, string name, CancellationToken cancellationToken) =>
|
||||
throw new NotSupportedException("This home does not rename projects.");
|
||||
|
||||
/// <summary>Deletes a project (never Main) into the home's project trash, with all its versions, which stay readable there.</summary>
|
||||
/// <exception cref="ProjectException">Unknown project, or the Main project.</exception>
|
||||
Task DeleteAsync(Guid projectId, CancellationToken cancellationToken) => throw new NotSupportedException("This home does not delete projects.");
|
||||
|
||||
/// <summary>The sequence and where it is.</summary>
|
||||
Task<HomeSequence> SequenceAsync(CancellationToken cancellationToken);
|
||||
|
||||
@@ -146,6 +156,21 @@ public sealed class ArchiveProjectHome(ChronosDatabase db, ProjectService projec
|
||||
|
||||
public Task<HomeFrames> FramesAsync(CancellationToken cancellationToken) => projects.FramesAsync(sequenceId, cancellationToken);
|
||||
|
||||
public Task<SequenceProject> RenameAsync(Guid projectId, string name, CancellationToken cancellationToken) =>
|
||||
Reach(async () =>
|
||||
{
|
||||
await Own(projectId, cancellationToken).ConfigureAwait(false);
|
||||
return await projects.RenameAsync(projectId, name, cancellationToken).ConfigureAwait(false);
|
||||
});
|
||||
|
||||
public Task DeleteAsync(Guid projectId, CancellationToken cancellationToken) =>
|
||||
Reach(async () =>
|
||||
{
|
||||
await Own(projectId, cancellationToken).ConfigureAwait(false);
|
||||
await projects.DeleteAsync(projectId, cancellationToken).ConfigureAwait(false);
|
||||
return true;
|
||||
});
|
||||
|
||||
/// <summary>
|
||||
/// The sequence's frames version (frames added, removed, converted or renamed), with how many of its photos the index has
|
||||
/// hashed and a checksum of those hashes (a Verify hashes them, or finds other bytes, without another frames version)
|
||||
|
||||
Reference in new issue
Block a user