Redesign Modern/Tijdreis, contactformulier via CMS, taalbestanden #17
@@ -850,3 +850,27 @@
|
||||
**Context**: U5 review feedback.
|
||||
|
||||
---
|
||||
|
||||
## U6 SEO and performance: owner answers
|
||||
|
||||
**Timestamp**: 2026-11-11T16:00:00Z
|
||||
|
||||
**User Input**: "Dynamic parts: Nog onduidelijk. Freshness: Idealiter binnen minuten, maar de vraag is of dat lukt op de iis host. Test environments: robots + noindex-header. Lighthouse: Doe hetzelfde als ASF"
|
||||
|
||||
**AI Response**: "Recorded the five answers in unit-u6-seo-and-performance.md. Open points: the IIS remark most likely concerns the ASF site (SLP is served by the .NET CMS host); to be confirmed with the owner before planning."
|
||||
|
||||
**Context**: U6 inception, questions settled except dynamic scope.
|
||||
|
||||
---
|
||||
|
||||
## U6 SEO and performance: dynamic scope revised
|
||||
|
||||
**Timestamp**: 2026-11-11T16:30:00Z
|
||||
|
||||
**User Input**: "Ik wil trouwens mijn antwoord aanpassen. Ik wil voor SLP Software statische tekst hebben met onderdelen dynamisch zoals de pakketten. ASF hetzelfde, maar daar moet later ook een galerij dynamisch bij bijvoorbeeld en misschien dat nog later de teksten ook dynamisch worden, maar dat laatste hoeven we nu geen rekening mee te houden"
|
||||
|
||||
**AI Response**: "Updated answer 1 in unit-u6-seo-and-performance.md: static text, dynamic parts (packages; for ASF later a gallery); dynamic texts out of scope. Points to option E (hybrid)."
|
||||
|
||||
**Context**: U6 inception, scope question settled.
|
||||
|
||||
---
|
||||
|
||||
+37
@@ -0,0 +1,37 @@
|
||||
# U6 SEO and performance: plan (draft for approval)
|
||||
|
||||
Basis: owner answers in `inception/application-design/unit-u6-seo-and-performance.md` (option E, hybrid).
|
||||
|
||||
## Approach
|
||||
- **Static text** (hero, about, process, contact, variant-neutral copy): prerendered into `index.html` at build time (React `renderToString` of the default Variant B shell in a post-build script; the client hydrates). Variant E (easter egg) stays client-only and is not indexed content.
|
||||
- **Dynamic parts** (packages now, gallery later): the CMS host (WebsiteMode `SpaFallback` for SLP) injects current data into the served HTML (JSON-LD `Offer` list plus the package markup placeholder) per request with a short cache (target: fresh within minutes). The client still fetches `/api/v1/offerings` and takes over. If the host injection is not available yet, the page degrades to static text plus client-side packages (no breakage).
|
||||
- **Per-environment rules from the host, not the bundle**: test hosts serve `robots.txt` `Disallow: /` and `X-Robots-Tag: noindex`; production serves `robots.txt` with sitemap reference. No password protection.
|
||||
|
||||
## Work split
|
||||
| Part | Website repo | CMS repo (`slp-modular-cms`) |
|
||||
|---|---|---|
|
||||
| Prerender static HTML | build script, hydration, tests | - |
|
||||
| Meta: canonical, Open Graph, Twitter, favicon set, theme-color | `index.html` + build | host fills absolute URLs from the request host |
|
||||
| JSON-LD Organization / LocalBusiness | static in build | - |
|
||||
| JSON-LD offers + packages HTML injection | placeholder markers | host injection with cache |
|
||||
| `robots.txt`, `sitemap.xml`, `X-Robots-Tag` | - | host, per environment setting |
|
||||
| Performance: LCP image dimensions + `fetchpriority`, display-font preload, chunk budget | yes | cache headers for hashed assets |
|
||||
| Lighthouse gate (mobile + desktop, >= 0.9 per category, as ASF) | `lighthouserc*.cjs` + pipeline job on the built site | - |
|
||||
|
||||
## Steps
|
||||
1. Add NFR group "SEO and performance" to `requirements.md` (below) and get approval of this plan.
|
||||
2. Website: meta tags, favicon set, JSON-LD organisation, LCP and font preload.
|
||||
3. Website: prerender script + hydration; tests that the HTML contains hero/about/process/contact text and no duplicate ids.
|
||||
4. CMS (via CMS session): robots/sitemap/`X-Robots-Tag` per environment; packages + JSON-LD injection with short cache. Contract: marker comments in `index.html`.
|
||||
5. Website pipeline: Lighthouse job (mobile + desktop, hard gate 0.9), runs on any runner (`linux`).
|
||||
6. Verify on test: crawler view (`curl`), Lighthouse results, `noindex` header, CSP unchanged (no new third-party scripts).
|
||||
7. Production only on explicit owner go.
|
||||
|
||||
## Risks
|
||||
- Hydration mismatch between prerendered and client output (theme, variant, date): prerender only the default Variant B/light shell; theme applied after hydration.
|
||||
- Hash routing stays (single page); sitemap lists the one URL plus the privacy page if it gets a real URL.
|
||||
- Host injection needs CMS work and a deploy to both hosts; ASF has the same pattern later (gallery), so keep the marker contract generic.
|
||||
|
||||
## Open points for the owner
|
||||
- Is the privacy page to become a real URL (affects sitemap)? Currently hash route.
|
||||
- Domain used for canonical/OG on production: `https://slpsoftware.nl` (assumed).
|
||||
+7
@@ -33,5 +33,12 @@ Options to compare (none chosen):
|
||||
4. How should test environments be kept out of search results (robots, headers, auth)?
|
||||
5. Is a measured Lighthouse score a release gate?
|
||||
|
||||
## Answers of the product owner (2026-11-11)
|
||||
1. **Dynamic parts** (revised later on 2026-11-11, replaces "still unclear"): SLP Software has **static text with some dynamic parts such as the packages**. The Andrea Slop Fotografie site is the same, and will later get a dynamic gallery as well; texts becoming dynamic is a possibility further out and is **not** to be designed for now. This points to option E (hybrid): prerender the static text at build time, fill the dynamic parts (packages, later the gallery) from current data.
|
||||
2. **Who serves the HTML**: answered from the repo and the hosts, not by the owner. The SLP test host (and production, same application) serves the SPA through the .NET CMS host, so it can render HTML itself. The owner's remark about an IIS host concerns the Andrea Slop Fotografie site (IIS production hosting), not SLP Software: to be confirmed with the owner.
|
||||
3. **Freshness**: ideally within minutes. Whether that is achievable on an IIS host is the open point for the ASF site; for SLP the CMS host can render per request or on publish (option C or the dynamic half of E).
|
||||
4. **Test environments**: `robots.txt` with `Disallow: /` plus an `X-Robots-Tag: noindex` header on test hosts, served by the host (environment-specific), not baked into the shared bundle. No password protection.
|
||||
5. **Lighthouse**: same as the ASF site (`web/lighthouserc.cjs`, `lighthouserc.desktop.cjs`): measured in the pipeline on the built site, mobile and desktop, a hard gate with a minimum score of 0.9 per category; exceptions only with a recorded owner decision and a floor, per page.
|
||||
|
||||
## Requirements touched
|
||||
New NFR group "SEO and performance" to be added to `requirements.md` when the unit is planned. Security Baseline applies to any new header or script (CSP, no new third-party scripts).
|
||||
|
||||
@@ -46,6 +46,8 @@
|
||||
- **NFR-7 Maintainability**: theme tokens as CSS variables per variant × mode; Tailwind semantic color names remain; content stays in `content.ts`/API.
|
||||
- **NFR-8 Compatibility**: hash routing and static hosting remain; the existing Sentry/Umami integration and the CI/CD pipeline keep working.
|
||||
|
||||
- **NFR-9 SEO and performance (U6)**: static text is prerendered into the HTML at build; dynamic parts (packages, later gallery) are injected by the CMS host from current data, fresh within minutes; canonical, Open Graph/Twitter, favicon set, JSON-LD (organisation and offers), `robots.txt` and `sitemap.xml`; test hosts serve `Disallow: /` and `X-Robots-Tag: noindex` from the host, not the bundle; Lighthouse in the pipeline on mobile and desktop is a hard gate of at least 0.9 per category (exceptions only with a recorded owner decision); no new third-party scripts.
|
||||
|
||||
## Assumptions
|
||||
- Current copy and texts of the live site (incl. the November text update) are leading unless the design says otherwise.
|
||||
- The packages API keeps its current shape plus `category`; the CMS session implements it.
|
||||
|
||||
Reference in New Issue
Block a user