Tab Backend DINHDANH Creator hiện thẻ Easy và Advanced
Backend - Easy vs Advanced

DINHDANH Creator · Bài EM01 · Loạt Easy Storage

Easy Storage:
trợ lý sẵn có & bản đồ học

Tab Backend = Phiên bản đơn giản (Easy). Bạn chỉ gọi appifio_client - không viết lại thư viện.

Mục tiêu: Hiểu Easy khác Aura thế nào; chờ client sẵn sàng đúng cách; biết đọc loạt EM02-EM09.

Điều kiện: Creator → tab Backend → chọn Easy → lưu trong tab → nhấn Lưu thay đổi.

Đọc kèm: F01 · BR02 · loạt EM

Lưu ý quan trọng - Prompt & skills

Creator → Prompt & skills → Mẫu prompt DINHDANH → bật đúng: DINHDANH Easy Storage - Complete AI Guide. Agent tự có đủ Prompt/skills - bạn không cần tự cung cấp tài liệu Storage.

Không bật cùng lúc template Aura (DINHDANH Aura Storage (Advanced) - Complete AI Guide) - sẽ xung đột và AI hiểu nhầm.

1. Easy là gì? (hình dung)

Easy = một quyển sổ JSON trên máy chủ. Muốn thêm / sửa / xóa bài hay liên hệ: tải cả sổ về trình duyệt → sửa bằng JavaScript → ghi đè cả sổ lên lại.

Trang của bạn → await appifio_client.appifio_…()
→ Máy chủ Easy xử lý
→ Hộp kết quả: { success, message, data? }
Khác Aura (Advanced): Aura cắt danh sách thành nhiều mảnh + có đăng nhập quản trị. Easy không có readList / appendData / trang login admin kiểu Aura. Đừng copy code Aura sang app Easy (đặc biệt JSON.parse - xem EM02).

2. Bạn được làm / không được làm

✅ Làm❌ Không làm
Gọi appifio_client.appifio_readFile(...) (và các hàm đã có)Tự viết class AppStorageClient
Viết giao diện + logic nghiệp vụ (form, list, blog…)Viết lại / ghi đè method appifio_*
Chờ sẵn sàng bằng waitForAppStorage()Kiểm typeof appifio_client === 'undefined' (luôn “có” vì là getter)

3. Chờ client sẵn sàng (bắt buộc trước lần gọi đầu)

Trang vừa mở có thể chưa nạp xong thư viện. Cách đúng:

document.addEventListener('DOMContentLoaded', async () => {
  if (typeof window.waitForAppStorage === 'function') {
    await window.waitForAppStorage();
  }
  // Giờ mới gọi API
  const res = await appifio_client.appifio_readFile('blog.json');
});
Đừng tin kiểm tra if (appifio_client.appifio_readFile) một mình - lúc chờ, hệ thống có thể đưa “proxy xếp hàng” khiến mọi tên method trông như đã có. Ưu tiên waitForAppStorage().

4. Hộp kết quả chuẩn

ÔNghĩa đời thường
successThành công hay không
messageCâu thông báo
dataNội dung hữu ích (content, url, exists…)

Easy không có “đăng nhập admin nội bộ”. Ai có chìa khóa phiên trang hợp lệ gần như làm được mọi ghi/sửa - cẩn thận khi nhờ AI viết trang quản trị.

5. Bản đồ đủ method Easy → bài EM

Mỗi bài EM03-EM08 có thẻ method kiểu AM: Việc · Tham số · Cách gọi · Trả về · Lưu ý (+ checklist đếm method).

NhómMethod (đủ danh sách)Bài
Kho dữ liệucreateFile, readFile, writeFile, deleteFile, restoreFile, hardDeleteFile, fileExists, getFileInfo, renameFile, copyFile, listFiles, searchFiles, findByName, readField, writeField - 15EM03
CompositecreateContentWithRoute, ensureHandlerFile, deleteContentWithRoute, updateContentIndex, removeFromContentIndex - 5EM04
File trang / uploadreadFsFile, writeFsFile, deleteFsFile, listFsFiles, getFsFileInfo, uploadImage, uploadFile - 7EM05
RouteaddRoute, removeRoute, getRoutes - 3EM06
HelpergenerateSlug, formatDateTime, formatFileSize, getRouteSlug, getQueryParams, sanitize/extension/isImage/unique · deepClone · debounce · showError/SuccessEM07
Máy chủexecuteBackendFunction (+ Secrets UI) - 1EM08
Auth adminKhông có (khác AM06 Aura)-
Bài khái niệm / ví dụNội dung
EM01Bản đồ + chờ client
EM02JSON.parse · file trống lần đầu
EM09Ví dụ blog + checklist tổng

6. Cách đọc mỗi thẻ method

  1. Việc làm - một câu đời thường
  2. Ai được gọi - Easy: chìa khóa phiên trang (không Guest/Admin như Aura)
  3. Tham số · Cách gọi · Kết quả trả về · Lưu ý

Tiếp theo

EM02 - Parse JSON & lần đầu chưa có file · rồi EM03 (15 method kho dữ liệu)

DINHDANH Creator · Loạt Easy Storage · EM01