64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
# 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).
|
|
|
|
```mermaid
|
|
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.
|