05 · Thông báo bất đồng bộ và push FCM

LoanNotificationPublisher đăng ký afterCommit rồi chạy task qua executor. SavingsEventRelay dùng @TransactionalEventListener(AFTER_COMMIT). Cả hai gửi eventType, userId, data vào notification.events; queue Notification bind routing #.
Mỗi template của event chọn processor theo channelType, render hai ngôn ngữ, gắn extraData phục vụ mở đúng đối tượng nghiệp vụ và save UserMessage. Chỉ sau khi save cho toàn bộ template mới bắt đầu vòng dispatch. Nguồn: NotificationProcessingService.java:33–69.
Các save diễn ra trong @Transactional; save xong trong code không đồng nghĩa đã commit trước FCM. Dispatch được gọi trước khi method process kết thúc.

PUSH_NOTIFICATION gọi FcmPushSender → FirebaseMessaging.send cho từng device token active. Token UNREGISTERED hoặc INVALID_ARGUMENT bị vô hiệu hóa. messageId trả về là FCM chấp nhận request, không bảo đảm người dùng đã xem trên thiết bị.
EMAIL và SMS processor hiện kế thừa default dispatch no-op; các template vẫn dựng/lưu UserMessage nhưng phần code đã đọc chưa gọi SMTP hay nhà cung cấp SMS. Luồng OTP SMS đăng nhập/đăng ký thuộc service khác.
In-app inbox đọc từ CSDL độc lập với push; không có token thì send trả 0, dữ liệu inbox vẫn được xử lý. Nguồn: FcmPushSenderImpl.java:48–91,136–145; MessageProcessor.java:22–24; EmailMessageProcessor.java và SmsMessageProcessor.java.

Lỗi build/template hoặc persistence ném ra khỏi process đi qua listener-container retry. maxAttempts=3 nghĩa là tối đa 3 lần thử tính cả lần đầu; backoff cấu hình 1000ms, hệ số 2, trần 4000ms. Hết lượt lỗi đi qua cơ chế reject/dead-letter tới notification-events.queue.dlq.
Lỗi không tìm thấy template được log rồi return, không ném để retry. Lỗi dispatch push được bắt và log trong processor, không kích hoạt retry message. Nguồn: NotificationEventListener.java:21–25; RabbitTopologyConfig.java:35–60,73–81; PushNotificationMessageProcessor.java:30–45.
Producer Loan/Savings cũng bắt lỗi publish để log; sơ đồ không mặc định có retry producer hoặc đảm bảo exactly-once.

Phần chuẩn bị device-token có thể xảy ra khi đăng nhập hoặc đổi token. Các phần phát event, nhận push và khách mở inbox là những mốc tách biệt; hệ điều hành và mạng quyết định thời điểm push tới máy.
Bước xử lý lỗi token là nhánh tùy kết quả send; nhánh token tốt tiếp tục bình thường. Các sơ đồ 01–04 dừng ở publish và dẫn tới luồng này.

Backend ghim commit 2d27752a4257d2f7d9e27811f98d14e9936ef94e. Các file được trích dẫn khớp commit; sơ đồ mô tả code, chưa chạy giao dịch nghiệp vụ thật.
Gateway / xác thực và các helper nội bộ được gộp vào API tương ứng. Mũi tên endpoint có thể rút gọn tiền tố; khoảng cách dọc là thứ tự, không phải thời gian đo.
SRC trên nút giao diện dẫn tới hợp đồng backend mà giao diện gọi. Nguồn mobile/admin đối chiếu riêng được liệt kê trong source-evidence.md ở trang mục lục.
Nội dung tiếng Việt; một số nút điều khiển Archify dùng tiếng Anh.