Files
slp-modular-cms/aidlc-docs/features/hero-module/inception/application-design/unit-of-work.md
T

3.3 KiB

Units of work: hero-module

One deployable service (the CMS host); the units are build parts with their own tests. Delivery: one pull request for H1 to H6, merged only after Bryan accepts the result on the test hosts (decision 2026-11-16). The first test deploy comes after H1 to H4; H5 follows.

Code organisation (brownfield, existing layout)

Area Location
Media service src/SlpModularCms.Core/Media/ (+ tests in SlpModularCms.Core.Tests/Media/)
Data block and injection src/SlpModularCms.Core/Hosting/Website/ (+ tests in SlpModularCms.Core.Tests/Hosting/)
Hero module src/SlpModularCms.Modules.Hero/ and src/SlpModularCms.Modules.Hero.Tests/ (new projects, in the solution folders Application/Modules and Tests/Modules, added to SlpModularCms.Ci.slnf)
Offerings change src/SlpModularCms.Modules.Offerings/Services/
Master and sites src/SlpModularCms.Api, Api.SlpSoftware, Api.AndreaSlopFotografie (module reference, committed defaults, SiteContractTests); not Api.Slave
Admin frontend/src/features/hero/
Scripts, docs scripts/Seed-Hero.ps1, docs/hero-module.md, docs/release-checklist-productie.md, scripts/smoke-site.sh, openapi/slpsoftware.v1.json

Units

Unit Responsibility Main artifacts Per-unit stages
H0 (done) release/* rule for SLP production workflow, docs (PR #16, 0824bfa) none
H1 Image pipeline Library proof and choice; IImageProcessor, IMediaUploadGuard, ImageRejectedException, pure FocusMath, VariantPlanner, MediaPaths; limits and options Core/Media/*, tests incl. property tests, image fixtures Functional Design, NFR Requirements (proof), NFR Design, Code Generation
H3 Media store and serving IMediaStore, FileSystemMediaStore, /media/... endpoint, rate-limit policy, startup check of the directory, options Core/Media/*, host registration Functional Design, Infrastructure Design (directory outside the release, backup, permissions), Code Generation
H2 Hero module backend Entities, migration, repositories, HeroService, HeroImageService, PublicHeroService, controllers, ButtonTargetValidator, texts, OpenAPI Modules.Hero, tests Functional Design, Code Generation
H4 Injection ICmsDataBlockContributor, CmsDataBlockTransform, Offerings contributor (byte-identical), HeroHtmlTransform, HeroPictureRenderer, ASF golden files (13f78c4) Core/Hosting/Website, Modules.Hero, Modules.Offerings, golden files Functional Design, Code Generation
H5 Admin Hero screen, slide list, upload, focus editor with previews, TypeScript focusMath twin frontend/src/features/hero Functional Design, Code Generation
H6 Delivery Seed script (test), docs, smoke test, checklist, LCP measurement, OpenAPI snapshot scripts, docs Code Generation, Build and Test

NFR Requirements and NFR Design run for H1 and H3 (library, limits, upload safety, storage) and, for the LCP budgets, for H4. Security Baseline and property-based (partial) rules apply as recorded in the requirements.

Build order

  1. H1 (library proof first), 2. H3 (needs H1 for addresses), 3. H2, 4. H4, then first test deploy and integration with the ASF and SLS sessions, 5. H5, 6. H6.