
DINHDANH Creator · Bài EM01 · Loạt 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.
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');
});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 |
|---|---|
success | Thành công hay không |
message | Câu thông báo |
data | Nộ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óm | Method (đủ danh sách) | Bài |
|---|---|---|
| Kho dữ liệu | createFile, readFile, writeFile, deleteFile, restoreFile, hardDeleteFile, fileExists, getFileInfo, renameFile, copyFile, listFiles, searchFiles, findByName, readField, writeField - 15 | EM03 |
| Composite | createContentWithRoute, ensureHandlerFile, deleteContentWithRoute, updateContentIndex, removeFromContentIndex - 5 | EM04 |
| File trang / upload | readFsFile, writeFsFile, deleteFsFile, listFsFiles, getFsFileInfo, uploadImage, uploadFile - 7 | EM05 |
| Route | addRoute, removeRoute, getRoutes - 3 | EM06 |
| Helper | generateSlug, formatDateTime, formatFileSize, getRouteSlug, getQueryParams, sanitize/extension/isImage/unique · deepClone · debounce · showError/Success | EM07 |
| Máy chủ | executeBackendFunction (+ Secrets UI) - 1 | EM08 |
| Auth admin | Không có (khác AM06 Aura) | - |
| Bài khái niệm / ví dụ | Nội dung |
|---|---|
| EM01 | Bản đồ + chờ client |
| EM02 | JSON.parse · file trống lần đầu |
| EM09 | Ví dụ blog + checklist tổng |
6. Cách đọc mỗi thẻ method
- Việc làm - một câu đời thường
- Ai được gọi - Easy: chìa khóa phiên trang (không Guest/Admin như Aura)
- 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)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Easy Storage · EM01