Files
AndreaSlopFotografie/aidlc-docs/features/cms-api-foundation/inception/requirements/requirement-verification-questions.md
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

7.7 KiB

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)