From ab50d7dfba05366069f1f2fb3dcff14324e85f2b Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Sun, 15 Nov 2026 15:23:45 +0100 Subject: [PATCH] Docs: ci-master-pipeline en asf-host-injection (voorstel), active-features bijgewerkt Co-Authored-By: Claude Sonnet 5.5 --- aidlc-docs/active-features.md | 2 + .../features/asf-host-injection/plan.md | 44 +++++++++++++++++++ .../features/ci-master-pipeline/overview.md | 33 ++++++++++++++ 3 files changed, 79 insertions(+) create mode 100644 aidlc-docs/features/asf-host-injection/plan.md create mode 100644 aidlc-docs/features/ci-master-pipeline/overview.md diff --git a/aidlc-docs/active-features.md b/aidlc-docs/active-features.md index c13be5a..048bed3 100644 --- a/aidlc-docs/active-features.md +++ b/aidlc-docs/active-features.md @@ -20,4 +20,6 @@ | Feature | [Offering banners (offering-banners)](features/offering-banners/overview.md) | 🟡 Op test (buiten AI-DLC gebouwd en achteraf gedocumenteerd; admin-lijst met Locatie-badge op test sinds 2026-11-15) | feature/contact-forms-module | Modules.Offerings (banner met positie top/bottom), openapi, Frontend (admin Aanbiedingen > Banner) | 2026-11-12 | | Feature | [Offering schedule (offering-schedule)](features/offering-schedule/overview.md) | 🟡 Op test zodra CI-run 109 is uitgerold (buiten AI-DLC gebouwd en achteraf gedocumenteerd) | feature/contact-forms-module | Modules.Offerings (aan/uit en van/tot per pakket, `/offerings/all`), openapi, Frontend (admin pakketformulier en -lijst) | 2026-11-15 | | Feature | [Website SEO (website-seo)](features/website-seo/overview.md) | 🟡 Op SLP-test (buiten AI-DLC gebouwd en achteraf gedocumenteerd; productie vraagt `Website__NoIndex=false` en `Website__PublicBaseUrl`) | feature/contact-forms-module | Core (Hosting/Website), Modules.Offerings (index-markers), Api.SlpSoftware (appsettings) | 2026-11-11 | +| Feature | [CI bouwt en test alleen het master-CMS (ci-master-pipeline)](features/ci-master-pipeline/overview.md) | 🟡 Gepusht, eerste CI-run met de nieuwe workflow volgt (buiten AI-DLC gebouwd en achteraf gedocumenteerd) | feature/contact-forms-module | CI/CD (workflow, slnf, rooktest), Core (Website:Mode), Api (alle modules), Tests (ASF-testproject opgeheven) | 2026-11-15 | +| Feature | [ASF: host injecteert in voorgerenderde pagina's (asf-host-injection)](features/asf-host-injection/plan.md) | 🔵 Voorstel; bouwen wacht op Bryans akkoord en op .NET 10 op het hostingpakket | feature/contact-forms-module | Core (Hosting/Website), Modules.Offerings, docs | 2026-11-15 | | Bug | [theme-toggle-first-click](bugs/theme-toggle-first-click/bug-fix.md) | ✅ Complete (niet gecommit/gemerged; buiten AI-DLC gebouwd; oorzaak niet in een echte browser nagebootst) | feature/contact-forms-module | Frontend (useTheme, index.html) | 2026-11-15 | diff --git a/aidlc-docs/features/asf-host-injection/plan.md b/aidlc-docs/features/asf-host-injection/plan.md new file mode 100644 index 0000000..c5d56f7 --- /dev/null +++ b/aidlc-docs/features/asf-host-injection/plan.md @@ -0,0 +1,44 @@ +# Host injection into ASF's prerendered pages (asf-host-injection) + +- **Slug**: asf-host-injection +- **Type**: Feature, **proposal; not approved, build not started** +- **Status**: Plan agreed with the ASF session (their counterpart: `AndreaSlopFotografie-packages/aidlc-docs/features/asf-cms-host-injection/plan.md`, section "Host contract"). Bryan accepted the approach (neutral list first, styled cards after hydration; the host writes the list HTML) on 2026-11-15 but said **not to start building yet**: he first reads the plan and finds out whether .NET 10 can run on the hosting package (hosting bundle or self-contained). +- **Affected components (planned)**: `SlpModularCms.Core` (`Hosting/Website`: generalise `IndexHtmlInjector`, hook in `PrerenderedSiteMiddleware`), `SlpModularCms.Modules.Offerings` (marker providers), `scripts/smoke-site.sh`, docs +- **Documented**: 2026-11-15 +- **Documentation Language**: English +- **Conversation Language**: Dutch (user language) + +## Why + +Bryan's hosting package has one entry per website: the CMS host is that entry and serves the website, the prerendered pages and `/admin`. So ASF in production also runs entirely through Kestrel (IIS passes every request on, serves no static files and caches no HTML). Packages, banners and (later) gallery data can therefore be written into the prerendered HTML by the host: visible to crawlers within about a minute of a CMS change, without a nightly build. A rebuild webhook stays an option only for build-processed gallery images. + +## Host contract (agreed with ASF) + +All markers are found in one pass; a page without markers and without the authored address is still served as a plain static file. **Fail-open everywhere**: missing marker = nothing; invalid data or a provider failure = the baked page is served. + +| Marker | Host behaviour | +|---|---| +| `…` | Replace the content between the markers by a simple crawlable list from the live offerings (C# template following ASF's "Neutral HTML spec" and their golden files; everything HTML-encoded). The markers stay. | +| `…`, `…` | Same, from the live banner of that position as `