Files
slp-modular-cms/aidlc-docs/features/contact-forms-module/inception/application-design/unit-of-work.md
T
SluijsensandClaude Sonnet 5.5 bc763c8ef6 Aanbod: RESTful routes zonder /admin, één OfferingDto en herordenen via PUT /offerings/order
Admin en bezoeker gebruiken dezelfde resource; alleen GET is anoniem, de rest vereist AdminOnly. OfferingAdminDto vervalt (displayOrder zit nu in OfferingDto), move-up/move-down zijn vervangen door de order-route die een onbekende of onvolledige lijst met 400 afwijst. De admin-frontend en alle tests zijn mee aangepast.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-10 13:06:08 +01:00

3.2 KiB

Units of Work — contact-forms-module

Naming: CMS-U1..CMS-U6 (the SLS frontend plan has its own U1..U5). One feature branch feature/contact-forms-module, one commit minimum per unit, sequential. Each unit: Code Generation plan => approval by Redesign - SLS => code + tests + automatic build/test => status.

Unit Name Phase Depends on New/changed projects Migration
CMS-U1 offerings-category 1 none Modules.Offerings (+Tests) AddOfferingCategory (Offerings context)
CMS-U2 gate-and-limiter 1 none (marks offerings GET from U1's controller) Core, Modules.Availability (+Tests), Core.Tests/Api.Tests none
CMS-U3 contact-core 1 U2 NEW Modules.Contact, NEW Modules.Contact.Tests, Api.SlpSoftware (reference), solution file InitialCreate (Contact context)
CMS-U4 contact-admin-api 1 U3 Modules.Contact (+Tests) none (maybe an index)
CMS-U5 contact-mail 2 ASF merge + rebase; U3, U4 Modules.Contact, Core/Email use (new MailKind), Api.AndreaSlopFotografie reference AddContactMailFields only if not already in InitialCreate (preferred: fields exist from U3)
CMS-U6 admin-ui 2 ASF merge + rebase; U4 frontend/ (new files + menu entry) none

Per-unit boundaries (what is NOT touched)

  • U1: no Core, no Availability, no Email; only Offerings files and its migration/tests.
  • U2: only AddCmsRateLimiting/OnRejected in Core, the marker attribute file, and AvailabilityMiddleware (minimal diff); no policy numbers changed; no Email, Identity, host config.
  • U3: no changes to existing modules except the .csproj reference in Api.SlpSoftware, the .sln, and appsettings sample keys; no Core/Email; no Identity.
  • U4: only Modules.Contact.
  • U5/U6: after merge; Email code of the ASF session is used, never edited (new MailKind only).

Test projects

  • SlpModularCms.Modules.Contact.Tests mirrors the module (xUnit as the other test projects). Solution layout: module under Application/Modules, tests under Tests/Modules (per CLAUDE.md).
  • PBT (partial): validator and token round-trips, using the repo's available property-testing library if present, otherwise parameterised generators; decided in Functional Design of U3.

Order and gates

U1 -> U2 -> U3 -> U4 (each approved before start). After Bryan merges the ASF branch: rebase, regenerate migrations only if snapshots conflict, then U5 -> U6.

Revision 2026-11-09 (Bryan via Redesign - SLS)

  • New CMS-U0 offerings-restful-routes (Phase 1, first): no /admin segments; plan in construction/plans/cms-u0-....
  • CMS-U1 offerings-category revised: categories are CMS data (table + FK + CRUD routes), no Offerings:Categories config, no seeding.
  • New CMS-U1b offerings-categories-ui: categories sub-section + select in OfferingForm (after U1).
  • Availability POST admin/status -> PUT /availability/status: Phase 2 (after the ASF merge), new unit CMS-U7 availability-restful-status.
  • Admin routes of Contact follow the RESTful scheme (no /admin): GET/PATCH/DELETE /contact-messages[/{id:guid}], POST /contact-messages/{id:guid}/resend. Application-design § 2 is superseded accordingly.
  • Order: U0 -> U1 -> U1b -> U2 -> U3 -> U4 | merge | U5 -> U6 -> U7.