Files
AndreaSlopFotografie/aidlc-docs/features/cms-api-foundation/inception/application-design/component-methods.md
T
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

3.2 KiB

Component Methods: cms-api-foundation

High-level signatures only. Business rules (exact canonicalisation, edge cases, error handling) are defined in Functional Design by the CMS session. Names are indicative; the CMS session may rename them.

C2. CmsHostOptions

public enum WebsiteMode { SpaFallback = 0, PrerenderedPages = 1 }

public sealed class CmsHostOptions
{
    public WebsiteMode WebsiteMode { get; init; } = WebsiteMode.SpaFallback;
}

C3a. PrerenderedPathResolver (pure)

public abstract record SiteResolution;
public sealed record ServeFile(string RelativePath, bool IsPage) : SiteResolution;   // IsPage drives cache policy
public sealed record RedirectTo(string CanonicalPath) : SiteResolution;              // 301, query added by caller
public sealed record NotFound() : SiteResolution;

public sealed class PrerenderedPathResolver
{
    public PrerenderedPathResolver(Func<string, bool> fileExists);
    public SiteResolution Resolve(PathString requestPath);   // total: never throws, never escapes the root
}

C3b. Middleware wiring

public static IApplicationBuilder UseCmsPrerenderedSite(this WebApplication app, CmsHostOptions options);
// - registered where UseCmsStaticContent registers the website mount
// - skips reserved prefixes: /admin, /api/v1, /health
// - NotFound -> serve 404.html with status 404 (plain 404 if 404.html is missing)

C3c. WebsiteCachePolicy

public static string CacheControlFor(SiteResolution resolution);   // pages: "no-cache"; /assets/*: long-lived immutable; other files: short default

C3d. WebsiteIndexingPolicy

public sealed class WebsiteOptions { public bool NoIndex { get; set; } }      // section "Website"
public static IEndpointRouteBuilder MapCmsRobots(this IEndpointRouteBuilder app, WebsiteOptions options);
// NoIndex: adds X-Robots-Tag header to website responses and answers /robots.txt "User-agent: *\nDisallow: /"

C4. CspPolicyCatalog

public const string StrictSite = "StrictSite";
public static SecurityHeaderSet Build(string policy, IEnumerable<string> scriptOrigins, IEnumerable<string> connectOrigins);
// StrictSite: script-src 'self' + scriptOrigins; connect-src 'self' + connectOrigins; FrameOptions "DENY".
// Strict and Relaxed unchanged. KnownPolicies includes StrictSite.

C1. Api.AndreaSlopFotografie/Program.cs

var orchestrator = CmsHost.ConfigureServices(builder, new CmsHostOptions { WebsiteMode = WebsiteMode.PrerenderedPages });
var app = builder.Build();
CmsHost.ConfigurePipeline(app, orchestrator, new CmsHostOptions { WebsiteMode = WebsiteMode.PrerenderedPages });

C5. Admin theme selection (build time)

VITE_THEME            -> frontend/themes/<name>/theme.css (+ logo, favicon); unset = default theme
VITE_DEFAULT_LANGUAGE -> "nl" | "en"; unset = current default
VITE_APP_TITLE        -> existing

C8. Deployment verification (shell, extends the existing script)

verify_csp_equals <url> <expectedCsp>     # expectedCsp generated from contentSecurityPolicy('production')
verify_status    <url> <expectedStatus>
verify_redirect  <url> <expectedLocation>
verify_header    <url> <name> <expectedValue|absent>