- README.md: what this is, how to run and build it, the folder map, how light and dark mode work (@hanzo/appearance, @hanzo/design), where every price and checkout link lives, scripts, and known differences from live - docs/build-notes/: status files, request notes, per-page checklists and reviews, plans - Removed: screenshot galleries, captures of third-party sites used as references, the generated status page and its script, editor config, a personal working-rules file - Code comments point at the new docs paths (no code changes) Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
8.7 KiB
/risk coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/apps/Risk.jsx (+ Risk.css) · gallery: docs/gallery/risk/ · metric id: contact_sales_submit
Open copy questions for James: dial labels not in content/ui-strings.json ("the line", "action", "reasons · tap one to set it back to neutral", "stage: ''", "Illustration. No figure on this page is a customer result."); chapter visual captions ("alert → case", "same call · same record · same model", "N of 4 facts"); the closing band repeats the h1's words.
Shared changes requested: docs/build-notes/requests/templates.md (covers every Business 2 page).
Forks this page deleted: the framed dial card and its corner name, the 76px score and the ±weights (no invented digits), the floating dial and chapter pauses, the "+"-only openers (now labelled with Hanzo's words), the 26px caps "Next", the black "summon a person" pill (now underlined ink), every spring, the colour comments, the inert data-cursor attributes.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; "Talk to us" → /contact-sales
- One h1; clear in 5 seconds
- No dead button
- Copy questions listed
Done here: gate: 1 h1, max 1 solid per viewport; the close has its own band with the solid ask.
2. Information architecture and navigation
- One
<main id="main">; shared skip link - Every link through
A - n/a breadcrumb
- Link parity 0 removed
Done here: parity links 7/7.
3. First impression and page narrative
- Sells in 5 s; the needle and action move within 2.2 s
- h1 CSS cut-in painted by the server; nothing above it
- JS off legible
- Hero gauge → statement and two faces → three chapters → cards → dark room → rules → plans → what it is not → band
- Ends on a band ("Talk to us"), then footer
- n/a Morph
Done here: one thing per screen: the gauge in the hero (decision word 32px, its label a caption under it), then "Where this is today" peeks under the hero (no void) as one engine with two faces, then one object per section in the second half: the rule card (its three descriptions swap under it), the declare stack, the request flow, the tier ladder (the active tier's words swap under it), the named gaps.
4. Conversion system
- Kit
A+.w2-cta - Sticky ask "Talk to us" (
data-thumb) - n/a copy button
data-ctaon hero (risk.hero), band (risk.close) and the Next card (risk.next)
Done here: hero and band both carry data-thumb="Talk to us".
5. Trust and proof
- No logo, seal or invented number (the score digits and weights are gone)
- Figures traced: twenty rules, five-year clock, four sanction lists (Hanzo's)
- n/a marquees
- n/a submit
Done here: the dial is labelled an illustration in Hanzo's words.
6. Content presentation (copy untouched)
- Phone text 14px+ (mono capitals 12px)
- Measures held; long opener labels wrap with the "+" unsquashed
- Sheets via OpenSheet (focus trapped)
parity.py /risk: 0 missing
Done here: parity text 114/114 links 7/7; no sentence under any tile (Decides-on and Plans words open or swap), no side-by-side text columns (Rules and Platforms are separate screens).
7. Visual design system
taste.pypasses (0 hues)- No label above a headline ("Next" is a 12px mono caption above its links, not a headline)
- Tiles flat; the chapter visuals float
- One icon set
- Differs from neighbours: an unframed gauge, not a desk or window
Done here: gate hues [].
8. UI component library
- Hover in
@media (hover:hover), press .98, focus-visible - Stage tabs take arrow keys, Home and End; facts are switches
- Sheets trap Tab and return focus
- No bare
:hover - Forks deleted: listed above
Done here: fact switches get an ink border on hover.
9. Motion and interaction
- Signature (the live dial), supporting: Settle, PinChapters, sheets; 0 fade-ups
- Idle (dial, chapter visuals, event stream, rule card, declare stack, request flow; all stop out of view), pointer (reasons, switches), state (sheets), arrival (h1)
- Moves without input; every control answers
- Reduced motion rests; no springs
- n/a sound (shared kit)
Done here: the action word holds a two-line box at both widths, so nothing under the dial moves when it flips.
10. Media
- n/a images; Sigil drawing in Next
- n/a video
- n/a
- n/a
Done here: one Sigil (seed hanzo-risk) beside Next.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Targets 44px+
- Primary above the fold at 375×667
Done here: the phone gauge stays full width (align-items: stretch); the dial pause sits beside the stage tabs.
12. Accessibility (WCAG 2.2 AA)
- Contrast measured
- Pause beside the stage tabs, under the chapter visual, beside the event stream
- n/a forms
- One h1; h2/h3 order
- Keyboard reaches every control
Done here: the dial's result is aria-live only after the visitor acts.
13. Performance and engineering
- h1 in server HTML
- No images
- No poller, no third party
- Nothing heavy on James's laptop
Done here: one client island.
14. SEO and machine files
- Title and description from
content/pages.json - Canonical from shared layout
<JsonLd route="/risk" />- Cards open sheets
Done here: app/risk/page.jsx.
15. Catalogue and product pages
- n/a
- Cards open into sheets
- n/a
- n/a (nothing priced)
Done here: n/a.
16. Developer experience
- Endpoints shown as Hanzo writes them (/v1/aml, /v1/risk, POST /v1/event)
- n/a config
- n/a terminal
- No version
Done here: n/a beyond the endpoints.
17. States and resilience
- Dial: every reason neutral reads "allow"; switches: none or all facts
- Blocked network: complete page, no console errors
- n/a submit
- n/a
Done here: look.cjs both widths errors none. Slice D, 7 Nov: check.mjs at 1470×801 and 375×812: 0 console errors, no Next issue badge, scrollWidth 1470/1470 and 375/375; gallery desktop-1.jpg, desktop-2.jpg, phone-1.jpg, phone-2.jpg refreshed from it.
18. Measurement and handover
data-ctaon every primary- Nothing identifier-bearing
V2:line inapp/risk/page.jsx- Review requested from an independent critic after this pass
Done here: previous review 6/10; all eight fixes addressed. Round 2 (this pass): "Rules, lists and suppression" gets a rule card (list chips light, Lists → Suppression, a "suppressed" stamp), the declare stack steps while in view instead of playing once, "How it connects" gets a request-flow drawing (your system → Risk, a decision back, the processor untouched), stage tabs take Home/End, off-deck greys swapped to the deck ramp, radii moved to the MASTER set, dead CSS dropped. Idle motion now reaches every screen: the decision-card drawings loop in view, the tier ladder steps, the three named gaps step, the live face pings, and on desktop the shorter column (Platforms, What this is not) stays sticky beside the longer one; a 1 s/2.4 s screenshot diff per screen finds STILL only in the shared footer (desktop 1 of 15, phone 3 of 18). Round 3 (critic 7/10): voids removed (hero and section padding), the faces drawn as one engine, Rules and Platforms split into one screen each with their text folded into the object or a sheet, connect notes open from their names, ladder tiles carry the tier names with the words swapping under, the phone keeps the hero "Talk to us" solid, phone stage pill on one line, gaps marked in place. Round 4 (critic 7/10, hero): the first screen is recomposed: a 3-line h1 (first baseline 27.5%, last 41.1% of 801), the dial beside it (58.7% of the hero width, 28px from the text, right edge on the container at 1446), the next section peeking 56px at 1470x801; on the phone the hero ask is the quiet ring so the header's "Try Hanzo" is the one solid; the verdict word holds one line with ACTION under it; chapter cards are flat #f5f5f5 tiles with their pause in the card's top-right corner (reachable at 375, not under the header); the declare stack, tier ladder and gaps run once on entry and rest (one continuous mover per viewport); the Abuse bars clear the card's +. Slice D, 7 Nov: the review's six fixes are in (h1 near 38%, gauge beside it, ACTION under the word, next section peeks; flat chapter cards with the pause in the corner; once-on-entry loops), and the unverified motion-map pass is verified: the ink-spread now arrives (it observed its own clip-path box and never fired; it watches its parent now and starts from a zero-size blot).