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

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.