Tích hợp
Helpdesk có bề mặt tích hợp mỏng bất thường: nó không thực hiện cuộc gọi HTTP outbound đồng bộ tới microservice chị em và không tiêu thụ/produce Kafka. Dữ liệu cross-domain được đọc qua repository ship bên trong
@nx/core, và xác thực tin tưởng JWKS của identity issuer.
1. Dịch vụ chị em
Hướng:→gọi /←được gọi bởi /↔hai chiều.
| Chị em | Hướng | Bề mặt | Hợp đồng | Auth | Ghi chú |
|---|---|---|---|---|---|
@nx/identity | → | Endpoint JWKS | Xác thực JWT (VerifierApplication) | — | Xác thực access token; không bao giờ phát |
@nx/core (library) | → | ProductRepository, SaleOrderRepository | Đọc Drizzle in-process | DB | Enrichment context đọc hàng product & sale-order trực tiếp từ schema DB dùng chung |
Không có trao đổi topic Kafka và không có REST client tới
@nx/sale,@nx/payment, v.v. Danh sáchdependencies.servicestrongapp-info.json(identity,payment,commerce,inventory,signal) là metadata khai báo, không phải cuộc gọi runtime được đấu nối.
2. Hệ thống bên ngoài
| Hệ thống | Hướng | Bề mặt | Auth | Chế độ lỗi |
|---|---|---|---|---|
| SMTP server | → | NodemailerComponent | SMTP user/password (env) | Job notification retry (BullMQ, tối đa 5 lần) |
| Lưu trữ object/file | ↔ | FileStorageHelper | theo từng triển khai | Upload/fetch attachment |
3. Luồng cross-service quan trọng
3.1 Enrichment context ticket (đọc từ repository core)
| Bước | Chi tiết |
|---|---|
| 2-5 | Không hop mạng — repository @nx/core đọc DB dùng chung |
| 6 | JSON đã enrich lưu trên Ticket.context để agent thấy order/product mà không truy vấn dịch vụ khác |
4. Tính ổn định của hợp đồng
| Bề mặt | Ổn định | Quản lý phiên bản |
|---|---|---|
REST /v1/api/helpdesk/* | beta | URL /v1/ |
WebSocket observation/helpdesk | beta | đường topic |
Sự kiện in-process (TicketEventTypes) | nội bộ | không quản lý phiên bản bên ngoài |
Đọc repository @nx/core | theo core | workspace:* |