Fast Track Workflow

Fast Track is the global workflow layer that summarizes the photographic preservation pipeline from workspace setup to backup-safe integrity verification.

Engine

The workflow engine lives in src/renderer/workflow/fast-track-workflow.ts.

It derives state from the existing app snapshot and renderer store instead of persisting a separate workflow document. This keeps Fast Track resilient to refreshes, sync updates, and long-running background tasks.

Pipeline steps:

Workspace
Projects / Collections
Metadata & Organization
Archive
Integrity & Verification
Backup & Cloud Preservation

Each step exposes:

state: not-started, in-progress, completed, warning, error, or offline
progress: numeric completion percentage
summary and tooltip
metrics shown in the detail panel
recommendations
contextual actions

UI Components

The reusable component lives in src/renderer/components/FastTrackWorkflow.tsx.

Variants:

header: compact global progress bar with a clickable popover
dashboard: full workflow-centric module for onboarding, workspace, and project screens

The component is integrated in:

AppHeader
HomeView
WorkspaceView

Actions

Fast Track actions are routed through runFastTrackAction.

Current actions include:

create workspace
configure folders
import project
scan metadata
archive project
backup now
run integrity scan
open health/integrity centers

The first implementation intentionally reuses existing store operations and views. Future actions should remain contextual and safe: when a destructive or long-running action is introduced, it should route through an existing confirmation or task queue.

Backup actions are guarded by archive integrity. If a completed archive has a failed checksum/signature/integrity record, Fast Track marks Backup & Cloud Preservation as blocked and disables backup actions until the archive is repaired or rebuilt.

Product Follow-Ups

Add a dedicated task center view with grouped Fast Track recommendations.
Add per-project Fast Track overlays for selected project detail pages.
Persist dismissed recommendations per workspace.
Add richer storage usage and estimated remote preservation cost.
Add Playwright visual coverage for completed, warning, error, offline, and syncing states.