Adds the code summaries for the shoot page and the submenu

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-30 15:21:07 +01:00
co-authored by Claude Opus 5.5
parent 7af2069959
commit d3bc1d751a
7 changed files with 268 additions and 15 deletions
@@ -15,7 +15,7 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
| `/over-mij` | `routes/over-mij.tsx` | `pageHead('/over-mij')` + `AboutPage` JSON-LD | `PageIntro`, `AboutIntro`, `StorySection` ×2, `PhotoDuo`, `LinkButton` | yes |
| `/portfolio` | `routes/portfolio.tsx` | `pageHead('/portfolio')` + `ImageGallery` JSON-LD; search `?shoot=` (`ShootTypeId`) | `PageIntro`, `PortfolioGallery`, `InstagramGrid` | yes |
| `/soorten-fotoshoots` | `routes/soorten-fotoshoots/index.tsx` | `pageHead('/soorten-fotoshoots')` + `WebPage` JSON-LD via `StructuredData` (`webPage()` + `shootServices()`; Service `@id` `…/soorten-fotoshoots/<id>#service` per D2) | `PageIntro`, `shoots/ShootList` (5× `ShootBlock`), `CallToAction`, `RichParagraph`, `LinkButton` | yes |
| `/soorten-fotoshoots/<id>` (newborn, zwangerschap, gezin, loveshoot, portret) | `routes/soorten-fotoshoots/<id>.tsx` | `pageHead('/soorten-fotoshoots/<id>')`; JSON-LD via `StructuredData` (`shootPageGraph`: `WebPage` with the shoot's Service, `FAQPage` when there are questions) | `shoots/ShootPage` (`PageIntro` only in unit 1), `NotFound` when `shootPageView` returns `undefined` | yes |
| `/soorten-fotoshoots/<id>` (newborn, zwangerschap, gezin, loveshoot, portret) | `routes/soorten-fotoshoots/<id>.tsx` | `pageHead('/soorten-fotoshoots/<id>')` with its own `ogImage` (`/og-<id>.jpg`, 1200 × 630, unit 2); JSON-LD via `StructuredData` (`shootPageGraph`: `WebPage` with the shoot's Service, `FAQPage` when there are questions) | `shoots/ShootPage` (intro, story blocks, process timeline, photo mosaic when there are at least two photos, FAQ when there are questions, package block, closing call to action), `NotFound` when `shootPageView` returns `undefined` | yes |
| `/contact` | `routes/contact.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
| `/privacyverklaring` | `routes/privacyverklaring.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
| (not found) | — | — | `NotFound` | — |
@@ -68,6 +68,7 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
- Portfolio (`lib/portfolioFilters.ts`): `isShootTypeId`, `shootTypesWithPhotos(shootTypes, photos)`, `shootFromSearch(value, available)`, `filterPhotos(photos, shoot)`, `filterOptions(shootTypes, allLabel)`, `toGalleryItems(photos, shootTypes)`, `photoCountLabel(n)`; `seo.ts`: `galleryImages(photos)`
- Gallery (portfolio-page): `wrapIndex(index, count)`, `swipeDirection(start, end, threshold = 50)`, `masonryRowSpan({ width, height }, K = 40, gapRows = 2)`, `neighbourIndexes(index, count, radius = 2)`, `lightboxReducer(state, event)` (+ `LightboxState`, `LightboxEvent`)
- Shoot pages (unit 1): `shootPagePath(id)`, `shootIdFromSlug(slug)`, `shootIdFromPath(pathname)` (`lib/shootPages.ts`); `shootPackage(shoot, packages)` (`lib/shootPackage.ts`); `fillPlaceholders(text, values)`, `fillRichText(rich, values)` (`lib/fillPlaceholders.ts`); `richTextToPlain(text)` (`lib/richTextToPlain.ts`); `shootPageView(id, page, sources)` (`lib/shootPageView.ts`)
- Shoot pages (unit 2): `headingId(prefix, id)` (`lib/headingId.ts`), `readMoreLabel(shoot)` (`lib/readMoreLabel.ts`), `mosaicLayout(count): MosaicTile[]` (`lib/mosaicLayout.ts`), `storyLayout(stories): StoryLayout[]` (`lib/storyLayout.ts`), `shootPageBands(view): SectionBand[]` (`lib/shootPageBands.ts`; the section order of `ShootPage`), `isShootSectionPath(pathname)` (`lib/isShootSectionPath.ts`, FR-ST-14, used by `NotFound`)
- Navigation (unit 3): `shootNavItems(shoots): NavItem[]` (`lib/shootNavItems.ts`); `isItemCurrent(item, pathname)`, `isSectionCurrent(item, pathname)` (`lib/navCurrent.ts`); `navMenuReducer(state, event)` with `NavMenuState`, `NavMenuEvent`, `initialNavMenuState`, `FocusRequest` (`lib/navMenuState.ts`)
### Monitoring
@@ -41,7 +41,7 @@ graph TD
class Content,NavData,Seo,Theme,Blocks support;
```
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero and six sections built from shared blocks (one of them lazily loads the contact form); the about route renders the Over mij page; the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero and six sections built from shared blocks (one of them lazily loads the contact form); the about route renders the Over mij page; the other routes render placeholder PageIntros; the shoot pages render `shoots/ShootPage`, whose sections follow `shootPageBands(view)` (`lib/shootPageBands.ts`): intro, stories, process, photos, FAQ, package, closing; content, navigation, SEO and theme modules support all of it.
## Component Descriptions
### main.tsx
@@ -60,19 +60,24 @@ Candidates for modification are marked with ★ for the over-mij-page feature.
- `web/src/routes/index.tsx` — home (`/`): Hero + six sections, `?pakket=` search param
- `web/src/routes/over-mij.tsx` — the about page (indexed; `AboutPage` JSON-LD)
- `web/src/components/about/*` — `AboutIntro`, `StorySection`
- `web/src/components/shoots/*` — `ShootList`, `ShootBlock` (soorten-fotoshoots page)
- `web/src/components/shoots/ShootPage/ShootPage.tsx` — shoot page shell, `ShootPageView` in (unit 1: intro only; unit 2 adds the sections)
- `web/src/components/shoots/*` — `ShootList`, `ShootBlock` (soorten-fotoshoots page; unit 2: "Lees meer over de …" link first in the row, to the shoot page)
- `web/src/components/shoots/ShootPage/ShootPage.tsx` — shoot page, `ShootPageView` in: intro, then the sections in `shootPageBands` order (unit 2: stories, process, photos, FAQ, package, closing; wrapper `data-testid="shoot-page"`)
- `web/src/components/shoots/{StoryBlocks,ProcessIcons}/` — shoot page parts (unit 2): one `PageSection` per story (`StoryBlocks`); the six process icons as inline SVG (`ProcessIcons`)
- `web/src/components/{Breadcrumb,ProcessTimeline,PhotoMosaic,FaqList,PackageBlock}/` — shoot page parts (unit 2), each with a test
- `web/src/components/StructuredData/StructuredData.tsx` — JSON-LD script via `jsonLdScript`; the only `dangerouslySetInnerHTML` of the shoot pages
- `web/src/components/{CallToAction,RichParagraph}/` — shared closing block; paragraph with inline links
- `web/src/components/{CallToAction,RichParagraph}/` — shared closing block (unit 2 adds `tone`); paragraph with inline links
- `web/src/content/{shootTypes,shootTypesPageContent}.ts` — shoot types (also used by the portfolio filters) and page texts; `web/src/assets/shoots/` — 4:5 shoot photos
- `web/src/lib/shootLinks.ts` — contact and portfolio link targets per shoot type
- `web/src/lib/{shootPages,shootPackage,fillPlaceholders,richTextToPlain,shootPageView}.ts` — shoot page helpers (ids and paths, package, placeholders, plain text, view), each with a test
- `web/src/lib/{headingId,readMoreLabel,mosaicLayout,storyLayout,shootPageBands}.ts` — shoot page helpers (unit 2): safe heading ids, "Lees meer" label, photo-mosaic and story layout, section bands; each with a test at 100 % coverage
- `web/src/lib/isShootSectionPath.ts` — whether a pathname is under `/soorten-fotoshoots/` (FR-ST-14, used by `StatusPage/NotFound`), with a property-based test
- `web/src/lib/{shootNavItems,navCurrent,navMenuState}.ts` — navigation helpers (unit 3), each with a test: submenu items from the shoot types (`shootNavItems`), current-page and section-current matching (`isItemCurrent`, `isSectionCurrent`), menu state reducer (`navMenuReducer`, `NavMenuState`, `NavMenuEvent`; `navMenuState.ts` at 100 % coverage)
- `web/src/components/PhotoDuo/PhotoDuo.tsx` — two photos side by side
- `web/src/content/aboutContent.ts` — about page content; `web/src/assets/about/*` — portrait and duo photos; `web/public/og-over-mij.jpg` — preview image
- `web/src/routes/soorten-fotoshoots/index.tsx` — the shoot types page (moved from `routes/soorten-fotoshoots.tsx`); `newborn.tsx`, `zwangerschap.tsx`, `gezin.tsx`, `loveshoot.tsx`, `portret.tsx` — one route per shoot page (`/soorten-fotoshoots/<id>`); `-shootPageSources.ts` — the sources the shoot routes share
- `web/src/content/shootPageShared.ts` — shared shoot page content (breadcrumb, process, deposit, shared FAQ items, offer texts); `web/src/content/shootPages/*.ts` — one content module per shoot page, plus `shootPages.test.ts` (content consistency)
- `web/src/test/renderApp.tsx` — `renderApp(path)` and `expectShell()` for the route tests
- `web/src/shootPages.test.tsx` — route tests for the five shoot pages (unit 2): outline, sections, breadcrumb, `aria-current` (main and menus), package variants, OG registry, axe; the overview's "Lees meer" links
- `web/src/routes/portfolio.tsx` — the portfolio (indexed; `?shoot=` filter; `ImageGallery` JSON-LD); `web/src/components/portfolio/PortfolioGallery/`, `web/src/content/portfolioContent.ts`, `web/src/lib/portfolioFilters.ts`, `web/src/assets/portfolio/*` (10 photos × 2 sizes), `web/public/og-portfolio.jpg`
- `web/src/routes/{contact,privacyverklaring}.tsx` — placeholders with `PageIntro`
- `web/src/components/AppShell.tsx` — shell
@@ -82,14 +87,14 @@ Candidates for modification are marked with ★ for the over-mij-page feature.
- `web/src/components/home/*` — five homepage sections (AboutBlock is the closest relative of the Over mij page's first block)
- `web/src/components/InstagramGrid/InstagramGrid.tsx` — Instagram block, shared by the homepage and the portfolio (moved from `home/` in portfolio-page)
- ★ `web/src/components/PageSection/PageSection.tsx` — section frame for any page (was `HomeSection`)
- ★ `web/src/components/MediaText/MediaText.tsx`, `Eyebrow/Eyebrow.tsx` — framed photo next to text; accent label
- ★ `web/src/components/MediaText/MediaText.tsx`, `Eyebrow/Eyebrow.tsx` — framed photo next to text; accent label (unit 2 adds `mediaSize` `'medium'`)
- ★ `web/src/components/SectionHeading/SectionHeading.tsx` — eyebrow + h2 + lead
- ★ `web/src/components/FramedImage/FramedImage.tsx`, `DeferredImage/DeferredImage.tsx`, `Reveal/Reveal.tsx` — photo blocks and fade-in
- `web/src/components/ContactForm/*` — contact form and gate
- `web/src/components/BackToTop/BackToTop.tsx` — back-to-top button
- `web/src/components/Analytics/UmamiAnalytics.tsx` — Umami script injection
- ★ `web/src/components/PageIntro/PageIntro.tsx` — page head block (eyebrow, h1, intro)
- `web/src/components/StatusPage/*` — StatusPage layout, NotFound, ErrorPage
- ★ `web/src/components/PageIntro/PageIntro.tsx` — page head block (eyebrow, h1, intro; unit 2 adds optional `titleId` and `breadcrumb`)
- `web/src/components/StatusPage/*` — StatusPage layout, NotFound (unit 2, FR-ST-14: under `/soorten-fotoshoots/` buttons back to the overview and to home, decided by `lib/isShootSectionPath.ts`), ErrorPage
- ★ `web/src/components/LinkButton.tsx`, `RouterLink.tsx` — router links (button style / Chakra-wrapped)
- ★ `web/src/content/types.ts` — content interfaces (API shape)
- ★ `web/src/content/*.ts` — static content (`siteContent`, `heroContent`, `homeContent` (exports `introPhotos`), `instagramContent`, `packages`, `testimonials`, `socialPlatforms`)
@@ -109,7 +114,7 @@ Candidates for modification are marked with ★ for the over-mij-page feature.
- `web/config/securityHeaders.ts` — CSP
- `web/config/serverConfig.ts`, `writeServerConfig.ts`, `sitemapPlugin.ts`, `testSeed.ts`
- `web/deploy/iis/web.config`, `web/deploy/nginx/*.conf` — generated server configs
- `web/public/*` — favicon, logo, og-image, robots.txt, icons.svg
- `web/public/*` — favicon, logo, og-image, robots.txt, icons.svg; `og-{newborn,zwangerschap,gezin,loveshoot,portret}.jpg` (unit 2: 1200 × 630, the shoot pages' `ogImage`)
## Design Patterns
### API-shaped static content