Adds the functional design and code generation plan of unit 2, its code summary with the verification, the agreements with the parallel features, and updates the shared reverse engineering lines, the state and the audit log. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.7 KiB
6.7 KiB
API Documentation
REST APIs
None. There is no back-end yet (api/ is empty). The static design README anticipates these endpoints on a .NET API:
POST /api/contact— contact form, payload{ naam, email, onderwerp, bericht }(maps to a C#ContactRequestrecord)/api/pages,/api/portfolio,/api/packages— CMS content
Internal APIs
Routes (TanStack Router, file-based)
| Path | File | Head | Component | Indexed |
|---|---|---|---|---|
| (root) | routes/__root.tsx |
siteHead(siteContent) |
AppShell |
— |
/ |
routes/index.tsx |
pageHead('/') |
Hero + six home sections; search ?pakket= |
yes |
/over-mij |
routes/over-mij.tsx |
pageHead('/over-mij') + AboutPage JSON-LD |
PageIntro, AboutIntro, StorySection ×2, PhotoDuo, LinkButton |
yes |
/portfolio |
routes/portfolio.tsx |
pageHead(...) |
PageIntro placeholder |
no |
/soorten-fotoshoots |
routes/soorten-fotoshoots.tsx |
pageHead('/soorten-fotoshoots') + WebPage JSON-LD (webPage() + shootServices()) |
PageIntro, shoots/ShootList (5× ShootBlock), CallToAction, RichParagraph, LinkButton |
yes |
/contact |
routes/contact.tsx |
pageHead(...) |
PageIntro placeholder |
no |
/privacyverklaring |
routes/privacyverklaring.tsx |
pageHead(...) |
PageIntro placeholder |
no |
| (not found) | — | — | NotFound |
— |
seo.ts / sitePages.ts / sitemap.ts
pageHead(path: RoutePath)→{ meta, links }(title, description, robots noindex if not indexed, OG tags, canonical)siteHead(content: SiteContent)→{ meta, scripts }(OG basics, JSON-LD ProfessionalService)canonicalUrl(path, base?),jsonLdScript(data),structuredDataScript(data),professionalService(content)(with@idbusinessIdandfounder→personId),person(content, site, image),aboutPage(path, content, site)sitePages: Record<RoutePath, PageMeta>,pageList(pages)sitemapXml(...)— used byconfig/sitemapPlugin.ts
Components (props)
AppShell(),NavigationBar(),BackToTop(),NotFound()— no propsMobileNav({ id, open, onClose }),NavLink(RouterLink props)Footer({ content: SiteContent }),FooterColumn({ title, children }),FooterLink(LinkProps)Hero({ content: HeroContent, socials: SocialLink[] }),HeroArrows({ onPrev, onNext }),HeroPauseButton({ stopped, onToggle }),HeroSocials({ socials })PageIntro({ title, eyebrow?, children? })— renders the page's only h1PageSection({ labelledBy, id?, tone?: 'paper' | 'alt', width?: 'default' | 'narrow' | 'full', spacing?: 'default' | 'tight' | 'flushTop', 'data-testid'?, children })(wasHomeSection)MediaText({ image, aspectRatio, priority?, reverse?, frameColor?, 'data-testid'?, children })— framed photo next to a text column;reverseputs the photo right fromlg,frameColorcolours the block behind it (defaultsand)CallToAction({ title, titleId, lead?, 'data-testid'?, children })— closing block of a page: h2, lead, action, onpaper.altRichParagraph({ paragraph: RichText })— paragraph with inline links (moved fromabout/)Eyebrow(TextProps & { as?: 'p' | 'span' | 'h2' | 'h3' | 'h4' })— accent label, optionally a headingSectionHeading({ id, title, eyebrow?, lead?, align?: 'center' | 'start', spacing?: 'default' | 'compact', focusable? })— renders an h2FramedImage({ image: ContentImage, aspectRatio }),DeferredImage(ImageProps & { image, near? }),Reveal(BoxProps & { delay? })IntroGallery({ content }),AboutBlock({ content }),Pricing({ content, packages }),PriceCard(...),Testimonials({ content, testimonials }),ContactSection({ content, packages, enabled, email, pakket? }),InstagramGrid({ content, profileUrl })ContactForm(...),ContactFormGate({ enabled, email, ... })PhotoDuo({ photos: [ContentImage, ContentImage], label, 'data-testid'? })about/AboutIntro({ content }),about/StorySection({ content, titleId, tone?, spacing?, children? }),shoots/ShootList({ shoots, packages, portfolioLive }),shoots/ShootBlock({ shoot, packages, reverse, priority, portfolioLive })StatusPage({ title, children, actions? }),ErrorPage({ error, reset })LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })UmamiAnalytics({ hostname? })
Hooks
useHeroSlider(count)→ slider state, controls, handlers,HeroAnnouncementuseScrolledPast(getThreshold)→ boolean (stablegetThresholdrequired)useRouteFocus()— focuses<main>after navigationuseInView({ rootMargin, skip })→{ ref, inView };usePageLoaded()→ boolean;useReveal()→{ ref, visible }
Pure helpers (lib/)
emailAddress({ user, domain }): string | nullvisibleSocials(socials): SocialLink[]— only valid https linkscopyrightLine(year): stringslidesToLoad(active, count): number[]backToTopThreshold(viewportHeight): numberslideLabel,formatPrice,bookLabel,visiblePackages,visibleTestimonials,packageFromSearch,shootOptions,mailSubject/mailtoLink,validateField/validateContact,isLikelySpam,toContactPayload,contactFormReducer
Monitoring
monitoringFor(hostname): Monitoring | null,startSentry(hostname?),reportError(error)
Data Models
SiteContent (content/types.ts)
- Fields:
footerIntro: string,socials: SocialLink[],email: EmailAddress,contactForm: { enabled: boolean }
ContentImage
- Fields:
src,alt,width,height(intrinsic size, reserves space)
HomeContent
- Fields:
intro,about(eyebrow,title,paragraphs[],image,link: { label, to: RoutePath }),pricing,testimonials,contact,instagram
LinkTarget / InlineLink / RichText
- Fields:
{ to: RoutePath; hash? };InlineLinkaddstext;RichText = (string | InlineLink)[]
AboutPageContent
- Fields:
head,intro(eyebrow, title,paragraphs: RichText[], image),background,photos,personal,booking(label + LinkTarget),person(name, jobTitle, knowsAbout)
PricingPackage / Testimonial
- Fields:
id,name,price,features[]/id,shoot,quote,author,image
SocialLink
- Fields:
platform: SocialPlatform(facebook|instagram),href: string - Validation: shown only if
hrefis a valid https URL
EmailAddress
- Fields:
user,domain— assembled only in the browser; invalid parts → hidden
HeroContent
- Fields:
title,tagline,cta: { label, to },slides: { id, src, alt }[]
NavItem (navigation.ts)
- Fields:
to: RoutePath,label: string
PageMeta (sitePages.ts)
- Fields:
title,description,indexed,ogImage?