Files
AndreaSlopFotografie/aidlc-docs/features/portfolio-page/inception/plans/application-design-plan.md
T
SluijsensandClaude Opus 5.5 b35b1c2404 Plans the portfolio page
Records the requirements, execution plan and application design for the
portfolio page: the ten live photos in a filterable masonry grid with an
accessible lightbox, filters per shoot type in the URL, the Instagram
block shared with the homepage, and an indexed page with image gallery
structured data. Built alongside the contact and shoot type pages, with
shared pieces split between them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 21:32:48 +01:00

7.1 KiB

Application Design Plan — Portfolio Page

Depth: standard. Business rules (filtering, wrap-around, lightbox states, masonry spans, ?shoot= parsing, gallery structured data) follow in Functional Design for units 2 and 3.

Plan

  • Answer the design questions below
  • Generate components.md — new and changed components with responsibilities and interfaces
  • Generate component-methods.md — props, hooks and pure function signatures
  • Generate services.md — composition in the route (there is no service layer in this SPA)
  • Generate component-dependency.md — dependency matrix, data flow, and where the peer commits slot in
  • Generate application-design.md — consolidated design
  • Validate completeness and consistency against requirements.md

Already decided (no question needed)

  • Names as claimed with the other sessions: PortfolioGrid, Lightbox, and InstagramGrid (moved). Despite the name, PortfolioGrid gets a generic API (a list of images, no knowledge of shoot types), so other pages can use it.
  • Gallery data for the components: the components work with a generic item, roughly { id, thumb: ContentImage, full: { src, width, height }, caption? }. The page maps its portfolio photos (with shootType) to that, taking the caption from shootLabel. So Lightbox and PortfolioGrid never import shoot types.
  • Portfolio content: content/portfolioContent.ts + a PortfolioContent / PortfolioPhoto type in content/types.ts; photos reference ShootTypeId only. Instagram content: content/instagramContent.ts + InstagramContent (split off from HomeContent); the homepage passes the same object.
  • URL state: ?shoot= is read through the route's validateSearch and checked by a pure function in lib/ against the shoot types that have photos, like packageFromSearch for ?pakket=. The route is the single source of truth for the active filter; it navigates to change it.
  • Lightbox on Chakra Dialog (focus trap, focus return, Escape, inert background and scroll lock come from Chakra/Ark); our part is the content, prev/next, counter, caption, swipe and preloading.
  • SEO: galleryImages(...)-style pure builders in seo.ts produce the ImageObject list; the route's head() combines pageHead('/portfolio') with one structuredDataScript(webPage('ImageGallery', '/portfolio', { associatedMedia })).

Vul per vraag de letter in na [Answer]:. Past geen enkele optie, kies dan de laatste (Anders) en licht toe.

Vraag 1: Hoe raster, lightbox en filter samenwerken

  • A) Drie losse onderdelen plus één pagina-onderdeel dat ze verbindt: PortfolioGrid toont foto's en meldt "foto X geopend"; Lightbox toont een lijst foto's vanaf een startpositie; de filterbalk meldt "filter gekozen". Een pagina-specifiek onderdeel in components/portfolio/ (bijvoorbeeld PortfolioGallery) bewaart welke foto open is en geeft het gefilterde lijstje aan beide door. Elk onderdeel is los te testen en los te hergebruiken, bijvoorbeeld een Lightbox bij de shootfoto's op Soorten fotoshoots (aanbevolen)
  • B) Raster met ingebouwde lightbox: PortfolioGrid opent zelf zijn Lightbox. Minder losse delen, maar de lightbox is dan niet zonder raster te gebruiken
  • C) Alles in de route opbouwen, zonder pagina-specifiek onderdeel
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 2: Hoe de filterbalk werkt (voor toetsenbord en screenreader)

  • A) Een groep schakelknoppen: elke knop is een tab-stop, de actieve heeft aria-pressed="true", en de groep heeft een naam ("Filter op soort shoot"). Eenvoudig en voorspelbaar (aanbevolen)
  • B) Een keuzerondjesgroep (radiogroup): één tab-stop, je kiest met de pijltjestoetsen. Compacter voor het toetsenbord, maar minder bekend voor wie het niet kent
  • C) Tabbladen (tablist): semantisch bedoeld voor wisselende inhoud in vaste panelen, wat hier niet helemaal past
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 3: Hoe de filterbalk eruitziet

Het ontwerp heeft geen filters, dus dit is nieuw.

  • A) Tekstlinks in labelstijl (zoals de eyebrows: kleine hoofdletters, ruime spatiëring), de actieve onderstreept in accent.deep. Rustig en past bij de typografie van de site; als nieuwe variant in een recipe (aanbevolen)
  • B) Omlijnde knoppen in de stijl van LinkButton outline, de actieve gevuld met de accentkleur. Duidelijker als "knoppen", maar zwaarder boven een fotoraster
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 4: Filter wisselen en de terugknop

  • A) Vervangen: wisselen van filter past de URL aan zonder een stap in de geschiedenis. De terugknop verlaat de pagina, ook na vijf keer wisselen (aanbevolen)
  • B) Toevoegen: elke filterwissel is een stap; de terugknop gaat terug naar het vorige filter
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 5: Vegen in de lightbox

De hero heeft al veeglogica, maar die zit vast in useHeroSlider.

  • A) Uit de hero halen naar een gedeelde hook (bijvoorbeeld useSwipe({ onPrev, onNext })) en die in de hero en de lightbox gebruiken. Eén plek voor drempel en gedrag; de hero blijft precies zo werken (aanbevolen)
  • B) De lightbox krijgt eigen veeglogica; de hero blijft ongemoeid
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 6: Techniek voor de masonry in rijvolgorde

  • A) Alleen CSS: een raster met hele kleine rijen, waarbij elke foto zoveel rijen beslaat als past bij zijn verhouding. Dat aantal rekent een losse functie uit met de breedte en hoogte uit de data, en de rijhoogte schaalt mee met de kolombreedte (container-eenheden). Geen meten in de browser, dus geen verspringen bij het laden (aanbevolen)
  • B) Meten met JavaScript: na het laden de echte hoogtes meten (ResizeObserver) en de foto's positioneren. Precies, maar het raster kan verspringen en het werkt pas als JavaScript draait
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Answer: A, als het later nodig kunnen we het alsnog ombouwen

Vraag 7: Lightbox-code apart laden

  • A) Apart laden: de code van de lightbox laadt pas zodra je een foto opent, of al vooruit als je met muis of focus op een foto komt. De eerste weergave van de pagina blijft lichter (helpt de prestatiescore) (aanbevolen)
  • B) Direct meeladen met de pagina. Eenvoudiger, de eerste keer openen is altijd direct
  • X) Anders (beschrijf hieronder na de Answer:-tag)

Vervolgvraag 6a: "A, als het later nodig"

Je antwoord op vraag 6 lijkt halverwege afgebroken. Wat bedoel je?

  • A) CSS-masonry nu; meten met JavaScript alleen als CSS later tekortschiet. Ik ontwerp de grid zo dat de berekening van de rijen op één plek zit, zodat die later vervangen kan worden zonder de rest aan te passen. Wat "tekortschiet" is, leg ik vast: zichtbare gaten groter dan één rij-eenheid, of verkeerd bijgesneden foto's in een browser die we ondersteunen (aanbevolen)
  • B) CSS-masonry, en verder niets voorbereiden. Als het later nodig is, bouwen we het dan om
  • X) Anders (beschrijf hieronder na de Answer:-tag)