Files
slp-modular-cms/aidlc-docs/features/andreaslop-site-hosting/inception/application-design/component-dependency.md
T

2.9 KiB

Component Dependencies - andreaslop-site-hosting

Dependency matrix (row depends on column)

Core hosting Security (CSP) Identity Frontend CI/CD
C2 WebsiteMode -
C3 Site serving uses uses (headers precede it)
C4 StrictSite -
C1 Andrea client references configures references consumes built admin built by
C5 Theme - selected by
C7 Setup token - (in module) setup page
C6 CI/CD builds -
  • C3a (pure resolver) depends on nothing but System; the predicate is injected. This keeps property-based testing trivial and keeps traversal safety in one testable place.
  • Api and Api.SlpSoftware depend on Core only through unchanged defaults (WebsiteMode.SpaFallback, empty site origin lists, no setup token configured).
graph TD
    opts["CmsHostOptions.WebsiteMode (C2)"]
    host["CmsHost / StaticContentExtensions"]
    mw["PrerenderedSiteMiddleware (C3c)"]
    res["WebsitePathResolver (C3a, pure)"]
    wopt["WebsiteOptions (C3b)"]
    csp["CspPolicyCatalog + SecurityHeadersOptions (C4)"]
    sethdr["SecurityHeadersMiddleware"]
    ident["Identity: SetupController + ISetupTokenValidator (C7)"]
    client["Api.AndreaSlopFotografie (C1)"]
    fe["frontend theme + setup page (C5, C7)"]
    ci["Gitea workflows (C6)"]

    host --> opts
    host --> mw
    mw --> res
    mw --> wopt
    host --> sethdr
    sethdr --> csp
    client --> host
    client --> ident
    client --> csp
    fe --> ident
    ci --> client
    ci --> fe

    classDef core fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
    classDef pure fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
    classDef newc fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
    classDef ext fill:#d6bcfa,stroke:#553c9a,stroke-width:1px,color:#000;
    class opts,host,mw,wopt,sethdr,csp core;
    class res pure;
    class client,ident,fe newc;
    class ci ext;

Text alternative: the host wires the options, the site middleware and the security-header middleware; the middleware depends on the pure resolver; the Andrea client references host and Identity and configures the policy; the frontend and CI build the client.

Communication patterns

  • In-process only; no new network calls from the host.
  • Website to API: browser calls same-origin /api/v1 where needed; Sentry and Umami origins are called directly by the site (listed in StrictSite).
  • Configuration is the only coupling between a client and a policy: DefaultPolicy, PathPolicies, AllowedSite*Origins, Website:NoIndex, Identity:Setup:Token.

Delivery coupling (website files)

wwwroot/web is owned by the website delivery (web CI or a symlink to /mnt/storage1/www/html/andreaslop-test); the host only reads it. Because pages are resolved per request without cache (Q2=A), both delivery variants work without restart.