From 33063afbdf3fe47b1d9aa70b493d8a646f69f6e7 Mon Sep 17 00:00:00 2001 From: Noel Sabia Date: Sat, 14 Nov 2026 11:03:18 +0100 Subject: [PATCH] design: give PulseCast a shift-board identity - replace default Onyx surfaces with paper/ink, signal orange and Archivo - make /plan answer peak, staff-hours, cost vs flat and coverage above the fold - add the weekly shift board, shared plan helpers and a pulse line - rebuild /live as a phone-first dark board and /stage as a full-bleed projector - label the real 14-20 Nov window; remove 'next week' claims - keep Onyx components, SSR, live scenario updates and accessible states --- .impeccable/surfaces/plan.md | 42 + PRODUCT.md | 64 ++ README.md | 10 +- app/app.vue | 64 +- app/assets/css/main.css | 1330 ++++++++++++++++++++++++-- app/components/LiveStatusBadge.vue | 113 ++- app/components/PulseLine.vue | 108 +++ app/components/WeekBoard.vue | 419 ++++++++ app/pages/about.vue | 2 +- app/pages/forecast.vue | 2 +- app/pages/index.vue | 779 ++++++++++----- app/pages/live.vue | 649 ++++++++----- app/pages/plan.vue | 1084 ++++++++++++--------- app/pages/stage.vue | 951 ++++++++++-------- app/utils/plan.ts | 108 +++ nuxt.config.ts | 20 +- public/fonts/archivo-latin-var.woff2 | Bin 0 -> 90104 bytes public/logo.svg | 7 +- 18 files changed, 4300 insertions(+), 1452 deletions(-) create mode 100644 .impeccable/surfaces/plan.md create mode 100644 PRODUCT.md create mode 100644 app/components/PulseLine.vue create mode 100644 app/components/WeekBoard.vue create mode 100644 app/utils/plan.ts create mode 100644 public/fonts/archivo-latin-var.woff2 diff --git a/.impeccable/surfaces/plan.md b/.impeccable/surfaces/plan.md new file mode 100644 index 0000000..3aff8cd --- /dev/null +++ b/.impeccable/surfaces/plan.md @@ -0,0 +1,42 @@ +--- +version: 1 +slug: "plan" +primary_target: "plan" +related_targets: ["/", "/live", "/stage"] +--- + +# Surface brief — decision, stage, phone + +## Scope + +Primary: `/plan` (Operate). Related: `/` (Persuade), `/live` and `/stage` (Experience), with supporting `/forecast`, `/simulate`, `/about`, `/control` to follow in the finish pass. + +## Audience and job + +A Heilbronn duty manager needs the coming week's staffing decision: who works, when, what it costs, and what the trade-off is. A hackathon audience needs the same decision at ten metres on a projector, then in their hand on a phone. The presenter needs to change one scenario and have every surface follow honestly. + +## Success + +- `/plan` answers what to do above the fold: peak shift, staff count, staff-hours, cost vs flat, coverage. +- `/live` answers on a 390×844 phone above the fold: shift, staff count, one-line reason, freshness. +- `/stage` is readable at 10 m without app chrome. +- `/` sets up the story in one screen with the live plan as proof. +- Measured, modelled and assumed stay visibly distinct; the real 14–20 Nov window is labelled. + +## Constraints + +Live API data only; no fabricated numbers. Preserve routes, API contracts, Onyx components, SSR, accessibility, reduced motion and the existing build/tests. The paper brief's 210 h / €3,360 is stale; the demo baseline is the live sunny-saturday-market plan (5 peak, 172 staff-hours, €2,752 vs €5,600 flat, 100% coverage). + +## Direction contract + +THESIS: A shift board, not a dashboard. The week's footfall becomes a physical timetable with an orange peak block; the category's metric-card hero and admin shell are refused. + +OWN-WORLD: Cool paper `#F4EFE6`, ink `#16130F`, signal orange `#E84100` for the peak (text `#B63A00` on paper), board green `#2E6B4F` for coverage. Archivo variable: condensed 78% display, tabular numerals, heavy rules, zero radius, no shadows. `/stage` and `/live` invert to ink `#0E100E` with paper type and bright orange. + +STORY: The manager reads "Five on Saturday, 10:00–14:00", sees the week board, and understands 172 staff-hours cost €2,752 against €5,600 flat with 100% coverage. They approve or export. The judge sees the same plan on stage and phone; a scenario change redraws the pulse and the blocks. + +FIRST VIEWPORT: `/plan` — h1 "Five on Saturday." with shift time and a receipt of staff-hours/cost/coverage on the left, a full-width seven-day shift board with the orange peak on the right/below, and Approve/Export actions. `/` — headline "Saturday needs five." beside the live board. `/live` — giant 5, Saturday 14 Nov, 10:00–14:00, one-line peak-forecast reason, freshness. `/stage` — full-bleed dark board: 5 staff, day/time, week board, cost line, QR. + +FORM: Shift board / timetable. The user pinned the world and its first-surface experience; no roll was needed. `seed: none (pinned)` — "A — Shift board. Full replacement. Paper/ink ground, signal orange for the peak, heavy timetable rules, tabular numerals, physical time blocks. /stage inverts to a dark board." + +FINISH: unreviewed and undocumented is unfinished; this build ends with the finish review, the verdict, DESIGN.md, and every shipping raster carrying its provenance. diff --git a/PRODUCT.md b/PRODUCT.md new file mode 100644 index 0000000..7aa9b7c --- /dev/null +++ b/PRODUCT.md @@ -0,0 +1,64 @@ +# Product + + + +## Platform + +web + +## Users + +The primary user is the duty manager of an inner-city Heilbronn retailer who has to decide the next staff schedule. The secondary audience is a hackathon judging room: a presenter on a projector, judges and audience on their own phones, and a presenter operating a control page. + +## Product Purpose + +PulseCast turns inner-city footfall into a transparent staffing plan for the coming store week. It exists so a manager can answer one question — who works when, and what does that week cost? — with the forecast, assumptions, uncertainty and trade-offs visible rather than hidden. + +## Positioning + +Measured footfall becomes a modelled forecast, the forecast becomes a shift board, and the same decision is broadcast to the room. The product shows the cost against a flat schedule and names the overstaffed hours it buys. A neighbouring dashboard could copy the chart; it cannot copy the honest chain from sensor to shift to phone. + +## Operating Context + +- Heilbronn inner-city store, Europe/Berlin, store hours 10:00–20:00. +- Eight fixed sensors in a roughly 580 m pedestrian cluster; 15-minute cadence. +- Shift blocks of 2–5 hours; default 4 hours; 25 visitors per staff-hour; ×1.15 safety factor; €16/hour labour assumption. +- No POS, sales, queue, payroll or labour-cost feed. Cost is an assumption, clearly labelled. +- The plan heuristic is decision support, not an optimizer. Coverage is at or above requirement by construction because each block is sized to its peak; overstaffed hours are the visible trade-off. +- The demo uses the live Go API. `/control` broadcasts a scenario over SSE; `/stage` and `/live` follow it with a 5-second polling fallback. +- The live plan window currently returned by the API is 14–20 Nov 2026, not next Monday's week. The UI must label the real window and never say "next week" while the data says otherwise. + +## Capabilities and Constraints + +- Nuxt 4 SSR with Onyx as the component system. Routes: `/`, `/forecast`, `/plan`, `/simulate`, `/about`, `/stage`, `/live`, `/control`. +- `/plan` reads Go `/api/staffing` through Nitro. Local assumption edits are an explicitly labelled preview; they do not change the API plan. +- `/stage` and `/live` follow the live scenario and must show connection state honestly (Live, Polling, Offline) and a last-updated time. +- No new backend behavior, no new dependencies, no fabricated numbers. Read plan values from the API. +- Preserve SSR, keyboard access, contrast, reduced motion, responsive behaviour and the existing build and tests. +- The plan window on 14 Nov 2026 is 14–20 Nov. The paper brief's 5 staff / 210 staff-hours / €3,360 is stale and not reproducible; the reproducible sunny baseline is 5 peak, 172 staff-hours, €2,752 vs €5,600 flat. + +## Brand Commitments + +- Name: PulseCast. +- Voice: direct, quiet confidence; honest about what is measured, modelled and assumed. "Staff the pulse, not the noise." +- The visual world is pinned as a **shift board**: paper/ink ground, signal orange for the peak, heavy timetable rules, tabular numerals and physical time blocks. `/stage` inverts to a dark board. +- Onyx remains the component system; default Onyx visuals must not ship. + +## Evidence on Hand + +- Live Go API at `https://api-pulse.noelsabia.dev` and checked-in mock JSON. +- Baseline screenshots and audit in `/tmp/opencode/audit` (session artefact). +- Tests in `test/` including a captured Go staffing fixture. +- No customer testimonials, no POS data, no city-wide heatmap claim. Do not invent them. + +## Product Principles + +1. Answer first. The peak shift, staff count, cost and coverage are the first reading order on every decision surface. +2. Show the chain. Measured, modelled and assumed are visibly different things. +3. One plan, every surface. The stage, the phone and the plan are the same numbers, propagated live. +4. Keep the trade-off visible. Overstaffed hours and uncertainty are part of the answer, not a footnote. +5. Earn the projector and the phone. Ten-metre legibility and one-thumb clarity are design constraints, not afterthoughts. + +## Accessibility & Inclusion + +WCAG 2.2 AA. Keyboard access for all controls and scrollable data; visible focus; 4.5:1 body text and 3:1 large text; no colour-only meaning; reduced-motion alternatives; touch targets at least 44×44 px where practical; stage text legible from 10 m. diff --git a/README.md b/README.md index a9fecb7..0a4e3e9 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # PulseCast web Nuxt 4 SSR frontend for **PulseCast**, a staffing copilot that turns inner-city -footfall into a next-week shift plan for a Heilbronn retailer. `/plan` is the +footfall into a weekly shift plan for a Heilbronn retailer. `/plan` is the decision surface; `/stage` and `/live` present that plan. The map, weather and forecast are supporting evidence. @@ -167,12 +167,12 @@ deployed path are the real API. | Route | Purpose | | --- | --- | -| `/` | Now: replay reading, 8-sensor schematic, weather, holiday, data versions | +| `/` | Landing: the live shift board, peak shift, cost vs flat, coverage and the measured/modelled/assumed chain | | `/forecast` | 7-day daily forecast, uncertainty band, weather strip | -| `/plan` | **Hero.** Peak decision, shift blocks, coverage, cost, why, assumptions | +| `/plan` | **Hero.** Peak decision, weekly shift board, coverage, cost vs flat, settings, hourly detail | | `/simulate` | Base vs scenario plan, both read from Go `/api/staffing` | -| `/stage` | Big-screen decision: headline, peak staff, cost, coverage, QR to `/live` | -| `/live` | Phone view: current recommendation, peak shift, scenario, last update | +| `/stage` | Dark projector board: peak shift, weekly board, cost, coverage, QR to `/live` | +| `/live` | Phone answer: peak shift, staff count, reason, freshness, scenario and transport | | `/control` | Presenter preset buttons; authenticated POST through Nitro | | `/about` | Method, metrics, limits, privacy, train form | diff --git a/app/app.vue b/app/app.vue index bd056fa..817438d 100644 --- a/app/app.vue +++ b/app/app.vue @@ -5,26 +5,22 @@ import { iconCircleInformation, iconFlash, iconHome, - iconMobileSignal, - iconPresentionBoard, } from '@sit-onyx/icons' const route = useRoute() const config = useRuntimeConfig() -const usingMock = computed( - () => - config.public.useMock === true || - config.public.useMock === '1' || - config.public.useMock === 'true', -) +const usingMock = computed(() => { + const value = config.public.useMock + return value === true || value === '1' || value === 'true' +}) + +const isPresentation = computed(() => route.path === '/stage' || route.path === '/live') const navigation = [ { to: '/', label: 'Now', icon: iconHome }, { to: '/forecast', label: 'Forecast', icon: iconChart }, { to: '/plan', label: 'Plan', icon: iconCalendar }, { to: '/simulate', label: 'Simulate', icon: iconFlash }, - { to: '/stage', label: 'Stage', icon: iconPresentionBoard }, - { to: '/live', label: 'Live', icon: iconMobileSignal }, { to: '/about', label: 'About', icon: iconCircleInformation }, ] @@ -32,10 +28,32 @@ const hiddenPageLabels: Record = { '/control': 'Control' } const activeLabel = computed( () => navigation.find((item) => item.to === route.path)?.label ?? hiddenPageLabels[route.path] ?? 'PulseCast', ) + +useHead(() => ({ + bodyAttrs: { class: isPresentation.value ? 'pc-presentation' : '' }, +})) + +// Onyx renders its overflow navigation as a `menubar` whose direct child is a +// div, which fails the required-children rule. The list is site navigation, +// not an application menu, so remove the menu role rather than fake menuitems. +let navRoleObserver: MutationObserver | undefined +function fixNavAria() { + for (const list of document.querySelectorAll('.onyx-more-list[role="menubar"]')) { + list.setAttribute('role', 'none') + } +} +onMounted(() => { + fixNavAria() + navRoleObserver = new MutationObserver(fixNavAria) + navRoleObserver.observe(document.body, { childList: true, subtree: true }) +}) +onBeforeUnmount(() => navRoleObserver?.disconnect())