Files
AndreaSlopFotografie/aidlc-docs/features/frontend-shell/construction/plans/frontend-shell-fd-clarification-questions.md
SluijsensandClaude Opus 5.5 069c7cb7eb Adds AI-DLC construction docs for the front-end shell feature
Functional design, NFR requirements, code generation plan and summary,
and build-and-test instructions with results.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:05:03 +02:00

5.6 KiB

Functional Design Clarification Questions — frontend-shell

Je antwoorden op vraag 4, 6 en 12 bevatten aanvullende wensen. Die werk ik hieronder uit met aanbevelingen. Vul per vraag de letter in na [Answer]:.


Ambiguity 1: Zichtbaarheid en positie van de to-top-knop (vraag 4)

Je koos accent.deep als hoverkleur, maar vindt de knop in het design niet duidelijk genoeg en hij staat op een 32:9-scherm ver van de content af.

Wat het design nu doet: lichte achtergrond (paper), dunne lijn (line) als rand en een donkere pijl. Over een lichte pagina valt die knop bijna weg. De rand zelf haalt geen 3:1 contrast, dus alleen de pijl is echt zichtbaar.

Clarification Question 1: Uiterlijk van de knop

A) Omgekeerd: donkere achtergrond (ink) met witte pijl, zonder rand. Hover: achtergrond accent.deep. Valt goed op op lichte en op donkere vlakken, en is dezelfde stijl als de skip link. (aanbevolen) B) Licht zoals het design, maar met een duidelijke rand in ink.soft en een lichte schaduw. Hover: rand en pijl accent.deep. Dichter bij het design, minder opvallend. C) Precies zoals het design, alleen de hoverkleur accent.deep X) Anders (beschrijf hieronder na de Answer:-tag)

Clarification Question 2: Positie op hele brede schermen

A) De knop lijnt uit met de rechterkant van de content (de maximale breedte van Container). Op normale schermen verandert er niets, want daar is de content even breed als het scherm. Op een ultrawide staat hij naast de content in plaats van in de hoek van het scherm. (aanbevolen) B) Altijd rechtsonder in de hoek van het scherm, zoals het design X) Anders (beschrijf hieronder na de Answer:-tag)


Ambiguity 2: E-mailadres beschermen tegen spam (vraag 6 en 12)

Eerst de eerlijke basis: een adres dat een bezoeker kan lezen, kan een bot uiteindelijk ook lezen. Je kunt het oogsten alleen duur en lastig maken. De meeste spambots zijn eenvoudig: ze lezen de HTML en zoeken naar iets@iets.nl of mailto:. Daar valt het meeste te winnen.

Hoe het nu zit:

  • De huidige statische site: het adres staat drie keer letterlijk in de HTML. Dat is precies wat bots oogsten, en verklaart waarschijnlijk de spam die je nu krijgt.
  • De nieuwe React-site: de pagina wordt in de browser opgebouwd, dus in de HTML staat het adres al niet meer. Wel staat info@andreaslop.nl letterlijk in het JavaScript-bestand. Sommige bots doorzoeken dat ook.

De gangbare technieken op een rij:

Techniek Bescherming Nadeel
1. Adres in delen opslaan (info + andreaslop.nl), pas in de browser samenvoegen Goed tegen bots die HTML of JS-bestanden doorzoeken Bots die de pagina echt uitvoeren (headless browser) zien het nog wel; dat zijn er weinig
2. Pas tonen na een klik ("Toon e-mailadres") Nog beter: zelfs een uitgevoerde pagina bevat het adres pas na een klik Eén extra klik voor de bezoeker
3. Contactformulier in plaats van een adres Het sterkst: het adres staat nergens op de site Heeft een backend nodig (de .NET API, later); hoort bij de Contact-pagina, buiten deze feature
4. Apart adres voor de site (bv. contact@) met een goed spamfilter Beperkt de schade als het toch uitlekt Is een mailbox-instelling, geen code
Afgeraden: adres als afbeelding, of met CSS-trucs achterstevoren Werkt Onbruikbaar voor schermlezers, niet te kopiëren of aan te klikken; botst met NFR-01

Mijn aanbeveling: 1 nu in de shell, en 3 en 4 voor later. Optie 2 is de moeite waard als je meer zekerheid wilt en de extra klik acceptabel vindt.

A) Techniek 1: het adres wordt in delen opgeslagen (ook straks in de CMS-data) en pas in de browser samengevoegd. Daarna staat het als gewone, aanklikbare mailto:-link met het adres als tekst, zoals in het design. Toegankelijk en zonder extra klik. (aanbevolen) B) Techniek 1 + 2: de footer toont eerst een knop "Toon e-mailadres". Pas na de klik wordt het adres samengevoegd en verschijnt de mailto:-link. C) Geen e-mailadres in de footer, alleen een link "Neem contact op" naar de Contact-pagina. Daar komt later het contactformulier (techniek 3). X) Anders (beschrijf hieronder na de Answer:-tag)

Answer: A, verder ter info: techniek 4 is al toegepast met dit specifieke e-mailadres.

Clarification Question 4: Vastleggen van de vervolgstappen buiten deze feature

Techniek 3 (contactformulier) en 4 (apart adres + spamfilter) vallen buiten de shell.

A) Opnemen als aanbeveling in de functional design, zodat ze bij de Contact-pagina en de .NET API weer opduiken (aanbevolen) B) Niet vastleggen X) Anders (beschrijf hieronder na de Answer:-tag)

Answer: A, maar techniek 4 is al (deels) toegepast. info@andreaslop.nl is al een mailadres specifiek voor de website.