149 lines
7.7 KiB
Markdown
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
|