The Backend version: Easy doi Advanced, Advanced dang chon kem Advanced plan
Easy vs Advanced

DINHDANH Creator · Báo cáo BR02 · Đối chiếu kỹ thuật

Easy vs Aura Storage
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 BackendBật đúng template (tiêu đề tiếng Anh)
Easy (App Storage)DINHDANH Easy Storage - Complete AI Guide
Advanced / AuraDINHDANH Aura Storage (Advanced) - Complete AI Guide
Advanced + CMSAura Complete + DINHDANH Aura CMS + Storage - Complete AI Guide (AS19). CMS không chạy với Easy.
(Tuỳ chọn) Khung chungDINHDANH Storage - Shared Prompt Framework (Easy + Aura) - vẫn chỉ kèm một guide Easy hoặc Aura
Không bật cùng lúc Easy + Aura Complete. Bật chồng khiến Agent trộn quy tắc (parse JSON, appendData vs writeFile, auth…) → code dễ sai phiên bản Storage bạn đã chọn trên tab Backend.

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êuApp 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ả filePhâ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 / MCPThường không đủ CMS đầy đủCần Advanced (+ gói tài khoản tương ứng)
Một câu nhớ: Easy = “lấy hết, sửa, đập lên hết”. Aura = “cắt nhỏ, lấy đúng phần, sửa đúng chỗ”. Cù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ểmEasyAura
Cách lưuMỗi tên file = một khối JSON nguyênflat = 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 trongMáy chủ không phân Object/Array - chỉ validate & lưuPhân loại rõ flat / indexed
Danh sách dàiCả sổ trong RAM trình duyệtChỉ 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òngSử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ặn readFile/writeFile thườ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

MethodEasyAura
readFilecontent = chuỗi thô → bắt buộc JSON.parse (+ try/catch)content đã là object/array → không parse lại
readListKhông cóĐã parse - dùng thẳng mảng
readFsFile (JSON)Thường vẫn là string → parse nếu cầnVD routes.json vẫn có thể là string
readFieldvalue đã decode; thiếu file → success: falseThiế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à object

5. 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 fields
  • appifio_appendData - thêm dòng (visitor/public cho form)
  • appifio_updateData - sửa; xóa item = content null (không có deleteData)
  • Auth: login, logout, getSession, registerAdmin, changePassword, updateProfile, quản trị admin…
  • Helper: validateAdminSession, isLoggedIn - không thay getSession khi 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ệcEasyAura
Đọc FS / list FSKey phiên trangKhách đọc được
Ghi/xóa FS, thêm/xóa routeAi có key gần như làm đượcBắt buộc admin
executeBackendFunctionCó sandbox NodeCó + rate limit chặt hơn; Secrets tách khỏi API client (cấu hình Panel)
Aura - trang khách: chỉ đọc (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

  1. readFile('data.json')
  2. JSON.parse(...)
  3. Sửa bằng JS
  4. writeFile(..., JSON.stringify(data))
  5. addRoute(slug, 'detail.html')

Aura

  1. login → token tự giữ
  2. Form khách: appendData
  3. Admin list: appendData / updateData
  4. Trang: writeFsFile + addRoute
  5. List UI: readList(..., fields)
  6. Chi tiết: readFile(file, id) → shard

8. Quy tắc vàng khi gen code / nhờ AI

Danh sach DINHDANH prompt template: Easy Storage, Aura Storage, Shared Framework, Aura CMS
Mot mau Prompt

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.
  • readField thiếu file → success: false. findByName chỉ 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.json quản trị - dùng Auth sẵn.
  • List: cấm writeFile cả sổ → dùng appendData / readList / updateData.
  • Config/settings flat: vẫn readFile/writeFile. Trang admin bọc getSession().

9. Bảng tổng hợp methods (đầy đủ)

MethodEasyAura
createFileTạo (lỗi nếu đã có)Có phân loại flat/indexed
readFileTrả string → cần JSON.parseĐã parse; có thể + id để đọc 1 mảnh
writeFileGhi đè (chìa khóa phiên trang)Ghi đè (cần admin)
deleteFile / restoreFileXóa mềm / khôi phụcCần admin
hardDeleteFileXóa vĩnh viễnThường cần superadmin
fileExists / getFileInfo / listFiles / searchFilesCó (metadata / tìm tên)Có
renameFile / copyFileCóCần admin
findByNameChỉ kho dữ liệu, kiểu “chứa”Khớp tên trên kho dữ liệu
readFieldThiếu file/field → success: falseThiếu → success: true, value: null
writeFieldChìa khóa phiên trangCần admin
uploadImage / uploadFileChìa khóa phiên trangCần admin
readFsFile / listFsFiles / getFsFileInfoCóKhách đọc được
writeFsFile / deleteFsFileChìa khóa phiên trangCần admin
addRoute / removeRoute / getRoutesComposite JS ↔ routes.jsonAPI + admin khi ghi
executeBackendFunctionSandbox 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:

HelperGhi chú
formatDateTimeUTC / …Z; preset date|time|datetime|full|iso|us|eu; tôn trọng window.__AURA_CMS_DISPLAY_FORMATS__ nếu có
generateSlugSlug 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 / showSuccessHook window.showError / showSuccess nếu trang định nghĩa
Không nhầm: Helper đồng nhất không có nghĩa API DB/FS đồng nhất (parse readFile, readField thiếu file, upload auth, route PHP vs composite…).

11. Checklist nhanh (in mang theo)

  1. Tab Backend: Easy hoặc Advanced → Lưu → Lưu thay đổi.
  2. Prompt & skills → Mẫu prompt DINHDANH: chỉ bật một guide khớp (tên tiếng Anh ở đầu bài).
  3. 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.
  4. Easy readFile/readFsFile JSON → phải JSON.parse (try/catch).
  5. Aura readFile/readList → không parse lại content.
  6. Easy readField thiếu file → success: false; Aura → value: null.
  7. Easy findByName = chỉ kho dữ liệu.
  8. Aura xóa item list = updateData(..., null) - không gọi deleteData.
  9. Aura rate mutation = 60/phút (không phải /giờ).
  10. Aura upload = admin; Easy = chỉ chìa khóa phiên trang.
  11. Role Aura gồm user.
  12. 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

Easy lưu cả “sổ” trong một JSON, trình duyệt xử lý và ghi đè; bảo vệ bằng chìa khóa phiên trang, không có admin nội bộ. Aura chia danh sách thành mảnh, có Guest/user/admin/superadmin, rate limit, và method list/auth riêng. Helper ngày giờ/slug gần như giống nhau; khác nhau nằm ở parse JSON, 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

DINHDANH Creator · Báo cáo đối chiếu đầy đủ · BR02