Functional design, code generation plan and summary of the contact page, the updated LAYOUT.md diagram and the extended link requirement. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.2 KiB
4.2 KiB
Code Generation Plan — Unit 3: Contact page
Single source of truth for generating unit 3. Workspace: K:\Development\SlpSoftware\Projects\AndreaSlopFotografie-contact\web, branch feature/contact-page (on master a58bc1c + units 1–2).
Unit context
- Requirements: FR-CP-01..05, FR-CP-09..11, SEO-CP-01..05, NFR-CP-01, 03..06.
- Design: functional design (BR-CP-01..20); shared blocks from unit 2 (
ContactPanel,ContactDetails,PrivacyNote);webPage()from unit 1. - Source photo: the original of the live contact photo,
https://andreaslop.nl/wp-content/uploads/2024/10/WhatsApp-Image-2024-10-27-at-14.31.42.jpeg(1600×1067, landscape). The live page and the design use a 632×658 crop of it, too small for the desktop column. - Shared resources: "claim 4173" / "4173 free" with Portfolio-pagina around Lighthouse; no deploy to test without "claim test".
Steps
- Step 1 — Images (one-off scratchpad script, PowerShell/System.Drawing with EXIF orientation, as in earlier features; not a build dependency):
web/src/assets/contact/contact.jpg— 4:5 cover crop around Andrea, 840×1050, JPEG quality 80;web/src/assets/contact/contact-portret.jpg— square face crop, 144×144;web/public/og-contact.jpg— 1200×630 crop with her face in the upper third.- Show the three crops on one contact sheet for approval before they are fixed; draft the alt texts (photo: descriptive Dutch; preview: own alt in
sitePages).
- Step 2 — Content:
ContactPageContentincontent/types.ts;content/contactContent.tswith the head texts (intro with{reactietermijn}),formTitle,detailsTitle,image,portrait. - Step 3 —
lib/withReplyTime.ts+ test: examples and the 3 properties (BR-CP-05). - Step 4 — SEO:
contactPage()inseo.ts+ tests (examples, invariants, round trip);sitePages['/contact'](title, description,indexed: true,ogImage);lighthouserc.cjs/contact→indexedPaths(not a photo page);sitemap.test.tsexpects/contact. - Step 5 —
components/contact/ContactAside+ test:picturewith thelgmedia source and the transparent fallback, priority, intrinsic size, overlapping card slot; tests for the source/fallback markup, alt text, priority and the card slot, axe. - Step 6 — Route
routes/contact.tsx:validateSearch, head (page head + JSON-LD), intro with the reply time, the section per the component design, URL clean-up of?pakket=. Route tests (inapp.test.tsxor a route test file): head tags (title, description, no noindex, canonical,og:image, JSON-LD), heading outline, both cards present with their own ids, form section named,/contact?pakket=newbornpreselects and cleans the URL without moving focus, invalid value removed, axe. - Step 7 — Over mij links:
aboutContent.ts"neem contact op" and "Boek je shoot" →/contact; update the Over mij tests that expect/#contact. - Step 8 — LAYOUT.md: the "Contact" diagram per
.ai/layout-conventions.md(Intro full width; Contact form beside Photo with contact details). - Step 9 — Verify (Step 13.5):
pnpm test(no rtk filter),pnpm lint,pnpm format:check,pnpm build; a browser check on the production build that a 390 px viewport does not requestcontact.jpgand a 1280 px viewport does (with high priority); then "claim 4173" →pnpm lighthouse→ "4173 free"./contactmobile must reach 0.9; if not, stop and report the measurement and cause (BR-CP-17). - Step 10 — Code summary:
aidlc-docs/features/contact-page/construction/contact-page/code/code-summary.md. - Step 11 — Commit (after approval): code commit and docs commit; push. Offer a deploy to test for your review (only after "claim test" to Portfolio-pagina).
Extension compliance (plan level)
- Security: no new endpoints, scripts or CSP changes (
data:images already allowed); JSON-LD throughjsonLdScript, no e-mail;?pakket=validated and never rendered; external linksnoopener noreferrer— Compliant. - PBT: PBT-01/03/05 for
withReplyTimeandcontactPage, PBT-02 round trip, PBT-07/08/10 as before — Planned.