Vodka

Ứng dụng nhắn tin thời gian thực

Môn học: Công nghệ mới trong phát triển ứng dụng

Thành viên

• Lê Hoàng Khang · developer@iamhoangkhang.id.vn
• Nguyễn Thanh Cảnh · thanhcanh.dev@gmail.comNhóm trưởng
• Trần Đình Kiên
• Hồ Thị Như Tâm

Mã nguồn

Vodka là ứng dụng nhắn tin thời gian thực tương tự Zalo, cho phép người dùng kết nối, trò chuyện và chia sẻ khoảnh khắc với bạn bè, gia đình trên cả web và di động.

Vodka theo mô hình client-server kết hợp hướng sự kiện (event-driven). Web và mobile chỉ hiển thị và thu thập tương tác; toàn bộ nghiệp vụ nằm ở backend NestJS, chia thành các module tính năng (người dùng, xác thực, tin nhắn, nhóm, bạn bè, danh bạ, lưu trữ, mã QR, AI) dựa trên ba module lõi: Prisma, Event và Cache.

Ba kênh giao tiếp

• REST (/api/v1, JWT): thao tác CRUD, đăng nhập, đăng ký, tải dữ liệu ban đầu. Tài liệu API sinh tự động bằng Swagger.
• WebSocket (Socket.io, xác thực JWT khi bắt tay): tin nhắn, thông báo, trạng thái đang gõ và online. Mỗi loại kết nối một namespace riêng (/message, /groups, /friends, /auth, /qr-code). Mỗi người dùng ở phòng user:{userId}, mỗi nhóm chat một phòng group:{groupId}; thêm hay xóa thành viên nhóm thì vào hoặc ra phòng tương ứng.
• Sự kiện nội bộ (EventEmitter2): các module báo cho nhau qua sự kiện thay vì gọi trực tiếp, nên ít phụ thuộc và dễ thêm tính năng mới.

Luồng gửi một tin nhắn

1. 1Người dùng AClient AGửi tin nhắn
2. 2Client AControllerGọi POST /messages kèm JWT
3. 3ControllerMessageServiceKiểm tra quyền, xử lý nghiệp vụ
4. 4MessageServicePostgreSQLLưu tin nhắn qua Prisma
5. 5MessageServiceMessageGatewayPhát sự kiện qua EventEmitter
6. 6MessageGatewayClient BĐẩy newMessage tới phòng user:{id} hoặc group:{id}
7. 7Client BNgười dùng BHiển thị tin nhắn mới

Dữ liệu

• PostgreSQL: dữ liệu chính (người dùng, tin nhắn, nhóm, bạn bè, danh bạ), nhất quán theo ACID; nội dung tin nhắn lưu dạng JSON để chứa cả văn bản lẫn media.
• Redis: mã OTP, dữ liệu đăng ký tạm, phiên làm việc và cache dữ liệu hay truy cập như danh sách cuộc trò chuyện.
• Supabase Storage: ảnh đại diện người dùng và nhóm, file, ảnh, video trong tin nhắn.

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

Access token sống 30 phút, refresh token 30 ngày. Guard của NestJS kiểm tra quyền theo vai trò trong nhóm: trưởng nhóm, phó nhóm, thành viên. Mã OTP gửi qua email (Resend) hoặc SMS (AWS SNS).

Triển khai

Docker Compose trên Coolify gồm ba container: API, PostgreSQL và Redis. API chờ PostgreSQL và Redis qua health check, tự chạy migration rồi mới khởi động. Có thay đổi trên nhánh chính thì hệ thống tự triển khai lại.