Hero-module: vergelijking SLS-hero vs ASF-hero; vragenbestand herzien op Bryans besluiten

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-16 13:05:53 +01:00
co-authored by Claude Sonnet 5.5
parent e80e5108c0
commit 75b883c576
3 changed files with 149 additions and 63 deletions
@@ -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 `<link rel="preload">` 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