Mô hình kênh chat

• Loại kênh mô tả mục đích nghiệp vụ, chẳng hạn kênh hỗ trợ.
• Kiểu hội thoại mô tả hình thức giao tiếp trực tiếp hay theo nhóm.
• Định dạng mô tả cấu trúc logic của kênh, nhóm hoặc luồng thảo luận.

Thành viên kênh

• Kênh tham gia.
• Loại danh tính, ví dụ người dùng hoặc quản trị viên.
• ID thành viên.
• Vai trò và tên vai trò.
• Trạng thái thành viên.
• Số tin chưa đọc.
• Thời điểm đọc gần nhất.
• Thời gian tạo và cập nhật quan hệ.

• ADDED: đã được thêm vào kênh.
• WAITING_FOR_APPROVAL: đang chờ duyệt.

Khởi tạo kênh hỗ trợ

• Tìm kênh gần nhất của người dùng và tái sử dụng nếu đã có.
• Luôn tạo một kênh hỗ trợ mới.

sequenceDiagram
    participant U as Người dùng
    participant API as API chat
    participant C as Dịch vụ kênh
    participant M as Thành viên
    participant P as Hồ sơ chat

    U->>API: Yêu cầu mở cuộc hội thoại
    API->>C: Tìm hoặc tạo kênh SUPPORT
    C->>M: Thêm người dùng vào kênh
    C->>M: Thêm nhân viên hỗ trợ mặc định
    API->>P: Gắn hồ sơ chat nếu có
    P->>M: Thêm thành viên của hồ sơ đang hoạt động
    API-->>U: Trả về ID kênh và trạng thái chatbot

• Loại SUPPORT.
• Trạng thái ACTIVATED.
• Phạm vi mặc định PRIVATE.
• Kiểu hội thoại mặc định DIRECT.
• Định dạng mặc định CHANNEL.
• Người yêu cầu được ghi nhận là người tạo.

• Gắn hồ sơ đó vào kênh.
• Thêm các thành viên đang hoạt động của hồ sơ vào kênh.
• Có thể tự động thêm chatbot nếu dịch vụ chatbot đã được cấu hình.

Quản lý danh sách kênh

• ID và avatar.
• Tên kênh.
• Loại kênh.
• Phạm vi công khai hoặc riêng tư.
• Kiểu hội thoại.
• Định dạng kênh.
• Trạng thái.
• Thời gian cập nhật.
• Các thao tác xem chat, lưu trữ, khôi phục hoặc xóa.

• Loại kênh.
• Phạm vi.
• Kiểu hội thoại.
• Định dạng.
• Trạng thái.
• Từ khóa.
• Số bản ghi trên trang.

Phân trang và sắp xếp

• Trang đầu.
• Trang trước.
• Trang tiếp theo.
• Trang cuối.
• Điều chỉnh số bản ghi trên mỗi trang.

• ID tăng dần.
• ID giảm dần.
• Thời gian chat gần nhất giảm dần, sau đó ID giảm dần.

Vòng đời của kênh

stateDiagram-v2
    [*] --> ACTIVATED
    ACTIVATED --> ARCHIVED: Lưu trữ
    ARCHIVED --> ACTIVATED: Khôi phục
    ARCHIVED --> DELETED: Xóa
    ACTIVATED --> BLOCKED: Chặn theo nghiệp vụ
    BLOCKED --> ACTIVATED: Kích hoạt lại

Đang hoạt động

Đã lưu trữ

Đã xóa

Bị chặn

Mở kênh và tham gia hỗ trợ

1. Hệ thống kiểm tra người đó có thuộc nhóm nhân viên hỗ trợ hay không.
2. Kiểm tra loại kênh có nằm trong nhóm kênh hỗ trợ được cấu hình hay không.
3. Nếu đủ điều kiện, thêm quản trị viên vào kênh.
4. Sau đó chuyển tới màn hình chat.

Tin nhắn, trạng thái đọc và số chưa đọc

1. Kiểm tra nội dung và quyền thành viên.
2. Lưu tin nhắn và các tài nguyên liên quan.
3. Cập nhật thời gian chat gần nhất của kênh.
4. Tăng số tin chưa đọc cho mọi thành viên trừ người gửi.
5. Bảo đảm thành viên hỗ trợ cần thiết đã có trong kênh.
6. Tạo trạng thái gửi cho các thành viên nhận.
7. Phát sự kiện realtime tới các thành viên.

• Số tin chưa đọc của thành viên đó được đặt về 0.
• Thời gian đọc gần nhất được cập nhật.
• Các tin vừa tải được đánh dấu là đã xem đối với người nhận.

• Lấy tin nhắn cuối cùng của nhiều kênh.
• Lấy nhóm tin nhắn xung quanh một tin cụ thể.
• Tra cứu trạng thái gửi/xem của từng tin nhắn.

Quản lý chatbot theo kênh

• Bật chatbot: lấy danh tính chatbot đã cấu hình và thêm vào kênh.
• Tắt chatbot: loại chatbot khỏi kênh.
• Nếu chưa có dịch vụ chatbot hợp lệ, yêu cầu bật không tạo thành viên mới.

Thiết lập riêng theo người dùng

• Đánh dấu spam.
• Ẩn kênh.
• Chặn.
• Mật khẩu khóa kênh.
• Token mở khóa có thời hạn.
• Khóa công khai và thông tin mã hóa.
• Tùy chọn hiển thị trạng thái đã xem.
• Các cặp thiết lập mở rộng.

Spam

Ẩn kênh

Khóa kênh

• Hệ thống tạo token mở khóa ngẫu nhiên.
• Token có thời hạn.
• Token được lưu trong thiết lập của người dùng.
• Các yêu cầu đọc hoặc gửi tin tiếp theo kiểm tra hiệu lực của token.

Xác thực và phân quyền

• Không phải thành viên thì không được tải hoặc gửi tin.
• Kênh bị khóa thì người dùng phải mở khóa trước.
• Kênh đã xóa bị từ chối ở các luồng phía người dùng.
• Quản trị viên chỉ được xem tin nhắn cuối của một tập kênh khi thuộc tất cả các kênh đó.
• Tin nhắn được yêu cầu phải thực sự thuộc kênh đang truy cập.

Quan hệ dữ liệu

erDiagram
    CHANNEL ||--o{ CHANNEL_MEMBER : "có thành viên"
    CHANNEL ||--o{ MESSAGE : "chứa tin nhắn"
    CHANNEL ||--o{ USER_CHANNEL_SETTING : "có thiết lập cá nhân"
    CHAT_PROFILE ||--o{ CHANNEL : "cấu hình cho"
    CHANNEL ||--o{ CHANNEL : "kênh cha/con"

    CHANNEL {
        long id
        string name
        string type
        string visibility
        string conversationType
        string channelFormat
        string status
        datetime lastChatTime
    }

    CHANNEL_MEMBER {
        long channelId
        string memberType
        long memberId
        long unreadCount
        datetime lastReadTime
    }

    USER_CHANNEL_SETTING {
        long channelId
        string userType
        long userId
        string spam
        string hidden
        string blocked
        string lockPasswordHash
    }

Kết luận

• Trạng thái chung của kênh, như đang hoạt động, lưu trữ hoặc đã xóa.
• Trạng thái thành viên, như vai trò, số chưa đọc và lần đọc cuối.
• Thiết lập cá nhân, như spam, ẩn hoặc khóa bằng mật khẩu.