Chuyển tới nội dung chính

Container Diagram

Mức 2 của mô hình C4: những tiến trình và kho dữ liệu chạy độc lập tạo nên hệ thống, cùng cách chúng giao tiếp. Trong C4, "container" nghĩa là một tiến trình hoặc kho dữ liệu triển khai được, không nhất thiết là Docker container.

Sơ đồ triển khai production​

Các container​

ContainerCông nghệTrách nhiệmNguồn cấu hình
backendNode 24, NestJS 10REST API, WebSocket, worker BullMQ, cron, tất cả cùng một tiến trìnhDockerfile, docker-compose.prod.yml
MongoDBmongo:7.0Lưu toàn bộ dữ liệu nghiệp vụdocker-compose.prod.yml
Redisredis:7-alpineHàng đợi BullMQ, rate limit, cache, quotadocker-compose.prod.yml
Reverse proxyCaddy (caddy:2-alpine)Kết thúc TLS, chuyển tiếp tới backendTrong compose production, cấu hình ở Caddyfile. Xem deployment

Giao tiếp giữa các container​

TừTớiGiao thứcMục đích
FrontendBackendHTTPS, Socket.IO namespace /notificationsAPI và thông báo thời gian thực
BackendMongoDBGiao thức MongoDB qua MongooseĐọc, ghi dữ liệu
BackendRedisioredisHàng đợi (DB REDIS_QUEUE_DB, mặc định 0), cache và rate limit (DB REDIS_CACHE_DB, mặc định 1)
BackendỔ đĩaHệ thống fileLưu và serve file tải lên ở public/

Design Decision: một tiến trình, nhiều vai trò​

Cùng một tiến trình NestJS xử lý HTTP, chạy worker BullMQ và chạy cron. Đây là lựa chọn của mã nguồn: QueuesModule đăng ký cả producer lẫn processor trong AppModule, và các hàm @Cron nằm trong service thường.

  • Ưu điểm: một đơn vị triển khai, không cần quản lý nhiều service, processor dùng lại trực tiếp service nghiệp vụ.
  • Đánh đổi: tải xử lý nền cạnh tranh tài nguyên với API. Muốn scale riêng worker phải tách code. Xem scalability.md.

Hạ tầng local​

docker-compose.yml chỉ chạy MongoDB và Redis, và tùy chọn thêm backend với profile full. Cổng được gắn vào 127.0.0.1. Xem local-development.md.

Chưa xác minh​

  • Cấu hình reverse proxy thực tế không có trong repository nên không được mô tả ở đây. DEPLOYMENT.md có hướng dẫn, nhưng chưa được đối chiếu với môi trường chạy thật.