Owner review 2, R10 on the desktop: every timer that queued work out of sight is now a visible, editable schedule of this PC. - DesktopScheduleHost implements IScheduleHost: the PC's time zone, the archive at Settings › Archive's folder (refreshed from archive.json, none while it is offline), and three system schedules: archive-scan (every:<ScanIntervalMinutes>m, seeded once from the old setting, no catch-up), index-backup (every day with catch-up, replacing DatabaseBackups.RunDailyAsync) and housekeeping (daily 04:00 with catch-up: job history 90 days and the new cache-trim step). - AppServices starts the Scheduler after the engine, once the archive was reopened; an unplugged archive is looked for every minute and the scheduler woken when it is back. The rescan loop and the daily backup loop are gone; ApplyJobSettings wakes the scheduler. - CacheStore.Trim brings the cache to Settings › Storage › Cache limit, oldest files first, skipping files in use and the proxies, render-node and server-import folders; CacheTrimStep runs it as a clean-up step. - Jobs gets a Queue | Scheduled segmented control. Scheduled lists the schedules (switch, name, action, when, next run, last result) with Run now, Edit, Reset (system) or Delete (user's, confirmed), the selected schedule's last runs with Show in queue, and an in-window editor that checks every field with the scheduler's limits. Jobs a schedule queued carry a "Scheduled" pill; the history line follows the housekeeping's job-history days. - JobNotices: a scheduled background run raises a toast only when it fails (upkeep stays silent). - Settings › Archive › Rescan every is removed; ScanIntervalMinutes stays only as the seed. Strings in en and it; the others are retranslated. - The capture shows jobs-scheduled and jobs-schedule-editor on a stopped scheduler clock with sample schedules. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit e25d812feb3f417cb9251c748c29e8035fd9b03c)
140 lines
11 KiB
Markdown
140 lines
11 KiB
Markdown
# Chronos — Design reference for Claude Code
|
||
|
||
Companion to `docs/BRIEF.md` §12 (UI spec). Suggested repo placement:
|
||
`docs/ui/DESIGN.md` (this file), `docs/ui/mockups/*.html` (open in any browser;
|
||
each file is one screen at its natural size, links between screens work), `branding/`
|
||
(icon sources). The mockups are the visual target; where a mockup and the brief disagree
|
||
on behaviour, the brief wins; where they disagree on looks, the mockup wins.
|
||
|
||
## 1. Tokens → WPF resource dictionary (`Chronos.App/Themes/Dark.xaml`, `Light.xaml`)
|
||
|
||
| Key (SolidColorBrush) | Dark | Light | Use |
|
||
|---|---|---|---|
|
||
| `Brush.Bg` | #1F1F23 | #F3F3F3 | window background |
|
||
| `Brush.Chrome` | #1A1A1E | #FFFFFF | title bar, rail, status bar, web sidebar |
|
||
| `Brush.Surface` | #26262C | #FFFFFF | panels, toolbars, dialogs |
|
||
| `Brush.Card` | #2F3038 | #FFFFFF | cards, inputs, buttons, hovered rows |
|
||
| `Brush.Stroke` | #3E404A | #E5E5E5 | 1 px borders and dividers |
|
||
| `Brush.Text` | #F2F3F5 | #1A1A1A | primary text |
|
||
| `Brush.TextMuted` | #A9AEB9 | #616161 | secondary text, labels |
|
||
| `Brush.TextFaint` | #7B818E | #9E9E9E | hints, column headers, disabled |
|
||
| `Brush.Accent` | #4CC2FF | #0067C0 | primary button, active rail edge, links, Auto |
|
||
| `Brush.OnAccent` | #0B1B24 | #FFFFFF | text on accent |
|
||
| `Brush.AccentSelected` | rgba(76,194,255,.25) | #E8F1FA | selection glow / selected nav |
|
||
| `Brush.Sun` | #F5A524 | #E08A1E | manual slider track, uploader accent, icon sun |
|
||
| `Brush.Success` | #35C48F | #0F7B4F | analysed, in sync, done |
|
||
| `Brush.Warning` | #E8B339 | #9A6700 | warnings, destructive outline |
|
||
| `Brush.Error` | #F0625D | #C42B1C | errors, failed |
|
||
| `Brush.Region` | #5AD1C8 | #1A9E95 | sky/landscape region masks only |
|
||
|
||
Dark is the client default; Light follows the OS setting; the web admin follows the browser's colour scheme, with a Light/Dark toggle in its header.
|
||
Never use colour alone to carry state: pair it with a glyph (● ○ ◐ ▲ ✕ ▶) or a word.
|
||
|
||
## 2. Type (Segoe UI Variable, fallback Segoe UI; `FontSize` keys)
|
||
|
||
`Text.PageTitle` 18/600 · `Text.Title` 16/600 · `Text.Section` 14/600 · `Text.Body` 13/400
|
||
· `Text.Secondary` 12/400 muted · `Text.Chip` 11/400. Line heights 24/22/20/18/16/14.
|
||
Numbers in tables use tabular figures (`Typography.NumeralAlignment="Tabular"`).
|
||
Layout must survive +40 % text width (de, fi): no fixed-width labels, `MinWidth` only.
|
||
|
||
## 3. Spacing, radii, sizes
|
||
|
||
Spacing scale 4 · 8 · 12 · 16 · 20 (`Thickness` keys `Space.1`…`Space.5`).
|
||
Radii: 6 controls · 8 cards/panels · 12 pills · 12 modal dialogs.
|
||
Controls 32 px tall, 44 px minimum width, 12 px horizontal padding; compact row buttons 26–28 px.
|
||
Rail 200 px (collapses to 48 px icons with ≡ or Ctrl+B, the tooltips then naming each section; the choice is kept; owner review 1); title bar 34; job bar 40; toolbar 56; status bar 30;
|
||
table rows 36–40 (52 in the web admin); side panels 320 px; settings section list 200 px.
|
||
Label column left of controls: 116 px in panels, 180 px in Settings.
|
||
|
||
## 4. Controls and states (see `Components.html`)
|
||
|
||
- **Button**: Card fill, Stroke border. Hover +6 % lightness, pressed −6 %, focus = 2 px
|
||
Accent ring outside. **Primary** (Accent fill, OnAccent text, 600) — one per screen.
|
||
**Destructive** = Warning outline, transparent fill, never a primary. **Subtle** = no border
|
||
until hover. **Toggled** = Accent text + Accent border. **Disabled** = 40 % opacity and the
|
||
tooltip says why. Icon-only buttons carry `AutomationProperties.Name` and a tooltip.
|
||
- **Inputs**: Card fill, Stroke border, Accent border on focus, Error border when invalid with
|
||
the message in the tooltip (never a line of text under the field). Enter commits, Esc reverts.
|
||
- **Slider — Auto/manual** (brief §10.4): Auto state = Accent track, dimmed thumb, an `Auto · 41`
|
||
pill at the right whose tooltip gives the advisor's reason; touching it turns the track Sun
|
||
(manual), shows the value, and a `⟲` reset button returns to Auto. Not applicable = greyed
|
||
value "n/a" with the reason in its tooltip.
|
||
- **Status glyphs**: `●` green Analysed · `○` faint Not analysed · `●` Proxies · `▶ n` rendered
|
||
· `●` accent Synced/Remote · `◐` amber Analysing · `▲ n` warnings · `✕ n` errors.
|
||
- **Chips**: 24 px pills, Card fill, Stroke border; selected/recommended = Accent border and text.
|
||
- **Progress**: 6 px bar, Accent fill, text to the right; indeterminate = sliding highlight.
|
||
- **Tooltip**: light on dark (#F2F3F5 on dark, #1A1A1A text), 12 px, one line: action + cost +
|
||
shortcut ("Read every frame again · about 6 min · Ctrl+Shift+A"); 400 ms delay; ≤ 200 chars.
|
||
Every interactive element has one. There is no other explanatory text in the UI.
|
||
- **Dialog**: Surface fill, Stroke border, radius 12, 24 px shadow, two buttons maximum, safe
|
||
action left and default, destructive on the right with typed confirmation for formatting.
|
||
- **Toast**: bottom-right, 420 px, Card fill with a 3 px Accent left edge, one action button,
|
||
8 s, hover pauses. Used for card insertion, render done, server messages.
|
||
- **Job bar**: 40 px strip under the title bar in every client screen: current job, progress,
|
||
time left, pause; hidden when idle only in the editor (it shows "Ready" elsewhere).
|
||
- **Rail item**: 36 px; active = Card fill + 3 px Accent left edge; badge = Accent pill with
|
||
the count of things needing attention. Library, Import, Edit, Archive, Jobs and Server at the
|
||
top, Settings alone at the bottom: no ⓘ About entry, About is the last Settings section (owner
|
||
review 2, R5).
|
||
- **Step bar** (Edit, owner review 1): one row of equal 36 px cells under the editor's header,
|
||
one per step, 4 px padding: a 22 px badge, the name (about 82 px at the 1200 px minimum, an
|
||
ellipsis beyond) and a 1 px Stroke connector to the next step. Badge = the number in a Stroke
|
||
ring (to do), `✓` Success (done), `▲` Warning (attention), `◐` Warning (running), `○` faint
|
||
(waiting): each status has its own glyph, so colour never carries it alone. Current step =
|
||
2 px Accent underline and a semibold name; visited steps' names in Text, the others muted. The
|
||
tooltip names the step, then what it is for, its state and its shortcut (Alt+n). Previous ·
|
||
n / m · Next sit under the settings column: both buttons whole, the counter giving way.
|
||
- **Cards** (Library): 236 px wide, thumbnail 16:9, count badge top-right, checkbox top-left on
|
||
hover/selection, selected = Accent border + `AccentSelected` glow; hover scrubs the thumbnail.
|
||
- **Tables**: header 11 px faint, sortable; rows Card fill on hover; numbers right-aligned,
|
||
tabular; virtualised beyond 200 rows; row actions are 26 px buttons revealed on the row.
|
||
|
||
## 5. Icons
|
||
|
||
16 px, 1.5 px strokes, round caps and joins, `currentColor`, drawn as `PathGeometry` /
|
||
`DrawingImage` resources in `Chronos.App/Icons/Icons.xaml` (source SVGs in `branding/ui-icons/`
|
||
if generated by a tool). No icon fonts, no emoji in shipped UI (the mockups use a few glyphs
|
||
only as placeholders: replace ⟳ ▾ ✕ ■ ❚❚ ≡ with drawn icons). Directional icons mirror in RTL:
|
||
`IconData.IsDirectional` marks the glyphs that point along the reading direction (back/forward, chevrons
|
||
left/right, external link, start-aligned lines); `ui:Bidi.IsDirectional` overrides it for a subtree (a ▶ used
|
||
as "next", a chevron on a left-to-right time axis). Every other glyph (clocks, media controls, the ▶ rendered
|
||
status) and the brand mark keep their drawn orientation. Photos, previews, charts, numbers, paths and
|
||
templates are left-to-right islands (`FlowDirection="LeftToRight"` on the smallest element holding them).
|
||
Category charts without a time axis (horizontal bars, stacked bars) still lay out from the reading side inside
|
||
their island: labels on the reading side, bars growing away from it; time axes and month grids never flip.
|
||
`branding/ui-icons/icons.py` is the one source: it writes `Icons.xaml` and the web admin's `icons.js`. Settings is a
|
||
toothed gear (8 teeth, outer radius 6.5, valleys on 4.6, centre hole 1.7: `gear()` in `icons.py`); a circle with rays
|
||
is the Sun icon only.
|
||
|
||
## 6. App icon (`branding/`)
|
||
|
||
`chronos.svg` is the master: 256 plate radius 56 #1A1A1E, ring r 92, 12 ticks of 12° with 18°
|
||
gaps, stroke 20 round caps, opacity 0.14 → 1.0 clockwise from 12 o'clock, sun disc at
|
||
(152,104) r 30 #F5A524. Variants: `chronos-server.svg` (rack badge), `chronos-uploader.svg`
|
||
(up-arrow badge), `chronos-mono.svg` (white, no plate, for the tray). PNG renders at
|
||
16/32/48/64/128/256 are reference output; `Chronos.Tools make-icon` must regenerate ICO/PNG
|
||
from the SVG geometry (no raster assets checked in as sources). Badges only at ≥ 48 px.
|
||
|
||
## 7. Screen-by-screen notes (mockup → brief section)
|
||
|
||
| Mockup | Brief | Notes |
|
||
|---|---|---|
|
||
| `Main.html` | §12.2 Library | grid/list, year·camera·status filters, selection panel |
|
||
| `Editor.html` | §12.3 Edit | Exposure step: step bar, title ▾ (Change sequence), wipe compare, curves, advisor Auto pills, Previous · n / m · Next |
|
||
| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence |
|
||
| `Import.html` | §12.4 / §13 | card profile, sessions, plan, verification, after-import actions |
|
||
| `Archive.html` | §12.5 | tree, mass operations, stats, verify/rebuild, maintenance |
|
||
| `Jobs.html` | §12.6 | filters, queue order, expandable log, retry/open/folder; a `Queue · Scheduled` segmented control first in the toolbar (owner review 2, R10): Scheduled is a table (on switch, name, action, when, next run, last result, Run now · Edit · Reset or Delete), the selected schedule's last runs under it (Show in queue), New schedule at the toolbar's end and the editor as an in-window dialog; jobs a schedule queued carry an Accent `Scheduled` pill after their target |
|
||
| `Server.html` | §12.7 / §14 | connection with TOFU fingerprint, account and quota, render node, sync table, conflicts |
|
||
| `Settings.html` | §12.8 | section list (About last, §12.9), Rendering section, encoder table, self-test |
|
||
| `Welcome.html` | §12.1 | first run: local archive / adopt folder / connect; consent line; card toast |
|
||
| `Admin.html` | §14.7 | dashboard; sidebar: pages from the top, Settings docked at its foot above the account, no About (the last group of Settings) |
|
||
| `AdminUsers.html` | §14.7 | users table, roles, quotas, temporary password, render-node right |
|
||
| `Uploader.html` | §15 | single window, watch folder, queue, tray |
|
||
| `Components.html` | §12.1 | the control kit above, with hex values and state rules |
|
||
| `Icon.html` | §17 | construction, sizes, variants, wordmark |
|
||
|
||
Missing on purpose (build from the brief and this kit): the Settings › About page, Login dialog, Jobs › Scheduled and its editor, the Edit picker
|
||
and the other steps (Analysis, Frames, Motion, Camera, Time, Stack), Import "Show plan",
|
||
Archive rebuild dialog, the admin Archive/Jobs/Settings/Logs pages. Reuse the shell and the kit; do not invent new colours.
|