diff --git a/aidlc-docs/features/hero-module/audit.md b/aidlc-docs/features/hero-module/audit.md index 3848989..25fe5d1 100644 --- a/aidlc-docs/features/hero-module/audit.md +++ b/aidlc-docs/features/hero-module/audit.md @@ -23,3 +23,15 @@ **Context**: Scope decision, recorded in aidlc-state.md. --- + +## Bryan's decisions and the comparison + +**Timestamp**: 2026-11-16T00:00:00Z + +**User Input**: "Bryan heeft besloten voor de Hero-feature (leg dit vast in de requirements): 1. Aanpak gelijk aan pakketten en formulieren: het CMS levert alleen INHOUD, elke site houdt zijn eigen layout/presentatie ... 2. De inhoud van de Hero komt volledig uit het CMS: teksten (titel, tagline/subtitel), knoppen (label, link) en afbeeldingen (0..n slides met afbeelding, alt-tekst, eventueel tekst per slide). Optioneel een veld "weergave" ... 3. EERSTE STAP in Requirements, vóór de vragen aan Bryan definitief worden: maak een vergelijking SLS-hero vs ASF-hero ... pas daarna het vragenbestand aan op wat overblijft. Bryan beantwoordt dan beide in één keer. 4. De ASF-sessie levert haar helft van de vergelijking ..." (relayed by SLP Software - SLS - Main; ASF half delivered by Andrea Slop Fotografie - ASF - Main) + +**AI Response**: Wrote `inception/requirements/hero-comparison.md` (table SLS vs ASF, decisions of Bryan, facts for the design) and rewrote the questions file: decided points listed at the top, 19 questions remain. + +**Context**: Requirements Analysis, waiting for Bryan's answers. + +--- diff --git a/aidlc-docs/features/hero-module/inception/requirements/hero-comparison.md b/aidlc-docs/features/hero-module/inception/requirements/hero-comparison.md new file mode 100644 index 0000000..fd18b3f --- /dev/null +++ b/aidlc-docs/features/hero-module/inception/requirements/hero-comparison.md @@ -0,0 +1,44 @@ +# Hero comparison: SLP Software (SLS) vs Andrea Slop Fotografie (ASF) + +Input for the requirements of `hero-module`. Sources: SLS = `src/features/landing/components/Hero.tsx`, `src/features/landing/data/content.ts` (`heroContent`), `src/prerender/StaticLanding.tsx`, `src/variants/e/Era2026.tsx` (read from the code by the CMS session, 2026-11-16); ASF = `web/src/components/Hero/*`, `web/src/content/heroContent.ts`, `types.ts` (delivered by the ASF session, 2026-11-16). Nothing here is a design decision yet; the decisions of Bryan are at the end. + +## Comparison + +| Aspect | SLS (Tailwind) | ASF (Chakra) | Same / different | Consequence for the CMS content | +|---|---|---|---|---| +| Small label above the title | `eyebrow` ("Web & .NET development"), shown in the code strip below | `tagline` ("Lifestyle fotograaf · Huizen"), a small uppercase label above the title, in the same `h1` | Same idea (short label), different place | One short text field ("tagline"); the site decides where it goes | +| Title | `heading` ("SLP software: websites, apps & meer", screen-reader only) and `displayHeading` (3 lines: "Websites," / "apps" / "& meer."); the era variant joins the lines with a space | `title` ("Andrea Slop"), one string, in the `h1` with the tagline | Different: SLS has a visual line split | One title text; line breaks as a separate optional representation (decision needed) | +| Lead / subtitle | `lead` (long paragraph, about 250 characters) | none | SLS only | Optional "subtitle/lead" text field | +| Code line | `codeLine` ("var website = slp.Bouw(uwIdee);") with blinking caret | none | SLS only, a style element | Not CMS content unless Bryan wants it editable (decision needed) | +| Buttons | Two: "Bekijk pakketten" (anchor `#pakketten`), "Plan een gesprek" (anchor `#contact`). Labels hardcoded in `Hero.tsx`; the era variant takes them from `nl.json` (`era.e2026.ctaPackages/ctaContact`) | One: `cta` `{label "Lees meer", to "/over-mij"}`, an internal route | Same idea (label + target), different count and target kind (page anchor vs site route) | 0..2 buttons, each label + target; the target is free text that the site interprets (anchor, route or address) | +| Images | None | `slides[]`, 8 images of 220 to 440 KB, JPG, one file per slide, no srcset or variants, object-fit cover, 100svh | Different | 0..n slides: the SLS hero has zero | +| Per slide | n/a | `id` (stable), `src`, `alt` (also read by the screen reader as "Photo n of N: alt"). No per-slide label, link or caption | ASF only | Slide: image, alt text, order; stable id | +| Display | Static, no slider | Slider: 6 s per slide, crossfade, slow zoom, pause on mouse hover / keyboard focus / hidden tab / pause button (WCAG 2.2.2), arrows and swipe, wrap-around; one slide = no arrows and no autoplay | Different | Optional "display" value (single / slideshow) that every site renders as it supports; the site keeps the timing and animation | +| Reduced motion | Not relevant (no motion beyond the caret) | `prefers-reduced-motion`: no autoplay, no progress bar, no pause button, no zoom | ASF only | Stays in the site | +| Noscript | The prerendered landing contains the hero text | Slide 1 stays as a static ``; progress bar hidden; arrows and pause need JS | Both readable without JS | The first HTML must contain the hero (LCP) without JS | +| LCP | The text (heading) | The first slide image | **Different** | Host injection per kind: text for SLS; for ASF the first slide `` with `fetchpriority="high"`, `width`/`height`, `srcset` and a matching `` | +| Loading | Everything in one page, text only | Active slide first; next and previous after `onLoad` plus 2 frames; the rest while advancing | ASF only | The host writes only slide 1 into the HTML; the site loads the rest from the data block | +| Prerender | `StaticLanding` renders the `Hero` into `#root` at build time (no hydration; `createRoot` replaces it) | Prerendered with the first slide and a preload link; slides 2 to 8 are empty wrappers | Same pattern (baked HTML, replaced by the app) | Host injection fills the baked hero and puts the full hero in the data block | +| Variants | Five era variants (Era1989 to Era2026) in `variants/e/`; only `Era2026` shows the hero content, it joins `displayHeading` | One layout | SLS only | Same content for every variant; the site renders it. The CMS has no layout choice | +| Where the text is now | `content.ts` (`heroContent`), button labels in `Hero.tsx` and `nl.json` (era) | `heroContent.ts`; aria texts ("Uitgelicht werk", "n van N", "Foto n van N") in the components | Both in code | Title, tagline, lead, buttons and alt texts move to the CMS; the aria texts go to the site's own language file, not the CMS | +| Socials | none in the hero | `HeroSocials` bottom left, from `siteContent.socials` | ASF only | Outside the hero module (site-wide) | +| CMS data today | Packages and banner via markers in `index.html`; the hero is not part of it | Packages and banners via markers and `#cms-data` (`{siteUrl, offerings, banners}`); the hero is not part of it | Same host contract | The data block gets a `hero` key; the baked hero stays the fallback (fail-open) | +| Image address | n/a | Vite import with hashed name in `/assets/` | n/a | CMS media URLs: the preload URL must equal the `img` src exactly; CSP `img-src` must allow the media host (same origin avoids a change) | + +## What is the same (core of the CMS content) + +Title (text), a short tagline, optional lead text, 0..2 buttons (label + target), and a list of 0..n slides (image, alt text, order). The sites differ in presentation, count and kind of buttons, and in whether slides exist. + +## Decisions of Bryan (relayed by SLP Software - SLS - Main, 2026-11-16) + +1. Same approach as packages and forms: the CMS delivers **content only**; every site keeps its own layout and presentation (ASF Chakra, SLS Tailwind). No layouts or sketch choice in the CMS or in the react package. A sketch choice may come later, with a third site. +2. The hero content comes **entirely from the CMS**: texts (title, tagline/subtitle), buttons (label, link) and images (0..n slides with image, alt text and optionally text per slide). Optionally a "display" field (for example single / slideshow) that every site renders according to its own support. +3. The comparison (this file) comes first; the question file is adjusted to what remains. Bryan answers both in one go. +4. The hero LCP (image or text) must be in the first HTML (prerender / host injection), and content is live (NFR-10). + +## Facts from the sites that the design must respect + +- ASF: the order of the slides decides the LCP; the first CMS slide must be in the first HTML with a preload whose URL is exactly the `img` src. +- ASF proposes the data shape `hero {title, tagline, cta{label,url}, slides[{id, imageUrl, width, height, alt, srcset?}]}` and delivers golden files after Bryan approves the requirements. +- ASF aria texts and the 6-second timing stay in the site; they move to the site's language file. +- SLS has no images; its hero has a lead and two buttons. diff --git a/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md b/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md index 6f61f24..c7cdb38 100644 --- a/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md +++ b/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md @@ -2,67 +2,105 @@ Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies de laatste (Other) en beschrijf het. Opmerking per vraag mag ook achter de letter. -**Wat er nu is:** de Hero van SLP Software is vaste tekst in de website-code (`Hero.tsx` en `content.ts`: kleine kop, grote kop in drie regels, lead, twee knoppen, een "code-regel"). Er is geen afbeelding. De Hero van ASF (`web/src/components/Hero/Hero.tsx`, inhoud in `heroContent.ts`) is een diavoorstelling: titel, tagline, een knop en een lijst slides (afbeelding met alt/label per slide; 6 seconden per slide, pauzeknop, pijlen, reduced-motion). De eerste slide laadt eerst, de rest na de eerste weergave. Bij SLP Software is de LCP de tekst, bij ASF de eerste afbeelding. De host kan al stukken van de pagina's invullen vanuit het CMS (pakketten, banners) via markers in de HTML, en dat is de route die we voor de Hero ook gebruiken. +**Eerst lezen:** [hero-comparison.md](hero-comparison.md) zet de hero van SLP Software en die van Andrea Slop Fotografie naast elkaar (velden, afbeeldingen, knoppen, LCP, slider, varianten, wat nu in code staat). + +**Al besloten (hoef je niet meer te beantwoorden):** + +1. Het CMS levert alleen **inhoud**; elke site houdt zijn eigen layout en presentatie (ASF Chakra, SLS Tailwind). Geen layouts of schetsenkeuze in het CMS of in het react-pakket. +2. De inhoud komt volledig uit het CMS: teksten (titel, tagline/subtitel), knoppen (label, link) en afbeeldingen (0 tot n slides met afbeelding, alt-tekst en eventueel tekst per slide). Optioneel een veld "weergave" dat elke site naar eigen ondersteuning toont. +3. De hero-LCP (bij SLP de tekst, bij ASF de eerste slide) staat in de eerste HTML (host-injectie); de ingebakken hero blijft de terugval als het CMS niets levert; wijzigingen zijn direct zichtbaar (NFR-10). +4. De teksten voor schermlezers en bediening (zoals "Foto 2 van 8", "Diavoorstelling gepauzeerd") en de timing en animatie van de slider blijven in de site (eigen taalbestand), niet in het CMS. Socials blijven buiten de hero-module. +5. De productie-conditie `release/*` voor de SLP-pipeline gaat mee in deze feature. ## Vraag 1 — Hoeveel heroes per site? -- A) Eén hero per site (een vaste plek die je bewerkt); de slides van ASF zitten daarbinnen (zie vraag 4) +- A) Eén hero per site (een vaste plek die je bewerkt) - B) Meerdere heroes per site, waarvan er één tegelijk actief is (bijvoorbeeld seizoensgebonden), met aan/uit -- C) Meerdere heroes die op een rooster wisselen (carrousel van hele heroes) - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 2 — Welke teksten en knoppen moeten beheerbaar zijn? +## Vraag 2 — Hoe wordt de titel opgeslagen? -- A) Kop, subkop/lead en maximaal twee knoppen (label + link) -- B) Zoals A, plus een kleine kop erboven (eyebrow) en de grote kop in meerdere regels (zoals "Websites," / "apps" / "& meer.") -- C) Zoals B, plus de "code-regel" van SLP Software als vrij tekstveld -- D) Alleen kop en subkop; knoppen blijven in de website-code +SLP Software toont de titel in drie regels ("Websites," / "apps" / "& meer.") met een aparte tekst voor schermlezers en zoekmachines; ASF heeft één titel. + +- A) Eén titeltekst; regelafbrekingen schrijf je er zelf in (een nieuwe regel in het veld); de site bepaalt hoe die getoond wordt +- B) Eén titeltekst zonder regelafbrekingen; de site splitst zelf +- C) Een titel plus een aparte optionele lijst "weergaveregels" (zoals nu bij SLP Software) - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 3 — Hoe worden de teksten per site en per taal bewaard? +## Vraag 3 — Welke overige tekstvelden? + +- A) Tagline (kort label), subtitel/lead (lange tekst, optioneel) +- B) Zoals A, plus de "code-regel" van SLP Software als vrij tekstveld +- C) Alleen tagline; de lead en de code-regel blijven vaste tekst in de SLP-website +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 4 — Knoppen + +SLP Software heeft twee knoppen naar plekken op dezelfde pagina (`#pakketten`, `#contact`); ASF heeft één knop naar een andere pagina (`/over-mij`). + +- A) 0 tot 2 knoppen, elk met label en doel; het doel is vrije tekst (een anker, een pad of een adres) die de site zelf interpreteert +- B) 0 tot 2 knoppen, elk met label en doel, waarbij het CMS het doel controleert (alleen `#anker`, `/pad` of `https://…`) +- C) 0 tot 3 knoppen (ruimte voor later), verder zoals B +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 5 — Veld "weergave" + +- A) Een keuzeveld met de waarden `enkel` en `diavoorstelling`; een site die er een niet ondersteunt, toont het zoals het kan +- B) Geen veld; de site beslist op basis van het aantal slides (één slide of meer) +- C) Een vrij tekstveld, door de site te interpreteren +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 6 — Wat heeft een slide? + +ASF heeft nu per slide alleen een stabiel id, de afbeelding en de alt-tekst. Kandidaten die ASF noemt: aan/uit per slide en een eigen duur per slide. + +- A) Afbeelding, verplichte alt-tekst (of expliciet "decoratief"), volgorde, aan/uit per slide +- B) Zoals A, plus een optionele eigen tekst per slide (bijschrift) en een optionele eigen duur +- C) Alleen afbeelding, alt-tekst en volgorde +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 7 — Hoe komen de afbeeldingen in het CMS? + +De host levert de afbeeldingen zelf onder het eigen adres van de site (dus geen wijziging van de CSP `img-src`), met een adres dat de inhoud bevat (hash), zodat ze lang gecachet kunnen worden. Voor een snelle LCP moet het adres in de preload gelijk zijn aan dat van de afbeelding. + +- A) Upload in het CMS; de host bewaart het origineel, leest de afmetingen uit en maakt varianten (verschillende breedtes, WebP/AVIF) voor `srcset` +- B) Upload in het CMS; de host bewaart het origineel en de afmetingen, zonder varianten (ASF levert nu ook één JPG per slide) +- C) Geen upload: het CMS bewaart een adres naar een afbeelding die in de website-build zit +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 8 — Grenzen aan een upload (alleen bij A of B hierboven) + +- A) JPEG, PNG en WebP tot 10 MB; de host controleert het echte bestandstype (niet de naam) en haalt metadata (zoals GPS) uit het bestand +- B) Zoals A, maar tot 5 MB +- C) Niet van toepassing (vraag 7 = C) +- X) Other (please describe after [Answer]: tag below) + +[Answer]: + +## Vraag 9 — Talen - A) Eén taal per site (Nederlands); de site-eigenaar vult het in - B) Nederlands en Engels per hero, beide in het CMS in te voeren -- C) Eén taal nu, maar het datamodel moet later talen kunnen toevoegen zonder migratie van bestaande data +- C) Eén taal nu, maar het datamodel laat later talen toe zonder migratie van bestaande data - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 4 — Afbeeldingen en slides in de hero - -Het datamodel krijgt ruimte voor 0 tot n slides per hero; een slide heeft een afbeelding, alt-tekst en eventueel eigen tekst. SLP Software gebruikt er nul, ASF meerdere. - -- A) Zo: 0 tot n slides per hero, elk met afbeelding, verplichte alt-tekst (of expliciet "decoratief"), optionele eigen tekst en volgorde; de website bepaalt de weergave (slider of niet) -- B) Zoals A, maar de wisselsnelheid, pauzeknop en pijlen zijn ook instelbaar in het CMS -- C) Eén afbeelding per hero (geen slides); de slider van ASF blijft vaste inhoud in de website-code -- X) Other (please describe after [Answer]: tag below) - -[Answer]: - -## Vraag 5 — Hoe komen de afbeeldingen in het CMS? - -- A) Upload in het CMS; de host bewaart het bestand en maakt automatisch varianten (verschillende breedtes, WebP/AVIF) met een adres met inhouds-hash, zodat ze lang gecachet kunnen worden -- B) Upload in het CMS; de host bewaart alleen het origineel (geen varianten); de website schaalt met CSS -- C) Geen upload: het CMS bewaart alleen een adres naar een afbeelding die in de website-build zit (ASF zet de afbeeldingen zelf in zijn build) -- X) Other (please describe after [Answer]: tag below) - -[Answer]: - -## Vraag 6 — Hoe moet de LCP in de eerste HTML komen? - -De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naar de browser gaat: voor tekst als gewone elementen, voor een afbeelding met een `` in de kop, `width`/`height`, `fetchpriority="high"` en een `srcset`. Bij een slider is dat de eerste slide; de andere slides laden na de eerste weergave. Na het laden verfrist de website de hero uit de API (NFR-10); als dat mislukt blijft de ingebakken versie staan. - -- A) Ja, zo (host-injectie voor beide sites; de ingebakken tekst blijft als terugval als het CMS niet bereikbaar is) -- B) Zoals A, maar de hero in de ingebakken HTML hoeft alleen bij de volgende bouw van de website bijgewerkt te worden (geen injectie in de eerste HTML) -- X) Other (please describe after [Answer]: tag below) - -[Answer]: - -## Vraag 7 — Hoe snel moet een wijziging zichtbaar zijn? +## Vraag 10 — Hoe snel moet een wijziging zichtbaar zijn? - A) Zoals banners en pakketten nu: binnen ongeveer een minuut (60 seconden cache, direct vernieuwd bij elke wijziging in het CMS) - B) Direct, zonder cache, bij elke bezoeker @@ -70,7 +108,7 @@ De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naa [Answer]: -## Vraag 8 — Concept en publiceren +## Vraag 11 — Concept en publiceren - A) Opslaan is publiceren (zoals bij pakketten en banners) - B) Er is een concept: eerst opslaan als concept, een voorbeeld bekijken, dan publiceren @@ -78,15 +116,15 @@ De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naa [Answer]: -## Vraag 9 — Planning (van/tot) +## Vraag 12 — Planning (van/tot) - A) Geen planning: een hero is aan of uit -- B) Wel planning (van/tot), zoals bij pakketten en banners; buiten de periode valt de site terug op de standaard-hero +- B) Wel planning (van/tot), zoals bij pakketten en banners; buiten de periode valt de site terug op de ingebakken hero - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 10 — Wie mag de hero wijzigen? +## Vraag 13 — Wie mag de hero wijzigen? - A) Administrator en hoger (zoals pakketten en banners) - B) Alleen de eigenaar (Owner) @@ -94,7 +132,7 @@ De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naa [Answer]: -## Vraag 11 — Waar komt de code? +## Vraag 14 — Waar komt de code? - A) Een eigen module `SlpModularCms.Modules.Hero` (met tests), aan of uit per site, zoals Offerings en Contact - B) Binnen de bestaande Offerings-module (hero naast pakketten en banners) @@ -102,34 +140,26 @@ De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naa [Answer]: -## Vraag 12 — Wat doen we met de statische teksten die jij nog niet hebt bekeken? +## Vraag 15 — Wat doen we met de statische teksten die jij nog niet hebt bekeken? -Er zijn vaste teksten in de websites (hero, secties van de landingspagina) die nog niet door jou zijn gelezen. Jij vroeg ze in deze feature mee te nemen. +Er zijn vaste teksten in de websites (de hero en de secties van de landingspagina) die nog niet door jou zijn gelezen. Jij vroeg ze in deze feature mee te nemen. -- A) Alleen de hero-teksten: jij leest die en geeft de definitieve tekst; die komt als startinhoud (seed) in het CMS +- A) Alleen de hero-teksten: jij leest die en geeft de definitieve tekst; die komt als startinhoud in het CMS - B) Hero én de andere secties van de landingspagina lezen/herschrijven in deze feature, maar alleen de hero gaat naar het CMS; de rest blijft vaste tekst - C) Hero én de andere secties lezen, en later een algemene "blokken"-module voor al die teksten (apart plan; in deze feature alleen de hero) - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 13 — Start-inhoud (seed) +## Vraag 16 — Startinhoud (seed) -- A) Een script zoals `Seed-Offerings.ps1` zet de huidige teksten van SLP Software en ASF als eerste hero in het CMS van de testomgeving; productie vullen we pas bij de release +- A) Een script zoals `Seed-Offerings.ps1` zet de huidige hero van SLP Software en ASF (inclusief de 8 foto's) als eerste hero in het CMS van de testomgeving; productie vullen we pas bij de release - B) De eigenaar vult de hero zelf in via de admin na uitrol - X) Other (please describe after [Answer]: tag below) [Answer]: -## Vraag 14 — Als het CMS leeg of onbereikbaar is - -- A) De ingebakken hero uit de website-build blijft staan (geen lege hero), zoals in NFR-10 -- B) Het CMS is leidend: zonder hero in het CMS wordt de hero-sectie weggelaten -- X) Other (please describe after [Answer]: tag below) - -[Answer]: - -## Vraag 15 — Beveiligingsregels (extensie) +## Vraag 17 — Beveiligingsregels (extensie) Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor deze feature? (Het gaat om een afbeelding-upload, invoer van beheerders en HTML die de host schrijft.) @@ -139,7 +169,7 @@ Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor deze fe [Answer]: -## Vraag 16 — Property-based testing (extensie) +## Vraag 18 — Property-based testing (extensie) - A) Ja — dwing alle PBT-regels af als blokkerende vereisten - B) Gedeeltelijk — alleen voor pure functies en serialisatie round-trips (bijvoorbeeld HTML-codering van hero-teksten) @@ -148,9 +178,9 @@ Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor deze fe [Answer]: -## Vraag 17 — Operations-fase +## Vraag 19 — Operations-fase -Moet deze feature na Construction door de Operations-fase (uitrol en monitoring inrichten)? De gezamenlijke productie-checklist (`docs/release-checklist-productie.md`) bestaat al en wordt in dat geval aangevuld. +Moet deze feature na Construction door de Operations-fase? De gezamenlijke productie-checklist (`docs/release-checklist-productie.md`) bestaat al en wordt in dat geval aangevuld. - A) Ja — Operations-fase draaien - B) Nee — stoppen na Build and Test; de hero-punten komen in de gezamenlijke productie-checklist