- 1. Tổng quan & triết lý
- 2. Lưu trữ & sharding
- 3. Bảo mật & phân quyền
- 3.1 Easy
- 3.2 Aura (Advanced)
- 4. JSON parsing - điểm dễ vỡ nhất
- 5. Method giống tên - hành vi khác
- 5.1 Chỉ có trên Aura (list + auth)
- 5.2 Composite / index thiên về Easy
- 6. FS, route & backend function
- 7. Flow phát triển điển hình
- 8. Quy tắc vàng khi gen code / nhờ AI
- 9. Bảng tổng hợp methods (đầy đủ)
- 10. Helper - Easy và Aura đồng nhất?
- 11. Checklist nhanh (in mang theo)
- 12. Tóm tắt một đoạn

DINHDANH Creator · Báo cáo BR02 · Đối chiếu kỹ thuật
so sánh chi tiết hai mô hình backend
Đối chiếu đầy đủ triết lý, lưu trữ, bảo mật, JSON parse, method, FS/route, helper, flow gen code - và cách bật đúng Prompt template để AI sinh đúng phiên bản Storage.
Lưu ý quan trọng - Prompt & skills
Trong DINHDANH Creator → tab Prompt & skills → tab Mẫu prompt DINHDANH → chọn đúng tài liệu theo phiên bản Backend. Khi đó AI Agent tự nhận đủ Prompt + skills - bạn không cần tự dán / đính kèm tài liệu Storage cho AI.
| Phiên bản Backend | Bật đúng template (tiêu đề tiếng Anh) |
|---|---|
| Easy (App Storage) | DINHDANH Easy Storage - Complete AI Guide |
| Advanced / Aura | DINHDANH Aura Storage (Advanced) - Complete AI Guide |
| Advanced + CMS | Aura Complete + DINHDANH Aura CMS + Storage - Complete AI Guide (AS19). CMS không chạy với Easy. |
| (Tuỳ chọn) Khung chung | DINHDANH Storage - Shared Prompt Framework (Easy + Aura) - vẫn chỉ kèm một guide Easy hoặc Aura |
Luồng đúng: (1) Tab Backend chọn Easy hoặc Advanced → Lưu → Lưu thay đổi · (2) Prompt template: đúng một guide Easy hoặc Aura (+ CMS guide nếu dùng CMS) · (3) Nhờ AI viết app.
Mục tiêu: Biết khi nào chọn Easy / Aura; không copy pattern từ mô hình này sang mô hình kia; tránh lỗi parse / quyền / xóa list; cấu hình Prompt đúng một template.
Thời lượng: khoảng 25-35 phút
Đối tượng: maker dùng Coder, AI gen code, người đã mở tab Backend (F01).
Đọc kèm: F01 (chọn Easy/Advanced) · hướng dẫn API Easy (loạt EM01-EM09) · Aura (loạt AM01-AM12) · BR01
Bài liên quan: AM02 / AM03 (list & flat Aura) · EM02 / EM03 (parse & một sổ JSON Easy)
1. Tổng quan & triết lý
| Easy (App Storage) | Aura / Advanced | |
|---|---|---|
| Mục tiêu | App vừa-nhỏ, ít bản ghi, tải thấp (landing, biolink, form, blog nhỏ) | App lớn hơn, nhiều dữ liệu, nhiều người, cần quyền rõ + CMS |
| Triết lý | Một sổ JSON - một loại dữ liệu nằm trong một file; trình duyệt tải hết → sửa → ghi đè cả file | Phân mảnh (sharding) - danh sách cắt thành mảnh; client chỉ lấy phần cần; giảm băng thông / race ghi đè |
| Ai xử lý list? | Chủ yếu JS phía trình duyệt (tìm, phân trang, thêm/xóa trên mảng) | Server hỗ trợ readList / appendData / updateData |
| CMS / MCP | Thường không đủ CMS đầy đủ | Cần Advanced (+ gói tài khoản tương ứng) |
appifio_client - nhưng hai bộ quy tắc API khác nhau.2. Lưu trữ & sharding
Giống nhau: Cùng kho dữ liệu nền tảng DINHDANH; cùng lọc tên file độc hại, chặn đuôi thực thi, quét chuỗi nguy hiểm trong nội dung.
| Điểm | Easy | Aura |
|---|---|---|
| Cách lưu | Mỗi tên file = một khối JSON nguyên | flat = khối nguyên (kiểu tờ cấu hình); indexed = master index + mảnh theo từng dòng |
| Cấu trúc bên trong | Máy chủ không phân Object/Array - chỉ validate & lưu | Phân loại rõ flat / indexed |
| Danh sách dài | Cả sổ trong RAM trình duyệt | Chỉ lấy field cần qua readList; mỗi dòng là một mảnh ẩn |
| Thêm / sửa / xóa 1 dòng | Sửa object/mảng rồi writeFile cả sổ | appendData (server cấp id) · updateData · xóa = content null |
3. Bảo mật & phân quyền
3.1 Easy
- Bảo vệ chính: chìa khóa phiên trang (+ quota nền tảng).
- Không có quản trị viên nội bộ app - đừng dựng login/admin kiểu Aura.
- Ai có chìa khóa phiên trang gần như full quyền mutation: kho dữ liệu, file trang, route (qua
appifio_client).
3.2 Aura (Advanced)
- Bốn cấp: Guest → user → admin → superadmin (có vai trò
user, không chỉ Guest/Admin). - Đăng nhập thành công → phiên quản trị được client Aura tự giữ và gửi kèm request sau.
- Auth kín trong
login.json- chặnreadFile/writeFilethường vào file này.
Rate limit Aura (khớp code - đừng nhầm đơn vị):
- Login sai: 5 lần / 10 phút → block IP ~30 phút
- Mutation spam: 60 lần / 1 phút / IP / link → block ~1 giờ (không phải 60 lần/giờ)
- Backend function: 120 lần / 1 giờ / IP / link
- Fail chìa khóa phiên trang cũng có ngưỡng block riêng
4. JSON parsing - điểm dễ vỡ nhất
| Method | Easy | Aura |
|---|---|---|
readFile | content = chuỗi thô → bắt buộc JSON.parse (+ try/catch) | content đã là object/array → không parse lại |
readList | Không có | Đã parse - dùng thẳng mảng |
readFsFile (JSON) | Thường vẫn là string → parse nếu cần | VD routes.json vẫn có thể là string |
readField | value đã decode; thiếu file → success: false | Thiếu → success: true, value: null |
// Easy - đúng
const r = await appifio_client.appifio_readFile('blog.json');
if (r.success && r.data.exists && r.data.content) {
const data = JSON.parse(r.data.content); // try/catch khuyến nghị
}
// Aura - đúng (KHÔNG JSON.parse content)
const a = await appifio_client.appifio_readFile('blog.json', itemId);
const item = a.data.content; // đã là object5. Method giống tên - hành vi khác
- Upload: Easy chỉ cần chìa khóa phiên trang. Aura
uploadImage/uploadFile→ cần đã đăng nhập quản trị. - findByName: Easy mặc định chỉ tìm trong kho dữ liệu, kiểu “chứa” tên. Aura khớp tên file trên kho dữ liệu.
- Route: Easy = client tự đọc/ghi
routes.json(composite JS). Aura = API route + bắt buộc quyền quản trị khi ghi. - hardDelete: Aura thường cần superadmin.
- CMS / MCP: Easy thường không đủ CMS đầy đủ. Aura + gói tài khoản tương ứng → panel CMS (loạt AS).
5.1 Chỉ có trên Aura (list + auth)
appifio_readList- list rút gọn theo fieldsappifio_appendData- thêm dòng (visitor/public cho form)appifio_updateData- sửa; xóa item = contentnull(không códeleteData)- Auth:
login,logout,getSession,registerAdmin,changePassword,updateProfile, quản trị admin… - Helper:
validateAdminSession,isLoggedIn- không thaygetSessionkhi vào trang admin
5.2 Composite / index thiên về Easy
createContentWithRoute, ensureHandlerFile có trên cả hai họ. deleteContentWithRoute, updateContentIndex, removeFromContentIndex - có trên Easy; Aura dùng indexed/shards + tự ghép updateData/removeRoute.
6. FS, route & backend function
Cả hai đều đọc/ghi Physical FS (HTML, asset) và dùng routes.json map URL → file.
| Việc | Easy | Aura |
|---|---|---|
| Đọc FS / list FS | Key phiên trang | Khách đọc được |
| Ghi/xóa FS, thêm/xóa route | Ai có key gần như làm được | Bắt buộc admin |
executeBackendFunction | Có sandbox Node | Có + rate limit chặt hơn; Secrets tách khỏi API client (cấu hình Panel) |
readFile/readList) + appendData cho form. Không gọi writeFile / updateData / addRoute trên frontend public. Xóa 1 dòng list = updateData(file, id, null) - không có deleteData.7. Flow phát triển điển hình
Easy
readFile('data.json')JSON.parse(...)- Sửa bằng JS
writeFile(..., JSON.stringify(data))addRoute(slug, 'detail.html')
Aura
login→ token tự giữ- Form khách:
appendData - Admin list:
appendData/updateData - Trang:
writeFsFile+addRoute - List UI:
readList(..., fields) - Chi tiết:
readFile(file, id)→ shard
8. Quy tắc vàng khi gen code / nhờ AI

