Hero-module: feature gestart (Workspace Detection, Requirements-vragen voor Bryan)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-16 11:53:39 +01:00
co-authored by Claude Sonnet 5.5
parent b2cacfe551
commit 026e6cb6c6
4 changed files with 239 additions and 0 deletions
+1
View File
@@ -24,3 +24,4 @@
| Feature | [ASF: host injecteert in voorgerenderde pagina's (asf-host-injection)](features/asf-host-injection/plan.md) | ✅ Gebouwd en op test (afgesloten 2026-11-16; ASF-productie op IIS is een apart, later plan) | feature/contact-forms-module | Core (Hosting/Website), Modules.Offerings, docs | 2026-11-15 |
| Feature | [Vertaalbestanden backend (translation-files)](../docs/translation-files.md) | ✅ Afgesloten 2026-11-16 (stappen 1-8, docs; buiten AI-DLC gebouwd; goedgekeurd door Bryan via SLS-Main; productie via de checklist) | feature/contact-forms-module | Core (Texts, Email, Identity, Hosting), Modules.Availability, Modules.Offerings | 2026-11-15 |
| Bug | [theme-toggle-first-click](bugs/theme-toggle-first-click/bug-fix.md) | ✅ Complete (niet gecommit/gemerged; buiten AI-DLC gebouwd; oorzaak niet in een echte browser nagebootst) | feature/contact-forms-module | Frontend (useTheme, index.html) | 2026-11-15 |
| Feature | [Hero module (hero-module)](features/hero-module/aidlc-state.md) | 🔵 Inception (Requirements: vragen aan Bryan) | feature/hero-module | Modules (new Hero), Core (Hosting/Website, host injection), CI (release/-regel voor SLS-productie), Frontend (admin) | 2026-11-16 |
@@ -0,0 +1,54 @@
# AI-DLC State Tracking
## Project Information
- **Feature Name**: Hero module (manageable hero for SLP Software and Andrea Slop Fotografie)
- **Feature Slug**: hero-module
- **Project Type**: Brownfield
- **Start Date**: 2026-11-16
- **Current Stage**: INCEPTION - Requirements Analysis (clarifying questions sent, waiting for answers)
- **Branch**: feature/hero-module (worktree K:\Development\Projects\SlpModularCms-contact-forms, from master b2cacfe)
## Workspace State
- **Existing Code**: Yes
- **Reverse Engineering Needed**: No full rerun (artifacts exist in `_shared/reverse-engineering/`; targeted review of Offerings banners, host injection and website hosting instead)
- **Workspace Root**: K:\Development\Projects\SlpModularCms
## Code Location Rules
- **Application Code**: Workspace root `src/` and `frontend/` (NEVER in aidlc-docs/)
- **Feature Documentation**: aidlc-docs/features/hero-module/ only
- **Shared Artifacts**: aidlc-docs/_shared/
## Language Configuration
- **Documentation Language**: English
- **Conversation Language**: User Language (Dutch)
- **Note**: Inherited from the other features in this workspace.
## Source Of Truth / Coordination
- Requested by Bryan via the session "SLP Software - SLS - Main" (2026-11-16). Starting points of Bryan: hero texts/image manageable in the CMS, immediately visible (NFR-10), but the hero LCP (image/text) must be in the first HTML (prerender / host injection), otherwise LCP regresses. Both sites (SLS and ASF) use it.
- NFR-10 (SLS requirements): CMS content is live; baked or host-injected HTML for crawlers plus a client refresh; on failure the baked version stays.
- Included in this feature (agreed 2026-11-16): align the SLS CI pipeline with ASF: production deploy only from a `release/*` branch (`startsWith(github.ref, 'refs/heads/release/')` on `publish-sls-production` and `deploy-sls-production`). The SLS site side is done by the SLS session.
- No merge, production deploy or production variables without Bryan's explicit go.
## Extension Configuration
| Extension | Enabled | Decided At |
|---|---|---|
| Security Baseline | Pending | Requirements Analysis (question in the questions file) |
| Property-Based Testing | Pending | Requirements Analysis (question in the questions file) |
## Operations Configuration
- **Include Operations Phase**: Undecided
- **Decided At**: Pending - asked at Requirements Analysis
## Stage Progress
### 🔵 INCEPTION PHASE
- [x] Workspace Detection (classification: Feature)
- [x] Reverse Engineering (skipped: targeted review)
- [ ] Requirements Analysis (questions asked, waiting for answers)
- [ ] User Stories
- [ ] Workflow Planning
- [ ] Application Design
- [ ] Units Generation
### 🟢 CONSTRUCTION PHASE
- [ ] Not started
### 🟡 OPERATIONS PHASE
- [ ] Undecided
+25
View File
@@ -0,0 +1,25 @@
# Audit Log - hero-module
## Workspace Detection (initial request)
**Timestamp**: 2026-11-16T00:00:00Z
**User Input**: "Daarna: start een nieuwe aidlc-feature voor de Hero als beheerbare CMS-module (naam bv. hero-module). Uitgangspunten van Bryan: Hero-teksten/-afbeelding beheerbaar vanuit het CMS, direct zichtbaar (NFR-10), maar de Hero-LCP (afbeelding/tekst) moet in de eerste HTML staan (prerender / host-injectie), anders gaat de LCP achteruit. Beide sites (SLS en ASF) gebruiken het. Begin met Workspace Detection/Requirements en stel de vragen aan mij; de statische teksten die nog niet door Bryan zijn bekeken nemen we daar mee. Ook als apart idee voor later (nog niet starten): feature voor een IIS-publish-pipeline voor ASF productie (self-contained win-x64, FTP, web.config, CMS-host als enige entry)." (cross-session message from "SLP Software - SLS - Main", relaying Bryan)
**AI Response**: Classified as Feature (new capability). Brownfield; no full reverse engineering rerun. Created feature folder, state and questions file.
**Context**: Workspace Detection complete; Requirements Analysis started.
---
## Pipeline alignment agreed
**Timestamp**: 2026-11-16T00:00:00Z
**User Input**: "Extra voor die feature (Bryan): trek de SLS-pipeline gelijk aan die van ASF (bv. productie alleen vanaf een release/-branch); dat voeren we in de Hero-feature door, geen aparte feature." and "Akkoord: ASF gebruikt `startsWith(github.ref, 'refs/heads/release/')`, dus branchnaam `release/*` (bv. `release/2026-11-20` of `release/1.0`, de naam na release/ is vrij). Neem die conditie op bij publish-sls-production en deploy-sls-production in de Hero-feature." (relayed by SLP Software - SLS - Main)
**AI Response**: Added to the feature scope (CMS repo side only: the two production jobs get the release-branch condition).
**Context**: Scope decision, recorded in aidlc-state.md.
---
@@ -0,0 +1,159 @@
# Vragen over de Hero-module
Vul per vraag de letter in na `[Answer]:`. Past geen enkele optie, kies de laatste (Other) en beschrijf het. Opmerking per vraag mag ook achter de letter.
**Wat er nu is:** de Hero van SLP Software is vaste tekst in de website-code (`Hero.tsx` en `content.ts`: kleine kop, grote kop in drie regels, lead, twee knoppen, een "code-regel"). Er is geen afbeelding. De Hero van ASF is nog niet bekeken voor deze vragen; als die een afbeelding heeft, komt dat in vraag 4 terug. De host kan al stukken van de pagina's invullen vanuit het CMS (pakketten, banners) via markers in de HTML, en dat is de route die we voor de Hero ook gebruiken.
## Vraag 1 — Hoeveel heroes per site?
- A) Eén hero per site (een vaste plek die je bewerkt)
- B) Meerdere heroes per site, waarvan er één tegelijk actief is (bijvoorbeeld seizoensgebonden), met aan/uit
- C) Meerdere heroes die op een rooster wisselen (carrousel)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 2 — Welke teksten en knoppen moeten beheerbaar zijn?
- A) Kop, subkop/lead en maximaal twee knoppen (label + link)
- B) Zoals A, plus een kleine kop erboven (eyebrow) en de grote kop in meerdere regels (zoals "Websites," / "apps" / "& meer.")
- C) Zoals B, plus de "code-regel" van SLP Software als vrij tekstveld
- D) Alleen kop en subkop; knoppen blijven in de website-code
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 3 — Hoe worden de teksten per site en per taal bewaard?
- A) Eén taal per site (Nederlands); de site-eigenaar vult het in
- B) Nederlands en Engels per hero, beide in het CMS in te voeren
- C) Eén taal nu, maar het datamodel moet later talen kunnen toevoegen zonder migratie van bestaande data
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 4 — Heeft de hero een afbeelding?
- A) Nee, alleen tekst (SLP Software zoals nu)
- B) Optioneel: een hero kan een afbeelding hebben, met verplichte alt-tekst (of expliciet "decoratief")
- C) Verplicht per hero, met alt-tekst
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 5 — Hoe komt de afbeelding in het CMS? (alleen als vraag 4 niet A is)
- A) Upload in het CMS; de host bewaart het bestand en maakt automatisch varianten (verschillende breedtes, WebP/AVIF) voor snelle mobiele weergave
- B) Upload in het CMS; de host bewaart alleen het origineel (geen varianten); de website schaalt met CSS
- C) Geen upload: het CMS bewaart alleen een adres naar een afbeelding die in de website-build zit
- D) Niet van toepassing (vraag 4 = A)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 6 — Hoe moet de LCP in de eerste HTML komen?
De host schrijft de hero (tekst, afbeelding, knoppen) in de HTML voordat die naar de browser gaat: voor tekst als gewone elementen, voor een afbeelding met een `<link rel="preload">` in de kop, `width`/`height`, `fetchpriority="high"` en een `srcset`. Na het laden verfrist de website de hero uit de API (NFR-10); als dat mislukt blijft de ingebakken versie staan.
- A) Ja, zo (host-injectie voor beide sites; de ingebakken tekst blijft als terugval als het CMS niet bereikbaar is)
- B) Zoals A, maar de hero in de ingebakken HTML hoeft alleen bij de volgende bouw van de website bijgewerkt te worden (geen injectie in de eerste HTML)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 7 — Hoe snel moet een wijziging zichtbaar zijn?
- A) Zoals banners en pakketten nu: binnen ongeveer een minuut (60 seconden cache, direct vernieuwd bij elke wijziging in het CMS)
- B) Direct, zonder cache, bij elke bezoeker
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 8 — Concept en publiceren
- A) Opslaan is publiceren (zoals bij pakketten en banners)
- B) Er is een concept: eerst opslaan als concept, een voorbeeld bekijken, dan publiceren
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 9 — Planning (van/tot)
- A) Geen planning: een hero is aan of uit
- B) Wel planning (van/tot), zoals bij pakketten en banners; buiten de periode valt de site terug op de standaard-hero
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 10 — Wie mag de hero wijzigen?
- A) Administrator en hoger (zoals pakketten en banners)
- B) Alleen de eigenaar (Owner)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 11 — Waar komt de code?
- A) Een eigen module `SlpModularCms.Modules.Hero` (met tests), aan of uit per site, zoals Offerings en Contact
- B) Binnen de bestaande Offerings-module (hero naast pakketten en banners)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 12 — Wat doen we met de statische teksten die jij nog niet hebt bekeken?
Er zijn vaste teksten in de websites (hero, secties van de landingspagina) die nog niet door jou zijn gelezen. Jij vroeg ze in deze feature mee te nemen.
- A) Alleen de hero-teksten: jij leest die en geeft de definitieve tekst; die komt als startinhoud (seed) in het CMS
- B) Hero én de andere secties van de landingspagina lezen/herschrijven in deze feature, maar alleen de hero gaat naar het CMS; de rest blijft vaste tekst
- C) Hero én de andere secties lezen, en later een algemene "blokken"-module voor al die teksten (apart plan; in deze feature alleen de hero)
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 13 — Start-inhoud (seed)
- A) Een script zoals `Seed-Offerings.ps1` zet de huidige teksten van SLP Software en ASF als eerste hero in het CMS van de testomgeving; productie vullen we pas bij de release
- B) De eigenaar vult de hero zelf in via de admin na uitrol
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 14 — Als het CMS leeg of onbereikbaar is
- A) De ingebakken hero uit de website-build blijft staan (geen lege hero), zoals in NFR-10
- B) Het CMS is leidend: zonder hero in het CMS wordt de hero-sectie weggelaten
- X) Other (please describe after [Answer]: tag below)
[Answer]:
## Vraag 15 — Beveiligingsregels (extensie)
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor deze feature? (Het gaat om een afbeelding-upload, invoer van beheerders en HTML die de host schrijft.)
- A) Ja — dwing alle BEVEILIGINGSREGELS af als blokkerende vereisten (aanbevolen voor productietoepassingen)
- B) Nee — sla alle BEVEILIGINGSREGELS over (geschikt voor PoC's, prototypes en experimentele projecten)
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]:
## Vraag 16 — Property-based testing (extensie)
- A) Ja — dwing alle PBT-regels af als blokkerende vereisten
- B) Gedeeltelijk — alleen voor pure functies en serialisatie round-trips (bijvoorbeeld HTML-codering van hero-teksten)
- C) Nee — sla alle PBT-regels over
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]:
## Vraag 17 — Operations-fase
Moet deze feature na Construction door de Operations-fase (uitrol en monitoring inrichten)? De gezamenlijke productie-checklist (`docs/release-checklist-productie.md`) bestaat al en wordt in dat geval aangevuld.
- A) Ja — Operations-fase draaien
- B) Nee — stoppen na Build and Test; de hero-punten komen in de gezamenlijke productie-checklist
- C) Nog niet zeker — vraag het opnieuw na Construction
- X) Other (please describe after [Answer]: tag below)
[Answer]: