Khôi phục V2 trên Supabase — không cài phần mềm

Bạn tải ZIP trực tiếp vào Supabase Dashboard → Storage. Website chỉ gửi lệnh cho Edge Function xử lý trên Supabase theo từng phần, không upload ZIP qua EdgeOne.

Cài đặt một lần qua trình duyệt

Sao lưu database độc lập và chuẩn bị Project TEST.
Vào SQL Editor, chạy trọn bộ 01_CAI_DAT_STORAGE_V2.sql, rồi 02_HAM_STORAGE_V2.sql từ FULL SOURCE 35. Không chạy riêng dòng lệnh trong thân hàm.
Trong Supabase → Database → Extensions, bật pg_cron, và kiểm tra Cron có hoạt động.
Supabase → Edge Functions → Deploy a new function → Via Editor. Tạo tên xm-storage-v2; dán toàn bộ supabase/functions/xm-storage-v2/index.ts, bật yêu cầu xác thực JWT.
Storage → mở bucket riêng tư xm-restore-v2 → tạo thư mục backups → Upload ZIP V2. Không đổi nội dung file. Tên file chỉ gồm chữ, số, dấu _ - ..

Nạp staging và áp dụng

Đăng nhập website bằng Admin, tab Người dùng → phần Sao lưu & Khôi phục V2.
Nhập backups/BACKUP_XUONG_MAY_V2.zip, nhấn 1. Tạo phiên từ Storage. Bộ ZIP phải có v2/manifest.json và các phần NDJSON hợp lệ.
Nhấn 2. Nạp tiếp staging nhiều lượt tới khi trạng thái ready. Có thể tắt trang/mở lại và tiếp tục bằng nút Kiểm tra phiên. Thao tác này chỉ nạp staging, chưa sửa dữ liệu nghiệp vụ.
Đối chiếu số dòng và SQL kiểm tra chỉ đọc; xác nhận riêng chế độ missing_only hoặc overwrite rồi nhấn áp dụng một lần.
Không gửi lại APPLY khi mất kết nối. Kiểm tra Cron job, audit restore_applied và trạng thái applied bằng SQL 03_KIEM_TRA_CHI_DOC.sql.

Giới hạn và an toàn: Gói Free giới hạn mỗi file Storage tối đa 50 MB. Worker Supabase giới hạn thời gian; xử lý chia thành bước nhỏ nhưng giao dịch cuối có thể vẫn dài và khóa bảng nghiệp vụ. Nếu còn job V2 cũ queued, hệ thống từ chối khôi phục mới cho tới khi bạn xử lý phiên đó. Bộ khôi phục này không nhập bảng Auth và không phục hồi hồ sơ tài khoản user_profiles vào database thật (theo chính sách V2 trước đó).

Chi tiết mở HUONG_DAN_STORAGE_SUPABASE_KHONG_CAI_SOFT_26_10_2026.md trong FULL SOURCE.