Translate the 40 keys of the work board, the archive folder structure and the Create archive prompt. STATUS gets how to try rc.14; BRIEF §14.9 and the Dockerfile say releases publish linux/amd64 only, as release.yml does. Refs #29 #31 #22 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
186 lines
43 KiB
Markdown
186 lines
43 KiB
Markdown
# Status
|
||
|
||
Phase plan: docs/BRIEF.md §22. CI runs on Gitea Actions (Linux runner, `.gitea/workflows`); Windows behaviour is verified
|
||
by its `windows` job once a Windows runner is registered (`WINDOWS_RUNNER`), and on a Windows PC until then.
|
||
|
||
| Phase | State |
|
||
|---|---|
|
||
| 0 Bootstrap | Done: solution, rules, Chronos.Testing, zero-package guard, i18n, WPF shell, server skeleton, Docker, icons, CI. |
|
||
| 1 Metadata and imaging | Done: metadata parsers, managed codecs, native RAW development (DNG, CR2, NEF, ARW, PEF, RAF), WIC provider and codec inventory, decode tiers, thumbnails and proxies, `diagnose`. Real-camera fixtures wait for verified raw.pixls.us URLs (CI warns per missing sample). |
|
||
| 2 Data layer and archive | Done: SQLite binding, PostgreSQL wire client, migrations, repositories, job engine, archive layout, sidecars, scan, rebuild, verify, duplicates, orphans, adopt, mass rename. Gate measured: a 100,000-frame archive (400 sequences of 250 photos) rebuilds from sidecars into an index identical in every column in 1.8 s on SQLite and 4.7 s on PostgreSQL (budget 120 s). |
|
||
| 3 Library and Archive manager | Done: Library (virtualised grid and list, timeline with year bands, filters, saved views, quick actions, mass bar, *Delete…* into the archive's trash with a dry run, typed confirmation and Undo, cards for server-only sequences), Archive manager (tree, health, statistics charts, maintenance with *Trash…* and restore, verify, duplicates, orphans, adopt, mass rename and move with dry runs), Jobs, Settings, Welcome, Server and About. Gate measured on 500,000 photos: Library open 259 ms on SQLite and 181 ms on PostgreSQL on a new connection pool (warm OS cache; budget 1 s); every filter, search, sort and next page ≤ 6.4 ms (budget 200 ms). |
|
||
| 4 Card import | Done: device detection, card pool and camera profiles, plan with sessions (merge and split), hash-verified copy, post-actions (verified delete, format behind a typed confirmation, eject), auto-import, Archive, Folder and Server destinations. Gate: import from a simulated card folder end to end in tests; delete and format refuse any photo the import did not verify; screenshots on `ci-screenshots`. |
|
||
| 5 Analysis advisor | Done: light and deep analysis, reports and section charts, recommendations with localised reasons, sequence presets, Auto/manual controls and Optimise in the editor. Gate: golden recommendations for synthetic sequences; every reason key exists in `en` and `it` (`i18n check`); deep analysis streams with checkpoints and resumes after a restart. |
|
||
| 6 Engine, encoding, editor | Done: render pipeline, MP4/AVI/GIF/APNG/image sequences, Media Foundation H.264/HEVC/AV1 with managed fallbacks; the sequence editor (Frames, Exposure, Camera, Motion and Export tabs, preview tools, section charts, curve editor, undo/redo, batch export) for local and server sequences. Gate: self-test suite green; the in-house inspector validates the containers the tests write; the encoder in use is logged. Playback: MediaPlayer opens the Media Foundation output and a source reader decodes its first frame (Windows tests). The pixel diff of every `--capture` screen against `tests/visual/baselines` (`screenshots diff`, BRIEF §20.2) is wired into CI but not armed: no baseline is committed yet, so the step compares nothing and only warns until the first baselines are accepted from `ci-screenshots` (Next steps). |
|
||
| 7 Server, sync, uploader | Done: server (API, auth, uploads, jobs, render nodes, events, admin panel with light and dark themes, Windows service), Uploader, client sync (sync table, conflicts with *Save both*, proxies kept offline, metered pause), server sequences edited with proxies and rendered where the originals are, this PC as a render node. Gate covered in-process: a sequence uploaded from one PC downloads identically on another, interrupted uploads and downloads resume, server events update a PC, renders run on a node and on the server's managed fallback, jobs resume after a restart, sign-ins and administrative actions are audited. The run with two real PCs and the Uploader against the Docker server is part of the release test. |
|
||
| 8 Release readiness | Release pipeline end to end (installers, portable and server zips, SHA256SUMS, release notes, optional signing, server image in the Gitea container registry, optional separate releases repository), update check with verified download, scrubbed diagnostics bundles (desktop and server), performance gates, 38 cultures (`en`, `it` and 36 machine translations with glossaries and independent reviews), RTL pass (`ar`, `he`: mirrored windows, left-to-right islands for media, charts, numbers and paths; any right-to-left culture added later follows), accessibility pass (names, live regions, keyboard paths for charts and the curve editor). The installer test (silent install of the packed installers, run, upgrade in place, uninstall: files, Add/Remove Programs, shortcuts, file type, user data kept, exit codes) runs in CI's `windows` job on a Windows runner. Pending: the interactive install on a real PC, Unraid template validation on a real server. |
|
||
| 8.1 Owner review 1 | In progress (request, answers and plan: `docs/requests/2026-10-15-owner-review-1.md`). Phase 1 done: stalled thumbnail and proxy jobs no longer fail and stay Running (frame-counted progress, bounded time left, final state always written); the editor's cancelled decodes stay in their tasks (no debugger stops in `WicDecoderProvider.cs`); WIC decodes RAW only through the Raw Image Extension and never DNG; GoPro DNGs converted by Adobe software are DNGs, developed natively for videos, read through their embedded preview for analyses and previews, and reclassified in existing archives by the next light analysis. Phase 2 done: jobs run one at a time on the desktop and the server; Parallelism is how many photos the running job processes at once (thumbnail and proxy passes, tier probes, deep analysis, render decodes); pausing the running job starts the next; an optional priority queue by job kind (Settings › Rendering, admin panel › Settings › Jobs, `CHRONOS_PRIORITY_QUEUE`) pauses lower jobs and resumes them by themselves; `CHRONOS_PARALLELISM` replaces `CHRONOS_WORKERS`. Phase 3a done: the rail is 200 px and collapses to icons with ≡ or Ctrl+B (tooltips then name the sections, the choice saved at once); the admin panel's sidebar is 256 px and collapses the same way. Phase 3b done: the Sequence section is now Edit, one sequence at a time chosen in a picker inside the section (Change sequence, Ctrl+O; the sequence edited last selected first), and the editor's tabs are the steps of a guided, freely navigable path from a new Analysis step (every finding with the step that deals with it) to Export, each step showing where it stands, with Previous and Next. Phase 4 done and released as `v0.1.0-rc.12` (issue #19, `188b2c2e`; one adversarial review round, 30 findings, all confirmed and fixed, and a final check that fixed one more; strings in all 38 languages; 31 screenshot baselines accepted): the crop edited on the preview with eight handles, always locked to the output's aspect, in the view frame, by mouse, keyboard (Enter selects) and Crop size/X/Y (R5); the chosen proportions win: a fixed-size preset is a box the aspect is fitted in (`RenderSize`: 4K at 9:16 = 2160×3840), "source" keeps the preset, *Output size* on the Export step; Rotation (quarter turns), Mirror, Flip and Straighten (±15°, automatic cover zoom, the grid while it moves) in the Camera step inside the one warp (`FrameOrientation`), a turn or mirror keeping the content (`OrientationEdit`: crop, keyframes, transposed aspect), Reset framing; eight built-in colour looks with a strength at the end of the Exposure step, after stacking and before the knee (`LookFilter`, `FrameFinish`), the same in the render, on the server, render nodes and the preview; settings format 2 written only while a transform or look is used (`ProjectSettings.RequiredFormat`), read-only in older builds; `server/info` and node registrations announce the settings format, jobs carry the one they need (`RenderRules.RequiredFormat`), and nothing an older server or node would get wrong is sent to it (Sync, Send and render, the Library's Render, a remote editor's save); encoder limits read either way round; the advisor on the view as shown. Also fixed on the way (issue #20): project text is LF on every OS, stored CRLF versions compare equal. Known limitations: an older desktop renders a chosen aspect at the preset's ratio on its own; the server's settings format is cached for a minute; the new Camera rows and the Straighten slider binding have no on-screen test. Phase 5 done, to be released as `v0.1.0-rc.13` (issue #21; eight parcels and an integration, one adversarial review round whose findings are all fixed; strings in English and Italian, the other 36 languages being imported): the header's *Render ▾* at a fixed width with its details in the tooltip and a structured menu (recommended, batch and recent presets, *Other presets ›* by group with a details line, *Render batch*, *Add to queue*, *Save frame ›*, *Videos*; `RenderMenu`, hierarchical two-line `SplitButton` entries) (R3); the Export step's grouped preset table, four collapsible groups with summaries kept per user (`ExportGroups`, `AppSettings.EditorGroups`) and a fixed footer (R3); advanced encoding (rate control, bit rate or quality, keyframes in seconds, B-frames, profile, gated per codec and depth) and standard resolutions over the existing overrides, no format raise (R8); playback (reverse, boomerang, loops, fades to black, hold) as the Core `OutputProgram` between the plan and the encoder, with estimates, progress and star trails following it, settings format 3 written only when used (R8); *Save frame* as a still render (PNG, JPEG, TIFF 16-bit; `RenderTarget.StillFrame`, `StillImageSession`; format-3 jobs, also from workspace projects) (R8); render SHA-256 and kind, render copies (migration 0010); the videos library (`VideoLibrary`, `VideoTrash` into `trash/videos/` with a dry run, fingerprint and journal, restore with the same id after a hash check; `VideoCopyJobHandler`, `video-copy` stored as 24, into a flat, hash-verified videos folder) on the desktop as the Videos section (Ctrl+4, Archive/Jobs/Server Ctrl+5…7; this PC's, the server's and unsent workspace renders merged, an in-process player) and on the server as `/api/v1/videos`, the `videos` capability, the admin panel's Videos page and the trash's Videos entries, `CHRONOS_VIDEOS_PATH` and the optional `/videos` volume (R9). Known limitations: GIF and APNG show their first frame in the desktop player; HEVC plays where Windows has its extension; older renders are hashed on first copy, delete or restore; the new screens have no screenshot scenes or baselines yet. Phase 6 in progress (issue #22), with owner review 4, for `v0.1.0-rc.14`: the deploy guide `docs/deploy/` (README, `docker.md` with every `CHRONOS_*` variable and its default, volumes, ports and public ports, TLS and the fingerprint, upgrades, backup and restore, PostgreSQL, troubleshooting; `unraid.md` with the owner's host ports 8087/8444 and Public HTTPS port 8444; `desktop.md` with Setup, portable mode and updates), BRIEF §14.9 (`CHRONOS_TRUSTED_PROXIES` listed), §19.6 and §24 (every amendment since owner review 1 listed); full verification before the release. Then `v1.0.0` (issue #23). |
|
||
| 8.2 Chronos on Gitea | Done (request: `docs/requests/2026-10-23-chronos-gitea.md`): Titano renamed Chronos everywhere, translations' grammar included; repository, update check, links, issue forms and registry moved to the self-hosted Gitea; Gitea Actions CI, release, nightly image and performance workflows for the Linux runner, with the Windows programs cross-compiled and checked (`pe-check`); new `Chronos.Tools` commands `zip`, `gitea-release`, `postgres-ci`, `pe-check`. Pre-releases `v0.1.0-rc.1` and `v0.1.0-rc.2` (the update check builds its links from `ChronosReleasesUrl`, since Gitea's use its LAN ROOT_URL) published; `REGISTRY_TOKEN` is set and the `v0.1.0-rc.2` server image is in the registry. |
|
||
| 8.3 Owner review 2 | Done (request, answers and plan: `docs/requests/2026-10-26-owner-review-2.md`). Phase 1 done and released as `v0.1.0-rc.3` (one adversarial review round, 19 findings fixed; strings in all 38 languages): `:latest` follows the highest stable release, or the highest pre-release while none is stable (`Chronos.Tools release-channels`), `:nightly` stays the nightly build of `main` (R1); `CHRONOS_SPACE_PATH` and the Unraid template's *Array view* (`/mnt/user0/<share>` read-only at `/space`) make the admin panel show the array's free space, the cache apart as *Write volume*, the file system in the tooltip, and completing an upload checks the archive volume first (507, resumable) (R2); the Settings icon is a toothed gear and the admin panel docks Settings at the foot of its sidebar (R4); About is the last page of Settings on the desktop and the last group of Settings on the admin panel (R5); Import › Folder… › *Whole folder* imports a folder as one sequence per format, titled after the folder (R9). Phase 2 done and released as `v0.1.0-rc.4` (one adversarial review round, 35 findings fixed; strings in all 38 languages): scheduled jobs (R10) — schedules (migration 0007) with an in-house recurrence form, one scheduler per host claiming runs by compare-and-set with catch-up, and Jobs › Scheduled on the desktop and the admin panel (`/api/v1/schedules`, `scheduleChanged`); every timer that queued work is a visible system schedule (server: archive scan, upload clean-up every 6 h, index backup at 03:00, job history and audit log clean-ups; desktop: archive scan, daily index backup, housekeeping with cache trim), the archive still scanned at start; new Backup and Clean-up jobs, duplicates and orphans reports as jobs, one backup retention, the trash only reported; log settings (R11) — file and console levels, retention, file and total size limits, daily or hourly rotation, audit retention (the audit clean-up schedule's) and the diagnostics share in the admin panel's Settings › Logs (`CHRONOS_LOG_*`, `lockedBy`) and the desktop's Settings › Advanced; the server's files take Debug and Trace again, and logging never fails a job. Phase 3 done and released as `v0.1.0-rc.5` (one adversarial review round and two fix rounds, 40 findings fixed; strings in all 38 languages; Library, photo delete and restore and the web upload tried by hand): the admin panel manages and never edits (R6) — a Library page (facets filters, cards or list, keyboard selection, mass Analyse, Proxies, Thumbnails, Verify, Tags, Export CSV and Delete, 1,000 sequences a request), a sequence's page (inline title, tags, rating, notes, photo viewer, cover, downloads, photo delete) and the trash view (Restore, Empty… behind a dry run, the typed word and a fingerprint); photos deleted into `trash/photos` under crash-safe journals with tombstones in the sidecar and `frame_removals` (migration 0008), so sync and uploads never bring them back unless restored or uploaded again on purpose; trash kinds, restore reasons and the `EmptyTrash` job on the desktop's Trash… too (typed entry count); the panel's files revalidated (`no-cache`, ETag); upload from the panel (R3) — file picker or drop, no folders, a self-tested in-house SHA-256 in a module worker, Exif capture time, resumable chunks. Known limitations: a never-hashed photo whose file was already missing is deleted without a tombstone; an unhashed server frame of a photo deleted on a PC stays *missing here* until the server verifies it; `jobState` carries no kind, so panel pages refresh after any job. Phase 4a done and released as `v0.1.0-rc.6` (one adversarial review round and six fix rounds; strings in all 38 languages): Reorganize after import (R7) on the desktop (Archive manager, Library, the toast after Settings › Archive templates change; it replaces Rename… and Move…) and the admin panel (Library, the *Saved* toast of Archive) — folder, file and title templates applied to filed sequences behind a dry run that lists every change, the photos that keep their names and why (in place, never verified, missing) and the sequences that stay whole (unreadable sidecar), applied by the `move` job of exactly the confirmed plan (fingerprint, `POST /api/v1/archive/reorganize`, plans kept a few minutes on the server), which holds the rest when paused, cancelled or failed (also while the archive is offline), lets a sequence still receiving photos keep its file names and takes along a sequence left as it was inside a folder that moves; files renamed in two phases under `.chronos/rename-files.json`, completed after a crash by the next writer; the index, frames and exports follow a moved folder in one transaction, here and at another index's next scan, and writers never create a folder a Reorganize left nor write into one another sequence took; import, upload and Reorganize name photos by one rule (the sequence's camera and lens), and templates follow one set of rules everywhere (no folder scans skip, the extension kept, names that tell photos apart), held only to templates given anew. Known limitations: a reader without the sequence's lease can miss a file while its files are renamed; a change made on disk alone after a server dry run is found by the job, which fails changing nothing; a photo restored from the trash after a Reorganize keeps its old name; a render of another program whose folder moves while it runs is not stopped. Phase 4b done and released as `v0.1.0-rc.7` (one adversarial review round, 42 findings, and three fix rounds; strings in all 38 languages): mass conversion after import (R7) on the desktop (the Archive manager's set, the Library's selection) and the admin panel (the Library's selection) — JPEG with a quality, TIFF-16 or linear DNG (the archival choice, scene-referred so a RAW's highlights above white and colours outside sRGB survive), Replace or New sequence chosen at every run and never remembered, behind a dry run that lists each sequence's photos and sizes, the photos that stay as they are and why (on the server, what it cannot read at full resolution: convert on a PC) and the free space where the conversion writes; Replace confirmed by typing; the `convert` job (stored as 19) converts exactly the photos confirmed (their digest in its parameters, their ids in `journal/convert-<job>.photos`, pinned when it first comes to a sequence; a retried New sequence never makes a second copy), one sequence at a time and all or nothing, resumable through `journal/convert-<job>.*` and `staging/convert-<job>/`, never twice at once; full-resolution decodes with the managed decoders first (never a 16-bit file from an 8-bit RAW development, never a TIFF WIC would read as black or noise), what Chronos reads from a photo never changed (a JPEG or TIFF-16 carries the profile; a linear DNG takes sRGB values only, so Adobe RGB, Display P3, ProPhoto and gamma-1.0 photos go to TIFF-16 or JPEG), Exif carried, every file verified by the server's decoders; Replace swaps the files of the frames in place under `replace.pending.json`, the originals going into a replaced trash entry that the toast's Undo or Restore swaps back and that Empty erases only while the archive on disk shows each conversion intact, or deleted on its own word (a tombstone, the trash, or `trash/.erased/<id>.json`; named first in its confirmation); import still copies byte for byte and the card keeps a converted photo's copy; sync and the ingest count every encoding of a photo as one; `POST /api/v1/archive/convert` in the plan cache Reorganize uses. Known limitations: a photo that fails although its headers read well leaves its sequence as it was; a decode larger than the memory stops the job; a damaged file that still decodes converts as decoded; a read error while a dry run reads a TIFF, DNG or TIFF-based RAW header lists the photo as needing a PC, preview-only or unreadable rather than held (the reader swallows it; nothing beyond the plan converts); JPEG and TIFF-16 clip float values beyond 0..1; not verified: a TIFF whose first image is a thumbnail and whose main image only WIC reads would convert at the thumbnail's size; a PNG's gamma and primaries without a profile count as sRGB; a linear DNG bakes the white balance in and clips below black; the desktop's Undo lives in the job's end toast only (later: Restore). Phase 5a done and released as `v0.1.0-rc.8` (one adversarial review round, 55 findings, and five fix rounds; strings in en and it): the desktop's workspace and projects with this PC's archive as the home (R8) — a sequence's projects (Main, mirrored both ways with the sequence's settings so older clients, analyses and sync keep working, and other named projects), each a linear history of immutable versions in the portable form (positions parked by photo, SHA-256 of canonical text), kept as sidecars in `.chronos/projects/` and indexed by migration 0009 (`projects`, `project_versions`, `renders.project_id`/`project_version_id`), deleted only on the archive's word (the projects' trash read first), healed from the index when a record is lost or behind, one Main decided from the records; Edit opens only workspace projects: *Open in workspace* (project, proxies, copy size and free space), the `workspace-copy` job (stored as 20, desktop only, hash-verified, resumable, space checked, its cancel clean-up under the project's lease), the working state in a folder outside the library, the title's project button (state chip; Save version with Ctrl+S, Sync, History with Compare and Restore, Open, New, Rename, Delete, Remove local copy after a plan), push and pull with replay and field-level merge under crash-safe journals, conflicts only where both sides changed a setting (Keep mine, Take library's, Save both, Later), Update media, newer and damaged copies named and left untouched, renders at the home with the settings embedded, `.chronos` format 2; Settings › Workspace (Folder with Change…, Sync, Kept versions). Known limitations: a server sequence still opens with proxies (the server home is 5b); originals, local render, moving the folder with its projects, emptying `<workspace>/.trash`, clean-up and the size limit are 5c; a capture still edits the library; nothing restores from the projects' trash yet; a lost record waits 2 minutes of one running Chronos before it is written again. Phase 5b done and released as `v0.1.0-rc.10` on 2026-11-04 (`81c303f4`; one adversarial review round, 21 findings, 19 fixed; strings in all 38 languages): a Chronos Server as the home of its sequences' projects (R8) — `/api/v1/sequences/{sid}/projects` on the archive's `ProjectService` (list with Main made at the first read, create, rename, delete by the owner, the maker or an admin, head, versions in size-capped pages, the stored check, push with its outcome, the frames and their stamp), the `projects` capability and `projectChanged`, Main taking settings written outside the projects soon after (`ProjectCatchUp`), a settings `PATCH` writing `project.json` under the lease, no projects for a sequence without photos, renders and render nodes of a project version, and the admin panel's Projects section (versions, Rename, Delete); on the desktop `ServerProjectHome` through the signed-in session: *Open in workspace* in Edit and on the Server screen, the proxies downloaded into the workspace (hash-checked, resumable, thumbnails standing in while the server has no proxy), push, pull, conflicts, history and the chip against the server (*Server newer*, *Not on server*), renames followed, renders and analyses on the server of the version it holds after *Send and render*; an account without Edit and an older server keep *Open with proxies*. Known limitations: projects read *Offline* when signed in to their server through another address; a copy reads the server's frames in one answer; *History* downloads every version's settings. A final check (2026-11-04) fixed what it left: Main's birth on an upgraded server keeps the settings an earlier release's `PATCH` wrote into the index alone (`IndexSettingsMayLead`), a pull never fails on the name it follows, the Server screen's row actions stay on one line and the capture shows sample paths (16 baselines recaptured: `server-*`, `settings-storage`, `settings-workspace`, `settings-advanced`, `archive-rebuild`). Phase 5c done and released as `v0.1.0-rc.11` on 2026-11-04 (`db389a54`; one adversarial review round, 35 findings, 32 confirmed and fixed, compat-2 in part; a final check fixed one more; strings in all 38 languages): originals in the workspace (R8) — *Open in workspace* › *Originals* (Default media first; sizes also for a server's sequence), *Copy originals…* and *Proxies only…* behind a plan, the copy from either home streamed, hash-checked against the home and resumable, a frame without a usable original keeping its proxy, media index format 2 and project file format 3 while originals are held (older Chronos refuses them); local render (`workspace-render`, stored as 21) from the workspace's originals into `exports/` with the ledger `renders.json`, *Version on render* saving a version first, and *Send render* (`workspace-send`, 22) to this PC's archive (staged, read back, filed under the lease) or to the server (`RenderUploadRequest` with `projectId`/`projectVersionId`, checked against the sequence, 422 `project_mismatch`), idempotent by render id, refusals per render, a version a replay renamed found by its content hash, the Export step's *Not sent* and *Send again*; *Pause metered transfers* holding uploads, the sync's downloads and the workspace's server copies and sends; originals judged by their bytes against the home's frames on removal, clean-up and Proxies only, the rest kept in the workspace's trash (entries filled under `.incoming-` names, emptied only by *Empty…* with the entry count typed and a fingerprint); the clean-up (`WorkspaceCleaner`: projects in step with their home, not open, without jobs or unsent renders; *Clean after* 30 days and *Size limit* 100 GB, the `workspace-cleanup` schedule daily at 04:30 and the limit after each copy); Remove local copy weighing unsent renders and originals; moving the workspace folder (`workspace-move`, 23; `WorkspaceMover`): a plan, renamed on one volume or copied and hash-verified across volumes, the journal `.move.json`, the source kept until the switch, resume and undo, jobs finding their project where the workspace is now (`WorkspaceJobRoots`), *Resume* in Settings; Settings › Workspace complete (Folder with Move…, Size limit, Default media, Sync, Version on render, Kept versions, Clean after, Open project, Trash). Known limitations: an older server drops a render's provenance and the render is still marked sent (logged); an original held open after Proxies only leaves the media index at format 1, so a downgraded 0.1.0-rc.10 could delete it; the removal plan's original count is an estimate and can fail when `media/originals` cannot be read; the Export tab's *Send again* view model has no unit test. |
|
||
| 8.4 Owner review 4 | In progress (request and plan: `docs/requests/2026-11-06-owner-review-4.md`), one phase released as `v0.1.0-rc.14` with owner review 1 phase 6, then `v1.0.0` (#23): R1 work board of every video made or published, the published apart from workspace work (#29); R2 the anonymous usage counts removed, nothing sent by itself (#30); R3 the archive's whole folder structure created inside the chosen archive path, desktop and server (#31); R4 the repository on Gitea in order (earlier work as closed issues #32–#54 in their milestones, the original documentation in `docs/reference/original`, `fe50b877`); R5 licensing set aside and recorded in #24. Work stops at 75% of the weekly usage. |
|
||
| 9 Monetization | Not started: requires explicit approval (§22); the proposal is recorded in issue #24 (owner review 4, R5). |
|
||
|
||
## Verification (2026-10-12)
|
||
|
||
A full audit against the brief, `CLAUDE.md`, the UI kit, the tests and the Docker and client setups confirmed 71
|
||
defects with independent verifiers. A second pass over the fixes confirmed 37 more (proxies and decode tiers, project
|
||
positions crossing copies through sync, server scans and maintenance, desktop settings and polling, a portable copy
|
||
inside OneDrive, setup and deployment guidance), a third pass 16 more (editors open while photos arrive, partial
|
||
writers of the index row, image passes after another writer's import, smaller error-text and documentation gaps), a
|
||
fourth pass 7 more (lock order of index writes, analyses and scans racing another writer), a fifth pass 4 more (tag
|
||
lock order on PostgreSQL, the orphans fix's follow-up analyses, deep reports saved over newer ones, frames versions
|
||
shared by two indexes), and a last check 2 more (an unreadable photo counted as a change, a deep report made stale by
|
||
proxies). All are fixed, each with tests (rows dated 2026-10-12 in DECISIONS and CHANGELOG), except that the
|
||
screenshot diff (BRIEF §20.2 visual regression) gates nothing until its first baselines are committed (Next steps).
|
||
The Docker image was built and run with PostgreSQL 17, a fresh archive folder and remapped ports; the client
|
||
installers were installed, run, upgraded and removed on GitHub's `windows-latest` by the `installer` CI job (since
|
||
2026-10-23 the last step of the `windows` job, on a Windows runner).
|
||
|
||
## How to try it
|
||
|
||
```
|
||
dotnet build Chronos.slnx -c Release
|
||
dotnet run --project src/Chronos.Server # https://localhost:8443/admin (set CHRONOS_DATA_PATH/CHRONOS_ARCHIVE_PATH)
|
||
src/Chronos.App/bin/Release/net10.0-windows/Chronos.exe # Windows
|
||
src/Chronos.Uploader/bin/Release/net10.0-windows/Chronos.Uploader.exe # Windows
|
||
docker compose -f deploy/docker/docker-compose.yml up -d # server + PostgreSQL 17
|
||
CHRONOS_PERF=1 dotnet run --project tests/Chronos.Data.Tests -c Release -- --filter category:perf --verbose # performance gates
|
||
src/Chronos.App/bin/Release/net10.0-windows/Chronos.exe --capture out/screenshots # every screen with sample data, plus Arabic (RTL)
|
||
```
|
||
|
||
- Diagnostics: Settings › Advanced › Diagnostics › *Export bundle* (desktop) or admin panel › Logs › *Diagnostics* (server,
|
||
`GET /api/v1/server/diagnostics`). Open the zip: logs, reports, settings and failed jobs, no passwords or tokens.
|
||
- Update download: Settings › Updates › *Check for updates*, then *Download* when a newer release exists; the verified
|
||
setup (the portable zip in a portable copy) appears in Explorer. *Cancel* stops it; the next *Download* resumes.
|
||
Settings › About shows the version, build, runtime and system.
|
||
- Import: Import › *Folder…* (any folder of photos stands in for a card) › *Import*; the sequence opens from the
|
||
Library. Delete a sequence with *Delete…* (dry run first) and bring it back from Archive › *Trash…*.
|
||
- Whole folder: Import › *Folder…* › Group › *Whole folder*: one plan row per file format (RAW+JPEG gives two), titled
|
||
after the folder whatever the cameras and pauses; add photos to the folder and import it again: they join the same
|
||
sequence.
|
||
- Free space on Unraid: map `/mnt/user0/<share>` read-only to `/space` and set `CHRONOS_SPACE_PATH=/space` (the
|
||
template's *Array view* and *Space path*); the admin panel's Dashboard and Archive show the array's free space, a
|
||
*Write volume* line the cache's, and the figures' tooltip names the file system (`fuse.shfs`).
|
||
- Admin panel: Settings at the foot of the sidebar; About is its last group, and `#/about` opens it there.
|
||
- `:latest`: after the next pre-release tagged on a `main` that has phase 1, the release log says "…:latest: true" and
|
||
`docker pull gitea.encke-hake.ts.net/balbosoft/chronos-server:latest` works. Re-publishing `v0.1.0-rc.2` cannot do
|
||
it: the workflow builds `Chronos.Tools` from the tag, which has no `release-channels`.
|
||
- Sync: sign in on Server (trust the certificate once); the sync table lists every sequence of both sides. Open a
|
||
server-only sequence from the Library to edit it with proxies; *Render* runs on the server or a render node.
|
||
- Language: Settings › General › *Language* switches at once; Arabic and Hebrew mirror every window.
|
||
- Settings: Import, Analysis and Formats pages; Archive rows edit the open archive's `archive.json`; Advanced ›
|
||
*Restore* picks a copy of the index (made by the *Index backup* schedule or *Back up now*), compares it with the
|
||
index and restores it at the next start.
|
||
- Scheduled jobs: Jobs › *Scheduled* (desktop) or admin panel › Jobs › *Scheduled* lists the system schedules (three
|
||
on the desktop; five on the server, four on PostgreSQL). *New schedule* › Integrity check, Weekly Mon and Thu 02:30,
|
||
create it, then *Run now*: the job appears in the Queue tab with a *Scheduled* pill; select the schedule (the panel:
|
||
its name) for its runs. Turn *Archive scan* off and restart: no scan runs at start.
|
||
- Logs: admin panel › Settings › *Logs* › File level Debug, Rotation Hourly › Save, then watch `/data/logs` get
|
||
`server-yyyyMMdd-HH.log` with Debug lines, no restart; with `CHRONOS_LOG_LEVEL` set the two levels are read-only
|
||
and their tooltip names the variable. Desktop: Settings › Advanced › *Log level* Debug, *Rotation* Hourly, then
|
||
*Logs* › *Open*.
|
||
- Admin panel Library: *Library* › filter by year, camera, status or tag, select cards (check box, Shift+click, or
|
||
Space and Shift+Space) and try *Tags…*, *Verify* or *Delete…* (dry run first); open a sequence, open a photo (←/→,
|
||
Esc), select 21 photos › *Delete…* (type their number), then the Library's *Trash* › *Restore*, or *Empty…*
|
||
(type "empty") and watch the job end. Re-uploading a deleted photo from the Uploader or sync does not bring it back.
|
||
- Web upload: Library › *Upload* › *New sequence*, drop a few JPEGs and a folder › *Upload*: one *Folders skipped*
|
||
chip, progress per photo, *Uploaded*; upload them again: *Already there*; delete one and upload it again: *Deleted
|
||
before*, whose *Upload again* files it on the next *Upload*. Esc does nothing while photos are sent.
|
||
- Desktop trash: Archive › Maintenance › *Trash…* lists photo entries beside deleted sequences; *Restore* says why a
|
||
photo stayed; *Empty…* measures the trash and asks for the number of entries before the *Empty trash* job.
|
||
- Reorganize: desktop Archive › select a year › *Reorganize…* › Folders `{year}/{date} {title}`: the dry run lists every
|
||
change, and *Apply* queues the *Reorganize* job (pause and resume it in Jobs).
|
||
Admin panel: Library › select sequences › *Reorganize…* › *Apply…* › *Reorganize* › *Open job*; or Archive › change
|
||
the file template › *Save* › *Reorganize…* in the toast.
|
||
- Convert: desktop Archive › select a year › *Convert…* › Linear DNG, *Replace* › *Apply* › type the number of photos ›
|
||
*Replace*; when the job ends, *Undo* in its toast brings the originals back (later: Maintenance › *Trash…*).
|
||
Admin panel: Library › select sequences › *Convert…* › JPEG, *New sequence* › *Convert…* › *Convert* › *Open job*:
|
||
the copies appear as "… (JPEG)"; with *Replace*, type "replace", and the trash's *Restore* swaps the originals back.
|
||
- Workspace: open a sequence from the Library: *Open in workspace* asks the project (Main, or New with a name) and
|
||
the media (Proxies), with the copy's size and the free space; the editor opens once the *Workspace copy* job ends.
|
||
Edit, then Ctrl+S, type a note, Enter: the chip says *In sync* and the Library's sequence takes the settings (Main).
|
||
Ctrl+O lists the project in the picker's *Workspace* group. The title's ▾ › *History…* › *Compare* or *Restore*;
|
||
▾ › *Remove local copy…* shows its plan. Two workspace folders on one archive (Settings › Workspace › *Change…*)
|
||
stand in for two PCs: change the same setting in both and *Sync* to see the conflict dialog.
|
||
- Server home: sign in on Server to a server of this release; a server-only row offers *Open in workspace* (an older
|
||
server shows it disabled). Choose a project (New, with a name): a *Workspace copy* job downloads the proxies and the
|
||
editor opens. Edit, Ctrl+S, Enter: the chip says *In sync*, and the admin panel's sequence page lists the version
|
||
under *Projects*. Rename the project there: the editor's project button takes the new name. Change a setting of
|
||
Main from another PC (or an older Chronos) on the server while Main is open here: the chip says *Server newer*;
|
||
*Sync* takes it. *Render* offers *Send and render* while changes are not sent, then renders on the server.
|
||
- Originals and local render: *Open in workspace* › Media *Originals* (or the project's ▾ › *Copy originals…*): a
|
||
*Workspace copy* job copies the originals besides the proxies. Edit and *Render*: a version noted *Render* is saved
|
||
first (Settings › Workspace › *Version on render*), a *Local render* job writes into the project's `exports/`, then a
|
||
*Send render* job files it in the library (or uploads it to the server, whose `GET …/renders` names the project and
|
||
version). Pull the network or sign out first: the Export step lists it as *Not sent*; *Send again* sends it once the
|
||
home is back. ▾ › *Proxies only…* shows its plan and deletes only originals the home holds.
|
||
- Workspace upkeep: Settings › Workspace › *Clean after* 7 days, then Jobs › *Scheduled* › *Workspace clean-up* ›
|
||
*Run now*: projects in sync and not opened for a week lose their media (the job log says which and why others were
|
||
kept), and open again by copying them. *Move…* to another drive shows its plan; the *Move workspace* job copies and
|
||
checks every file, then Settings shows the new folder. *Trash* › *Empty…* lists the entries and asks for their number.
|
||
- Crop, transforms and looks: Edit › Camera › Aspect 9:16, then drag the box on the preview and one of its handles: the
|
||
ratio stays locked; Enter, arrows and + / − nudge it, Esc gives the arrows back. *Rotate right*, *Mirror* and
|
||
Straighten 3°: the box keeps the content and the grid shows while the slider moves. Exposure › *Look* › Sepia at 60 %,
|
||
compared with the wipe. Export › 4K: *Output size* reads 2160 × 3840 while the preset keeps its name; render it and
|
||
check the file. Open the project in 0.1.0-rc.11: it is read-only. Against a server of 0.1.0-rc.11, *Sync* and
|
||
*Render* are disabled with their reason; with only a node of 0.1.0-rc.11 online, the job is not given to it.
|
||
- Export and Render menu: Edit › Export: the preset table groups the presets (fold *Social*, tick a second preset:
|
||
*Batch (2)*); open *Encoding*, set *Rate control* Constant, *Keyframes* 1 s, *B-frames* 0, and *Resolution* 4K UHD
|
||
with Aspect 9:16: *Output size* reads 2160 × 3840. Open *Playback*: Boomerang, Loops 2, Fade in 1 s, Fade out 1.5 s,
|
||
Hold end 2 s; the footer's duration and time grow, and the project is saved as format 3 (read-only in
|
||
0.1.0-rc.12). *Render now*, then check the file's length in Windows' file properties. *Render ▾* lists Recommended,
|
||
batch and recent presets and *Other presets ›*; *Save frame ›* › PNG writes `<file name> - 0413.png`.
|
||
- Videos: Ctrl+4 (Archive is now Ctrl+5). Select the render › *Play* in the pane; *Copy to folder* queues *Copy
|
||
videos* into Settings › Archive › *Videos folder*; copy it again: "… (2)". *Delete…* shows the dry run (bytes,
|
||
"copies stay"); then Archive › Maintenance › *Trash…* › *Restore* brings it back with the same id. The Export
|
||
footer's *Videos (n)* opens the list on the sequence.
|
||
- Server videos: `docker compose -f deploy/docker/docker-compose.yml up -d` maps `./videos` to `/videos` with
|
||
`CHRONOS_VIDEOS_PATH=/videos`; admin panel › *Videos*: *Play* (seek works), *Copy to folder* (the audit log says
|
||
`videos_copied`), *Delete…* (dry run, then Library › *Trash* › *Restore*). Without `CHRONOS_VIDEOS_PATH`, *Copy to
|
||
folder* is disabled with its reason. Against a server of 0.1.0-rc.12, the desktop's Videos lists this PC's videos
|
||
and says why.
|
||
- Project files: *Save project file* (the Export footer, or the project ▾ menu) writes a `.chronos` file; opening it
|
||
(double-click or `Chronos.exe <file>`) opens the sequence with those settings in the running Chronos, given to its
|
||
Main project in the workspace.
|
||
- Notifications: minimise Chronos and insert a card or finish a job: a Windows notification appears; Ctrl+1…7 and
|
||
Ctrl+, switch sections.
|
||
- Edit: Ctrl+3 with no sequence open shows the picker (type to search, Enter opens); the title's ▾ or Ctrl+O chooses
|
||
another sequence and Esc comes back. The step bar, *Previous*/*Next* (Ctrl+PgUp/PgDn) and Alt+1…8 move between
|
||
steps; on Analysis each finding's button opens the step that deals with it.
|
||
- Work board: Videos › *Board* (third layout): *Published* holds the renders filed in the archive or on the server,
|
||
*Workspace* the workspace's renders, a sent one with the *Sent* chip; cards start with the preset ("4K archive ·
|
||
HEVC · 0:41 · 1.4 GB"). Admin panel › *Videos* › *Board*: the Order menu is disabled, *Published* counts every
|
||
video.
|
||
- No usage data: the first run and Settings › General have no usage-counts option; an old `settings.json` carrying
|
||
`AnonymousUsageCounts` loads and is saved without it.
|
||
- Archive folders: Settings › Archive › a new empty folder › *Create archive*: the folder gets `.chronos`, the trash
|
||
and every root folder of BRIEF §7. Server: start a container with an empty `/archive` and it holds the same tree;
|
||
make `/archive` read-only and the dashboard shows *Archive incomplete* with the reason.
|
||
- Deploy: `docs/deploy/` (Docker, Unraid, desktop) lists every `CHRONOS_*` variable, the volumes and the public ports.
|
||
|
||
## Next steps
|
||
|
||
Each phase ends with a release (owner review 2, R12):
|
||
|
||
1. Owner review 4 with owner review 1 phase 6 (issues #29, #30, #31, #22, #28): the work board, the usage counts
|
||
removed, the archive's folder structure, the deploy guide (`docs/deploy/`) and BRIEF §24; released as
|
||
`v0.1.0-rc.14`.
|
||
2. `v1.0.0` (issue #23), the first stable release (owner review 3, R4): `:latest` then follows stable releases only,
|
||
and the update check offers it to every pre-release build.
|
||
|
||
Phase 8 gate:
|
||
|
||
3. Visibility: make the `BalboSoft` organisation (and its packages) public, or publish to a public `RELEASES_REPO`, so
|
||
that people without an account can download releases, get update notices and pull the image.
|
||
4. Windows runner: register an act_runner in host mode on a Windows PC (.NET SDK, Git for Windows, PowerShell 7) and
|
||
set the repository variable `WINDOWS_RUNNER` to its label. The screenshot baselines in `tests/visual/baselines`
|
||
were captured on the development PC (2026-11-04): register the runner on that PC, or accept a new set captured on
|
||
the runner's PC (its README says how). From then on a visual change, or a screen without a baseline, fails the
|
||
`windows` job.
|
||
5. On Windows: install the latest pre-release's setup, upgrade over the previous version, uninstall (with and without
|
||
user data), silent mode.
|
||
6. Unraid: install the template as a user template (README › Server image, Compose and Unraid) with the official
|
||
PostgreSQL template, check that its icon (the SVG of `branding/`) shows, reach the WebUI, and that the Dashboard
|
||
shows the array's free space through *Array view*.
|
||
7. Native-speaker review of the machine translations where users report wording (`i18n export` per language).
|