pal-e-docs

Account Email Delivery

story-landscaping-assistant-account-email User Story

active user-story
Project

story: Account Email Delivery

Role

Landscaping app user (all roles — client, crew member, crew lead, admin)

Key

account-email

Want

As a landscaping app user, I want to receive password reset and email verification emails

So That

So that I can recover my account if I forget my password and verify my email address during registration

Acceptance Criteria

  • Clicking "Forgot Password?" on the Keycloak login page sends a reset email to the user's address
  • Password reset email arrives within 60 seconds
  • Reset link in email works and allows setting a new password
  • Email verification works for new registrations (if registration is enabled)
  • Emails send from noreply@landscaping-assistant.app and do not land in spam

Success Metric

100% of password reset requests result in delivered email (verified via Postmark Activity feed)
  • arch:keycloak — Keycloak realm SMTP config
  • arch:iac — Postmark server provisioning + DNS records in pal-e-platform
  • board-landscaping-assistant — project board
  • pal-e-services/docs/postmark-email.md — procedure documentation
  • Precedent: ISS realm SMTP (pal-e-services#174, pal-e-platform#517)
  • Apple App Store rejection (July 2, 2026) — password reset flow must work for resubmission