
DINHDANH Creator · Bài K08 · Kỹ thuật
· 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
2. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơ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 được | Xó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ác | Chỉ khi bật Hiện file đã xóa |
| Hiện file đã xóa | Toggle xem danh sách file/thư mục đã xóa mềm | Toolbar tab Thư mục |
| Khôi phục file | Đưa file về trạng thái bình thường, dùng ngay được | Cạnh file đã xóa mềm |
| restoreFile / hardDeleteFile | API backend tương ứng - hard thường cần superadmin | Không có nút cho role thấp |
3. Các bước khôi phục sau xóa nhầm
- Mở tab Thư mục (Files).
- 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.
- 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).
- Tắt toggle để quay về cây file bình thường - kiểm tra route/link còn trỏ đúng file.
- 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ống | Xử lý |
|---|---|
| Xóa nhầm file HTML quan trọng | Bậ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ễn | Role không đủ - nhờ superadmin hoặc chỉ dùng soft delete |
| Trang 404 sau khi xóa file | Khô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ạn | Xó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
- Bạn phân biệt được soft delete và Xóa vĩnh viễn?
- Bạn khôi phục được file qua Hiện file đã xóa → Khôi phục file?
- 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.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · K08 · Nhãn UI theo D01