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:
@@ -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
|
||||
@@ -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.
|
||||
|
||||
---
|
||||
+159
@@ -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]:
|
||||
Reference in New Issue
Block a user