ci / check (push) Successful in 55s
- 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
70 lines
5.6 KiB
Markdown
70 lines
5.6 KiB
Markdown
# Product
|
||
|
||
<!-- impeccable:product-schema 1 -->
|
||
|
||
## 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.
|