feat: work board, no usage data, archive folder tree, deploy guide (owner review 4 + owner review 1 phase 6) #62

Merged
Alby96 merged 13 commits from or1-p6 into main 2026-11-06 18:46:29 +01:00
Owner

Owner review 4 (docs/requests/2026-11-06-owner-review-4.md) and owner review 1 phase 6, to be released as v0.1.0-rc.14.

What changes

  • Work board (#29): Videos › Board, on the desktop and on the admin panel, has two lanes:

    • Published: renders filed in the archive or on the server;
    • Workspace: workspace renders, the sent ones marked Sent.

    Newest first, with a count per lane, the list's filters and the existing actions.

  • No usage data (#30): the anonymous usage counts option and its setting are gone (first run, Settings › General). Chronos sends nothing about its use; the diagnostics bundle is still only saved locally. Old settings.json files load. BRIEF §21 and EULA §4 are updated.

  • Archive folder tree (#31): whatever folder is the archive root gets the whole §7 layout. It is created idempotently and never touches user files.

    • Server: done at start-up and re-checked by the dashboard and /health. The panel shows Archive incomplete with the reason.
    • Desktop: done on create and adopt. Settings › Archive offers Create archive for a folder that is not an archive yet.
    • Errors are localised: drive unavailable, permission denied, read-only, a file in the way.
  • #28: video cards start with the preset name, and sizes keep the number and unit together (no-break space) on the desktop and the panel.

  • Phase 6 (#22):

    • the deploy guide docs/deploy/ (Docker, Unraid, desktop), with every CHRONOS_* variable, the volumes, the public ports (host 8087/8444 → 8080/8443), TLS, upgrades, backup, PostgreSQL and troubleshooting;
    • BRIEF §24 rows;
    • an error for out-of-range ports that names its variable;
    • BRIEF and the Dockerfile now say releases publish linux/amd64 only.
  • Original documentation: docs/reference/original/, the Titano kit with its mockups and icons.

Verification

  • Two adversarial review lenses found 10 problems; all 10 are fixed.

  • Build: 0 warnings.

  • Tests:

    Suite Passed Failed
    Core 1522 0
    Data 944 0
    Server 356 0
    Tools 60 0
    App (usual exclusions) 897 0
    Core.Windows 86 0
  • i18n: 5039 keys in 38 cultures, 0 warnings. xaml-lint, package-guard and the format check are clean.

  • Screenshots captured again on the development PC: 158 within tolerance, and 14 accepted (12 expected changes plus the new videos-board pair).

  • Server started by hand on an empty archive: it created .chronos/{journal,locks,staging,trash/photos,trash/videos}, and /health returned ok.

Closes #22
Closes #28
Closes #29
Closes #30
Closes #31

🤖 Generated with Claude Code

Owner review 4 (`docs/requests/2026-11-06-owner-review-4.md`) and owner review 1 phase 6, to be released as `v0.1.0-rc.14`. ## What changes - **Work board (#29):** Videos › *Board*, on the desktop and on the admin panel, has two lanes: - *Published*: renders filed in the archive or on the server; - *Workspace*: workspace renders, the sent ones marked *Sent*. Newest first, with a count per lane, the list's filters and the existing actions. - **No usage data (#30):** the anonymous usage counts option and its setting are gone (first run, Settings › General). Chronos sends nothing about its use; the diagnostics bundle is still only saved locally. Old `settings.json` files load. BRIEF §21 and EULA §4 are updated. - **Archive folder tree (#31):** whatever folder is the archive root gets the whole §7 layout. It is created idempotently and never touches user files. - Server: done at start-up and re-checked by the dashboard and `/health`. The panel shows *Archive incomplete* with the reason. - Desktop: done on create and adopt. Settings › Archive offers *Create archive* for a folder that is not an archive yet. - Errors are localised: drive unavailable, permission denied, read-only, a file in the way. - **#28:** video cards start with the preset name, and sizes keep the number and unit together (no-break space) on the desktop and the panel. - **Phase 6 (#22):** - the deploy guide `docs/deploy/` (Docker, Unraid, desktop), with every `CHRONOS_*` variable, the volumes, the public ports (host 8087/8444 → 8080/8443), TLS, upgrades, backup, PostgreSQL and troubleshooting; - BRIEF §24 rows; - an error for out-of-range ports that names its variable; - BRIEF and the Dockerfile now say releases publish linux/amd64 only. - **Original documentation:** `docs/reference/original/`, the Titano kit with its mockups and icons. ## Verification - Two adversarial review lenses found 10 problems; all 10 are fixed. - Build: 0 warnings. - Tests: | Suite | Passed | Failed | |---|---|---| | Core | 1522 | 0 | | Data | 944 | 0 | | Server | 356 | 0 | | Tools | 60 | 0 | | App (usual exclusions) | 897 | 0 | | Core.Windows | 86 | 0 | - i18n: 5039 keys in 38 cultures, 0 warnings. xaml-lint, package-guard and the format check are clean. - Screenshots captured again on the development PC: 158 within tolerance, and 14 accepted (12 expected changes plus the new `videos-board` pair). - Server started by hand on an empty archive: it created `.chronos/{journal,locks,staging,trash/photos,trash/videos}`, and `/health` returned ok. Closes #22 Closes #28 Closes #29 Closes #30 Closes #31 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added this to the v0.1.0-rc.14 milestone 2026-11-06 18:05:33 +01:00
Alby96 added the documentationenhancementarea/desktoparea/server labels 2026-11-06 18:05:33 +01:00
Alby96 added 13 commits 2026-11-06 18:05:33 +01:00
The documentation the project started from (then called Titano), frozen under
docs/reference/original for history; the current docs win where they differ.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The owner does not want Chronos to send data about its use, and nothing
ever sent the counts the consent promised. The first-run checkbox, the
Settings > General row, the AnonymousUsageCounts setting and its three
strings in every culture are gone; a settings file that still carries the
member loads and is saved without it. BRIEF §21, the EULA and the Welcome
mockup now say Chronos sends nothing about its use; the diagnostics
bundle stays, saved only locally.

Refs #30

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Owner review 1 phase 6 asks for Docker, Unraid and deploy documentation. docs/deploy/
now covers the image tags, volumes, every CHRONOS_* variable with its default, ports and
public ports (the owner's host 8087/8444 mapping), TLS modes and the fingerprint,
upgrades and forward-only migrations, backup and restore, PostgreSQL, troubleshooting,
and the desktop Setup, portable mode and update channel.

The owner review 4 request (2026-11-06) is recorded with its interpretation and plan;
BRIEF §14.9 lists CHRONOS_TRUSTED_PROXIES, which the server already read, §19.6 points
to the Unraid guide, and §24 gains the rows of owner review 4 and phase 6. STATUS shows
both in progress for v0.1.0-rc.14, then v1.0.0.

Refs #22

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The owner asked (2026-11-06) that whatever path is given as the archive
root, on the server in Docker or on Windows, Chronos creates inside it
every folder the archive keeps. Until now only .chronos was made up
front; locks, journal, staging, trash and its photos and videos areas
appeared on first use, and an archive copied or made by an older build
could lack them.

ArchiveStructure.Ensure (Core) creates the missing folders of BRIEF §7
idempotently, never touching existing folders or files, and reports why
it could not (drive or share unavailable, permission denied, read-only,
a file in the way) as one localized sentence. ArchiveService runs it
when it creates an archive (refused with the reason when the tree cannot
be made) and at every open. The server checks it at start-up and on
each dashboard read: it logs a warning, the dashboard shows an "Archive
incomplete" chip with the reason, and /health reports archive
"incomplete". The desktop runs it when an archive is created, adopted or
opened at start, and a folder typed in Settings that is not an archive
yet becomes one in place, as Welcome's Create does; a writable archive
whose tree cannot be completed is refused with the reason.

Refs #31

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Videos section and the admin Videos page gain a Board view with two
lanes, newest first, each with a count and the list's filters: Published
(library and server renders, including those sent from a workspace) and
Workspace (workspace exports, unsent ones plus sent ones marked Sent).
Cards show the sequence, project and version when known, preset, kind,
date and state chips, and reuse the existing actions; no new store.

Video cards now start with the preset ("4K archive · HEVC · 0:41 · 1.4 GB")
and Formatting.Bytes keeps number and unit together with a no-break space
(#28). The capture tool adds the videos-board scene in both themes.

Refs #29

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts:
#	docs/BRIEF.md
The phase 6 docs were written before the board, no-usage and archive
layout parcels landed: the BRIEF section 24 rows now name the sections
actually amended, sections 7, 12.10 and 14.8 describe the board and the
archive's root folder tree, and the Docker guide explains the start-up
layout and the "Archive incomplete" warning. The phase 5 changelog moves
under rc.13 and [Unreleased] carries the rc.14 work.

Refs #29 #30 #31 #22
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Settings no longer makes a folder an archive on its own: a typed or
picked folder without archive.json is made one only after a
confirmation naming it, and Settings > Import keeps this PC's archive
folder and never creates one. A half-typed path or another PC's drive
letter could otherwise get .chronos and sidecars written unasked.

The server's structure check creates nothing in a root that lost its
archive.json (an unmounted disk's empty mount point) and reports it
unavailable; /health re-checks when its last check is over 10 s old,
so a fix on the host shows without a dashboard read.

The admin board reads the server newest first with Order off, counts
Published over the server's total, and a Shift range runs along the
lane picked in. Admin sizes keep number and unit together. A sent
workspace render whose file left exports/ is no longer listed as
missing. Desktop Board cards put their actions under the text while
the player is open. Start-up range errors name the CHRONOS_* variable;
the deploy guide documents the parallelism clamp and the log rule.

Refs #29 #31

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
test(visual): baselines for the work board and the preset-first cards
CI / Build and test (pull_request) Successful in 9m45s
CI / Windows tests and installer (pull_request) Skipped
CI / YAML check (pull_request) Successful in 21s
CI / PostgreSQL 16 integration (pull_request) Successful in 11m47s
CI / PostgreSQL 17 integration (pull_request) Successful in 13m6s
CI / Docker image (pull_request) Successful in 2m18s
8ea0022d07
videos-board is new; videos, videos-list, the Export footer and the Render
menu changed with the preset-first card line and sizes kept whole (#28).

Refs #29 #28

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96 merged commit 0075065884 into main 2026-11-06 18:46:29 +01:00
Alby96 deleted branch or1-p6 2026-11-06 18:46:34 +01:00
Sign in to join this conversation.