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>
This commit is contained in:
@@ -0,0 +1,12 @@
|
||||
# Build and Test Questions — frontend-shell
|
||||
|
||||
## Vraag 1: "SOCIALS" wordt door de schermlezer gespeld
|
||||
|
||||
De koptekst is in de code "Socials"; het thema maakt hem met CSS hoofdletters. Schermlezers op mobiel (VoiceOver, TalkBack) lezen de tekst zoals hij in beeld staat, zien "SOCIALS" en behandelen het als een afkorting. "CONTACT" herkennen ze wel als woord. Ik kan mobiele schermlezers hier niet zelf testen, dus na de aanpassing vraag ik je het opnieuw te proberen.
|
||||
|
||||
A) De kop een `aria-label` geven met het woord in gewone schrijfwijze ("Socials"). In beeld verandert niets. Moderne schermlezers lezen dan het label in plaats van de hoofdletters, maar niet elke combinatie van schermlezer en browser doet dat even goed.
|
||||
B) De kop veranderen in "Social media". In beeld staat dan "SOCIAL MEDIA"; twee gewone woorden worden vrijwel altijd als woorden voorgelezen. **(aanbevolen)** Het meest betrouwbaar, en ook voor bezoekers duidelijker.
|
||||
C) De kop veranderen in "Volg mij", passend bij de Nederlandse toon van de site
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
+34
@@ -0,0 +1,34 @@
|
||||
# Code Generation Change Questions — frontend-shell
|
||||
|
||||
Meting na je nieuwe afbeeldingen: homepage mobiel **0,82** (doel 0,9), totale download **2,6 MB**. Vul per vraag de letter in na `[Answer]:`. Waar ik een voorkeur heb staat **(aanbevolen)**.
|
||||
|
||||
## Vraag 1: Hoe halen we de homepage op mobiel naar 0,9?
|
||||
|
||||
Wat nu nog vertraagt: de eerste foto (2560 px breed, ook op een telefoon), de JavaScript-bundel (169 KB gzip, vooral Chakra) en de titel die pas verschijnt als de JavaScript binnen is.
|
||||
|
||||
A) Nu responsive afbeeldingen toevoegen: bij het bouwen worden van elke hero-foto kleinere varianten gemaakt (bv. 640, 1280 en 2560 px), en de browser kiest de passende (`srcset`). Telefoons downloaden dan een foto van ±50–80 KB in plaats van 325 KB. Kost één extra dev-afhankelijkheid (`vite-imagetools`). Waarschijnlijk genoeg voor 0,9, maar dat meet ik na. **(aanbevolen)**
|
||||
B) Het doel voor de homepage op mobiel voorlopig op 0,8 zetten. Responsive afbeeldingen en prerendering pakken we op bij de portfolio-feature.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: B, omdat de data later uit een API komt weet ik niet of responseive foto's met een vite-plugin toevoegen verstandig is voor een tijdelijke situatie. Prerendering pakken we sowieso later op.
|
||||
|
||||
## Vraag 2: Wanneer moet de controle op kwetsbare pakketten falen?
|
||||
|
||||
De gebouwde site heeft geen kwetsbaarheden (`pnpm audit --prod` is schoon). De 5 meldingen zitten in ontwikkeltools die alleen op jouw computer draaien. Voor de meeste bestaat nog geen oplossing.
|
||||
|
||||
A) De check faalt alleen op kwetsbaarheden in pakketten die in de site terechtkomen. Meldingen in ontwikkeltools worden wel getoond, maar blokkeren niet. **(aanbevolen)**
|
||||
B) Zoals A, en daarnaast Lighthouse CI niet meer als vaste ontwikkeltool installeren, maar bij elke run met een vaste versie ophalen (`pnpm dlx @lhci/cli@0.15.1`). Er staan dan minder pakketten in het project; de meldingen blijven bestaan, maar buiten het project.
|
||||
C) Zoals vastgelegd: de check faalt op elke hoge melding, ook in ontwikkeltools. Dan faalt `pnpm check` tot de makers van die tools een oplossing uitbrengen.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
## Vraag 3: Hoe laden de hero-foto's?
|
||||
|
||||
Nu laadt de homepage na de eerste foto direct alle andere foto's (8 stuks, ±2,4 MB), ook als de bezoeker na 10 seconden doorklikt.
|
||||
|
||||
A) Alleen de huidige en de volgende foto laden. Elke keer dat de slider doorschuift, wordt de foto daarna opgehaald; met de pijlen terug blijft de vorige ook beschikbaar. Het aantal foto's maakt dan voor de snelheid nauwelijks uit. **(aanbevolen)**
|
||||
B) Zoals nu: na de eerste foto alles laden
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A, maar je kan vanaf de eerste foto ook terug-klikken naar de laatste foto, dus de actieve foto + de volgende en vorige (of laatste in geval van eerste foto) wil je laden.
|
||||
+195
@@ -0,0 +1,195 @@
|
||||
# Code Generation Plan — frontend-shell
|
||||
|
||||
**This plan is the single source of truth for Code Generation.** Steps are executed in order; each is checked off as soon as it is done.
|
||||
|
||||
## Unit Context
|
||||
|
||||
- **Unit**: frontend-shell (single unit, brownfield)
|
||||
- **Application code**: `web/` (paths below are relative to `web/` unless stated otherwise)
|
||||
- **Documentation**: `aidlc-docs/features/frontend-shell/construction/frontend-shell/code/` (markdown summaries only)
|
||||
- **Dependencies on other units**: none. No back-end exists, and content is static and shaped like the future CMS API.
|
||||
- **Inputs**:
|
||||
- [requirements.md](../../inception/requirements/requirements.md): FR-01…FR-13, NFR-01…NFR-06
|
||||
- [application design](../../inception/application-design/application-design.md)
|
||||
- functional design:
|
||||
- [business-rules.md](../frontend-shell/functional-design/business-rules.md) (BR-*)
|
||||
- [frontend-components.md](../frontend-shell/functional-design/frontend-components.md)
|
||||
- [domain-entities.md](../frontend-shell/functional-design/domain-entities.md)
|
||||
- NFR:
|
||||
- [nfr-requirements.md](../frontend-shell/nfr-requirements/nfr-requirements.md) (NFR-P/A/S/SEC/R/M/B)
|
||||
- [tech-stack-decisions.md](../frontend-shell/nfr-requirements/tech-stack-decisions.md) (TD-*)
|
||||
- **Conventions** (NFR-02a):
|
||||
- Code comments in Dutch.
|
||||
- Prettier style: 4 spaces, single quotes.
|
||||
- One folder per component.
|
||||
- Chakra tokens/recipes, no hard-coded values (BR-THEME-01).
|
||||
- **Test conventions**:
|
||||
- Tests sit next to the code as `*.test.ts(x)`.
|
||||
- Queries by role/label first (Testing Library).
|
||||
- Stable `data-testid` on interactive shell elements, named `{component}-{element-role}`.
|
||||
- **Traceability**: User Stories were skipped. Each step references FR/NFR/BR/TD IDs instead.
|
||||
|
||||
## Steps
|
||||
|
||||
### Part A — Tooling and configuration
|
||||
|
||||
- [x] **Step 1: Dependencies** (TD dependency table, FR-11, Q2)
|
||||
- Remove `next-themes`.
|
||||
- Move `@vitejs/plugin-react` and `@tanstack/react-router-devtools` to `devDependencies`.
|
||||
- Add dev dependencies with pnpm:
|
||||
- testing: `vitest`, `@vitest/coverage-v8`, `jsdom`, `@testing-library/react`, `@testing-library/user-event`, `@testing-library/jest-dom`, `fast-check`, `vitest-axe`
|
||||
- linting: `eslint`, `@eslint/js`, `typescript-eslint`, `eslint-plugin-react-hooks`, `eslint-plugin-jsx-a11y`, `globals`
|
||||
- Lighthouse: `@lhci/cli`
|
||||
- [x] **Step 2: Scripts** in `package.json` (TD-07): `test`, `test:watch`, `lint`, `format:check`, `audit:deps`, `lighthouse`, `check`.
|
||||
- [x] **Step 3: Security headers** — create `config/securityHeaders.ts`, with `securityHeaders(mode: 'production' | 'development')` (TD-05, NFR-SEC-01…03).
|
||||
- [x] **Step 4: Sitemap plugin** — create `config/sitemapPlugin.ts`. The Vite plugin emits `sitemap.xml` via `sitemapXml(sitePages, siteUrl)` (TD-06, BR-SEO-06).
|
||||
- [x] **Step 5: Vite config** — `vite.config.js` → `vite.config.ts` (TD-06). It holds:
|
||||
- the existing plugins plus the sitemap plugin
|
||||
- `server.headers` and `preview.headers` from `securityHeaders`
|
||||
- the Vitest `test` section: `jsdom`, setup file, coverage with 100% per-file thresholds for the pure functions (NFR-M-02)
|
||||
- `tsconfig.json` includes `config` and `vite.config.ts`
|
||||
- [x] **Step 6: Linting and formatting config**
|
||||
- `eslint.config.js`, flat config (TD-03)
|
||||
- `.prettierignore` gets `routeTree.gen.ts`, `.lighthouseci`, `coverage`
|
||||
- `.gitignore` gets `.lighthouseci`, `coverage`
|
||||
- [x] **Step 7: Lighthouse CI config** — `lighthouserc.cjs` (TD-04):
|
||||
- starts `pnpm preview`
|
||||
- URLs: every `sitePages` path plus `/bestaat-niet` (404)
|
||||
- presets: mobile and desktop
|
||||
- assertions per NFR-P-01, NFR-A-01, NFR-S-01/02
|
||||
- [x] **Step 8: Test setup** — `src/test/setup.ts` with jest-dom and vitest-axe matchers, plus `src/test/renderWithProviders.tsx`, which renders inside the Chakra system and a memory-history router (TD-02).
|
||||
|
||||
### Part B — Theme (BR-THEME-01…07)
|
||||
|
||||
- [x] **Step 9: Tokens and global styles** in `src/theme.ts`
|
||||
- Remove `body.height: 250vh` (FR-11).
|
||||
- New tokens:
|
||||
- semantic colour `focusRing` (`accent.deep`)
|
||||
- size `content`, used by the `Container` recipe override
|
||||
- spacing `pageTop`
|
||||
- z-index tokens `header`, `mobileNav`, `menuToggle`, `backToTop`
|
||||
- Text style `pageTitle`.
|
||||
- Global `:focus-visible` ring (BR-THEME-02), with `[tabindex="-1"]:focus` showing no ring (BR-A11Y-06).
|
||||
- [x] **Step 10: Recipes**
|
||||
- `link` variant `subtle` (BR-FOOT-04)
|
||||
- `skipNavLink` override (FR-07)
|
||||
- new `recipes/iconControl.ts` (AD D9, BR-THEME-02 ring colour on photos)
|
||||
- register them in `theme.ts`
|
||||
- run `pnpm typegen`
|
||||
|
||||
### Part C — Content, configuration and pure logic (with unit + property tests)
|
||||
|
||||
- [x] **Step 11: Content module** (`src/content/`) (AD D2, domain-entities)
|
||||
- `types.ts`: `SiteContent`, `SocialLink`, `EmailAddress`, the Hero types
|
||||
- `siteContent.ts`: new `footerIntro` text, socials, `email: { user, domain }`
|
||||
- move `heroContent.ts` and `socialPlatforms.ts` here; remove `socials` from `HeroContent`
|
||||
- delete the old files in `components/Hero/`
|
||||
- [x] **Step 12: Navigation** — `src/navigation.ts` with `mainNav` and `footerNav` (FR-02, FR-05, BR-NAV-*). Delete `NavigationBar/navItems.ts`.
|
||||
- [x] **Step 13: Pure helpers** (`src/lib/`)
|
||||
- `backToTopThreshold.ts` (BR-TOP-01)
|
||||
- `visibleSocials.ts` (BR-SOC-01/02)
|
||||
- `emailAddress.ts` (BR-EMAIL-01/02)
|
||||
- `copyrightLine.ts` (BR-FOOT-02)
|
||||
- [x] **Step 14: SEO module**
|
||||
- `src/seo.ts` gets:
|
||||
- `siteUrl`, `siteName`, `defaultOgImage`
|
||||
- `canonicalUrl` (BR-SEO-02)
|
||||
- `pageHead(path)` (BR-SEO-01…04)
|
||||
- `siteHead`
|
||||
- `jsonLdScript` (BR-SEO-05)
|
||||
- `professionalService(content)`
|
||||
- `src/sitePages.ts`: the registry (domain-entities)
|
||||
- `src/sitemap.ts`: `sitemapXml` (BR-SEO-06)
|
||||
- [x] **Step 15: Tests for Part C** (PBT-02…08, NFR-M-01/02)
|
||||
- Property tests (fast-check) for every row in "Testable Properties": threshold, socials, e-mail, copyright, canonicalUrl, sitemapXml, jsonLdScript.
|
||||
- Example tests for edge cases and the menu invariants (BR-NAV-01/02).
|
||||
- `securityHeaders` test: the production CSP has no `unsafe-eval`, no `'unsafe-inline'` in `script-src` and no `ws:`.
|
||||
- Domain generators are shared in `src/test/arbitraries.ts`.
|
||||
|
||||
### Part D — Shared primitives and hooks
|
||||
|
||||
- [x] **Step 16: RouterLink** — create `components/RouterLink.tsx` (AD D8). Refactor `LinkButton`, `NavLink` and `MobileNav` onto it.
|
||||
- [x] **Step 17: useRouteFocus** — create `hooks/useRouteFocus.ts` (BR-A11Y-01), plus a test (focus moves on a pathname change, not on first load).
|
||||
|
||||
### Part E — Components (with component tests incl. axe)
|
||||
|
||||
- [x] **Step 18: PageIntro** — `components/PageIntro/PageIntro.tsx` + test (FR-01, BR-THEME-03/06)
|
||||
- [x] **Step 19: StatusPage, NotFound, ErrorPage** in `components/StatusPage/` + tests (FR-09, FR-10, BR-404-*, BR-ERR-*). Tests cover:
|
||||
- no error details are rendered
|
||||
- `console.error` is called once
|
||||
- retry calls `reset` and `invalidate`
|
||||
- title and `noindex` are set
|
||||
- [x] **Step 20: Footer + FooterColumn** — `components/Footer/` + tests (FR-05, BR-FOOT-*, BR-SOC-*, BR-EMAIL-03, BR-A11Y-03, BR-SEO-09). Delete the old `components/Footer.tsx`. Tests cover:
|
||||
- columns are omitted when empty
|
||||
- the mailto link
|
||||
- the new-tab text
|
||||
- `aria-current`
|
||||
- the `h2` headings
|
||||
- the year
|
||||
- [x] **Step 21: BackToTop** — `components/BackToTop/BackToTop.tsx` + tests (FR-06, BR-TOP-*). Tests cover:
|
||||
- hidden/visible around the threshold
|
||||
- not focusable while hidden
|
||||
- smooth vs instant scrolling under reduced motion
|
||||
- focus moves to `main`
|
||||
- [x] **Step 22: NavigationBar**
|
||||
- Logo becomes a link home (FR-03).
|
||||
- Menu from `mainNav`.
|
||||
- `let` → `const`.
|
||||
- z-index tokens (BR-THEME-05) + test (menu order, logo link name).
|
||||
- [x] **Step 23: Hero**
|
||||
- Separate `socials` prop.
|
||||
- `HeroSocials` uses `visibleSocials`, the `iconControl` recipe and the new-tab `aria-label`.
|
||||
- `HeroArrows` uses `iconControl`.
|
||||
- Type rename `HeroSocial` → `SocialLink` + test.
|
||||
- [x] **Step 24: AppShell**
|
||||
- `SkipNavLink` + `SkipNavContent as="main" id="main"`
|
||||
- `Footer content={siteContent}`
|
||||
- `BackToTop`
|
||||
- `useRouteFocus`
|
||||
- Test (landmarks, skip link target).
|
||||
|
||||
### Part F — Routes, app entry and static files
|
||||
|
||||
- [x] **Step 25: Root route** — `routes/__root.tsx`:
|
||||
- head = `siteHead` + JSON-LD
|
||||
- `notFoundComponent: NotFound` and `errorComponent: ErrorPage`
|
||||
- devtools lazy and only in DEV (NFR-P-04)
|
||||
- [x] **Step 26: Page routes**
|
||||
- `index.tsx`: `pageHead('/')`, Hero with `socials`.
|
||||
- `over-mij.tsx`: rewritten as a `PageIntro` placeholder in the Prettier style.
|
||||
- New: `portfolio.tsx`, `soorten-fotoshoots.tsx`, `contact.tsx`, `privacyverklaring.tsx` with the copy from frontend-components.md (FR-01, Q8).
|
||||
- Regenerate `routeTree.gen.ts` via the router plugin.
|
||||
- [x] **Step 27: App entry** — `main.tsx`:
|
||||
- remove `ThemeProvider`
|
||||
- `createRouter({ routeTree, scrollRestoration: true, defaultErrorComponent: ErrorPage })` (FR-08, FR-10)
|
||||
- [x] **Step 28: Static files**
|
||||
- `public/robots.txt` (BR-SEO-08).
|
||||
- `public/og-image.jpg`: a 1200×630 crop of a hero photo (BR-SEO-04). If no image tool is available locally, I'll ask you to supply the crop.
|
||||
- `public/logo.png` for JSON-LD.
|
||||
- `index.html` fallback gets `og:image`, canonical and `twitter:card`.
|
||||
- Delete `assets/hero.png`, `assets/typescript.svg`, `assets/vite.svg` after checking they are unreferenced (FR-11).
|
||||
- [x] **Step 29: Integration tests** (`src/app.test.tsx`), with the real route tree in a memory router:
|
||||
- an unknown URL shows the 404 inside the shell
|
||||
- a throwing route shows the error page inside the shell (NFR-R-01)
|
||||
- the `sitePages` registry equals the route tree (BR-SEO-07)
|
||||
- axe on every page
|
||||
|
||||
### Part G — Documentation and verification
|
||||
|
||||
- [x] **Step 30: Code summary** — `aidlc-docs/features/frontend-shell/construction/frontend-shell/code/code-summary.md`. It covers:
|
||||
- files created, modified and deleted
|
||||
- mapping to FR/BR IDs
|
||||
- how to run the scripts
|
||||
- Check LAYOUT.md. No change is expected: the shell blocks (Header / Content / Footer) stay the same.
|
||||
- [x] **Step 31: Unit verification** (Step 13.5): run `pnpm lint`, `pnpm format:check`, `pnpm test` and `pnpm build`, fixing failures until green. Then:
|
||||
- check that `dist/sitemap.xml` exists
|
||||
- check that the bundle does not contain the joined e-mail address (NFR-SEC-07)
|
||||
- run `pnpm audit:deps`
|
||||
- try `pnpm lighthouse`. If Chrome is missing, report that and leave it for Build and Test.
|
||||
|
||||
## Scope Estimate
|
||||
- **About 30 files**:
|
||||
- roughly 18 new source/test files
|
||||
- about 12 modified
|
||||
- 7 deleted, of which 3 starter assets
|
||||
- **New dev dependencies**: 15. **Removed**: 1.
|
||||
+95
@@ -0,0 +1,95 @@
|
||||
# Functional Design Change Questions — SEO, schermlezers, responsive, hergebruik
|
||||
|
||||
Je vroeg om SEO, schermlezers, responsive design en hergebruik via Chakra/thema meteen mee te nemen. Het grootste deel kan ik op vaste uitgangspunten uitwerken (zie "Wordt uitgewerkt zonder vraag"). Hieronder staan alleen de punten waar een echte keuze in zit. Vul per vraag de letter in na `[Answer]:`. Waar ik een voorkeur heb staat **(aanbevolen)**.
|
||||
|
||||
## Wordt uitgewerkt zonder vraag
|
||||
|
||||
**SEO**
|
||||
|
||||
- Per pagina een unieke titel en beschrijving (bestaat al via `pageHead`). Placeholderpagina's en 404/fout krijgen `noindex`, zodat een lege "in de maak"-pagina niet in Google komt. Zodra de echte inhoud er staat, gaat `noindex` eraf.
|
||||
- Eén `h1` per pagina, koppen in logische volgorde (geen niveaus overslaan). Footerkoppen zijn `h2`, opgemaakt als eyebrow: het zijn hoofdsecties van de pagina (gecorrigeerd bij het uitwerken, zie BR-SEO-09).
|
||||
- Interne links zijn echte `<a href>`-links (geen klik-handlers op `div`s), zodat zoekmachines ze kunnen volgen.
|
||||
- Alle afbeeldingen hebben een betekenisvolle `alt`, decoratieve krijgen `alt=""`.
|
||||
|
||||
**Schermlezers**
|
||||
|
||||
- `lang="nl"` (staat al), landmarks `header`/`nav`/`main`/`footer` met Nederlandse labels.
|
||||
- Skip link, zichtbare focusstijl op alles wat focus kan krijgen, en die focusstijl komt **op één plek uit het thema** in plaats van per component.
|
||||
- Iconen zijn `aria-hidden`; knoppen met alleen een icoon hebben een `aria-label`.
|
||||
- Externe links die in een nieuw tabblad openen, melden dat aan schermlezers ("opent in nieuw tabblad", visueel verborgen).
|
||||
- Respecteren van `prefers-reduced-motion`.
|
||||
|
||||
**Responsive**
|
||||
|
||||
- Mobile-first, met de standaard Chakra-breakpoints (`sm` 480, `md` 768, `lg` 1024, `xl` 1280, `2xl` 1536). Per component een tabel met wat er per breakpoint verandert.
|
||||
- Werkt van 320px breed tot 32:9 zonder horizontaal scrollen; tekst kan 200% vergroot worden zonder dat er iets wegvalt.
|
||||
- Klikdoelen minimaal 44×44px op touch (menu, footerlinks, to-top).
|
||||
|
||||
**Hergebruik via Chakra en het thema**
|
||||
|
||||
- Een overzicht per component van welke tokens, text styles en recipes het gebruikt, en welke nieuwe gedeelde stukken erbij komen (bv. één `pageTitle`-text style voor de `h1` van PageIntro en StatusPage, één `focusRing` voor de hele site, z-index-tokens voor header/menu/to-top in plaats van losse getallen).
|
||||
- Geen waarden die al als token bestaan, opnieuw hard in een component.
|
||||
|
||||
---
|
||||
|
||||
## Questions
|
||||
|
||||
### Vraag 1: Link-previews en crawlers die geen JavaScript uitvoeren
|
||||
|
||||
De site wordt in de browser opgebouwd. Google voert JavaScript uit en ziet dus de juiste titel per pagina. **WhatsApp, Facebook en LinkedIn doen dat niet**: die zien bij elke pagina alleen de vaste fallback uit `index.html` (de homepage-titel). Dat los je alleen op door de pagina's bij het bouwen al als HTML te genereren ("prerendering").
|
||||
|
||||
A) Nu nog niet prerenderen, maar alles zo bouwen dat het later zonder ombouw kan: alle head-data via de route-`head`, geen `window`/`document` tijdens het renderen, content via props. Prerendering wordt een vervolgpunt bij hosting/Operations. **(aanbevolen)** Prerendering is pas zinvol als er echte pagina-inhoud is; nu zijn het placeholders.
|
||||
B) Nu al prerendering toevoegen in deze feature (een build-stap die per route statische HTML maakt). Grotere scope en een extra afhankelijkheid.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 2: Domein voor canonical-URL's en `og:url`
|
||||
|
||||
Voor canonical-URL's (voorkomt dubbele pagina's in Google) en voor link-previews is het definitieve adres nodig.
|
||||
|
||||
A) `https://andreaslop.nl` (zonder www) **(aanbevolen)** Komt overeen met het e-maildomein; `www` stuurt de host dan door.
|
||||
B) `https://www.andreaslop.nl`
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 3: Afbeelding voor link-previews (`og:image`)
|
||||
|
||||
Zonder `og:image` tonen WhatsApp en Facebook een preview zonder plaatje.
|
||||
|
||||
A) Eén vaste site-brede afbeelding (een uitsnede van een hero-foto, 1200×630), die een pagina later kan overschrijven met een eigen beeld **(aanbevolen)**
|
||||
B) Het logo als preview-afbeelding
|
||||
C) Nog geen `og:image`
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 4: Gestructureerde data voor Google (JSON-LD)
|
||||
|
||||
Met gestructureerde data begrijpt Google dat dit een lokale fotograaf is (naam, plaats, socials). Dat helpt bij lokaal zoeken ("fotograaf Huizen").
|
||||
|
||||
A) Ja, site-breed één `ProfessionalService`-blok met naam, website, regio Huizen, logo en de social-links. **Zonder e-mailadres**, anders staat het adres alsnog leesbaar in de pagina. **(aanbevolen)**
|
||||
B) Nog niet, later met de echte pagina's
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 5: `robots.txt` en `sitemap.xml`
|
||||
|
||||
A) Beide als statisch bestand in `public/`. De sitemap bevat alleen de geïndexeerde pagina's (nu: home) en wordt bijgewerkt zodra er een pagina live gaat. Een test controleert dat de sitemap en de routes niet uit elkaar lopen. **(aanbevolen)**
|
||||
B) De sitemap wordt bij elke build automatisch gemaakt uit de routes. Meer werk nu, maar niets handmatig bij te houden.
|
||||
C) Later, bij hosting/Operations
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: B is het makkelijkste. Hoeveel meerwerk is het en hoe wordt het automatisch opgebouwd? Hoe betrouwbaar is het? Bij teveel gedoe of onzekerheden is A het beste. Anders B, met eventueel de test uit optie A
|
||||
|
||||
### Vraag 6: Paginawissel aankondigen aan schermlezers
|
||||
|
||||
Bij een gewone website leest een schermlezer na een klik de nieuwe pagina voor. In een app als deze gebeurt dat niet vanzelf: de inhoud wisselt, maar de schermlezer merkt het niet.
|
||||
|
||||
A) Na elke paginawissel (niet bij de eerste keer laden) gaat de focus naar `main#main`, net als bij de skip link en de to-top-knop. De schermlezer leest dan de nieuwe inhoud vanaf het begin. **(aanbevolen)** Eén consistent gedrag.
|
||||
B) De focus blijft staan en een onzichtbaar meldingsgebied leest de nieuwe paginatitel voor ("Portfolio, pagina geladen")
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
# 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)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### 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)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
|
||||
### Clarification Question 3: Hoe toont de footer het e-mailadres?
|
||||
|
||||
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.
|
||||
@@ -0,0 +1,127 @@
|
||||
# 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
|
||||
+21
@@ -0,0 +1,21 @@
|
||||
# Functional Design Plan — frontend-shell
|
||||
|
||||
Unit: **frontend-shell** (single unit; Units Generation skipped). Builds on the approved Application Design in `inception/application-design/`.
|
||||
|
||||
Questions for this stage are in [frontend-shell-fd-questions.md](frontend-shell-fd-questions.md).
|
||||
|
||||
## Plan
|
||||
|
||||
- [x] 1. Answer the functional design questions
|
||||
- [x] 2. Analyze answers for ambiguities (follow-up questions if needed)
|
||||
- [x] 3. Generate `domain-entities.md` — content and navigation data model (`SiteContent`, `SocialLink`, `SocialPlatform`, `NavItem`, `HeroContent`) with relationships and field rules
|
||||
- [x] 4. Generate `business-rules.md` — behaviour rules and decision logic:
|
||||
- back-to-top visibility, scroll and focus rules
|
||||
- social link filtering/validation and empty-content rules
|
||||
- copyright line, nav invariants
|
||||
- 404 head (title + `noindex`) mechanism
|
||||
- error page behaviour and logging
|
||||
- [x] 5. Generate `business-logic-model.md` — flows: page navigation and scroll restoration, not-found and error rendering inside/outside the shell, back-to-top interaction, content provisioning
|
||||
- [x] 6. Generate `frontend-components.md` — component hierarchy, props/state per component, interaction flows, final Dutch copy for placeholders, 404 and error page
|
||||
- [x] 7. Add the "Testable Properties" section (PBT-01) covering `backToTopThreshold`, `visibleSocials`, `copyrightLine`, `mainNav`/`footerNav`, and explicitly mark components without properties
|
||||
- [x] 8. Validate against FR-01…FR-11, NFR-01…NFR-05, Security Baseline and PBT-01; validate Mermaid diagrams
|
||||
+18
@@ -0,0 +1,18 @@
|
||||
# NFR Requirements Clarification Questions — frontend-shell
|
||||
|
||||
## Ambiguity 1: Wanneer draait Lighthouse CI? (vraag 3 = B)
|
||||
|
||||
Je koos voor automatisch meten met Lighthouse CI. Een run bouwt de site, start een browser (Chrome moet geïnstalleerd zijn) en meet elke pagina een paar keer. Dat kost al snel 30–60 seconden. "Bij elke build" kan twee dingen betekenen.
|
||||
|
||||
Twee dingen gelden ongeacht je keuze:
|
||||
|
||||
- Lighthouse meet de pagina's mobiel én desktop.
|
||||
- De placeholderpagina's staan bewust op `noindex`, en Lighthouse rekent dat af in de SEO-score. Het doel "SEO 100" geldt daarom alleen voor geïndexeerde pagina's (nu: home). Voor de andere pagina's geldt alleen de controle dat `noindex` er bewust staat.
|
||||
|
||||
### Clarification Question 1
|
||||
|
||||
A) Een apart script `pnpm lighthouse`, en het draait mee in `pnpm check` (de controle vóór elke release, zie vraag 8). `pnpm build` blijft snel. Haalt een pagina de doelen niet, dan faalt `check`. **(aanbevolen)**
|
||||
B) Echt bij elke `pnpm build`. Elke build duurt dan 30–60 seconden langer en faalt als een doel niet gehaald wordt.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A, er vanuitgaand dat ik lokaal de check kan draaien zodat ik tussendoor ook een check kan doen. Ik vraag me alleen wel af of een automatische check vlak voor release niet te laat is. Stel ik doe onderhoud en vergeet dat ik die check moet doen. Dan zie ik dat pas vlak voor release. Als het standaard in CI/CD workflow wordt meegenomen als bijvoorbeeld de laatste stap, dan hoeft het niks in de weg te zitten.
|
||||
+99
@@ -0,0 +1,99 @@
|
||||
# NFR Requirements Plan — frontend-shell
|
||||
|
||||
Unit: **frontend-shell**. Builds on requirements NFR-01…NFR-06 and the approved functional design. NFR Design is skipped (execution plan); the patterns are small and go straight into this document and the code generation plan.
|
||||
|
||||
## Plan
|
||||
|
||||
- [x] 1. Answer the questions below
|
||||
- [x] 2. Analyze answers for ambiguities (follow-up questions if needed)
|
||||
- [x] 3. Generate `nfr-requirements.md` — measurable NFRs per category: performance, accessibility, SEO, security, reliability, maintainability/testing, browser support; scalability/availability marked N/A with rationale
|
||||
- [x] 4. Generate `tech-stack-decisions.md` — test stack (PBT-09), linting, security headers/CSP, build plugins, dependency changes with rationale
|
||||
- [x] 5. Validate against Security Baseline (SECURITY-04, -09, -10, -13, -15) and PBT-09
|
||||
|
||||
## Already decided (no question needed)
|
||||
|
||||
- **Scalability and availability**: N/A for the shell. It is a static site without a server; availability depends on the future host (Operations).
|
||||
- **Test stack** (NFR-03, PBT-09): Vitest + React Testing Library + `@testing-library/user-event` + `jsdom` + fast-check. fast-check covers custom generators, shrinking and seed-based replay, and runs inside Vitest. The seed is printed on failure and can be passed back to replay a run.
|
||||
- **Security headers** (NFR-04): `X-Content-Type-Options: nosniff`, `X-Frame-Options: DENY`, `Referrer-Policy: strict-origin-when-cross-origin` and HSTS `max-age=31536000; includeSubDomains`. Browsers ignore HSTS over plain `http://localhost`, so locally it has no effect; it matters on the production host.
|
||||
- **CSP content for the production build**: `default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'`.
|
||||
- `style-src 'unsafe-inline'` is needed because Chakra/Emotion inject `<style>` tags at runtime (justified).
|
||||
- The JSON-LD block is a data block (`application/ld+json`). It is not executed and needs no CSP exception.
|
||||
- **Router devtools**: only loaded in development (`import.meta.env.DEV`), so they are not in the production bundle (SECURITY-09 hardening). `@tanstack/react-router-devtools` moves to `devDependencies`.
|
||||
- **Sitemap plugin**: a local plugin in the Vite config; no extra dependency. `vite.config.js` becomes `vite.config.ts`, so it can import the typed `sitePages` registry and get type checking.
|
||||
|
||||
---
|
||||
|
||||
## Questions
|
||||
|
||||
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)**.
|
||||
|
||||
### Vraag 1: Content-Security-Policy tijdens het ontwikkelen
|
||||
|
||||
De strenge CSP hierboven werkt op de gebouwde site (`pnpm preview`). De dev-server (`pnpm dev`) heeft voor hot reload een inline script en een websocket nodig. Een strenge CSP breekt daar het herladen.
|
||||
|
||||
A) Strenge CSP op `preview` (en als voorschrift voor productie). In `dev` dezelfde CSP, maar met alleen de uitzonderingen die Vite nodig heeft (inline script voor React Refresh, websocket voor HMR). De overige headers zijn in beide gelijk. **(aanbevolen)** Je ziet CSP-problemen dan al tijdens het ontwikkelen, behalve die van Vite zelf.
|
||||
B) Alleen op `preview` een CSP; `dev` zonder CSP
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 2: `next-themes` (wisselen tussen licht en donker)
|
||||
|
||||
De site staat vast op licht (`defaultTheme="light"`, `enableSystem={false}`). `next-themes` doet nu dus niets nuttigs. Wel zet het een inline script in de pagina, en dat botst met een strenge CSP (`script-src 'self'`).
|
||||
|
||||
A) `next-themes` verwijderen en de site vast op licht zetten. Het thema houdt zijn `_dark`-waarden, zodat een donkere modus later weer kan. **(aanbevolen)** Eén afhankelijkheid minder, en geen CSP-uitzondering nodig.
|
||||
B) Houden voor een mogelijke donkere modus later, en het script via een hash in de CSP toestaan
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 3: Meetbare doelen voor kwaliteit
|
||||
|
||||
A) Lighthouse (mobiel) ≥ 90 voor Performance en 100 voor Accessibility, Best Practices en SEO, op de gebouwde site (`pnpm preview`). Handmatig gemeten bij Build and Test. **(aanbevolen)**
|
||||
B) Hetzelfde, maar automatisch bij elke build (Lighthouse CI). Meer opzetwerk, en zonder CI-server draait het alleen lokaal.
|
||||
C) Geen harde doelen, alleen de regels uit het functional design
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: B
|
||||
|
||||
### Vraag 4: Automatisch testen op toegankelijkheid
|
||||
|
||||
A) `axe-core` in de componenttests (via `vitest-axe`): elke shell-, placeholder-, 404- en foutpagina-test controleert ook op toegankelijkheidsfouten. Contrast controleert axe in `jsdom` niet; dat dekt Lighthouse (vraag 3) af. **(aanbevolen)**
|
||||
B) Geen automatische controle, alleen handmatig met Lighthouse en een schermlezer
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 5: Linting
|
||||
|
||||
Er is nu alleen Prettier (opmaak), geen linter die fouten in code vindt.
|
||||
|
||||
A) ESLint toevoegen met de aanbevolen regels voor TypeScript, React Hooks en `jsx-a11y` (toegankelijkheid in JSX), plus een `lint`-script **(aanbevolen)** Vangt bv. vergeten `alt`-teksten en fouten met hooks al tijdens het schrijven.
|
||||
B) Geen linter in deze feature
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 6: Welke browsers ondersteunen we?
|
||||
|
||||
A) De laatste 2 versies van Chrome, Edge, Firefox en Safari, plus Safari op iOS 16 en nieuwer. Dat dekt vrijwel alle bezoekers; oudere browsers krijgen de site zonder garantie. **(aanbevolen)**
|
||||
B) Ruimer: ook oudere browsers (bv. iOS 14), met extra fallbacks voor nieuwere CSS
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: Begin met optie A. B zou later nog kunnen met name voor de mobiele versies.
|
||||
|
||||
### Vraag 7: Testdekking
|
||||
|
||||
A) Geen harde drempel voor de hele code, wel 100% dekking van de pure functies (`backToTopThreshold`, `visibleSocials`, `emailAddress`, `copyrightLine`, `canonicalUrl`, `sitemapXml`, `jsonLdScript`). De dekking wordt gerapporteerd bij `pnpm test`. **(aanbevolen)**
|
||||
B) Een drempel voor de hele code (bv. 80% van de regels), die de tests laat falen als hij niet gehaald wordt
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
|
||||
### Vraag 8: Controle op kwetsbare afhankelijkheden
|
||||
|
||||
A) Een script `pnpm audit:deps` (`pnpm audit --audit-level high`) plus een `check`-script dat lint, tests, build en audit achter elkaar draait. Dit is de controle vóór elke release, en later de basis voor CI. **(aanbevolen)**
|
||||
B) Alleen documenteren dat `pnpm audit` handmatig gedraaid moet worden
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A
|
||||
Reference in New Issue
Block a user