Files
SluijsensandClaude Sonnet 5.5 288b0e3838
Continuous Integration / check (pull_request) Successful in 1m50s
Continuous Integration / deploy-test (pull_request) Skipped
Continuous Integration / lighthouse (pull_request) Successful in 8m50s
Continuous Integration / deploy-production (pull_request) Skipped
Adds the AI-DLC documents of the CMS and API foundation feature
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-08 02:06:00 +01:00

149 lines
7.7 KiB
Markdown

# Vragen bij de requirements: cms-api-foundation
Vul achter elke `[Answer]:` de letter van je keuze in. Past geen enkele optie, kies dan de laatste (Anders) en licht je keuze toe. Bij elke vraag staat welke optie ik aanbeveel en waarom.
**Wat deze feature is:** de basis waarop Andrea's site straks op de SlpModularCms draait. Dus: een eigen client-project voor Andrea (zoals `Api.SlpSoftware`), een vast thema per site, een instelbare set modules per site, en de CMS-host die zowel de admin als de geprerenderde site serveert. Pakketten, contactformulier, testimonials en shoot-pagina's zijn aparte, latere features.
**Vaste uitgangspunten, hierover hoef je niets te beslissen** (uit je antwoorden):
- Meerdere sites = één deployment en één database per site; de modules per site bepaal je met de DLL-referenties van de client (aangepast in het ontwerp).
- Het thema staat vast per site en wordt niet in de admin aangepast.
- De CMS-host serveert admin (`/admin`), API (`/api/v1`) en de site (`/`); er is maar ruimte voor één website op de host.
- Dit werk raakt de bestanden van de Testimonials-sessie niet.
## Vraag 1
Wat hoort er in deze feature bij het "de CMS serveert de site" deel aan de kant van deze (web)repo?
- A) Alleen de CMS-kant: een brief en bewaking van het resultaat. De omschakeling van de huidige hosting (nginx test, IIS productie) en de CI van de site volgt in een eigen feature.
- B) CMS-kant én de web-kant: de site-build wordt bij de deploy in `wwwroot/web/` van de CMS-host gezet, de CI van de web-repo wordt daarop aangepast en op test is de omschakeling bewezen. Aanbevolen: de feature is pas af als de keten werkt, en de web-kant is klein.
- C) CMS-kant plus web-kant tot en met productie.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 2
Hoe moet de CMS-host de geprerenderde pagina's serveren? Nu is er een SPA-fallback: een pad zonder extensie (`/over-mij`) krijgt `index.html`. Onze build maakt per pagina een eigen HTML-bestand, en een onbekend pad moet de echte 404-pagina met status 404 krijgen.
- A) De host krijgt een "geprerenderde site"-modus: eerst `{pad}.html` of `{pad}/index.html`, anders de 404-pagina met status 404. Aanbevolen: dit geeft de bezoeker de snelle HTML en de SEO-winst van de prerendering echt.
- B) De bestaande SPA-fallback blijft: elke pagina laadt `index.html` en React rendert daarna. Dan verdwijnt het voordeel van de prerendering.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A (prerender-modus nu). User note: wants SSR eventually to be independent of the build pipeline; asked whether Node runs on mijnhostingpartner.nl (unknown, to be checked by the user). Decision: prerender-modus now, SSR vs hybrid decided before the first content feature.
## Vraag 3
De site heeft nu strenge beveiligingsheaders (CSP uit `web/config/securityHeaders.ts`). De CMS geeft de site standaard het mildere `Relaxed`-beleid.
- A) De CMS-host krijgt een instelling waarmee het client-project de CSP voor `/` zelf kan bepalen, en Andrea's client gebruikt dezelfde strenge CSP als nu. Aanbevolen: geen beveiligingsachteruitgang bij de omschakeling.
- B) We accepteren het `Relaxed`-beleid voor de site.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 4
Hoe wordt het thema per site vastgelegd?
- A) In het client-project (configuratie of een vast bestand), dat de API aanbiedt; de admin leest het bij het opstarten en zet het als CSS-variabelen. Eén admin-build voor alle sites. Aanbevolen.
- B) Een aparte admin-build per site met het thema ingebakken.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: X: admin build per site where only a theme file is specified (user proposal; styling does not belong in the API). Theme files live in the CMS repo, selected at build time, no theme API.
## Vraag 5
Wat moet het thema per site kunnen bepalen?
- A) Kleuren (de bestaande tokens), hoekafronding, lettertype, logo/app-naam en favicon. Aanbevolen: genoeg om aan te sluiten op Andrea's site, zonder overbodige vrijheid.
- B) Alleen kleuren en logo/app-naam.
- C) Alles uit A plus eigen CSS per site.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 6
Welke modules staan voor Andrea aan in deze feature? (Master is voor het beheren van andere CMS-instanties; Availability hoort bij de master-status.)
- A) Alleen wat voor een werkende admin nodig is (Identity en wat de CMS-host verplicht stelt); `Offerings` staat uit. Zo bewijst het verschil met SlpSoftware dat de schakelaar werkt. Aanbevolen.
- B) Identity plus `Offerings` aan, zodat de pakketten-feature er direct op kan aansluiten.
- C) Alles aan, net als de bestaande Api-host.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A (this feature = step 0; Offerings is switched on in the packages feature)
## Vraag 7
Wie zijn de gebruikers van Andrea's CMS in deze feature?
- A) Zoals nu: een eerste beheerder via de setup-flow en daarna uitnodigingen. Geen nieuwe rollen. Aanbevolen: auth bestaat al en hoeft hier niet opnieuw ontworpen.
- B) Er komen rollen bij (bijvoorbeeld beheerder en alleen-lezen).
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 8
Welke taal heeft de admin standaard voor Andrea? De admin kent NL en EN.
- A) Nederlands standaard, Engels blijft kiesbaar; de standaardtaal wordt per site vastgelegd. Aanbevolen.
- B) Engels standaard, zoals nu.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 9
Op welke omgevingen komt Andrea's CMS-instantie in deze feature?
- A) Eerst alleen test (de Pi, via de bestaande Gitea-deploy van de CMS-repo); productie volgt als de keten bewezen is. Aanbevolen.
- B) Test en productie.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 10
Hoe werk ik met de CMS-sessie (`AndreaSlopFotografie`) samen?
- A) Hybride: web-vragen beantwoord ik zelf uit de repo en het design. Beslissingen over CMS-interne zaken, security en datamodel leg ik aan jou voor. Jij keurt de requirements en het ontwerp van de CMS-kant goed. Aanbevolen.
- B) Ik beantwoord alles wat ik uit de context kan afleiden, houd een besluitenlijst bij en jij keurt alleen het eindresultaat goed.
- C) Alle vragen van de CMS-sessie gaan naar jou.
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A
## Vraag 11: Beveiligingsextensies
Moeten de beveiligingsregels als harde vereisten worden afgedwongen voor dit project?
- 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]: A
## Vraag 12: Property-Based Testing Extensie
Moeten de property-based testing (PBT) regels worden afgedwongen voor dit project?
- A) Ja: dwing alle PBT-regels af als blokkerende vereisten (aanbevolen voor projecten met bedrijfslogica, datatransformaties, serialisatie of stateful componenten)
- B) Gedeeltelijk: dwing PBT-regels alleen af voor pure functies en serialisatie round-trips (geschikt voor projecten met beperkte algoritmische complexiteit)
- C) Nee: sla alle PBT-regels over (geschikt voor eenvoudige CRUD-applicaties, UI-only projecten of dunne integratielagen zonder significante bedrijfslogica)
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: B
## Vraag 13: Operations-fase
Moet deze feature na de Construction-fase door de Operations-fase (deployment en monitoring inrichten)?
- A) Ja: voer de Operations-fase uit na Construction (deployment en monitoring)
- B) Nee: stop na Build and Test (deployment en monitoring vallen buiten deze feature)
- C) Nog niet zeker: vraag het me opnieuw na de Construction-fase
- X) Anders (beschrijf hieronder na de [Answer]:-tag)
[Answer]: A