93 lines
4.2 KiB
Markdown
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]:
|