
DINHDANH Creator · Bài T03 · Thuật ngữ
(CRUD list)
Một quyết định sai - dùng writeFile cho danh sách blog/đơn hàng - có thể phá sharding và làm dữ liệu “mất hình” khi scale.
Mục tiêu: Chọn đúng kiểu file; biết API nào đi với flat, API nào với indexed; phát hiện khi AI làm sai.
Thời lượng: 12-14 phút · Trước: T02, F02 · Sau: T04
UI: Backend · Xem backend database content · Chat mode Coder · Kiến trúc · So sánh thay đổi
1. Sơ đồ quyết định
cms-settings.json = { site_name, logo_url, … }blog-posts.json, contacts.json, orders.json2. Thuật ngữ & API Aura Storage
| Thuật ngữ | Nghĩa | API chính |
|---|---|---|
| Flat | Một JSON object cho cả file | readFile, writeFile |
| Indexed / CRUD list | Danh sách có id; master index + shard (T04) | appendData, readList, updateData, readFile(file,id) |
| id / created_at | Backend tự sinh khi append - không tự set | Kết quả appendData |
| Đọc lần đầu rỗng | success: true + [] / null - không phải 404 | Mọi read vdisk |
3. Ví dụ file cụ thể
4. Các bước dùng đúng (qua Creator)
- Tab "Backend" → xác nhận Advanced version nếu cần list lớn / CMS (T06).
- Chat mode "Coder" hoặc "Kiến trúc" → prompt: “Form liên hệ: lưu bằng appendData vào contacts.json (indexed). Admin đọc readList. Không writeFile list.”
- Sau AI sửa → mở So sánh thay đổi → kiểm có appendData/readList; nếu thấy
writeFile('blog-posts.json', [...])cả mảng → ✗. - Submit form thử → Backend → "Xem backend database content" thấy bản ghi mới có id.
- CMS bật: tên file theo
entities.*.data_filetrong __cms_manifest__ (T05) - vd.blog-posts.jsonkhông đổi thành my-blog.json. - Nhấn "Lưu thay đổi" khi ổn.
5. So sánh · Giới hạn
- Airtable / Notion DB: luôn list-oriented; Aura Indexed gần tinh thần đó.
- Một ô nhớ trình duyệt chứa cả danh sách: giống sai lầm writeFile list - vỡ khi lớn.
- Mongo 1 document settings vs collection: flat ≈ settings doc; indexed ≈ collection.
6. Bảo mật · Sự cố
Guest chỉ được appendData khi policy cho phép - không cho guest writeFile/updateData (T07). CMS bật → bám manifest data_file.
| Sự cố | Xử lý |
|---|---|
| List “mất” sau vài trăm bản ghi | Nghi writeFile list - migrate indexed (X07/F05) |
| Đọc lần đầu tưởng lỗi | Khởi tạo default khi rỗng - success vẫn true |
| updateData không tìm id | Dùng id từ appendData/readList - không tự invent |
7. Lời khuyên · Checklist
- Prompt cố định: “Indexed cho mọi danh sách; Flat chỉ cho settings.”
- Một file list (vd. blog-posts.json) chứa mọi item - backend tự shard.
- Bạn phân biệt được khi nào writeFile vs appendData?
- Bạn đọc Diff và từ chối writeFile([...]) cho list?
- Bạn biết readList trả id do backend sinh?
Tiếp: T04 - Sharding & system files
Điều hướng nội bộ (cùng ngôn ngữ)