diff --git a/fotos/homepage.png b/fotos/homepage.png new file mode 100644 index 0000000..dfc2a31 Binary files /dev/null and b/fotos/homepage.png differ diff --git a/fotos/homepage_mobile.png b/fotos/homepage_mobile.png new file mode 100644 index 0000000..6d7732a Binary files /dev/null and b/fotos/homepage_mobile.png differ diff --git a/fotos/playground.png b/fotos/playground.png new file mode 100644 index 0000000..e4e4a32 Binary files /dev/null and b/fotos/playground.png differ diff --git a/fotos/sensors.png b/fotos/sensors.png new file mode 100644 index 0000000..500b89f Binary files /dev/null and b/fotos/sensors.png differ diff --git a/fotos/use-cases.png b/fotos/use-cases.png new file mode 100644 index 0000000..b9bcf65 Binary files /dev/null and b/fotos/use-cases.png differ diff --git a/knowledge/index.md b/knowledge/index.md index 8824242..d9ff4ad 100644 --- a/knowledge/index.md +++ b/knowledge/index.md @@ -20,6 +20,11 @@ Six partner organizations brought one challenge each to the Future City Hackatho * [Preselection / pre-pitch](events/preselection-prepitch.md) - Sunday schedule and selection criteria: pitch, demonstrate, submit the final presentation and code by 13:00, then preselection for the final jury pitch. * [Final pitches](events/final-pitch.md) - Sunday, 15 November at 14:00: 8-minute pitch, 8 minutes of questions, scored on idea and implementation (50%), pitch and storytelling (30%), and vision (20%). +# Product strategy + +* [PulseCast as a foundation](product/foundation-pitch.md) - Build the data-analysis and ML foundation, then plug it into existing systems; includes the pre-jury feedback and integration-first candidates for retail media, waste routing, city operations, workforce and more. +* [Frontend brand](product/frontend-brand.md) - Strict frontend palette `#081723`, `#00C3CD`, `#FFFFFF` and Google font Barlow; overrides Onyx teal, Source Sans 3 and all earlier Stitch palettes. + # Datasets * [HNVG LoRaWAN reception data](data/hnvg-lorawan-reception.md) - Real uplink receptions from roughly 600 water meters and 8 gateways, plus transmitter, gateway, address, and candidate-site tables. diff --git a/knowledge/log.md b/knowledge/log.md index 17ca1dd..deaf4c7 100644 --- a/knowledge/log.md +++ b/knowledge/log.md @@ -1,5 +1,16 @@ # Knowledge Bundle Update Log +## 2026-11-14 + +* **Creation**: Added the foundation / integration-first product strategy, the user-reported pre-jury feedback that the standalone shift plan and summer-heat use case were “okay but not great,” and the candidate connectors for retail media, bakery production, PreZero waste routing, city operations, loyalty, workforce, real estate and logistics. +* **Update**: Recorded the 14 Nov constraints: STACKIT deployment is the pre-jury’s biggest plus; the third asset must be private-sector Schwarz, not community; the wow must be a zero-friction public screen for a person with no phone/app/account; PreZero is allowed only as plug-and-play proof; “barely legal” is interpreted as audacious but privacy-preserving, not unlawful. +* **Update**: Added the Schwarz Retail Media Pulse Screen as the private-sector anchor and reframed the recommendation around engine + STACKIT, Pulse Screen, PreZero proof and Cool City reference. +* **Update**: Recorded the three-use-case scope — staffing, cool route and PreZero — plus the challenge insight on privacy-preserving data, real-world context, intuitive visual story and predictive foresight. +* **Update**: Recorded the current product gap: the pieces exist but the frontend does not fuse them into one official product; the next pass uses the Onyx light theme, mobile-first, an engine-first hero, SSE-controlled use cases and a frontend playground. +* **Update**: Recorded the Apple-methodology correction after the first Stitch preview: the preview was still a dashboard; the next design must use one idea per screen, one primary action, large type, generous whitespace and progressive disclosure; if in doubt, remove it. +* **Creation**: Added the strict frontend brand: colors `#081723`, `#00C3CD`, `#FFFFFF`, and Google font Barlow 400/500/600/700; this overrides Onyx teal, Source Sans 3 and all earlier Stitch palettes. +* **Update**: Indexed the product strategy as a new knowledge bundle section. + ## 2026-11-13 * **Update**: Added the official Schwarz Digits challenge website content, including the data and SKE access links, the three use cases, the Vue.js/Go and Onyx details, and the STACKIT DNS guide. diff --git a/knowledge/product/foundation-pitch.md b/knowledge/product/foundation-pitch.md new file mode 100644 index 0000000..08187a9 --- /dev/null +++ b/knowledge/product/foundation-pitch.md @@ -0,0 +1,151 @@ +--- +type: Product Strategy +title: "PulseCast as a foundation: integration-first use cases" +description: Platform thesis, pre-jury feedback, and integration-first use-case candidates for the Schwarz Digits Pulse of the City challenge. +tags: [hackathon, future-city-hackathon-2026, schwarz-digits, pulsecast, product-strategy, integration, platform, retail-media, waste, city] +status: draft +generated: { by: opencode/deepseek-v4.1-flash, at: 2026-11-14T14:30:00Z } +sources: + - id: user-brief + title: "User brief, 14 Nov 2026" + author: team:pulsecast + - id: current-product + resource: ../../../COOL_CITY.md + title: "Cool City product brief" +--- + +# At a glance + +| Field | Value | +|---|---| +| Thesis | Build the foundation — data analysis pipeline + ML forecast + API — and spin up many decision layers on top. | +| Integration rule | Combine things that already exist. Do not build another silo; plug into existing systems. | +| Current state | The pipeline, forecast, Go API, Nuxt/Onyx frontend, SSE, SKE deployment, k6 evidence and the Cool City reference integration are live. New applications are cheap to deploy. | +| Pre-jury signal | The use cases were received as “okay”; the biggest plus was that the solution is deployed on STACKIT. This is user-reported, not a transcript. | +| Next move | Sell the engine + STACKIT deployment as the product; add a private-sector Schwarz anchor with a zero-friction public interface, and use PreZero only as the plug-and-play proof. | + +# The pitch + +**We built the foundation; you spin up the decisions.** + +The foundation is a data-analysis pipeline and a weather-aware machine-learning forecast over Heilbronn’s eight inner-city PAX counters. It is already deployed on SKE with a Go API, a Nuxt/Onyx frontend, live SSE, cached fallback and load-test evidence. The forecast is a relative device index, not a count of people; every integration must carry that caveat. + +The product is not one dashboard. It is the **demand signal layer** that existing systems can consume: + +- a retail media planner schedules a campaign; +- a store production system plans bakery batches; +- a waste route planner adds a stop; +- a city dashboard opens a cooling station or reroutes an event; +- a workforce system fills a shift; +- a loyalty app sends a quiet-hour offer. + +The same API, the same forecast, different decisions. The value is the foundation and the connectors, not another app. + +# New constraints from the user — 14 November 2026 + +1. **STACKIT deployment is the strongest signal.** The pre-jury liked that the solution is already deployed on STACKIT. Keep the production deployment and the engine as the headline. +2. **The wow must be zero-friction.** A person with nothing on them should be able to experience it plug-and-play. Workable interpretation: no phone, no app, no account, no login, no setup. The interface is a public screen or kiosk that is already there. If “nothing on them” means no device at all, the public screen is the only answer; a browser-only experience is the fallback. +3. **The third asset is private sector, for Schwarz — not another community app.** The community reference can stay, but the third asset must be a Schwarz business use case. +4. **PreZero is allowed only as proof of plug-and-play.** The engine is the main selling point. The PreZero dataset is a test that the same engine can feed an existing waste-routing system, not the hero use case. +5. **“Barely legal” is treated as audacious, not unlawful.** No cameras, no MAC addresses, no personal data, no deception. Aggregate counts only, anonymous interaction, public screen, DPIA before production. The edge is the public, ambient, zero-friction interface — not surveillance. + +# The three use cases + +The user narrowed the product to three concrete decisions, one per surface: + +1. **Staffing** — “How many employees do I need?” A private-sector workforce decision. The current `/plan` is the reference connector. +2. **Cool route** — “Which path in summer avoids sunlight and crowds, fastest from A to B?” A public/community decision. The current `/cool` is the live reference. +3. **PreZero** — “Which containers or routes need service first?” A private-sector waste decision. This may be **mocked from the real fill-level dataset**; the engine is the product. The data has no coordinates, so the honest output is a service-priority proof, not a fake route. + +The three are not three apps. They are three connectors on one engine. + +# The challenge insight we must make explicit + +> “The true value of this challenge isn't just crunching numbers; it's proving that teams can take raw, privacy-preserving sensor data, fuse it with real-world context, and turn it into an intuitive visual story. Adding a predictive model is the ultimate cherry on top that turns hindsight into foresight.” + +The site and the pitch must show each clause: + +| Clause | Where it appears | +|---|---| +| Raw, privacy-preserving sensor data | The privacy ladder: sniff → hash → aggregate → privacy-first. | +| Fuse with real-world context | Weather, holidays, events, and the live scenario controls. | +| Intuitive visual story | The three short, sharp use-case previews, updated together over SSE. | +| Predictive model as the cherry on top | The 7-day forecast and the “play with the engine” simulator. | + +# Current gap + +The pieces exist, but they do not feel fused. The frontend still reads as a set of separate demos rather than one official product. The next design pass must: + +- use the **Onyx (Schwarz IT) light theme**, not the current beige/black editorial look; +- be mobile-first; +- lead with “we provide the engine, you provide the system it works on”; +- show the three use cases as one live system, controlled by SSE; +- end with a frontend playground where a visitor can change place, weather, event and time and see a simulated decision; +- keep the PreZero proof clearly labeled as mocked from the real fill-level dataset; +- keep the privacy and deployment evidence visible but compact. + +The first Stitch preview confirmed the gap: it was still a dashboard. It packed proof chips, a pipeline breadcrumb, floating chart annotations, a live telemetry bar, three metric tables, three mini-dashboards, a privacy trade-off panel and a compliance chip row into one page. The correction is **Apple’s methodology 1:1**: clarity, deference, depth; one idea per screen; one primary action; large type; generous whitespace; progressive disclosure. If a detail does not help the current idea, remove it. The site should feel almost empty compared with the preview. + +# Why the previous use cases were “okay, not great” + +The private shift plan and the community heat app are both plausible, but each was pitched as a standalone product. Hypotheses, to validate with the challenge provider: + +1. **They looked like new apps, not integrations.** The judge has to imagine adopting another dashboard. +2. **The buyer was unclear.** A store manager, a city department and a public app user are different customers with different budgets. +3. **The benefit was plausible but not urgent.** “Better shifts” and “cooler routes” are good, but not a must-have next quarter. +4. **The platform story was hidden.** The same forecast can feed many systems; the pitch led with one use case. +5. **The data caveat dominated.** The index is not people, so absolute claims are hard; the product needs a decision that works with a relative signal. + +The fix is not a new model. It is a clearer buyer, an existing system to plug into, and a demo that shows one foundation feeding several decisions. + +# Integration-first candidates + +| # | Integration | Existing system it plugs into | What the foundation adds | Buyer | Demo feasibility | +|---:|---|---|---|---|---| +| 1 | **Schwarz Retail Media Pulse Screen** | Existing DOOH screen, store-window display or kiosk | Live city pulse + best time/route; the screen adapts its message to the predicted audience; the person touches the screen, no phone needed | Schwarz retail media / Kaufland or Lidl store operations | High — a tablet/laptop in kiosk mode can demo the experience | +| 2 | **Retail media / DOOH scheduling** | Retail media or digital-signage planner | Predicted audience by place and hour; best time/screen to run a campaign | Schwarz Digits / retail media | High — one planner screen, forecast-driven slots | +| 3 | **Fresh food / bakery production** | Store production or replenishment system | Predicted footfall by hour; recommended bake batches; waste vs availability | Kaufland / Lidl store operations | Medium — needs transparent production assumptions | +| 4 | **PreZero dynamic waste routing** | Existing route planner and fill-level data | Predicted crowd hotspots and event peaks; add or move a collection | PreZero | Medium–high — combine footfall with the available fill-level dataset | +| 5 | **City operations / heat & events** | City dashboard, heat map, event control room | Predicted crowd/heat pressure; where to open a cooling station or add staff | City of Heilbronn | High — Cool City already exists as the reference | +| 6 | **Loyalty / quiet-hour offers** | Lidl Plus / Kaufland Card or a city app | Predicted quiet windows; send an opt-in offer when the store is calm | Retail CRM / loyalty team | Medium — privacy and spam risk; mock only | +| 7 | **Workforce management connector** | Existing WFM system | Predicted demand signal; the WFM system fills shifts | Retail operations | High — current `/plan` is the reference connector | +| 8 | **Store location / real estate** | GIS or site-selection tool | Predicted footfall for vacant sites and trade areas | Schwarz Real Estate / city | Medium — map and score, less live | +| 9 | **Delivery / logistics** | Last-mile routing or cargo-bike dispatch | Predicted pedestrian density; choose a quieter delivery window/route | Logistics operator | Medium — mock route, less direct | + +# Recommended shape + +**The engine + STACKIT is the product. The connectors prove it. The public screen is the wow.** + +1. **The engine on STACKIT** — the foundation and the main selling point. Data pipeline, ML forecast, Go API, Nuxt/Onyx, SSE, cached fallback, k6 evidence, deployed. The buyer is not adopting an app; the buyer is adopting a demand-signal layer they can deploy on their own STACKIT infrastructure. +2. **Schwarz Retail Media Pulse Screen** — the private-sector anchor and the zero-friction wow. An existing DOOH screen, store-window display or kiosk shows the live city pulse and a best-time/route recommendation. A passer-by with no phone, no app and no account touches the screen and gets an answer. The screen is an existing retail-media asset; the engine makes it context-aware. This is the “barely legal” edge without surveillance: aggregate counts only, anonymous interaction, public screen. +3. **PreZero dynamic waste** — the plug-and-play proof, not the hero. The same engine plus the PreZero fill-level dataset feeds an existing route planner and adds or moves a collection after a high-footfall event. It proves the engine can plug into another Schwarz Group system. +4. **Cool City** — the public-good reference. Already live. It shows the same engine serving the city and the public without becoming the whole product. +5. **Workforce / bakery** — optional commercial connectors if time allows. Do not lead with the shift plan again. + +The demo should show the **same forecast API response** driving the Pulse Screen and the PreZero proof, with Cool City as the live public reference. That is the platform proof: one engine, several existing systems, no new silo. + +# Answered and remaining questions + +Answered by the user on 14 Nov 2026: + +- The pre-jury’s biggest plus was the STACKIT deployment; the use cases were “okay.” +- The third asset must be private sector, for Schwarz, not another community app. +- The wow must be zero-friction: a person with nothing on them can experience it plug-and-play. +- PreZero is allowed only as a plug-and-play proof; the engine is the main selling point. + +Still open: + +- Which Schwarz business unit owns the Pulse Screen: retail media, Kaufland/Lidl store operations, or Schwarz Digits? This changes the pitch language and the buyer. +- Which physical screen or kiosk can we use at the venue? A tablet or laptop in kiosk mode is enough; a real DOOH screen would be stronger but is not required. +- Does “nothing on them” mean no phone, or no device at all? The current interpretation is no phone/app/account, with the public screen provided. If it means no device at all, the public screen is the only answer. +- What is the smallest credible PreZero proof? A single high-footfall zone + one fill-level hotspot + one recommended route change is enough; a full router is not. +- Do we keep Cool City as the live public reference, or hide it from the 5-minute preselection and use it only in Q&A? + +# Links + +- [Cool City product brief](../../../COOL_CITY.md) +- [Cool City coordination status](../../../COOL_CITY_STATUS.md) +- [Pulse of the City challenge](../challenges/schwarz-digits-pulse-of-the-city.md) +- [PreZero waste routing challenge](../challenges/prezero-waste-routing.md) +- [PreZero glass fill levels](../data/prezero-glass-fill-levels.md) +- [Project foundation](../../../FOUNDATION.md) diff --git a/knowledge/product/frontend-brand.md b/knowledge/product/frontend-brand.md new file mode 100644 index 0000000..6eb36ae --- /dev/null +++ b/knowledge/product/frontend-brand.md @@ -0,0 +1,79 @@ +--- +type: Product Brand +title: "PulseCast frontend brand — strict colors and typeface" +description: Strict frontend palette (#081723, #00C3CD, #FFFFFF) and Google font (Barlow) for the PulseCast prototype. +tags: [hackathon, future-city-hackathon-2026, pulsecast, frontend, brand, design-system, onyx] +status: stable +generated: { by: opencode/deepseek-v4.1-flash, at: 2026-11-14T15:30:00Z } +sources: + - id: user-brief + title: "User brand instruction, 14 Nov 2026" + author: team:pulsecast + - id: brand-doc + resource: ../../../FRONTEND_BRAND.md + title: "PulseCast frontend brand — strict must" +--- + +# At a glance + +| Field | Value | +|---|---| +| Ink | `#081723` | +| Signal / accent | `#00C3CD` | +| Surface | `#FFFFFF` (`rgb(255, 255, 255)`) | +| Typeface | **Barlow** from Google Fonts, weights 400/500/600/700 | +| Rule | Strict must. No other hues and no other typeface. | +| Overrides | Onyx teal, Source Sans 3, Archivo, Montserrat and all earlier Stitch palettes. | + +# Usage + +- Body text: `#081723` on `#FFFFFF`. +- Dark sections and hero: `#081723` background with `#FFFFFF` text. +- Accent, CTA, live dot, active state: `#00C3CD`. +- If `#00C3CD` is the background, the text is `#081723`. Never white on cyan. +- Never use small `#00C3CD` text on white; use ink text or a large graphic accent. +- Hairlines: `rgba(8, 23, 35, 0.12)`. Muted text: `rgba(8, 23, 35, 0.64)`. +- No red, green, orange, purple, teal or gray-blue status colors. Use ink opacity or signal. + +# Font + +Load Barlow from Google Fonts, weights 400, 500, 600 and 700: + +```html + + + +``` + +```css +:root { + --brand-ink: #081723; + --brand-signal: #00c3cd; + --brand-surface: #ffffff; + --brand-font: 'Barlow', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; +} +body { color: var(--brand-ink); background: var(--brand-surface); font-family: var(--brand-font); } +``` + +No Source Sans 3, Inter, Montserrat, Archivo, or any other typeface. + +# Onyx + +Use Onyx components and structure, but override Onyx typography and colors: Barlow instead of Source Sans 3, signal cyan and ink instead of Onyx teal/green/red. Keep Onyx spacing, radius and accessibility behavior unless they conflict with this brand. + +# Stitch prompt block + +```text +STRICT BRAND — do not deviate: +- Use only three colors: #081723 (ink), #00C3CD (signal), #FFFFFF (surface). No other hues. No gradients. +- Font: Barlow from Google Fonts, weights 400/500/600/700. No other typeface. +- Body text #081723 on #FFFFFF. Dark sections #081723 with #FFFFFF text. Accent/CTA/live #00C3CD. +- Never white text on #00C3CD; use #081723 text on cyan. Never small #00C3CD text on white. +- Use whitespace over borders. One accent color. One primary action per section. +``` + +# Links + +- [Full brand document](../../../FRONTEND_BRAND.md) +- [Foundation / integration strategy](foundation-pitch.md) +- [Cool City design guide](../../../COOL_CITY_DESIGN.md)