Cay Assets muc xoa mem voi nut Restore
Xoa mem va Restore

DINHDANH Creator · Bài K08 · Kỹ thuật

Soft delete · Hard delete
· Khôi phục file - đừng xóa vĩnh viễn khi chưa Clone

Góc nhìn kỹ thuật bổ sung cho D01: phân biệt xóa mềm (còn cứu) và xóa vĩnh viễn (mất hẳn), kèm giới hạn theo role và quota file.

Mục tiêu bài học: Thao tác khôi phục sau xóa nhầm, hiểu ai được hard delete, và biết khi nào cần Clone trước thao tác nguy hiểm.

Thời lượng đọc: khoảng 12 phút

Điều kiện trước: D01 (tab Thư mục cơ bản), K02 (Clone trước thay đổi lớn).

Bài trước → sau: K07 → K08 → K09

Nhãn UI (tiếng Việt): Tab Thư mục · Hiện file đã xóa · Khôi phục file · Xóa vĩnh viễn · Tải lên hình ảnh

1. Sơ đồ vòng đời file

File bình thường → icon Xóa file
→ Soft delete - ẩn khỏi cây, dữ liệu còn, khôi phục được
Bật toggle Hiện file đã xóa
→ Khôi phục file hoặc Xóa vĩnh viễn (hard - không hoàn tác)
Role user thường: không hardDeleteFile · Trước hard delete production → Clone (K02)

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
Soft delete (xóa mềm)File chuyển trạng thái đã xóa nhưng còn trong kho file của dự án - khôi phục đượcXóa file / Xóa thư mục
Hard delete (xóa vĩnh viễn)Xóa hẳn khỏi kho file của dự án - không thể hoàn tácChỉ khi bật Hiện file đã xóa
Hiện file đã xóaToggle xem danh sách file/thư mục đã xóa mềmToolbar tab Thư mục
Khôi phục fileĐưa file về trạng thái bình thường, dùng ngay đượcCạnh file đã xóa mềm
restoreFile / hardDeleteFileAPI backend tương ứng - hard thường cần superadminKhông có nút cho role thấp

3. Các bước khôi phục sau xóa nhầm

  1. Mở tab Thư mục (Files).
  2. Bật toggle Hiện file đã xóa - không dùng nhãn tiếng Anh “Show deleted files” làm chuẩn UI.
  3. Tìm file/thư mục cần cứu → nhấn Khôi phục file (hoặc Khôi phục thư mục).
  4. Tắt toggle để quay về cây file bình thường - kiểm tra route/link còn trỏ đúng file.
  5. Nếu file là ảnh media: có thể Tải lên hình ảnh lại nếu đã bị xóa vĩnh viễn trước đó.

4. Giải thích hard delete & phân quyền

Xóa vĩnh viễn: Dialog xác nhận dạng “…xóa vĩnh viễn file '{name}' khỏi kho file của dự án?” - sau bước này không còn Khôi phục file.

Giới hạn role: User thường chỉ soft delete. Hard delete thường chỉ superadmin - nếu không thấy nút, đừng cố qua API guest.

Quy trình an toàn: Trước hard delete trên phiên production → tab Phiên bản → Tạo mới (Clone) (K02). Chắc không còn route/HTML trỏ file sắp xóa.

restoreFile vs upload lại: Soft delete còn metadata trong kho file → Khôi phục file giữ nguyên URL cũ. Hard delete mất hẳn → phải Tải lên hình ảnh hoặc tạo file mới và sửa link trong HTML/CMS.

5. So sánh với công cụ khác

  • Windows Recycle Bin: soft delete ≈ đưa vào thùng rác; hard delete ≈ Shift+Delete - không lấy lại được.
  • Google Drive Trash: tương tự hai bước; Creator không tự xóa vĩnh viễn theo thời gian - bạn phải chủ động.
  • Git revert: Clone + Lưu thay đổi tương đương “commit an toàn” trước khi xóa file quan trọng.

6. Giới hạn kỹ thuật

Quota: “Giới hạn số lượng file” hoặc “Giới hạn dung lượng lưu trữ” - xóa vĩnh viễn file/ảnh không dùng để giải phóng chỗ upload mới.

Không khôi phục được: Sau Xóa vĩnh viễn; sau hard delete database cho file dữ liệu CMS - chỉ còn cách upload/tạo lại hoặc restore từ Clone/.afi.

7. Bảo mật

Hard delete là hành động phá hủy - chỉ superadmin nên có quyền trên production. Không chia sẻ tài khoản admin cho cộng tác viên chỉ cần soft delete + upload (Tải lên hình ảnh).

8. Vấn đề thường gặp

Tình huốngXử lý
Xóa nhầm file HTML quan trọngBật Hiện file đã xóa → Khôi phục file ngay - trước khi ai đó Xóa vĩnh viễn
Không thấy nút Xóa vĩnh viễnRole không đủ - nhờ superadmin hoặc chỉ dùng soft delete
Trang 404 sau khi xóa fileKhôi phục file hoặc sửa tab Đường dẫn trỏ sang file mới
Không upload được - báo giới hạnXóa vĩnh viễn file/ảnh thừa; hoặc nâng gói

9. Lời khuyên

  • Ưu tiên xóa mềm - để vài ngày trước khi Xóa vĩnh viễn dọn dẹp quota.
  • Luôn Clone trước khi hard delete hàng loạt hoặc xóa thư mục lớn.
  • Chi tiết UI tab Thư mục đầy đủ hơn ở D01 - bài K08 tập trung quyết định kỹ thuật.
  • Trước khi xóa thư mục chứa nhiều file: grep/search tên file trong tab Đường dẫn và __cms_manifest__.
  • Ảnh media xóa nhầm: ưu tiên Khôi phục file; nếu đã vĩnh viễn - Tải lên hình ảnh lại và cập nhật URL trong HTML.

10. Checklist tự kiểm

  1. Bạn phân biệt được soft delete và Xóa vĩnh viễn?
  2. Bạn khôi phục được file qua Hiện file đã xóa → Khôi phục file?
  3. Bạn nhớ Clone trước hard delete trên production?

Bài tiếp theo

K09 - Custom domain & preview iframe

Overlay Xem trước không khả dụng khi link gắn tên miền riêng - site live vẫn chạy, chỉ editor iframe bị chặn.

DINHDANH Creator · Bộ hướng dẫn người dùng · K08 · Nhãn UI theo D01