diff --git a/aidlc-docs/features/hero-module/audit.md b/aidlc-docs/features/hero-module/audit.md index 1700e7f..1dd5712 100644 --- a/aidlc-docs/features/hero-module/audit.md +++ b/aidlc-docs/features/hero-module/audit.md @@ -95,3 +95,15 @@ **Context**: Application Design complete; waiting for approval. --- + +## Application Design approved; Units Generation plan + +**Timestamp**: 2026-11-16T00:00:00Z + +**User Input**: "Bryan heeft het Application Design van de Hero-module goedgekeurd (2026-11-16, 47fcaeb). Ga door met Units Generation, Functional Design, NFR Requirements (incl. de beeldbibliotheek-proef op win-x64 en linux-arm64, AVIF/licentie) en NFR Design. Stel vragen aan Bryan via mij." (relayed by SLP Software - SLS - Main) + +**AI Response**: Wrote unit-of-work-plan.md with four questions (delivery, first test deploy, library proof approach, project references), each with a recommendation. + +**Context**: Units Generation planning; waiting for answers. + +--- diff --git a/aidlc-docs/features/hero-module/inception/plans/unit-of-work-plan.md b/aidlc-docs/features/hero-module/inception/plans/unit-of-work-plan.md new file mode 100644 index 0000000..51f7f70 --- /dev/null +++ b/aidlc-docs/features/hero-module/inception/plans/unit-of-work-plan.md @@ -0,0 +1,71 @@ +# 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) + +- [x] 1. Eenheden afgeleid uit uitvoeringsplan en ontwerp +- [ ] 2. Vragen hieronder beantwoord +- [ ] 3. Antwoorden geanalyseerd +- [ ] 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]: + +### 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]: + +### 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]: + +### 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]: