diff --git a/aidlc-docs/active-features.md b/aidlc-docs/active-features.md index 36736b6..8f628d1 100644 --- a/aidlc-docs/active-features.md +++ b/aidlc-docs/active-features.md @@ -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 | diff --git a/aidlc-docs/features/hero-module/aidlc-state.md b/aidlc-docs/features/hero-module/aidlc-state.md new file mode 100644 index 0000000..02e9dc7 --- /dev/null +++ b/aidlc-docs/features/hero-module/aidlc-state.md @@ -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 diff --git a/aidlc-docs/features/hero-module/audit.md b/aidlc-docs/features/hero-module/audit.md new file mode 100644 index 0000000..3848989 --- /dev/null +++ b/aidlc-docs/features/hero-module/audit.md @@ -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. + +--- diff --git a/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md b/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.md new file mode 100644 index 0000000..dc54e5d --- /dev/null +++ b/aidlc-docs/features/hero-module/inception/requirements/requirement-verification-questions.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 `` 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]: