Backend File Type flat vs indexed cho list
Flat vs indexed

DINHDANH Creator · Bài X07 · Xử lý sự cố

AI dùng writeFile cho list
→ data hỏng

Danh sách contacts/products/blog “mất”, co lại, hoặc hỏng shard - thường do writeFile ghi cả mảng thay vì indexed CRUD.

Mục tiêu: Phát hiện Diff có writeFile('contacts.json', [...]); migrate sang appendData/readList/updateData; cứu bằng Clone/Checkpoint.

Thời lượng: ~12 phút · Trước: T03, F05 · Sau: X08

Nhãn UI: So sánh thay đổi: · Phiên bản · Tạo mới (Clone) · Backend · Xem backend database content · Lưu thay đổi · Hủy

Cảnh báo: writeFile lên file indexed (contacts, products, orders…) có thể ghi đè / phá sharding - dữ liệu có thể không khôi phục nếu đã Lưu thay đổi mà không có Clone.

1. Sơ đồ nhận biết & sửa

Triệu chứng: list mất khi lớn · admin chỉ thấy vài bản ghi · Diff có writeFile([...]) cả mảng
→ Chưa Lưu thay đổi? ✗ Diff hoặc Hủy
→ Đã Lưu? tab Phiên bản → chuyển Clone/Checkpoint cũ
→ Trước migrate: Tạo mới (Clone)
→ Prompt: chuyển sang indexed - appendData + readList + updateData + deleteFile(id)
→ Diff: ✗ mọi writeFile lên contacts/products/orders list
→ Test append → Backend Xem backend database content
❌ KHÔNG writeFile cả mảng list · KHÔNG đụng .shards (T04)

2. Thuật ngữ (Flat vs Indexed - T03)

KiểuDùng khiAPI đúng
FlatMột object cấu hình (settings)readFile / writeFile
Indexed / CRUD listcontacts, products, blog posts, orders…appendData · readList · updateData · readFile(file,id)
writeFile listSai - ghi đè master + phá shardLuôn ✗ trong Diff

3. Các bước cứu & migrate

Danh sach CMS Contacts de kiem list sau khi cuu
Kiem contacts
  1. Cứu khẩn: nếu chưa publish → Hủy hoặc ✗ Diff writeFile.
  2. Đã publish → tab Phiên bản → chọn Clone/Checkpoint trước khi AI phá (T10).
  3. Tạo mới (Clone) trước mọi migrate lớn.
  4. Mode Coder / Kiến trúc: “Chuyển contacts/products sang indexed; cấm writeFile list; dùng appendData/readList/updateData.”
  5. Mở So sánh thay đổi: - ✗ nếu thấy writeFile('contacts.json', [...]) hoặc tương tự products/orders.
  6. Preview Thay đổi → submit thử → tab Backend → Xem backend database content.
  7. CMS bật: bám data_file trong manifest (T05) - không đặt tên file tùy ý.
  8. OK → Lưu thay đổi.

4. So sánh · Làm được / Không

Một ô nhớ trình duyệt chứa cả danh sách: giống sai lầm writeFile list - vỡ khi scale. Airtable/Notion DB: luôn record-oriented ≈ indexed Aura.

Làm được: List lớn nhờ shard tự động; restore từ Clone; reject Diff sớm.
Không: Tự ghép shard tay; tự set id; writeFile ghi cả mảng; sửa file .shards/*.

5. Bảo mật

Guest chỉ được appendData khi policy cho phép - không cho guest writeFile/updateData (K05/T07). writeFile list từ frontend guest = vừa hỏng data vừa lỗ hổng.

6. Bảng sự cố chi tiết

Triệu chứngXử lý
List “mất” sau vài trăm bản ghiNghi writeFile - migrate indexed; restore Clone
Diff thấy writeFile([...])✗ từ chối - prompt lại appendData
Chỉ còn 1 object thay vì listFile bị ghi đè flat - Clone + migrate
CMS panel trống dù form OKSai data_file / writeFile sai file manifest
Đã Lưu thay đổi, không backupClone cũ nếu còn; không magic - liên hệ support

7. Lời khuyên · Checklist

  • Prompt chốt mọi dự án: “Indexed cho mọi danh sách; Flat chỉ settings.”
  • Review Diff như review PR - một dòng writeFile list = ✗ ngay.
  • Trước prompt CMS lớn: Clone + (tuỳ) Export .afi.
  1. Phân biệt Flat vs Indexed (T03)?
  2. Biết ✗ writeFile trên contacts/products trong Diff?
  3. Có Clone trước khi để AI migrate list?