Giao diện
@digiforce-nc/plugin-mailbox
Plugin hộp thư email — nhận/gửi email trực tiếp trong Digiforce, quản lý conversation theo thread, đính kèm file, và liên kết email với record.
Plugin này làm gì?
Thay vì chuyển qua ứng dụng email riêng, plugin cho phép gửi/nhận email ngay trong Digiforce và tự động tổ chức thành conversation. Email từ khách hàng tự gắn vào record tương ứng, reply trực tiếp từ giao diện Digiforce, và mọi attachment được quản lý tập trung.
Ba nhiệm vụ chính
| # | Nhiệm vụ | Chi tiết |
|---|---|---|
| 1 | Nhận email | Đồng bộ email từ IMAP, parse body + attachments, tổ chức thành thread |
| 2 | Gửi email | Soạn và gửi qua SMTP, hỗ trợ reply/forward, đính kèm file |
| 3 | Record linking | Tự động liên kết email với record (ticket, khách hàng, đơn hàng) |
Kiến trúc
Luồng nhận email (IMAP sync)
API endpoints
| Endpoint | Mô tả |
|---|---|
mailbox:list | Danh sách email (inbox, sent, draft) |
mailbox:get | Chi tiết email theo ID |
mailbox:send | Gửi email mới |
mailbox:reply | Reply email trong thread |
mailbox:forward | Forward email |
mailbox:sync | Trigger đồng bộ IMAP thủ công |
mailbox:threads | Danh sách conversation threads |
mailbox:attachments | Danh sách attachments của email |
Database
| Bảng | Chứa gì |
|---|---|
mailboxAccounts | Tài khoản email (IMAP/SMTP credentials) |
mailboxMessages | Email messages (from, to, subject, body, status) |
mailboxThreads | Conversation threads (nhóm email cùng chủ đề) |
mailboxAttachments | Metadata file đính kèm (filename, size, storageKey) |
Cấu hình
| Tham số | Mô tả |
|---|---|
imapHost | IMAP server hostname |
imapPort | IMAP port (mặc định: 993 SSL) |
smtpHost | SMTP server hostname |
smtpPort | SMTP port (mặc định: 587 STARTTLS) |
email | Địa chỉ email |
password | Mật khẩu hoặc App Password |
syncInterval | Tần suất đồng bộ IMAP (phút) |
Thành phần client
| Thành phần | Mô tả |
|---|---|
MailboxInbox | Giao diện hộp thư đến — danh sách email với preview |
ComposeEmail | Form soạn email (rich text editor, attachments) |
EmailThread | Hiển thị chuỗi email conversation |
MailboxConfig | Cấu hình tài khoản email (Settings → Mailbox) |
RecordEmailTab | Tab email trong record detail — hiển thị email liên quan |
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/server | Server framework (peer) |
@digiforce-nc/database | Database ORM (peer) |
@digiforce-nc/client | Client UI framework (peer) |
nodemailer | SMTP client — gửi email |
imap | IMAP client — nhận email |