Hero-module: unit-of-work plan met vier vragen
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
@@ -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]:
|
||||
Reference in New Issue
Block a user