Let users email personal reports on demand

2026-09-10 16:15:39 +12:00
parent 6e473fd0a7
commit b286ca3c42
13 changed files with 261 additions and 36 deletions
@@ -0,0 +1,22 @@
+# Personal report emails
+
+
+## On-demand personal reports
+
+Users can email the month shown on **My stats > Monthly report**, including the
+current month to date or any available previous month. Delivery uses the confirmed
+profile email and the existing private report generator. The API does not accept
+another user, recipient, or delivery kind. The request UUID is idempotent, and
+manual/test report requests share a five-minute per-user cooldown.
+
+**Profile > Your reports, your choice** offers on-demand-only delivery or on-demand
+plus automatic monthly emails. New confirmations default to on-demand-only;
+existing confirmed subscribers retain their previous automatic monthly preference.
+Turning automatic delivery off cancels pending scheduled emails, but preserves
+verified-email consent and explicitly requested emails. A full unsubscribe, email
+change, identity change or blocked account prevents pending personal delivery.
+
+On-demand requests work while the monthly schedule is paused, provided SMTP,
+Jellystat and the delivery worker are available. Delivery status is available to
+the requesting user and in the admin recap history. New-arrivals newsletters are
+unchanged and keep their independent subscriptions and schedule.