From a1e740c5585aebe7d95745367a0032f27cb31419 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Mon, 16 Nov 2026 14:28:35 +0100 Subject: [PATCH] Hero-module: application design plan met zes ontwerpvragen Co-Authored-By: Claude Sonnet 5.5 --- aidlc-docs/features/hero-module/audit.md | 12 +++ .../plans/application-design-plan.md | 91 +++++++++++++++++++ 2 files changed, 103 insertions(+) create mode 100644 aidlc-docs/features/hero-module/inception/plans/application-design-plan.md diff --git a/aidlc-docs/features/hero-module/audit.md b/aidlc-docs/features/hero-module/audit.md index c04c90e..178458d 100644 --- a/aidlc-docs/features/hero-module/audit.md +++ b/aidlc-docs/features/hero-module/audit.md @@ -71,3 +71,15 @@ **Context**: Workflow Planning approved; Application Design. --- + +## Application Design plan + +**Timestamp**: 2026-11-16T00:00:00Z + +**User Input**: (no new input; continuing after plan approval) + +**AI Response**: Wrote application-design-plan.md with six design questions (storage, image formats, data block composition, media service location, admin crop UI, focus model), each with a recommendation. The data block `#cms-data` is currently written only by OfferingsHtmlTransform, so the hero key needs a shared composition point. + +**Context**: Application Design, waiting for answers. + +--- diff --git a/aidlc-docs/features/hero-module/inception/plans/application-design-plan.md b/aidlc-docs/features/hero-module/inception/plans/application-design-plan.md new file mode 100644 index 0000000..3bce734 --- /dev/null +++ b/aidlc-docs/features/hero-module/inception/plans/application-design-plan.md @@ -0,0 +1,91 @@ +# Application Design Plan: hero-module + +Vul per vraag de letter in na `[Answer]:`. Bij elke vraag staat mijn aanbeveling; "alle aanbevelingen" mag ook, dan vul ik die in. Het zijn technische keuzes waar ik een besluit van Bryan nodig heb omdat ze kosten, risico of werk voor de websites raken. + +## Wat al vaststaat (uit requirements en contract) + +- Eén module `SlpModularCms.Modules.Hero`; het CMS levert alleen inhoud; crop-model B (host snijdt `wide` 3:2 en `tall` 4:5 rond het focuspunt, focuspunt ook in de data); markers `CMS:HERO-HTML`, `CMS:HERO-PRELOAD` en sleutel `hero` in `#cms-data`; afbeeldingen op `/media/hero//…`, immutable; fail-open. +- Het bestaande blok `#cms-data` wordt nu volledig door `OfferingsHtmlTransform` geschreven (pakketten en banners). Het hero-deel moet in hetzelfde blok komen (afgesproken met ASF). + +## Plan (stappen) + +- [x] 1. Context geanalyseerd (requirements, contract, bestaande `HtmlMarkerInjector`/`IHtmlPageTransform`/`OfferingsHtmlTransform`) +- [ ] 2. Vragen hieronder beantwoord door Bryan +- [ ] 3. Antwoorden geanalyseerd op tegenstrijdigheden en vaagheid +- [ ] 4. `components.md` (componenten en verantwoordelijkheden) +- [ ] 5. `component-methods.md` (signaturen; bedrijfsregels volgen in Functional Design) +- [ ] 6. `services.md` (services en orkestratie) +- [ ] 7. `component-dependency.md` (afhankelijkheden, datastromen) +- [ ] 8. `application-design.md` (samenvatting) en consistentiecontrole +- [ ] 9. Goedkeuring van Bryan + +## Vragen + +### Vraag 1 — Waar bewaart de host de afbeeldingen? + +De bestanden moeten een deploy overleven (releases worden vervangen), in de back-up zitten en werken op de Pi én op IIS. + +- A) In de database (MariaDB, blobs; één plek voor back-up en herstel; geen schrijfrechten op een map nodig, handig op gedeelde hosting). Let op: de limiet `max_allowed_packet` van de database moet voor een upload van 10 MB hoog genoeg staan; dat controleer ik op beide testhosts. +- B) In een map buiten de release (bijvoorbeeld naast de app of in een gedeelde map), met alleen de metadata in de database. Vraagt Infrastructure Design en een aparte back-up van die map. +- C) Originelen in de database, varianten als cache in een map die opnieuw gemaakt kan worden. +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: + +### Vraag 2 — Welke afbeeldingsformaten leveren we? + +AVIF is vaak het punt waarop een bibliotheek of platform tegenvalt (win-x64 voor IIS, linux-arm64 op de Pi). De bibliotheek kiezen we in NFR Requirements met een korte proef; het ontwerp zet de verwerking achter een eigen koppeling, zodat de bibliotheek te wisselen is. + +- A) WebP en AVIF zijn beide verplicht; zonder AVIF-ondersteuning op een platform is de bibliotheek ongeschikt +- B) WebP is verplicht (met het originele formaat als terugval); AVIF komt erbij als de gekozen bibliotheek het op alle platformen kan, anders later +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: B. + +[Answer]: + +### Vraag 3 — Hoe komt het hero-deel in het blok `#cms-data`? + +Nu schrijft alleen de Offerings-module dit blok. Er moet één blok blijven (afspraak met ASF). + +- A) Core krijgt een koppeling waarmee elke module een sleutel aan het datablok toevoegt; de Offerings-module gebruikt die ook (uitvoer byte-identiek, de bestaande golden files blijven groen) en de Hero-module voegt `hero` toe +- B) De Hero-module leest het blok dat Offerings schreef en voegt `hero` toe (hangt van de volgorde af; kwetsbaar) +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: + +### Vraag 4 — Waar komt de beeldverwerking en het serveren van media? + +Er is al een plan voor een galerij (later), die dezelfde verwerking nodig heeft. + +- A) Alles in de Hero-module +- B) Een algemene, kleine mediadienst in Core (verwerking, opslag, serveren op `/media/…`), die de Hero-module gebruikt en een latere galerij ook kan gebruiken +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: B. + +[Answer]: + +### Vraag 5 — Hoe stelt de beheerder uitsnede en focus in? + +- A) Eigen lichte component in de admin: klik of sleep het focuspunt op de afbeelding, een zoomregelaar, en een live voorbeeld van `wide` en `tall`; geen extra pakket +- B) Een bestaand croppakket (bijvoorbeeld react-easy-crop) als dependency +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. + +[Answer]: + +### Vraag 6 — Wat legt de beheerder per afbeelding vast? + +- A) Eén focuspunt (x,y) en één zoomfactor, gedeeld door beide verhoudingen (`wide` en `tall`); de host berekent elke uitsnede rond dat punt +- B) Per verhouding een eigen focuspunt en zoom (meer vrijheid, meer werk voor de beheerder) +- X) Other (please describe after [Answer]: tag below) + +Aanbeveling: A. Per-verhouding-instellingen kunnen later zonder wijziging van het publieke contract, want de data bevat al per variant de verhouding. + +[Answer]: