Report Subscription

Report Subscription = đăng ký nhận báo cáo định kỳ tự động (vd báo cáo tuần). Đây là một đường automation mỏng (thin MVP) chạy qua đúng các primitive lõi: AutomationScheduler, key helper dùng chung, Ensure*, dispatch guard, send claim.

Đường đi

Gửi thẳng OutgoingMessage mà bỏ cầu NotificationScheduler cần phê duyệt riêng và vẫn phải giữ send-claim guard.

Dùng AutomationScheduler (không thêm cột mới)

AutomationTypeId   = ReportSubscription
TriggerTypeId      = ScheduledRun | ManualRun
SourceEntityTypeId = ReportSubscription ; SourceEntityGuid = ReportSubscription.Guid
SchedulerKey       = report-subscription:{guid}:scheduled:{periodStartUtc-or-scheduledOn}
                   | report-subscription:{guid}:manual:{manualRunGuid}

• SchedulerKey là khóa run nghiệp vụ canonical — không suy delivery key từ AutomationScheduler.Id/Guid.
• manualRunGuid sinh trước insert, trả về caller, tái dùng khi retry.
• StorageRunKeyHash (hash ngắn ổn định của SchedulerKey) gom các delivery artifact (MessagingJob.Guid, report NotificationJob.RowKey).

One-Owner Guard — không gửi đôi khi cutover

Scheduler cũ và automation scheduler mới cùng kiểm một ownership guard trước khi tạo delivery:

ReportRunOwnership: SchedulerKey, OwnerTypeId (OldScheduler | AutomationScheduler),
                    OwnerVersion, StatusId (Owned | DeliveryCreated | Cancelled), CoordinatesJson?

• Chỉ owner mới tạo NotificationJob/MessagingJob/blob/NotificationScheduler.
• Shadow rows không acquire ownership.
• Retry tái dùng ownership + tọa độ. Xung đột ownership → IsOnSupportHold, không bao giờ tạo delivery thứ hai.

Rollout từng bước (an toàn, rollback được)

0 Design validation : xác nhận delivery path, hành vi scheduler cũ, ownership storage.
1 Shadow            : row không-chạy; so khóa kỳ vọng với run của scheduler cũ.
2 Run-now allowlist : automation chạy các manual run được chọn; scheduler cũ bị chặn cho chúng.
3 Scheduled allowlist: chọn BU/subscription; theo dõi conflict/failure/latency.
4 Cutover           : guard scheduler cũ cho subscription trong allowlist;
                      rollback = bỏ allowlist, ownership trả về scheduler cũ.

Lifecycle & support

• Create/update → ensure next scheduled row (chỉ next run, trừ khi cần horizon có biên rõ).
• Pause/deactivate/delete → deactivate pending rows; completed runs giữ nguyên.
• Template/recipient/delivery đổi → reload lúc execution. Run-now → manualRunGuid mới.
• Support API: GET/POST /report-subscriptions/{guid}/automation-runs[...] — report run detail, ownership detail, delivery coordinates, failed report queue, recent runs/subscription.

Liên quan

• Automation & Reminders — nền automation chung.
• Subscription — khác với "report subscription"; subscription là gói đăng ký học/billing.