Files
slp-modular-cms/aidlc-docs/features/hero-module/construction/plans/functional-design-plan.md
T

93 lines
4.2 KiB
Markdown

# 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/<unit>/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]: