From 3f353307cf83241c73c1802c6050327f59083210 Mon Sep 17 00:00:00 2001 From: JakeBreath Date: Thu, 17 Sep 2026 08:10:35 -0500 Subject: [PATCH] docs: correct spec assumptions (storage line, status pill, footer workers) - 'NAS UI' tag was a misinterpretation of the watched-folder path; the spec now calls it the storage line and notes J621 is folder-based - Status pill documents the real backend fields: environment, actual host OS, page generation time, e621 API request time - Footer strip is marked as a proposal; the workers count is real data from the stats page, not invented thread counts - Removed the remaining 'Write to NAS' / 'Ingest to NAS' phrasing --- frontend/design.md_j621_frontend_spec.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/frontend/design.md_j621_frontend_spec.md b/frontend/design.md_j621_frontend_spec.md index adc21be..94cc9de 100644 --- a/frontend/design.md_j621_frontend_spec.md +++ b/frontend/design.md_j621_frontend_spec.md @@ -2,7 +2,7 @@ > **Version:** 1.4.2-stable > **Theme Foundation:** Catppuccin Mocha + e621 Authentic Taxonomy Architecture -> **Target Platform:** Desktop-first, fully responsive self-hosted NAS / Home Server Media Web Application +> **Target Platform:** Desktop-first, fully responsive self-hosted home-server media web application (the library is a watched folder on disk, not a NAS appliance) > **Reference Design System:** `Mocha Archive Terminal` (`{{DATA:DESIGN_SYSTEM:DESIGN_SYSTEM_3}}`) --- @@ -77,13 +77,14 @@ All tag chips, counters, and sidebar taxonomy badges strictly adhere to e621's e ### 4.1 Global Frame (Shell) - **Top App Bar (`#11111b`, height: 56px):** - - Left: Brand mark `J621` badge (`#cba6f7` badge with `NAS UI` tag). + - Left: Brand mark `J621` badge (`#cba6f7`) followed by the **storage line** — the path of the watched folder that J621 indexes (e.g. `/mnt/media/library`). J621 is folder-based: this is just a path on disk, not a NAS/appliance indicator. - Center: Nav pills: `Library`, `Online`, `Pools`, `Followed`, `Upload`, `Duplicates`, and `Stats [STAFF]`. - - Right: System latency pill (`ENV: PROD · LINUX · 18ms (e621: 4ms)`), user avatar. + - Right: System status pill with real backend values, never hardcoded: environment (`DEV`/`PROD`), the actual host OS, page generation time, and the total e621 API request time for that page load — e.g. `ENV: PROD · LINUX · 18ms (e621: 4ms)`. Followed by the user avatar. - **Global Footer Status Strip (`#11111b`, height: 32px):** - - Left: `📁 Local Storage: /data/media/j621/archive` - - Center: `⚡ Active Workers: 4 Parsing | Sync Queue: 0 Pending` - - Right: `J621 Engine v1.4.2-stable` + - The strip placement is a proposal; its values are real and drawn from the existing stats data. + - Left: the watched folder path — `📁 Local Storage: /mnt/media/library`. + - Center: `⚡ Active Workers: N running | Queue: M pending` — the count of active optimization/ingest jobs and queued downloads (the original app surfaced this on its stats page; the footer simply keeps it visible). + - Right: the build actually running — `J621 ` / commit hash. - **Collapsible Sidebar (Behavior):** - **Closed by default** across all gallery and viewer views to prioritize screen real estate. - Toggled via `☰` button or quick keyboard shortcut (`Ctrl+B` or `⌘B`). @@ -105,7 +106,7 @@ All tag chips, counters, and sidebar taxonomy badges strictly adhere to e621's e - **2-Column Layout:** - **Left Rail (320px):** Categorized tag hierarchy (`Artist`, `Copyright`, `Species`, `General`, `Meta`) with tag search links `?` and follow `+` toggles. Specs sheet (Post ID, MD5, dimensions, format, source URL). - **Right Main Area:** - - Action Header: `Download to Local Library`, `Write to NAS`, `Favorite`, `Add to Pool`. + - Action Header: `Download` (local files) / `Download to Library` (online posts), `Favorite`, `Add to Pool` — downloading writes into the watched folder; there is no separate "NAS" step. Favorites and pools are e621-side actions. - Media Canvas: Centered high-resolution image or loopable WebM/MP4 viewer with pan/zoom. - Context Panels: Artist commentary, local storage allocation paths (`/data/media/j621/...`), inode/checksum integrity report, and user comment stream. @@ -138,5 +139,5 @@ All tag chips, counters, and sidebar taxonomy badges strictly adhere to e621's e - `/`: Focus search bar - `Ctrl+K` / `⌘K`: Quick command palette & tag finder - `[` / `]`: Previous / Next post in detail view - - `D`: Trigger "Download / Ingest to NAS" + - `D`: Trigger Download (or "Download to Library" while browsing online posts) - `F`: Toggle favorite / follow