01Bên gửi / RPSự kiện nghiệp vụ hoặc ý định yêu cầu
NHÀ PHÁT TRIỂN · KÊNH TÍCH HỢP
Tích hợp Kafka — ranh giới hướng sự kiện của CheckID
Kafka được trình bày như kênh bất đồng bộ bổ sung REST; chi tiết topic/lược đồ/bảo mật chỉ công bố khi tài liệu nguồn/hợp đồng đối tác xác nhận.
HƯỚNG SỰ KIỆN
REST + Kafka thay vì hai card rỗng
Trực quan hóa vai trò vận hành mà không tự tạo thông tin broker/topic/bảo mật khi nguồn được phê duyệt chưa cung cấp.
02Tích hợp KafkaThao tác / nội dung theo nguồn
03Tương quanTham chiếu / giao dịch / billcode khi áp dụng
04Bên tiêu thụ / CheckIDQuy trình và trạng thái
05Bằng chứngKết quả / truy vết / ngữ cảnh kiểm toán
MA TRẬN RANH GIỚI
Công bố đúng độ sâu của hợp đồng kỹ thuật
Ranh giới chính xác đáng tin cậy hơn việc tự tạo tên topic.
| Vấn đề | REST | Kafka | Trạng thái công bố |
|---|---|---|---|
| Tương tác | Yêu cầu/phản hồi đồng bộ | Bất đồng bộ / hướng sự kiện | Khái niệm có nguồn hỗ trợ |
| Xác thực / bảo mật | OAuth2/Bearer cho REST theo tài liệu | Cần hợp đồng/tài liệu đối tác để công bố chi tiết bảo mật Kafka | Không tự suy diễn |
| Lược đồ | OpenAPI / JSON | Lược đồ thông điệp theo nguồn/đối tác | Chỉ công bố khi nguồn xác định |
| Tương quan | HTTP/bối cảnh giao dịch | Tương quan/bối cảnh sự kiện | Ánh xạ theo nguồn |
| Xử lý lỗi | HTTP + mã kết quả | Ngữ nghĩa cơ chế thử lại/lỗi cần hợp đồng kỹ thuật | Chi tiết dành cho đối tác |
TÍCH HỢP HƯỚNG SỰ KIỆN
Kafka là kênh hướng sự kiện, không phải “REST nhưng chạy async”
Chỉ công bố broker/topic/an ninh khi đối tác đặc tả có; phần công khai tập trung vào trách nhiệm bên gửi/consumer, tương quan và vòng đời.
api
REST
Tương tác đồng bộ phù hợp yêu cầu / phản hồi trực tiếp và quy trình cần kết quả ngay.
Đầu vàoHTTP yêu cầu
Đầu raHTTP phản hồi
api
Kafka
Kênh sự kiện/request-reply không đồng bộ cho mẫu tích hợp được đặc tả hỗ trợ.
Đầu vàoMessage/sự kiện
Đầu raCorrelated kết quả/sự kiện
bảo đảm
Tương quan
Message phải có tương quan/bối cảnh giao dịch theo nguồn đặc tả để truy vết đúng quy trình.
Đầu vàoYêu cầu/bối cảnh sự kiện
Đầu raXử lý có thể truy vết
ngoại lệ
Lỗi / cơ chế thử lại ranh giới
Cơ chế thử lại, ordering, delivery guarantee và dead-letter hành vi chỉ công bố khi nguồn định nghĩa.
Đầu vàoLỗi chuyển giao
Đầu raPartner-đặc tả hành vi