2.1 KiB
2.1 KiB
Tech Stack Decisions - andreaslop-client (U2)
| # | Decision | Rationale |
|---|---|---|
| T1 | New project SlpModularCms.Api.AndreaSlopFotografie (net10.0, Microsoft.NET.Sdk.Web), thin Program.cs on CmsHost with WebsiteMode.PrerenderedPages; same package references as Api.SlpSoftware, only the modules it needs |
Brief; no new packages |
| T2 | Modules: Core + Identity; Master and Offerings not referenced (capabilities must not list Offerings); Availability decided in Code Generation by checking whether the admin needs it |
Brief D1/D9 |
| T3 | Setup token: SetupOptions + ISetupTokenValidator in Modules.Identity; comparison via CryptographicOperations.FixedTimeEquals on SHA-256 digests |
Constant time, no length leak, in-box API |
| T4 | Rate limiting: reuse the login fixed-window policy via [EnableRateLimiting("login")] |
Q3 = A; existing, tested mechanism |
| T5 | Theme: plain CSS custom properties in frontend/themes/asf/theme.css, imported through a build-time Vite alias driven by VITE_THEME; fonts, logo and favicon as theme assets |
No new dependency; Q5 = B |
| T6 | Language default: VITE_DEFAULT_LANGUAGE read in i18n init |
Existing i18next setup |
| T7 | CI: new jobs publish-asf-test and deploy-asf-test in continuous_integration.yaml, gated by the Gitea variable ASF_TEST_DEPLOY_ENABLED; reuse deploy-scp.yaml unchanged |
Q1, Q2; NFR-DEP-02 |
| T8 | Gitea variables for ASF (non-secret): DEPLOY_PATH_ASF_TEST, SERVICE_NAME_ASF_TEST, HEALTH_CHECK_URL_ASF_TEST, ASF_TEST_DEPLOY_ENABLED; the SSH secrets PI_MAIN_* are the existing ones |
Mirrors the existing pattern |
| T10 | Forwarded headers: built-in ForwardedHeadersMiddleware, options from section ForwardedHeaders (KnownProxies), registered only when configured; limiters re-registered with AddPolicy and RateLimitPartition.Get*Limiter keyed on the client address |
Option B; in-box APIs, no new packages |
| T9 | Tests: xUnit + FluentAssertions + FsCheck.Xunit (test-only) for the validator and controller; Vitest for the setup page and theme/i18n; Api.Tests on MariaDB for regression |
Existing frameworks |