# Application Design Plan: hero-module Vul per vraag de letter in na `[Answer]:`. Bij elke vraag staat mijn aanbeveling; "alle aanbevelingen" mag ook, dan vul ik die in. Het zijn technische keuzes waar ik een besluit van Bryan nodig heb omdat ze kosten, risico of werk voor de websites raken. ## Wat al vaststaat (uit requirements en contract) - Eén module `SlpModularCms.Modules.Hero`; het CMS levert alleen inhoud; crop-model B (host snijdt `wide` 3:2 en `tall` 4:5 rond het focuspunt, focuspunt ook in de data); markers `CMS:HERO-HTML`, `CMS:HERO-PRELOAD` en sleutel `hero` in `#cms-data`; afbeeldingen op `/media/hero//…`, immutable; fail-open. - Het bestaande blok `#cms-data` wordt nu volledig door `OfferingsHtmlTransform` geschreven (pakketten en banners). Het hero-deel moet in hetzelfde blok komen (afgesproken met ASF). ## Plan (stappen) - [x] 1. Context geanalyseerd (requirements, contract, bestaande `HtmlMarkerInjector`/`IHtmlPageTransform`/`OfferingsHtmlTransform`) - [x] 2. Vragen hieronder beantwoord door Bryan (2026-11-16, via SLS-Main) - [x] 3. Antwoorden geanalyseerd: geen tegenstrijdigheid; Q2 en Q6 verbreden de requirements (zie requirements.md, aangepast) - [x] 4. `components.md` (componenten en verantwoordelijkheden) - [x] 5. `component-methods.md` (signaturen; bedrijfsregels volgen in Functional Design) - [x] 6. `services.md` (services en orkestratie) - [x] 7. `component-dependency.md` (afhankelijkheden, datastromen) - [x] 8. `application-design.md` (samenvatting) en consistentiecontrole - [ ] 9. Goedkeuring van Bryan ## Vragen ### Vraag 1 — Waar bewaart de host de afbeeldingen? De bestanden moeten een deploy overleven (releases worden vervangen), in de back-up zitten en werken op de Pi én op IIS. - A) In de database (MariaDB, blobs; één plek voor back-up en herstel; geen schrijfrechten op een map nodig, handig op gedeelde hosting). Let op: de limiet `max_allowed_packet` van de database moet voor een upload van 10 MB hoog genoeg staan; dat controleer ik op beide testhosts. - B) In een map buiten de release (bijvoorbeeld naast de app of in een gedeelde map), met alleen de metadata in de database. Vraagt Infrastructure Design en een aparte back-up van die map. - C) Originelen in de database, varianten als cache in een map die opnieuw gemaakt kan worden. - X) Other (please describe after [Answer]: tag below) Aanbeveling: A. [Answer]: B. Een MAP buiten de release (niet de database). Opslag komt achter een eigen koppeling zodat database-opslag later kan; risico's en gevolgen in het ontwerp; Bryan wordt opnieuw gevraagd als de proef op de hosting (MijnHostingPartner, IIS) tegenvalt. ### Vraag 2 — Welke afbeeldingsformaten leveren we? AVIF is vaak het punt waarop een bibliotheek of platform tegenvalt (win-x64 voor IIS, linux-arm64 op de Pi). De bibliotheek kiezen we in NFR Requirements met een korte proef; het ontwerp zet de verwerking achter een eigen koppeling, zodat de bibliotheek te wisselen is. - A) WebP en AVIF zijn beide verplicht; zonder AVIF-ondersteuning op een platform is de bibliotheek ongeschikt - B) WebP is verplicht (met het originele formaat als terugval); AVIF komt erbij als de gekozen bibliotheek het op alle platformen kan, anders later - X) Other (please describe after [Answer]: tag below) Aanbeveling: B. [Answer]: Invoer: zoveel mogelijk formaten (jpg/jpeg, png, webp en waar de bibliotheek het kan gif, bmp, tiff, heic/avif), met echte typecontrole en metadata strippen. Uitvoer: het systeem kiest per platform (WebP verplicht, AVIF als het kan). ### Vraag 3 — Hoe komt het hero-deel in het blok `#cms-data`? Nu schrijft alleen de Offerings-module dit blok. Er moet één blok blijven (afspraak met ASF). - A) Core krijgt een koppeling waarmee elke module een sleutel aan het datablok toevoegt; de Offerings-module gebruikt die ook (uitvoer byte-identiek, de bestaande golden files blijven groen) en de Hero-module voegt `hero` toe - B) De Hero-module leest het blok dat Offerings schreef en voegt `hero` toe (hangt van de volgorde af; kwetsbaar) - X) Other (please describe after [Answer]: tag below) Aanbeveling: A. [Answer]: A. Core-koppeling waarmee elke module een sleutel aan het datablok toevoegt; Offerings gebruikt die ook (byte-identieke uitvoer, groene golden files). ### Vraag 4 — Waar komt de beeldverwerking en het serveren van media? Er is al een plan voor een galerij (later), die dezelfde verwerking nodig heeft. - A) Alles in de Hero-module - B) Een algemene, kleine mediadienst in Core (verwerking, opslag, serveren op `/media/…`), die de Hero-module gebruikt en een latere galerij ook kan gebruiken - X) Other (please describe after [Answer]: tag below) Aanbeveling: B. [Answer]: B. Algemene mediadienst in Core. ### Vraag 5 — Hoe stelt de beheerder uitsnede en focus in? - A) Eigen lichte component in de admin: klik of sleep het focuspunt op de afbeelding, een zoomregelaar, en een live voorbeeld van `wide` en `tall`; geen extra pakket - B) Een bestaand croppakket (bijvoorbeeld react-easy-crop) als dependency - X) Other (please describe after [Answer]: tag below) Aanbeveling: A. [Answer]: A. Eigen lichte component. ### Vraag 6 — Wat legt de beheerder per afbeelding vast? - A) Eén focuspunt (x,y) en één zoomfactor, gedeeld door beide verhoudingen (`wide` en `tall`); de host berekent elke uitsnede rond dat punt - B) Per verhouding een eigen focuspunt en zoom (meer vrijheid, meer werk voor de beheerder) - X) Other (please describe after [Answer]: tag below) Aanbeveling: A. Per-verhouding-instellingen kunnen later zonder wijziging van het publieke contract, want de data bevat al per variant de verhouding. [Answer]: Standaard het midden voor alle verhoudingen; per verhouding (tall/mobiel, ook wide) kan optioneel een apart focuspunt worden ingesteld, anders terugval op het algemene punt (midden).