- 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
5.6 KiB
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 incool-city-data/city/. Final JSON is copied topublic/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. /coolis mobile-first and must also read clearly on a projector./cool/stageis a dark, full-bleed projection surface./cool/cityranks 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,/aboutworking. 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./coolis a minimal phone/desktop card flow;/cool/stageis 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.mdproduct brief andPaper/research/cool-city-sources.mdsource-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
- Public first. The hero is a person trying to reach a place safely, not a retailer's dashboard.
- The hour matters. A route is not cool in the abstract; it is cool at 14:00 or 16:00.
- Modelled is not measured. Shade coverage and direct-sun minutes are model outputs; say so.
- The room is part of the product. The vote is aggregate, anonymous and shown next to the model.
- The city only sees what the person reveals. The cooling-gap module is a relative planning aid, not a temperature map.
- 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.