Triển khai & vận hành

Tài liệu này hướng dẫn từng bước để build Docker image production và triển khai toàn bộ hệ thống (Backend FastAPI + Frontend Next.js + Postgres + Nginx/TLS + kho ảnh) lên 1 VPS. Đây là bản hướng dẫn thao tác thực tế, dựa trên thiết kế chi tiết ở tasks/phase_f/ (đọc thêm ở đó nếu cần hiểu tại sao mỗi bước được làm như vậy — tài liệu này chỉ tập trung làm thế nào).

Toàn bộ script/config nhắc tới trong bài đã có sẵn trong repo — không có bước nào yêu cầu viết code mới, chỉ cần chạy đúng thứ tự.

Ghi chú

Có bản HTML cùng nội dung, dễ đọc hơn (mục lục, sơ đồ kiến trúc, khối lệnh có nút copy): DEPLOY.html — mở trực tiếp bằng trình duyệt (không cần chạy server). DEPLOY.md là bản gốc: sửa ở đây rồi chạy python3 scripts/render_deploy_html.py DEPLOY.md DEPLOY.html DEPLOY.html để dựng lại bản HTML, không sửa tay DEPLOY.html.

Cập nhật tới: bản v1.2.0 — Phase R (Shop & Vật phẩm thưởng), Phase S (backup/restore; S.1–S.7 đã có script, diễn tập dựng lại từ VPS trắng còn chờ) và kênh cảnh báo Telegram; migration head 0053_telegram_alert_channels, SDK v0.3.0.

Lần đầu cài đặt	Đã chạy production, nâng cấp lên bản mới
Làm lần lượt §1 → §7	§7 (deploy các lần sau) + §8 các bước riêng của từng phase mà bản đang chạy chưa có

---