Appearance
Kiến trúc MINAP Chat
Version: 1.1
Date: 2026-11-17
Status: Working baseline
1. Hướng sản phẩm
MINAP Chat là lớp giao tiếp tích hợp sẵn, toàn nền tảng, ban đầu không cần subscription Chat riêng cho cả Personal và Organization Workspace. Nó phải truy cập được xuyên các MINAP Applications và giữ identity người dùng nhất quán.
DECIDED: một MINAP Account tương ứng một Matrix Account.
2. General Chat
- Giao tiếp xuyên nền tảng tổng quát cho người dùng cá nhân và doanh nghiệp.
- Hướng open-source/self-hosted dựa trên Matrix.
- UI/UX MINAP tùy chỉnh tích hợp vào platform shell và Applications.
- Không lộ chi tiết triển khai Matrix không cần thiết cho end users.
- Trải nghiệm đính kèm file/tài liệu nên tích hợp với MINAP File Service khi khả thi, thay vì coi Matrix media storage thô là hệ thống file dài hạn duy nhất.
- Gọi video/voice trong tương lai là khả năng cần đánh giá, không phải cam kết MVP.
3. Tích hợp logic
Đây là ranh giới khái niệm. Matrix client/server APIs, đồng bộ sự kiện và xử lý media phải được xác thực với triển khai và client SDK đã chọn.
4. Hướng đính kèm
Trải nghiệm ưu tiên (khớp File Service DB: không cột workspace_id trên files):
- Người dùng chọn file trong MINAP Chat (ngữ cảnh Personal hoặc Organization Workspace hiện tại).
- Chat Integration / UI xác định Workspace (+ room nếu có) và gọi File Service upload/promote với authz đủ điều kiện. File Service lưu metadata (
file_…, uploader, purpose, …) và bytes theo vòng đời temp→local→cloud (/architecture/05-storage-and-file-service, /architecture/database/02-file-service). Liên kết nghiệp vụ file ↔ Workspace / room do Chat (hoặc Application) giữ — không nhân bảnworkspace_idtrong FS DB. - Chat gửi tin nhắn chứa tham chiếu đính kèm (
file_id) được kiểm soát và metadata hiển thị. - UI list/scroll/init xin variant qua
GET /files/{file_id}/{size}(allowlist; disk{FS_VARIANT_ROOT}/{file_id}/{size}.webp); full view xin original. - Mỗi lần đọc: File Service authorize lại (token + policy caller — có thể kèm kiểm tra membership Workspace/chat do Chat/Core cung cấp hoặc FS gọi ngược). Không serve chỉ vì path disk tồn tại. Miss variant → đọc gốc (local/cloud) → sinh box N×N → ghi cache → trả.
Không giả định sự kiện Matrix chứa tham chiếu file tự nó đủ authorization.
Cần quyết định tương thích sự kiện đính kèm Matrix m.room.message (tham chiếu file ngoài / Matrix media / hybrid). Tránh phá interoperability nếu chưa ghi nhận trade-off.
OPEN (authz) — hoãn đến implement: wire Chat → FS chứng minh membership Workspace/room (token claim / Core API / Chat GW proxy). Làm rõ cùng các mục OPEN File Service §15.
5. Allowance lưu trữ
Đề xuất hiện tại:
- Mặc định 5 GB mỗi Personal Workspace/user hoặc Organization Workspace.
- Storage thêm bán dưới dạng add-on Cloud Storage riêng.
- Chat ban đầu miễn phí.
OPEN: allowance là một quota MINAP dùng chung xuyên Applications hay phân bổ riêng cho Chat.
6. MINAP Business Chat trong tương lai
Khả năng tương lai được hoãn cho tổ chức có yêu cầu quyền riêng tư hoặc data-residency mạnh hơn:
- Cụm database riêng.
- Lưu trữ file riêng.
- Ranh giới vận hành/bảo mật riêng.
- Chỉ nhân sự được ủy quyền thuộc tổ chức đó mới dùng được.
- Trách nhiệm ownership tổ chức, backup, retention, xuất, encryption-key và sự cố tường minh.
Không tách sớm General Chat thành hai sản phẩm trong MVP. Giữ hợp đồng tích hợp có khả năng hỗ trợ ranh giới triển khai/tenant riêng sau này.
7. Câu hỏi mở
- Matrix homeserver và client SDK được chọn.
- Vòng đời provisioning và deprovisioning tài khoản.
- Đồng bộ Workspace membership và quy tắc room membership.
- Federation bật hay tắt theo mặc định.
- Yêu cầu end-to-end encryption và hệ quả recovery.
- Retention tin nhắn, xóa, xuất và moderation.
- Tương thích đính kèm và tính toán storage.
- Phạm vi và hạ tầng gọi video/voice.
- Authz đính kèm: Chat GW proxy vs FS tự verify membership (xem §4 OPEN).