Files
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

128 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Functional Design Questions — frontend-shell
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies dan de laatste (Anders) en licht toe. Waar ik een voorkeur heb staat **(aanbevolen)**.
## Already decided (no question needed)
- **Drempel to-top**: zichtbaar zodra `scrollY > 0,6 × viewporthoogte` (strikt groter dan, zoals `useScrolledPast` nu werkt voor de header).
- **Jaartal**: `new Date().getFullYear()` op het moment van renderen.
- **Externe links**: altijd `target="_blank"` + `rel="noopener noreferrer"` (NFR-04).
- **Volgorde menu's**: exact zoals FR-02 en FR-05; geen dubbele routes binnen één menu.
---
## Questions
### Vraag 1: Hoe krijgt de 404-pagina haar titel en `noindex`?
Een onbekende URL heeft geen eigen route, dus ook geen eigen `head`. Ik heb React 19 en TanStack Router naast elkaar bekeken.
A) `NotFound` rendert zelf `<title>` en `<meta name="robots" content="noindex">`. React 19 zet die automatisch in `<head>` en haalt ze weg zodra je de pagina verlaat. Bij een not-found matcht alleen de root-route, en die zet geen titel, dus er komt geen dubbele `<title>`. **(aanbevolen)** Simpel en lokaal bij de pagina.
B) De root-route `head` kijkt of de huidige match "not found" is en zet dan titel + `noindex`. Alles loopt via `HeadContent`, maar de root krijgt kennis van de 404-pagina.
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 2: Waar gaat de toetsenbordfocus heen na een klik op "Terug naar boven"?
Bovenaan verdwijnt de knop, dus als de focus erop blijft, staat hij op een onzichtbaar element.
A) Naar `main#main` (hetzelfde doel als de skip link). Een toetsenbordgebruiker kan daarna direct verder vanaf de inhoud. **(aanbevolen)**
B) Naar het begin van de pagina (`body`), zodat de volgende Tab weer bij de skip link begint
C) Focus niet verplaatsen
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 3: Animatie van de to-top-knop bij verschijnen en verdwijnen
A) Zoals het design: infaden en 8px omhoog schuiven, met de bestaande tokens voor duur en easing. Bij `prefers-reduced-motion` alleen direct tonen/verbergen, zonder beweging. **(aanbevolen)**
B) Alleen infaden, geen beweging
C) Geen animatie
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 4: Hoverkleur van de to-top-knop
Het design kleurt rand en pijl bij hover naar `accent` (#7f8b76). Dat haalt op de lichte achtergrond net 3:1, de grens voor iconen. Voor tekstlinks gebruiken we al `accent.deep` (NFR-01).
A) `accent.deep`, gelijk aan de linkhover in de footer. Ruim voldoende contrast en één consistente hoverkleur. **(aanbevolen)**
B) `accent`, precies zoals het design
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A, al vind ik de knop en z'n kleuren nu sowieso niet heel erg duidelijk en vraga me af of die niet wegvalt. Daarbij komt dat op een 32:9 scherm de knop nog steeds helemaal rechtsonderin getoond wordt terwijl de content een max width heeft.
### Vraag 5: Welke social-links worden getoond?
Nu filtert `HeroSocials` alleen lege `href`s weg. Straks komen de links uit het CMS, dus ze zijn invoer van buiten de code.
A) Alleen links met een geldige `https://`-URL tonen. Leeg, `http://`, `javascript:` of iets anders onleesbaars wordt overgeslagen. **(aanbevolen)** Dit voorkomt dat een fout in het CMS een onveilige link oplevert.
B) Alleen lege links overslaan, zoals nu
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 6: Wat als een footerkolom niets te tonen heeft?
Bijvoorbeeld geen enkele geldige social-link, of een leeg e-mailadres.
A) De kolom (kop + inhoud) helemaal weglaten. Het grid schuift gewoon door. **(aanbevolen)**
B) De kop wel tonen met een lege kolom, zodat de layout altijd drie kolommen heeft
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A, verder wil ik kijken hoe we het e-mailadres zo veilig mogelijk kunnen plaatsen om te beschermen tegen spam. Dat is nu namelijk ook al een probleem.
### Vraag 7: Actieve pagina in het footermenu
In het hoofdmenu krijgt de actieve pagina een streep (`aria-current="page"`).
A) Ook in de footer `aria-current="page"` zetten (gratis via de router) en de actieve link in `accent.deep` tonen
B) Wel `aria-current="page"` voor schermlezers, maar geen visueel verschil **(aanbevolen)** Het design toont geen actieve status in de footer.
C) Geen actieve status in de footer
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
### Vraag 8: Tekst op de placeholderpagina's (Portfolio, Soorten fotoshoots, Contact, Privacyverklaring, Over mij)
A) Eyebrow en `h1` uit de `page-head` van het design (Portfolio: "Werk" / "Portfolio", Soorten fotoshoots: "Mogelijkheden" / "Soorten fotoshoots", Contact: "Neem contact op" / "Contact", Over mij: "Andrea Slop Fotografie" / "Over mij"; Privacyverklaring heeft geen design en wordt "Privacy" / "Privacyverklaring"), plus de regel "Deze pagina is nog in de maak. Kom snel terug!" **(aanbevolen)**
B) Alleen de paginanaam als `h1`, zonder eyebrow, met de regel "Deze pagina is nog in de maak."
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 9: Tekst op de 404-pagina
A) Kop "Pagina niet gevonden", tekst "Deze pagina bestaat niet (meer). Misschien is de link verouderd of zit er een typfout in het adres.", knop "Terug naar home". **(aanbevolen)**
B) Kop "Oeps, hier is niets te zien", tekst "Deze pagina kon ik niet vinden.", knop "Terug naar home"
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 10: Welke acties biedt de foutpagina?
A) Alleen "Terug naar home"
B) "Opnieuw proberen" (laadt de pagina opnieuw via de router) én "Terug naar home" **(aanbevolen)** Een tijdelijke fout is dan met één klik op te lossen.
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
### Vraag 11: Loggen van fouten in de browserconsole
Er is (nog) geen centrale logging. Bezoekers zien nooit details, maar de console is voor iedereen te openen.
A) Altijd `console.error(error)`, ook in productie. Handig bij het debuggen van meldingen, en een frontend-fout bevat geen geheimen. **(aanbevolen)**
B) Alleen in development (`import.meta.env.DEV`)
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
### Vraag 12: Hoe staat het e-mailadres in de Contact-kolom?
A) Het adres zelf als linktekst (`info@…` → `mailto:`), zoals het design **(aanbevolen)**
B) Een vaste tekst, bv. "Stuur me een mail", met het adres alleen in de link
X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: x, bij vraag 6 heb ik ook al een opmerking geplaatst. Wat is de veiligste manier om het e-mailadres te tonen? Geef mij aanbevelingen