From 5f6d2b4bd2ee40e7a24e5243e20b93b03dbf34c4 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Mon, 16 Nov 2026 14:52:56 +0100 Subject: [PATCH] Hero-module: functional design plan (H1 t/m H5) met zes vragen Co-Authored-By: Claude Sonnet 5.5 --- aidlc-docs/features/hero-module/audit.md | 12 +++ .../plans/functional-design-plan.md | 92 +++++++++++++++++++ 2 files changed, 104 insertions(+) create mode 100644 aidlc-docs/features/hero-module/construction/plans/functional-design-plan.md diff --git a/aidlc-docs/features/hero-module/audit.md b/aidlc-docs/features/hero-module/audit.md index e1b93b4..649cdf5 100644 --- a/aidlc-docs/features/hero-module/audit.md +++ b/aidlc-docs/features/hero-module/audit.md @@ -119,3 +119,15 @@ **Context**: Construction, NFR Requirements input for H1. --- + +## Functional Design plan + +**Timestamp**: 2026-11-16T00:00:00Z + +**User Input**: "Master-run #121 (0824bfa, H0) is groen en deployde alleen naar test: publish-/deploy-sls-test, publish-/deploy-asf-test en beide rooktests success; publish-sls-production en deploy-sls-production skipped. De release/*-regel werkt. Verder met Functional Design / NFR Requirements." (relayed by SLP Software - SLS - Main) + +**AI Response**: H0 verified by the leader. Wrote functional-design-plan.md (bundled for H1 to H5) with six questions and the defaults I set without asking. + +**Context**: Functional Design planning; waiting for answers. + +--- diff --git a/aidlc-docs/features/hero-module/construction/plans/functional-design-plan.md b/aidlc-docs/features/hero-module/construction/plans/functional-design-plan.md new file mode 100644 index 0000000..40a0a05 --- /dev/null +++ b/aidlc-docs/features/hero-module/construction/plans/functional-design-plan.md @@ -0,0 +1,92 @@ +# Functional Design Plan: hero-module (units H1 tot en met H5) + +Gebundeld voor alle units, zodat Bryan één keer antwoordt. De uitkomst wordt per unit uitgewerkt in `construction//functional-design/` (bedrijfslogica, regels, entiteiten). Vul de letter in na `[Answer]:`, of "alle aanbevelingen". + +H0 is klaar (master-run #121 groen, alleen test). De bibliotheek is gekozen (Magick.NET, zie `h1-image-pipeline/nfr-requirements/library-proof.md`). + +## Plan + +- [x] 1. Context geladen (requirements, ontwerp, units, contract met ASF, golden files 13f78c4, bibliotheekproef) +- [ ] 2. Vragen hieronder beantwoord +- [ ] 3. Antwoorden geanalyseerd +- [ ] 4. H1 Beeldpijplijn: `business-logic-model.md`, `business-rules.md`, `domain-entities.md` +- [ ] 5. H3 Mediaopslag en -serving: idem +- [ ] 6. H2 Hero-backend: idem +- [ ] 7. H4 Injectie: idem, inclusief de byte-exacte HTML volgens de ASF-golden files +- [ ] 8. H5 Admin: `frontend-components.md`, schermen en validatie +- [ ] 9. Controle: elk FR/NFR gedekt; regels consistent over de units + +## Wat ik zonder vraag vastleg (zeg het als het anders moet) + +- Kwaliteit: WebP 80, AVIF 50, JPEG als terugval 82; bredere uitvoer dan de bron wordt niet gemaakt. +- Breedtes: `wide` 640, 960, 1280, 1600, 2560 en `tall` 480, 640, 960, 1280, alleen tot de breedte van de bron die na de uitsnede overblijft; er is altijd minstens één variant per verhouding (de grootste mogelijke). +- Een upload telt als één beeldset; een foto wordt nooit twee keer opgeslagen (dezelfde inhoud + focus geeft dezelfde set). +- Tekst is platte tekst; de host codeert bij het schrijven (HTML en JSON). Lengtes: titel 200 (max 5 regels), tagline 120, lead 600, knoplabel 50, doel 500, alt 300. +- Het publieke antwoord is er alleen als er een actieve hero met minstens één bruikbare slide of een titel is; anders 204. +- Beheer slaat de hele hero in één keer op (volledig vervangen, met de slidelijst en volgorde); afbeeldingen worden apart geüpload. + +## Vragen + +### Vraag 1 — Wat gebeurt er met een afbeelding die een slide nog gebruikt, bij verwijderen? + +- A) Het CMS weigert (409) met een duidelijke melding; eerst de slide verwijderen of een andere afbeelding kiezen +- B) Het CMS haalt de afbeelding van de slide af en laat de slide zonder afbeelding staan (die dan niet gepubliceerd wordt) +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. Dat voorkomt dat per ongeluk een slide uit de hero verdwijnt. + +[Answer]: + +### Vraag 2 — Hoe lang blijven oude afbeeldingsbestanden bestaan na een nieuwe focus of een vervangen foto? + +Een website die de oude data nog in de cache heeft, verwijst nog naar de oude adressen. + +- A) 7 dagen, daarna worden ze door een opschoontaak verwijderd +- B) Direct verwijderen +- C) 24 uur +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. Een paar dagen dekt browsercaches en gecachete prerender-pagina's; de opslag is klein. + +[Answer]: + +### Vraag 3 — Hoeveel slides mag een hero hebben? + +- A) Maximaal 12 +- B) Maximaal 8 (de huidige ASF-hero heeft er 8) +- C) Geen vaste grens, alleen de totale opslaglimiet +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. Ruimte boven de huidige 8 zonder dat de pagina te zwaar wordt. + +[Answer]: + +### Vraag 4 — Hoe gaan we om met HTML of speciale tekens in de teksten? + +- A) Toegestaan als platte tekst en altijd gecodeerd bij het schrijven (een `<` blijft zichtbaar als `<`; er komt nooit opmaak of script uit een tekstveld) +- B) Het CMS weigert tekens als `<` en `>` in de velden +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: + +### Vraag 5 — Wat toont de admin als de hero (nog) niet live is? + +- A) Een duidelijke melding bovenaan met de reden (buiten de planning, uitgezet, geen bruikbare slide, geen titel) en wat de sites dan tonen (de ingebakken hero) +- B) Alleen een kleine status-badge +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: + +### Vraag 6 — Wie mag een afbeelding uploaden? + +- A) Dezelfde rol als de hero wijzigen (Administrator en hoger); uploads zijn beperkt per gebruiker (bijvoorbeeld 20 per uur) +- B) Alleen de eigenaar +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: