2.2 KiB
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. SiteSettingstable + migration,ISiteSettingsService,SiteSettingsController, Mail card (Owner edits, Administrator reads),emailEnabledanddefaultLanguagein system capabilities.- Config documentation (appsettings placeholders, env secrets
Email__Smtp__Username/Password, smtp4dev),Infrastructure Designfor 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. IIdentityMailServiceand its use in invite, regenerate, new resend action, deactivate/reactivate and role change; responsemailresult; 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-passwordand/reset-passwordpages.- 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.