Requirements, application design (incl. concept-API-contract voor het contactformulier), units en functional design voor U1. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
174 lines
8.0 KiB
Markdown
174 lines
8.0 KiB
Markdown
# Requirements-vragen — redesign B (Modern) + E (Tijdreis) + contactformulier
|
||
|
||
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies de laatste (Anders) en beschrijf je voorkeur.
|
||
|
||
Context uit de analyse: de zusterrepo `AndreaSlopFotografie-cms-api-foundation` bevat feature-briefs voor de aparte repo **SlpModularCms** (de CMS/API) en een afgeronde `contact-page`-feature met een eigen `ContactForm`. Daar sluiten de andere formulier-sessies en de CMS-sessie op aan (vragen 9 t/m 13).
|
||
|
||
---
|
||
|
||
## Vraag 1 — Scope van B en E in deze feature
|
||
B is het uitgangspunt. E (Tijdreis) is een grote bouw met vijf tijdperken (2026, 2013, 2006, 1998, 1989).
|
||
|
||
- A) B volledig + E volledig, in deze feature, als aparte units (B eerst, dan E)
|
||
- B) B volledig + de wissel-infrastructuur (knop, thema-model, laden van E) nu; de E-secties in een vervolgfeature
|
||
- C) Alleen B nu; de knop naar E pas bouwen zodra E aan de beurt is
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 2 — Uiterlijk van de knop naar E
|
||
Naast de licht/donker-schakelaar in de nav.
|
||
|
||
- A) Icoon + tekst (bijv. een klokje/terugspoelpijl met "Tijdreis")
|
||
- B) Alleen een icoon met tooltip en toegankelijk label
|
||
- C) Tekst die van label wisselt ("Tijdreis" in B, "Terug naar nu" in E)
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: B
|
||
|
||
## Vraag 3 — Onthouden van de variant
|
||
Moet de bezoeker na een bezoek aan E de volgende keer weer in E starten?
|
||
|
||
- A) Nee, altijd starten in B (E blijft een verrassing); alleen licht/donker wordt onthouden
|
||
- B) Ja, variant én licht/donker worden onthouden (localStorage)
|
||
- C) Alleen binnen dezelfde sessie onthouden (sessionStorage)
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 4 — Bestaande rood/paars-thema's
|
||
Nu zijn er twee kleurthema's (rood, paars). In het ontwerp heeft B accent #7A1414 en E #AC0000, met licht en donker.
|
||
|
||
- A) Rood/paars vervalt; thema wordt: variant (B/E) × modus (licht/donker)
|
||
- B) Paars blijft als extra accentkeuze voor B
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 5 — Beginstand licht/donker
|
||
- A) Standaard licht, daarna de gekozen modus onthouden
|
||
- B) Volg de systeeminstelling van de bezoeker (prefers-color-scheme); gekozen modus overschrijft dit en wordt onthouden
|
||
- C) Standaard donker (zoals de huidige site)
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: B
|
||
|
||
## Vraag 6 — Pakketten: aantal, filter en categorieën
|
||
De API levert nu 3 pakketten. Het ontwerp toont ook 6 pakketten met filterchips (Websites / Software / Beheer). Vier daarvan hebben nog geen inhoud.
|
||
|
||
- A) Het blok moet met elk aantal pakketten overweg kunnen; de filterchips verschijnen pas vanaf 4 pakketten; categorie komt als veld uit de API
|
||
- B) Zoals A, maar de categorie wordt in de frontend afgeleid uit de slug (geen API-wijziging)
|
||
- C) Altijd 3 kaarten zonder filter; het 6-pakkettenontwerp is alleen een toekomstvoorbeeld
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 7 — Pakketten op mobiel
|
||
Je suggestie: naast elkaar en swipeable in plaats van onder elkaar.
|
||
|
||
- A) Horizontale swipe-rij (scroll-snap) op mobiel bij elk aantal pakketten: ~85% kaartbreedte zodat de volgende kaart zichtbaar is, stipjes, uitgelicht pakket als eerste in beeld; raster op tablet/desktop
|
||
- B) Swipe-rij alleen bij meer dan 3 pakketten; bij 3 pakketten onder elkaar
|
||
- C) Op mobiel onder elkaar laten staan
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 8 — Inhoud van de vier extra pakketten
|
||
- A) Niet in scope: ik bouw het blok generiek en test met nepdata; de echte inhoud volgt via de API/CMS
|
||
- B) Wel in scope: ik lever de teksten en prijzen aan voordat de code gegenereerd wordt
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 9 — Velden van het contactformulier
|
||
- A) Naam, e-mail, onderwerp/pakket (keuzelijst, voorgeselecteerd via de "Kies …"-knop op een kaart), bericht
|
||
- B) Zoals A, plus telefoonnummer (optioneel) en bedrijf (optioneel)
|
||
- C) Zoals A, plus indicatie budget en gewenste startdatum (optioneel)
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 10 — Wat gebeurt er met een verzonden formulier?
|
||
- A) De CMS/API (SlpModularCms) krijgt een eindpunt (bijv. `POST /api/v1/contact-messages`) dat het bericht opslaat én een e-mail naar mij stuurt
|
||
- B) Alleen een e-mail naar mij via de API, geen opslag
|
||
- C) Voorlopig de mailto-link behouden tot de API klaar is; formulier-UI en validatie wel bouwen en achter een instelling (feature flag) zetten
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 11 — Hoe delen de sessies het formulier?
|
||
Andere sessies willen ook een formulier (o.a. de Andrea-site met een eigen `ContactForm`); de CMS-sessie bouwt de API.
|
||
|
||
- A) Eén gedeeld contract (request/response, foutcodes, spamregels) in de CMS-repo; elke site bouwt zijn eigen formulier-UI daartegen
|
||
- B) De CMS-repo levert een herbruikbare formuliermodule (frontend-component + endpoint) die alle sites gebruiken
|
||
- C) Elke site volledig eigen formulier en eindpunt (geen deling)
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: B
|
||
|
||
## Vraag 12 — Spambescherming
|
||
- A) Honeypot-veld + tijdcontrole + rate-limit op de server, zonder externe dienst
|
||
- B) Externe captcha (bijv. Cloudflare Turnstile of hCaptcha)
|
||
- C) Combinatie: A, met een captcha als terugvaloptie als er misbruik komt
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: C
|
||
|
||
## Vraag 13 — Privacy bij het formulier
|
||
- A) Korte privacyzin onder het formulier (waarvoor de gegevens gebruikt worden en hoe lang bewaard), zonder aanvinkvakje
|
||
- B) Verplicht aanvinkvakje voor toestemming
|
||
- C) Geen aparte tekst
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 14 — Toegankelijkheid en beweging
|
||
E heeft veel effecten (scanlines, marquee, dithering, glanzende knoppen).
|
||
|
||
- A) WCAG 2.1 AA voor B en E (contrast, toetsenbord, schermlezer) en alle animatie uit bij `prefers-reduced-motion`
|
||
- B) WCAG AA voor B; in E mogen effecten blijven, maar tekst blijft leesbaar en animatie stopt bij `prefers-reduced-motion`
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag 15 — Operations-fase
|
||
Deployment (Gitea Actions + test/productie op de Pi's) bestaat al uit de vorige feature.
|
||
|
||
- A) Ja — Operations-fase draaien (deployment- en monitoringaanpassingen, bijv. voor het formulier-eindpunt in de nginx-proxy)
|
||
- B) Nee — stoppen na Build and Test; bestaande pipeline blijft ongewijzigd
|
||
- C) Nog niet zeker — vraag het opnieuw na de Construction-fase
|
||
- X) Anders (beschrijf na de [Answer]:-tag)
|
||
|
||
[Answer]: C
|
||
|
||
## Vraag: Beveiligingsextensies
|
||
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor dit project? (Het formulier verwerkt persoonsgegevens, dus A ligt voor de hand.)
|
||
|
||
- A) Ja — dwing alle BEVEILIGINGSREGELS af als blokkerende vereisten (aanbevolen voor productietoepassingen)
|
||
- B) Nee — sla alle BEVEILIGINGSREGELS over (geschikt voor PoC's, prototypes en experimentele projecten)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: A
|
||
|
||
## Vraag: Property-Based Testing Extensie
|
||
Moeten de property-based testing (PBT) regels worden afgedwongen voor dit project? (Denkbare kandidaat: formuliervalidatie.)
|
||
|
||
- A) Ja — dwing alle PBT-regels af als blokkerende vereisten (aanbevolen voor projecten met bedrijfslogica, datatransformaties, serialisatie of stateful componenten)
|
||
- B) Gedeeltelijk — dwing PBT-regels alleen af voor pure functies en serialisatie round-trips (geschikt voor projecten met beperkte algoritmische complexiteit)
|
||
- C) Nee — sla alle PBT-regels over (geschikt voor eenvoudige CRUD-applicaties, UI-only projecten of dunne integratielagen zonder significante bedrijfslogica)
|
||
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||
|
||
[Answer]: B
|
||
|
||
## Vraag 16 — Vervolg op vraag 11: vorm van de formuliermodule
|
||
Antwoord gekozen in de chat (interactieve vragenronde, 2026-11-09).
|
||
|
||
- A) Headless + thema-slots
|
||
- B) Vooraf gestyled component
|
||
- C) Web component
|
||
|
||
[Answer]: A
|
||
|
||
---
|
||
Opmerking: alle antwoorden zijn interactief in de chat gegeven op verzoek van de gebruiker en hierboven overgenomen.
|