Preferences / Subscriptions: PRD

Domain Notifications · function preferences · mã story NOTIF-PREF · SDD · Tests

Hiện trạng: phần lớn đã xây (14.10.2026). Huỷ một chạm, danh sách chặn, và từ Nhịp thư có thêm trang tuỳ chọn có chữ ký, không cần đăng nhập (nhịp, nhóm thư, đồng ý ưu đãi) và đăng ký lại. Trang tuỳ chọn TRONG tokyo và chọn theo kênh vẫn chưa có.

User story

NOTIF-PREF-01: huỷ nhận thư gắn kết bằng một cú bấm

Là thành viên, tôi muốn bấm link huỷ ở chân thư mà không phải đăng nhập, để thôi nhận thư nhắc.

• Given một thư gắn kết When tôi bấm link huỷ Then tôi thấy trang xác nhận cùng khung với thư (GET không ghi gì, vì máy quét link của doanh nghiệp tải mọi link trong thư); bấm nút "Huỷ nhận thư" (POST) thì tôi không nhận thư gắn kết nữa.
• Given Gmail gửi POST huỷ một chạm (RFC 8058: u, t ở query, không cookie) When endpoint nhận Then huỷ được ghi ngay, trả 200 HTML không chuyển hướng; ghi hỏng thì trả 503.

NOTIF-PREF-02: không ai huỷ hộ người khác

• Given một link huỷ với user_id bị sửa hoặc chữ ký sai When gọi endpoint huỷ Then trang báo "không hợp lệ", không ghi gì.

NOTIF-PREF-03: thư giao dịch không bao giờ bị chặn

• Given tôi đã huỷ nhận When hệ gửi login_code hay biên nhận tiền Then thư vẫn được gửi.

NOTIF-PREF-04: nhớ địa chỉ không nhận được

Là người vận hành, tôi muốn hệ nhớ địa chỉ bị nhà cung cấp chặn vĩnh viễn, để vòng gửi hằng ngày không thử lại mãi và làm hỏng uy tín miền.

• Given một lượt gửi hỏng với E_RECIPIENT_SUPPRESSEDWhen ghi kết quả Then người đó được đánh dấu source='suppressed', tách biệt với người tự huỷ (source='link').

NOTIF-PREF-05: trang tuỳ chọn

Là thành viên, tôi muốn bật/tắt từng nhóm thư và chọn nhịp nhận thư, để không phải chọn giữa "nhận tất" và "huỷ tất".

Đã xây (14.10.2026) dưới dạng trang có chữ ký, không cần đăng nhập (/api/system/email/prefs, link "Đổi nhịp nhận thư" ở chân mọi thư gắn kết), không phải trang trong tokyo: người muốn thư thưa đi không nên bị bắt đăng nhập, và người chỉ có ở hệ cũ không có tài khoản tokyo. Khoá theo ĐỊA CHỈ (email_audience_prefs.email_key), không theo id: 57 người có hai id.

• Given tôi tắt "Học tập" nhưng giữ các nhóm khác When Nhịp thư hay vòng gửi hằng ngày chạy Then tôi không nhận learning_nudge, weekly_progress, profile_incomplete, course_new; pro_expiring (nhóm tài khoản, không tắt riêng được) vẫn có thể tới.
• Given tôi bỏ tích "Chuỗi thư làm quen" (nhóm lam_quen, thêm 14.10.2026) Then tôi không nhận thư nào của chuỗi 30 thư làm quen (journey_day) nữa, còn nhắc học, sự kiện, bài đọc và tin tuần vẫn như cũ. Nhóm này tách riêng có chủ ý: người thấy chuỗi dày phải tắt được nó mà không mất luôn nhắc học. Người đã lưu tuỳ chọn trước 14.10.2026 vẫn nhận chuỗi cho tới khi tự bỏ tích, vì danh sách nhóm tắt của họ không có lam_quen.
• Given tôi chọn nhịp "Chỉ thư về việc của tôi" hoặc "Tối đa 1 thư/tuần" Then cổng gửi thi hành cho MỌI thư gắn kết, kể cả của daily.ts (prefsBlock trong send.ts).
• Given tôi bật "Ưu đãi" Then thời điểm và phiên bản câu chữ đồng ý (consent_version) được ghi; bỏ tích là rút lại.

Chọn theo kênh vẫn chưa có (chỉ có một kênh, email). Trang tuỳ chọn trong tokyo để giai đoạn sau.

NOTIF-PREF-06: đăng ký lại

• Given tôi đã huỷ When chọn một nhịp khác "Không nhận thư nào" ở trang tuỳ chọn, hoặc bấm "Có" ở thư hỏi lại Then huỷ nhận do chính tôi chọn (source='link') được gỡ cho mọi id của địa chỉ, và tôi nhận lại thư gắn kết; người bị suppressed thì không tự bật lại được.