# 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