2.9 KiB
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. ApiandApi.SlpSoftwaredepend 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/v1where needed; Sentry and Umami origins are called directly by the site (listed inStrictSite). - 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.