Files
slp-modular-cms/aidlc-docs/features/identity-email-notifications/inception/application-design/unit-of-work.md
T

2.2 KiB

Units of Work - identity-email-notifications

Order: U1, then U2, then U3. Hand-back and approval after each unit. Each unit runs Code Generation with its own build and test; functional and NFR design are light and recorded in the unit's code summary.

U1 mail-foundation

  • Core: IEmailSender, SmtpEmailSender, NullEmailSender, EmailOptions + start-up validation, MailSendResult, IMailTemplateRenderer + nl/en resources + shared layout, ILanguageResolver, fake sender for tests.
  • SiteSettings table + migration, ISiteSettingsService, SiteSettingsController, Mail card (Owner edits, Administrator reads), emailEnabled and defaultLanguage in system capabilities.
  • Config documentation (appsettings placeholders, env secrets Email__Smtp__Username/Password, smtp4dev), Infrastructure Design for the host.
  • Tests: option validation, sender behaviour with an in-process SMTP stub, renderer (encoding, header injection, fallback), settings (allowlist, roles), PBT-02/03/07/08/09 targets for renderer and validator.

U2 identity-mail-flows

  • Migration: Users.PreferredLanguage, Invitations.Language. Profile language select; login applies the user's language.
  • IIdentityMailService and its use in invite, regenerate, new resend action, deactivate/reactivate and role change; response mail result; invite dialog language and result; resend action in the users list.
  • Tests: each mail kind with the fake sender; failure never fails the action; hierarchy for resend; language fallback chain; migration up/down on MariaDB; UI tests.

U3 password-reset

  • forgot-password / reset-password, Identity default token provider (lifetime configurable, default 60 minutes), ResetCooldown, revocation of refresh tokens on completion only, stamp in access tokens (decision D2), login link, /forgot-password and /reset-password pages.
  • Tests: request leaves password, stamp and sessions untouched; completed reset revokes refresh tokens, old password fails, token single-use; identical responses for known and unknown addresses; cooldown; rate limiter wired; PBT for link round trip.

Dependencies

U2 needs U1 (sender, renderer, capabilities). U3 needs U1 and U2 (language column, mail service). No unit changes behaviour for a host without mail configuration.