Easy - template: DINHDANH Easy Storage - Complete AI Guide
- Luôn parse sau
readFile; không dựng login/admin kiểu Aura. - Vẫn cần chìa khóa phiên trang - ai có key ≈ full mutation.
readFieldthiếu file →success: false.findByNamechỉ kho dữ liệu.
Aura - template: DINHDANH Aura Storage (Advanced) - Complete AI Guide
- Không tự hash mật khẩu admin; không tự tạo
users.jsonquản trị - dùng Auth sẵn. - List: cấm
writeFilecả sổ → dùngappendData/readList/updateData. - Config/settings flat: vẫn
readFile/writeFile. Trang admin bọcgetSession().
9. Bảng tổng hợp methods (đầy đủ)
| Method | Easy | Aura |
|---|---|---|
createFile | Tạo (lỗi nếu đã có) | Có phân loại flat/indexed |
readFile | Trả string → cần JSON.parse | Đã parse; có thể + id để đọc 1 mảnh |
writeFile | Ghi đè (chìa khóa phiên trang) | Ghi đè (cần admin) |
deleteFile / restoreFile | Xóa mềm / khôi phục | Cần admin |
hardDeleteFile | Xóa vĩnh viễn | Thường cần superadmin |
fileExists / getFileInfo / listFiles / searchFiles | Có (metadata / tìm tên) | Có |
renameFile / copyFile | Có | Cần admin |
findByName | Chỉ kho dữ liệu, kiểu “chứa” | Khớp tên trên kho dữ liệu |
readField | Thiếu file/field → success: false | Thiếu → success: true, value: null |
writeField | Chìa khóa phiên trang | Cần admin |
uploadImage / uploadFile | Chìa khóa phiên trang | Cần admin |
readFsFile / listFsFiles / getFsFileInfo | Có | Khách đọc được |
writeFsFile / deleteFsFile | Chìa khóa phiên trang | Cần admin |
addRoute / removeRoute / getRoutes | Composite JS ↔ routes.json | API + admin khi ghi |
executeBackendFunction | Sandbox Node + Secrets (tab Backend) | Có + rate limit chặt hơn |
| Composite / index - thiên Easy | ||
createContentWithRoute / ensureHandlerFile | ✅ | ✅ (họ tương tự + auth/shard) |
deleteContentWithRoute / updateContentIndex / removeFromContentIndex | ✅ (EM04) | ❌ - dùng indexed + tự ghép |
| List / sharding - chỉ Aura | ||
appendData / readList / updateData | ❌ | ✅ (xóa dòng = updateData(..., null)) |
deleteData | ❌ | ❌ không tồn tại |
| Auth / CMS - chỉ Aura | ||
login / logout / getSession / registerAdmin… | ❌ | ✅ (AM06) - trang admin bọc getSession |
| CMS security / MCP / theme helpers | ❌ | ✅ panel CMS (loạt AS) |
Chi tiết từng method + ví dụ: Easy → EM01-EM09 · Aura → AM01-AM12. Không trộn hai loạt.
10. Helper - Easy và Aura đồng nhất?
Các helper JS sau cùng họ logic trên thư viện appifio_client bản Easy và bản Aura / Advanced:
| Helper | Ghi chú |
|---|---|
formatDateTime | UTC / …Z; preset date|time|datetime|full|iso|us|eu; tôn trọng window.__AURA_CMS_DISPLAY_FORMATS__ nếu có |
generateSlug | Slug tiếng Việt cùng kiểu |
formatFileSize, sanitize / extension / isImage / unique name | Đồng nhất |
deepClone, debounce, getRouteSlug, getQueryParams | Đồng nhất |
showError / showSuccess | Hook window.showError / showSuccess nếu trang định nghĩa |
readFile, readField thiếu file, upload auth, route PHP vs composite…).11. Checklist nhanh (in mang theo)
- Tab Backend: Easy hoặc Advanced → Lưu → Lưu thay đổi.
- Prompt & skills → Mẫu prompt DINHDANH: chỉ bật một guide khớp (tên tiếng Anh ở đầu bài).
- Không bật đồng thời Easy + Aura; không tự đính kèm chồng hai bộ tài liệu vào cùng chat.
- Easy
readFile/readFsFileJSON → phảiJSON.parse(try/catch). - Aura
readFile/readList→ không parse lạicontent. - Easy
readFieldthiếu file →success: false; Aura →value: null. - Easy
findByName= chỉ kho dữ liệu. - Aura xóa item list =
updateData(..., null)- không gọideleteData. - Aura rate mutation = 60/phút (không phải /giờ).
- Aura upload = admin; Easy = chỉ chìa khóa phiên trang.
- Role Aura gồm user.
- Học sâu: Easy → EM01-EM09 · Aura → AM01-AM12 · CMS UI → AS · trước giao khách: EM09 hoặc AS17.
12. Tóm tắt một đoạn
readField, upload, route và cách sửa list. Muốn AI sinh đúng: Backend và một Prompt template phải cùng “màu” Easy hoặc Aura - không bật cả hai.Bước tiếp theo gợi ý
F01 → chọn Backend → bật đúng Prompt template → EM01 (Easy) hoặc AM01 (Aura)
Easy: DINHDANH Easy Storage - Complete AI Guide · Aura: DINHDANH Aura Storage (Advanced) - Complete AI Guide
AI Agent làm được gì: BR03
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Báo cáo đối chiếu đầy đủ · BR02