Files
slp-modular-cms/aidlc-docs/features/hero-module/inception/plans/unit-of-work-plan.md
T

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 IImageProcessor maakt 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-Api en beide sites (Api.SlpSoftware en Api.AndreaSlopFotografie) vanaf H2; Api.Slave niet. 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-Api en Api.AndreaSlopFotografie nu; 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.