Records unit 1 of the Soorten fotoshoots page as generated

Adds the feature's inception documents (requirements, execution plan,
application design), the code generation plan and summary of unit 1,
its state and audit log, and its row in the active features list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-25 08:26:06 +01:00
co-authored by Claude Opus 5.5
parent 6cf909564b
commit 166e5d32bb
15 changed files with 1366 additions and 0 deletions
@@ -0,0 +1,48 @@
# Application Design — Soorten fotoshoots Page
Consolidated design. Details: [components.md](components.md), [component-methods.md](component-methods.md), [services.md](services.md), [component-dependency.md](component-dependency.md). Decisions: [application-design-plan.md](../plans/application-design-plan.md).
## Decisions
| # | Decision |
|---|---|
| Q1 | The offset block behind the photo stays; `FramedImage`/`MediaText` take an optional `frameColor`, default `sand` (existing callers unchanged) |
| Q2 | `CallToAction` is layout with fixed slots: `title`, `titleId`, `lead` (`ReactNode`), action as `children` |
| F1 | Live frame colours become theme tokens `frame.stone/rust/taupe/olive`; Gezin uses `accent`; content names the token |
| F2 | Photos cropped to portrait 4:5; crop point chosen per photo and shown to the user before it is fixed |
| F3 | "Bekijk meer …foto's" links to `/portfolio?shoot=<id>`, rendered only once `/portfolio` is indexed |
| — | Page parts in `components/shoots/` (`ShootList`, `ShootBlock`); `RichParagraph` moves to shared; contact and portfolio targets derived by pure functions in `lib/shootLinks.ts`; JSON-LD via contact-page's `webPage()` with a `shootServices()` builder; `serviceArea` in `siteContent` |
## Page composition
```mermaid
graph TD
Head["PageIntro: Mogelijkheden / h1 Soorten fotoshoots / intro"] --> List["ShootList (PageSection flushTop)"]
List --> B1["ShootBlock Newborn (photo left, stone)"]
List --> B2["ShootBlock Zwangerschap (photo right, rust)"]
List --> B3["ShootBlock Gezin (photo left, accent)"]
List --> B4["ShootBlock Loveshoot (photo right, taupe)"]
List --> B5["ShootBlock Portretten (photo left, olive)"]
List --> Cta["CallToAction: Benieuwd naar de prijzen?"]
classDef head fill:#e76f51,stroke:#ad533d,color:#000;
classDef shoot fill:#f4a261,stroke:#b77a49,color:#000;
classDef cta fill:#b56576,stroke:#884c59,color:#000;
class Head head;
class List,B1,B2,B3,B4,B5 shoot;
class Cta cta;
```
Text alternative: the page head is followed by a list of five alternating shoot blocks, each with its own frame colour, and the closing call to action.
## Units
- **Unit 1 Shared blocks and content**: `FramedImage`/`MediaText` options, theme frame tokens, `CallToAction`, `RichParagraph` move, `Pricing` anchor; first commit `ShootType` + `shootTypes.ts` + `assets/shoots/` (hash to portfolio-page); separate commit `serviceArea` + `professionalService` (hash to contact-page).
- **Unit 2 Soorten fotoshoots page**: `shootLinks.ts`, `ShootList`/`ShootBlock`, page content, route with head and JSON-LD, SEO registry and Lighthouse entries, preview image, LAYOUT.md, RE delta lines.
## Open dependencies on parallel features
- `webPage()` (contact-page): needed in unit 2.
- `/portfolio` `?shoot=` search validation (portfolio-page): `validateSearch` returns `{ shoot?: ShootTypeId }`, so the link type-checks once that route is in master; until then the link is switched off anyway.
- A shoot type without portfolio photos falls back to "Alles" on the portfolio page. Proposed: show the "Bekijk meer …foto's" link only for types that have photos, using a pure helper portfolio-page will export from `lib/` (working name `shootTypesWithPhotos(photos)`). Wired in when that helper is in master; until then the links are off anyway (FR-SF-04b).
- `/contact?pakket=` (contact-page): `shootContactLink` switches in one place when the contact page lands.
## Extension compliance (design level)
- **Security Baseline**: no new inputs, endpoints or third parties; query parameters only built from our own ids (SECURITY-05, -11 compliant); other rules N/A as at requirements level.
- **PBT**: properties to be identified in Functional Design for `shootLinks` and `shootServices`/`areaServed` (PBT-01 planned); generators for `ShootType` added to `src/test/arbitraries.ts` (PBT-07 planned).
@@ -0,0 +1,51 @@
# Component Dependencies — Soorten fotoshoots Page
## Dependency graph
```mermaid
graph TD
Route["routes/soorten-fotoshoots.tsx"] --> PageIntro["PageIntro"]
Route --> ShootList["shoots/ShootList"]
Route --> Cta["CallToAction"]
Route --> Seo["seo.ts: webPage + shootServices"]
Route --> Live["lib/shootLinks: isPortfolioLive"]
ShootList --> ShootBlock["shoots/ShootBlock"]
ShootBlock --> MediaText["MediaText (reverse, frameColor)"]
ShootBlock --> Links["lib/shootLinks: contact + portfolio"]
MediaText --> Framed["FramedImage (frameColor)"]
Cta --> PageSection["PageSection"]
Cta --> Rich["RichParagraph (moved)"]
ShootList --> PageSection
Links --> Packages["content/packages.ts ids"]
Live --> Pages["sitePages.ts"]
Seo --> Site["siteContent.serviceArea"]
Route --> Shoots["content/shootTypes.ts"]
Portfolio["portfolio-page (parallel)"] -.-> Shoots
classDef newpart fill:#FFA726,stroke:#E65100,stroke-width:1px,color:#000;
classDef changed fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
classDef existing fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
classDef other fill:#CE93D8,stroke:#6A1B9A,stroke-width:1px,color:#000;
class Route,ShootList,ShootBlock,Cta,Links,Live,Shoots newpart;
class MediaText,Framed,Rich,Seo,Site changed;
class PageIntro,PageSection,Packages,Pages existing;
class Portfolio other;
```
Text alternative: the route composes PageIntro, ShootList (which renders ShootBlocks on MediaText and FramedImage) and CallToAction (on PageSection and RichParagraph); link helpers read package ids and the page registry; SEO reads the service area; portfolio-page also reads shootTypes.ts.
## Dependency matrix
| Component | Depends on | Used by |
|---|---|---|
| `FramedImage` | `DeferredImage`, theme tokens | `MediaText` |
| `MediaText` | `FramedImage`, `Reveal` | `AboutBlock`, `AboutIntro`, `ShootBlock` |
| `CallToAction` | `PageSection`, `Reveal` | route (first use) |
| `RichParagraph` | `RouterLink`, `Link` | `AboutIntro`, route (`CallToAction` lead) |
| `ShootList` | `PageSection`, `ShootBlock` | route |
| `ShootBlock` | `MediaText`, `shootLinks`, `VisuallyHidden` | `ShootList` |
| `shootLinks` | `packages` ids, `sitePages` | `ShootBlock`, route |
| `shootTypes.ts` | assets, `ShootType` | route, portfolio-page |
| `seo.ts` | `siteContent`, `sitePages`, `webPage()` (contact-page) | route heads, `siteHead` |
## Communication
Props only, top-down. No context, no global state. Links are plain router links; the homepage reads `?pakket=` with the existing `packageFromSearch`, the portfolio page reads `?shoot=` with its own validation.
@@ -0,0 +1,119 @@
# Component Methods — Soorten fotoshoots Page
Props and function signatures. Business rules (exact link rules, structured data rules, properties for PBT) follow in Functional Design for unit 2.
## Types (`content/types.ts`)
```ts
export type ShootTypeId = 'newborn' | 'zwangerschap' | 'gezin' | 'loveshoot' | 'portret';
// Colour tokens allowed behind a framed photo
export type FrameColor = 'sand' | 'accent' | 'frame.stone' | 'frame.rust' | 'frame.taupe' | 'frame.olive';
export interface ShootType {
id: ShootTypeId; // stable; also used by portfolio-page and in URLs
name: string; // heading / short name: 'Newborn' … 'Portretten'
shootLabel: string; // 'Newbornshoot' … 'Portretshoot'
photosLabel: string; // "newbornfoto's" … "portretfoto's" (portfolio link)
paragraphs: string[];
image: ContentImage; // 4:5 crop
frameColor: FrameColor;
packageId?: PricingPackage['id'];
}
export interface ShootTypesPageContent {
head: { eyebrow: string; title: string; intro: string };
closing: { title: string; lead: RichText; buttonLabel: string };
}
export interface SiteContent {
// … existing fields
serviceArea: ServiceArea[];
}
export interface ServiceArea {
type: 'City' | 'AdministrativeArea';
name: string;
}
```
`photosLabel` and `frameColor` are additions to the shape agreed with portfolio-page; both are additive and announced to it.
## Shared components
```ts
// FramedImage
type FramedImageProps = {
image: ContentImage;
aspectRatio: string;
priority?: boolean;
frameColor?: FrameColor; // default 'sand'
};
// MediaText
type MediaTextProps = {
image: ContentImage;
aspectRatio: string;
priority?: boolean;
reverse?: boolean; // default false
frameColor?: FrameColor; // default 'sand'
'data-testid'?: string;
children: ReactNode;
};
// CallToAction
type CallToActionProps = {
title: string;
titleId: string; // names the section
lead?: ReactNode;
'data-testid'?: string;
children: ReactNode; // the action, e.g. a LinkButton
};
// RichParagraph (moved, same props)
type RichParagraphProps = { paragraph: RichText };
```
## Page components
```ts
// ShootList
type ShootListProps = {
shoots: ShootType[];
portfolioLive: boolean;
};
// ShootBlock
type ShootBlockProps = {
shoot: ShootType;
reverse: boolean;
priority: boolean;
portfolioLive: boolean;
};
```
## Logic
```ts
// lib/shootLinks.ts — router link props, so routes and search stay type-checked
export function shootContactLink(shoot: ShootType):
| { to: '/'; search: { pakket: string }; hash: 'contact' }
| { to: '/'; hash: 'contact' };
export function shootPortfolioLink(shoot: ShootType):
{ to: '/portfolio'; search: { shoot: ShootTypeId } };
// The portfolio links show once the page is live (indexed in sitePages)
export function isPortfolioLive(pages: Record<RoutePath, PageMeta>): boolean;
```
When contact-page lands, `shootContactLink` switches to `{ to: '/contact', search?: { pakket } }`; nothing else changes. The `/portfolio` route must accept `?shoot=` in its search validation (portfolio-page's route); until it does, the link type is guarded by the `isPortfolioLive` switch and the typed route check is added when portfolio-page's route is in master.
```ts
// seo.ts
export function areaServed(area: ServiceArea[]): object[]; // schema.org Place items
export function professionalService(content: SiteContent): object; // now uses areaServed(content.serviceArea)
export function shootServices(shoots: ShootType[], content: SiteContent): object; // ItemList of Service
// Used in the route head:
// webPage('WebPage', '/soorten-fotoshoots', { mainEntity: shootServices(shootTypes, siteContent) })
```
@@ -0,0 +1,64 @@
# Components — Soorten fotoshoots Page
Status per component: **new**, **changed** (backwards compatible) or **reused** (unchanged).
## Shared components (`web/src/components/`)
### `FramedImage` (changed)
- **Purpose**: photo with the offset block behind its lower left corner (design `.about__media`).
- **Change**: optional `frameColor` (a colour token), default `sand`. Existing callers pass nothing and render exactly as before.
### `MediaText` (changed)
- **Purpose**: framed photo next to a text column; stacked below `lg`.
- **Change**: optional `reverse` (photo in the second column from `lg`; stacked it stays on top) and `frameColor` (passed to `FramedImage`). Defaults keep `AboutBlock` and `AboutIntro` unchanged.
### `CallToAction` (new)
- **Purpose**: closing block of a page (design `.section--alt.section--tight` + `.container--narrow.text-center`): h2, lead, action.
- **Responsibilities**: the section frame (`PageSection` with `tone="alt"`, `width="narrow"`, `spacing="tight"`, named by its h2), heading style (`sectionTitle`), lead style, the space above the action, centring, `Reveal`.
- **Interface**: layout with fixed slots: `title`, `titleId`, `lead` (`ReactNode`), action as `children` (Application Design Q2 = A).
### `RichParagraph` (moved, unchanged)
- **Purpose**: a paragraph of text pieces and inline links (`RichText`).
- **Change**: moves from `components/about/` to `components/RichParagraph/`; Over mij's `AboutIntro` updates its import. Used here for the lead of `CallToAction`.
### Reused
`PageIntro`, `PageSection`, `Reveal`, `LinkButton` (`accent`), `RouterLink`, Chakra `Link` (`underline`), `VisuallyHidden`, `DeferredImage`.
## Page components (`web/src/components/shoots/`)
### `ShootList` (new)
- **Purpose**: the five shoot blocks in one `PageSection` (`spacing="flushTop"`, directly below the page head).
- **Responsibilities**: order, alternation (every second block `reverse`), the hairline between consecutive blocks (`line` token), which block gets the high-priority photo (the first).
### `ShootBlock` (new)
- **Purpose**: one shoot (design `.shoot`): an `article` named by its h2.
- **Responsibilities**: `MediaText` with the shoot photo (4:5, frame colour from the content), the h2 (shoot `name`), the paragraphs, and the links: "Stuur een berichtje" (always) and "Bekijk meer …foto's" (only when the portfolio is live). Visible link texts are completed for screen readers with `VisuallyHidden` parts, as on the price cards.
## Content (`web/src/content/`)
### `ShootType`, `ShootTypeId`, `FrameColor` (new types in `types.ts`)
- Shape agreed with portfolio-page; see component-methods.md.
### `shootTypes.ts` (new)
- The five shoot types in page order: texts, photo, frame colour token, optional package id. Also consumed by portfolio-page (filters, captions).
### `shootTypesPage` content (new, e.g. `shootTypesPageContent.ts`)
- Page texts: page head (eyebrow, title, intro) and the closing block (title, lead as `RichText`, button label).
### `siteContent.ts` / `SiteContent` (changed)
- New `serviceArea`: the places the business serves, used by all structured data.
## Logic (`web/src/lib/`, `web/src/seo.ts`)
### `shootLinks.ts` (new)
- Pure functions that derive router link props from a shoot type: contact target and portfolio target, plus whether the portfolio link is shown.
### `seo.ts` (changed)
- `professionalService` reads `areaServed` from `serviceArea`.
- New pure builder for the page's `ItemList` of `Service` items, passed as `extra` into contact-page's `webPage()`.
## Theme (`web/src/theme.ts`)
- New colour tokens for the frames: `frame.stone` `#ABA699`, `frame.rust` `#975030`, `frame.taupe` `#A18679`, `frame.olive` `#84847C`. `sand` and `accent` already exist.
## Homepage (`web/src/components/home/Pricing`)
- `Pricing` passes `id="prijzen"` to its `PageSection` (anchor for "de pakketten"). Nothing else changes.
@@ -0,0 +1,17 @@
# Services — Soorten fotoshoots Page
The SPA has no service layer. Orchestration happens in the route, the same pattern as the homepage and Over mij.
## Route `routes/soorten-fotoshoots.tsx`
- **`head()`**: `pageHead('/soorten-fotoshoots')` (title, description, canonical, `og:image`, no `noindex` once indexed) plus one `application/ld+json` script: `structuredDataScript(webPage('WebPage', '/soorten-fotoshoots', { mainEntity: shootServices(shootTypes, siteContent) }))`.
- **`component`**: composes, in page order:
1. `PageIntro` with the page head texts (eyebrow, h1, intro).
2. `ShootList` with `shootTypes` and `portfolioLive = isPortfolioLive(sitePages)`.
3. `CallToAction` with the closing title, the lead as `RichParagraph` (link "de pakketten" → `/#prijzen`) and a `LinkButton variant="accent"` "Boek je shoot" → `/#contact`.
## Data flow
Static content modules (later the CMS API) → route → components via props. Components never import content directly, so tests can pass any content and the API can replace the modules 1-to-1.
## External dependency
`webPage()` comes from contact-page (separate commit). If unit 2 starts before that commit exists, this feature asks contact-page whether to add it to the agreed signature itself (see aidlc-state.md § Parallel Work Agreements).