Files
web-nuxt/PRODUCT.md
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

5.6 KiB
Raw Permalink Blame History

Product

Platform

web

Users

Primary public user: Ruth, 78, lives alone in Heilbronn. She is a clearly labelled composite persona, not a real person: the stand-in for an older resident who needs bread, a bench, water and shade on a hot day. The product must work on her phone, one-handed, in bright light.

Secondary audiences: the hackathon room watching a projector; a city climate-adaptation team looking for where shade, water and benches are missing; the retailer who pays for the staffing module.

Product Purpose

Cool City is Heilbronn's public heat-safe route. It tells a person how to reach the places they need — cooler, quieter, step-free — at a given hour, and shows the city where shade, water and benches are missing. The retail staffing plan remains a separate commercial module, not the hero.

Positioning

The city publishes almost 60 cool places on a map and an address list. It does not turn them into a time-aware, person-level route. Cool City connects the public cool-place map, modelled shade, OSM access features and the existing footfall/weather stack into three route choices a person can act on: shortest, shaded, accessible. It shows the room's vote next to the model's recommendation. A private dashboard cannot truthfully copy the public framing or the person-level route.

Operating Context

  • Heilbronn inner city. Origin Stadtgalerie, destination Marktplatz. Verify route geometry and place names against OSM and the final route bundle before the demo.
  • Three options: shortest; shaded via the Deutschhof passage / Kiliansplatz; accessible with water, benches and step-free access.
  • Time stops: 10:00, 12:00, 14:00, 16:00. The recommendation may change with the sun.
  • Shade is modelled from solar position and building/tree geometry, not measured. Never claim a temperature difference.
  • Sensors are eight inner-city PAX counters: a relative device index, not people. No city-wide heatmap claim.
  • Public vote: one vote per random session ID in localStorage; aggregate tally only; no PII, no accounts, no location upload.
  • The route/shade bundle lives in cool-city-data/route/; the cooling-gap bundle in cool-city-data/city/. Final JSON is copied to public/cool-city/. If a bundle is missing, label TBD and do not invent values.
  • Do not generalise the commissioned FITNAH PET range to every inner-city street.

Capabilities and Constraints

  • Nuxt 4 SSR + Onyx + MapLibre available. Routes: /cool, /cool/stage, /cool/city, plus the existing retail routes.
  • /cool is mobile-first and must also read clearly on a projector. /cool/stage is a dark, full-bleed projection surface.
  • /cool/city ranks eight sensor catchments with a relative cooling-gap index and shows the weights and assumptions. No measured temperature map.
  • Vote backend: in-memory Nitro route, aggregate counts, one vote per random session ID, stage polls every 2 s. No database, no Go change.
  • Keep /plan, /forecast, /simulate, /about working. The retail module is linked, not merged into the Cool City hero.
  • Preserve SSR, keyboard access, contrast, reduced motion, responsive behaviour, build and tests.

Brand Commitments

  • Name: Cool City (public product). Built on the PulseCast stack; the retail plan remains PulseCast's staffing module.
  • Visual world pinned by COOL_CITY_DESIGN.md: a live demo, not a dashboard. Apple-like clarity: warm off-white ground, near-black ink, heat orange, shade/water blue, one system typeface, generous space, 28 px translucent surfaces and soft shadows, subtle motion. /cool is a minimal phone/desktop card flow; /cool/stage is a full-bleed dark route board with huge type and quiet presenter controls. The retail module keeps the shift-board identity.
  • Voice: public, direct, protective, not promotional. Never present Ruth as a real person without consent.

Evidence on Hand

  • COOL_CITY.md product brief and Paper/research/cool-city-sources.md source-checked claims.
  • RKI estimate: ~16,000 heat-related deaths in Germany in 2026 through KW37 (95% PI 14,400–17,600). Say estimated, not a count; not Heilbronn.
  • FITNAH-3D commissioned model: citywide PET 16.1–44.5 °C; unshaded sealed street space can exceed 41 °C PET. Do not generalise.
  • City: almost 60 cool places; map + address list, not a routing or time-aware service. 2021 climate-adaptation concept adopted 2023 with 31 measures; 2025 spatial concept; 2023 heat-health action package. Do not say no heat action plan.
  • City tree cadastre Jan 2026 (dl-de/by-2.0); OSM (ODbL); Open-Meteo (CC BY 4.0); population by planning district aggregate.
  • The route/shade and city bundles are pending. Use a clearly labelled TBD placeholder; no fake numbers.

Product Principles

  1. Public first. The hero is a person trying to reach a place safely, not a retailer's dashboard.
  2. The hour matters. A route is not cool in the abstract; it is cool at 14:00 or 16:00.
  3. Modelled is not measured. Shade coverage and direct-sun minutes are model outputs; say so.
  4. The room is part of the product. The vote is aggregate, anonymous and shown next to the model.
  5. The city only sees what the person reveals. The cooling-gap module is a relative planning aid, not a temperature map.
  6. Keep the retail proof separate. The staffing module is the commercial layer, not the public story.

Accessibility & Inclusion

WCAG 2.2 AA. Keyboard and visible focus for the time control, route cards and vote; 4.5:1 body text and 3:1 large text; no colour-only meaning; reduced-motion alternatives; 44 px touch targets; stage text legible at 10 m; phone-first reading order with no horizontal page scroll.