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
This commit is contained in:
2026-09-17 08:10:35 -05:00
parent 555c25d77b
commit 3f353307cf
+9 -8
View File
@@ -2,7 +2,7 @@
> **Version:** 1.4.2-stable > **Version:** 1.4.2-stable
> **Theme Foundation:** Catppuccin Mocha + e621 Authentic Taxonomy Architecture > **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}}`) > **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) ### 4.1 Global Frame (Shell)
- **Top App Bar (`#11111b`, height: 56px):** - **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]`. - 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):** - **Global Footer Status Strip (`#11111b`, height: 32px):**
- Left: `📁 Local Storage: /data/media/j621/archive` - The strip placement is a proposal; its values are real and drawn from the existing stats data.
- Center: `⚡ Active Workers: 4 Parsing | Sync Queue: 0 Pending` - Left: the watched folder path — `📁 Local Storage: /mnt/media/library`.
- Right: `J621 Engine v1.4.2-stable` - 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 <version>` / commit hash.
- **Collapsible Sidebar (Behavior):** - **Collapsible Sidebar (Behavior):**
- **Closed by default** across all gallery and viewer views to prioritize screen real estate. - **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`). - 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:** - **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). - **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:** - **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. - 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. - 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 - `/`: Focus search bar
- `Ctrl+K` / `⌘K`: Quick command palette & tag finder - `Ctrl+K` / `⌘K`: Quick command palette & tag finder
- `[` / `]`: Previous / Next post in detail view - `[` / `]`: 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 - `F`: Toggle favorite / follow