Files
Noel Sabia 2bc52a314d
ci / check (push) Successful in 55s
feat: build the Cool City public route demo
- add /cool, /cool?vote=1, /cool/stage and /cool/city on the existing Nuxt/Onyx stack
- wire real route/shade metrics and OSM geometry from the route bundle; city-gap data for the city view
- show shade % and direct-sun minutes together; recommend Accessible for Ruth with the 15% ramp trade-off
- add in-memory time/scene/round state and one anonymous vote per session, polled every 2 s
- keep the retail module linked but out of the Cool City story
2026-11-14 13:49:22 +01:00

43 lines
3.4 KiB
Markdown

---
version: 1
slug: "cool"
primary_target: "cool"
related_targets: ["/cool/stage", "/cool/city", "/plan"]
---
# Surface brief — Cool City decision demo
## Scope
Primary: `/cool` (public, person-first route decision). Related: `/cool/stage` (projector keynote), `/cool/city` (cooling-gap module), `/plan` (retail module, linked only).
## Audience and job
Ruth, 78, lives alone — a composite, not a real person. She needs bread from Marktplatz on a hot day. The phone answers which way now; the stage tells the room the same story. The audience votes; the model recommends **Accessible for Ruth**.
## Success
- `/cool` is minimal: Ruth card, time slider, three route cards with shade and direct-sun minutes, vote buttons. No map dashboard, sensor table, weather card or methodology paragraphs.
- `/cool?vote=1` is only the question and three buttons. No map, no PII.
- `/cool/stage` is a keynote: Ruth card → Cool places → Data honesty → Find routes → 10:00→16:00 → Start vote → Lock vote → City view → Retail module → close. Quiet presenter controls, exact labels.
- The key insight is visible: the shaded route is 732 m / 9.8 min, 50.0% shade but 4.9 direct-sun min versus the shortest 359 m / 4.8 min, 43.8% shade, 2.7 min, with a 15% ramp. The accessible route is 438 m / 5.8 min, 43.8% shade, 3.3 min, no ramp, water and benches.
- Real route/city JSON only; missing values are hidden or TBD.
## Constraints
Real data: `public/cool-city/route.json` (normalised from `shade.json`, `routes.geojson`, `places.json`) and `public/cool-city/city-gap.json`. No retail numbers on Cool City. Onyx stays, themed with the system UI stack. Shared time/phase state is in-memory Nitro; vote per round. No PII. Keep SSR, accessibility, reduced motion, build/tests.
## Direction contract
THESIS: A live demo, not a dashboard. One decision: which way should Ruth go now? Apple-like clarity — less information, more confidence — with the map as stage content and a minimal phone flow.
OWN-WORLD: Warm off-white `#F6F3EE`, near-black `#121212`, heat `#E4572E`, shade/water `#2F6FED`, system UI stack, tabular numerals, 28 px translucent surfaces, soft shadows, generous 8-point space, subtle state motion. Stage inverts to `#0B1114` with bright heat and shade.
STORY: Ruth card. The city has cool places but no route. Three routes; at 10:00 the shortest is fine; at 16:00 shade % and direct-sun minutes disagree. The shaded route takes twice as long for 4.9 sun minutes; the shortest has a 15% ramp; the accessible route is one minute longer with no ramp, water and benches. The room votes; the model recommends **Accessible for Ruth**. Close: "The pulse is not the people. But the city still has to protect them."
FIRST VIEWPORT: `/cool` — Ruth card, time slider, route cards with accessible first. `/cool/stage` — Ruth card first; then the dark route board at `Find routes`, with the exact labels and presenter strip.
FORM: Pinned by `COOL_CITY_DESIGN.md` and `presentation/cool-city-demo-script.md`; no roll. `seed: none (pinned)` — "The frontend is a live demo, not a dashboard. Less information, more confidence. ... Apple-like clarity, not an Apple skin. ... full-bleed map ... floating bottom sheet ... one typeface, one accent, subtle motion, immaculate finish."
FINISH: unreviewed and undocumented is unfinished; this build ends with the finish review, the verdict, DESIGN.md, and every shipping raster carrying its provenance.