AIDLC-documentatie voor andreaslop-site-hosting (U1 tot en met Code Generation)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
+63
@@ -0,0 +1,63 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user