4.6 KiB
Unit of Work Plan: hero-module
Vul per vraag de letter in na [Answer]: (of "alle aanbevelingen"). Dit is een enkele service (de CMS-host) met één nieuwe module en een uitbreiding van Core; "units" zijn dus bouwonderdelen, geen aparte services. De units H0 tot en met H6 komen uit het uitvoeringsplan en het ontwerp; hieronder staan de keuzes over volgorde en oplevering.
Voorstel (uit het ontwerp)
| Unit | Inhoud | Hangt af van |
|---|---|---|
| H0 | CI: release/* voor SLP-productie. Klaar (PR #16, 0824bfa) |
- |
| H1 | Beeldpijplijn in Core.Media: proef met bibliotheken, IImageProcessor, uploadwacht, FocusMath, VariantPlanner, MediaPaths |
- |
| H3 | Mediaopslag en -serving: IMediaStore, FileSystemMediaStore, /media/…-endpoint, opties, snelheidsbegrenzing |
H1 (adressen) |
| H2 | Hero-module backend: tabellen en migratie, beheer-API, publieke GET /hero, validatie, planning, teksten, OpenAPI |
H1, H3 |
| H4 | Host-injectie: CmsDataBlockTransform + ICmsDataBlockContributor, Offerings omzetten (byte-identiek), HeroHtmlTransform (regio + preload), golden files van ASF |
H2 |
| H5 | Admin-frontend: hero-formulier, slides, upload, focus-editor met voorbeeld | H2, H3 |
| H6 | Seed-script, docs/hero-module.md, rooktest, productie-checklist, LCP-meting op beide testhosts |
H2 tot H5 |
Plan (stappen)
- 1. Eenheden afgeleid uit uitvoeringsplan en ontwerp
- 2. Vragen hieronder beantwoord (2026-11-16, alle aanbevelingen)
- 3. Antwoorden geanalyseerd: geen vaagheid of tegenstrijdigheid
- 4.
unit-of-work.md(definities en verantwoordelijkheden, codeorganisatie) - 5.
unit-of-work-dependency.md(afhankelijkheden, bouwvolgorde) - 6.
unit-of-work-story-map.md(user stories zijn overgeslagen: de requirements-ID's FR/NFR worden aan units gekoppeld) - 7. Grenzen en afhankelijkheden gecontroleerd; alle FR/NFR hebben een unit
Vragen
Vraag 1 — Hoe leveren we op naar master?
H0 is al los gemerged.
- A) Eén pull request voor H1 tot en met H6, pas gemerged na Bryans acceptatie op de testhosts; tussendoor deployen we de featurebranch niet automatisch (de leader dispatcht test-deploys)
- B) In stappen: eerst H1+H3 (media), dan H2+H4 (module en injectie), dan H5+H6, elk met een eigen pull request en groene checks
- X) Other (please describe after [Answer]: tag below)
Aanbeveling: A. De sites hebben markers, module en admin samen nodig om iets te zien; stapsgewijs mergen levert niets zichtbaars op en vergroot het aantal reviews.
[Answer]: A. Eén PR voor H1 t/m H6, pas gemerged na Bryans acceptatie op de testhosts.
Vraag 2 — Wanneer de eerste test-deploy?
- A) Na H1 tot en met H4 (API, media en injectie werken; de seed vult de hero via de beheer-API of het script), zodat de ASF- en SLS-sessies al kunnen integreren; H5 (de admin) volgt daarna
- B) Pas als alles incl. H5 klaar is
- X) Other (please describe after [Answer]: tag below)
Aanbeveling: A. Dat ontsluit het werk van de sites één stap eerder en laat de LCP en het contract vroeg meten.
[Answer]: A. Eerste test-deploy na H1 t/m H4; H5 volgt.
Vraag 3 — Hoe pakken we de bibliotheekproef aan (onderdeel van H1 en NFR Requirements)?
De proef vergelijkt ImageSharp, NetVips, Magick.NET en SkiaSharp op: invoerformaten (incl. heic, avif, tiff), WebP- en AVIF-uitvoer, geheugen en snelheid met een 10 MB-foto, licentie, en werking op win-x64, linux-x64 (CI) en linux-arm64 (Pi).
- A) Lokaal op win-x64 en in een linux-arm64-container (emulatie) op deze machine; de echte Pi bevestigt het pas bij de eerste test-deploy. Als de bibliotheek daar faalt, schakel ik terug naar de volgende kandidaat (de koppeling
IImageProcessormaakt dat klein) - B) Eerst een aparte testrun op de Pi, voordat we de bibliotheek vastleggen (kost extra tijd en een handmatige stap van Pi-Main)
- X) Other (please describe after [Answer]: tag below)
Aanbeveling: A.
[Answer]: A. Lokaal op win-x64 en in een linux-arm64-container; de echte Pi bevestigt het bij de eerste test-deploy.
Vraag 4 — Welke projecten verwijzen naar de Hero-module?
- A) De master-
Apien beide sites (Api.SlpSoftwareenApi.AndreaSlopFotografie) vanaf H2;Api.Slaveniet. Het werkt pas zichtbaar als een site de markers gebruikt, dus mergen naar test heeft geen effect op pagina's zonder markers - B) Alleen de master-
ApienApi.AndreaSlopFotografienu; SLP volgt pas als SLS de markers heeft - X) Other (please describe after [Answer]: tag below)
Aanbeveling: A (zelfde regel als Offerings; SiteContractTests leggen de samenstelling vast).
[Answer]: A. Master-Api en beide sites verwijzen vanaf H2; de Slave niet.