
DINHDANH Creator · Bài X07 · Xử lý sự cố
→ 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
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
2. Thuật ngữ (Flat vs Indexed - T03)
| Kiểu | Dùng khi | API đúng |
|---|---|---|
| Flat | Một object cấu hình (settings) | readFile / writeFile |
| Indexed / CRUD list | contacts, products, blog posts, orders… | appendData · readList · updateData · readFile(file,id) |
| writeFile list | Sai - ghi đè master + phá shard | Luôn ✗ trong Diff |
3. Các bước cứu & migrate

- Cứu khẩn: nếu chưa publish → Hủy hoặc ✗ Diff writeFile.
- Đã publish → tab Phiên bản → chọn Clone/Checkpoint trước khi AI phá (T10).
- Tạo mới (Clone) trước mọi migrate lớn.
- Mode Coder / Kiến trúc: “Chuyển contacts/products sang indexed; cấm writeFile list; dùng appendData/readList/updateData.”
- Mở So sánh thay đổi: - ✗ nếu thấy
writeFile('contacts.json', [...])hoặc tương tự products/orders. - Preview Thay đổi → submit thử → tab Backend → Xem backend database content.
- CMS bật: bám
data_filetrong manifest (T05) - không đặt tên file tùy ý. - 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.
.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ứng | Xử lý |
|---|---|
| List “mất” sau vài trăm bản ghi | Nghi writeFile - migrate indexed; restore Clone |
| Diff thấy writeFile([...]) | ✗ từ chối - prompt lại appendData |
| Chỉ còn 1 object thay vì list | File bị ghi đè flat - Clone + migrate |
| CMS panel trống dù form OK | Sai data_file / writeFile sai file manifest |
| Đã Lưu thay đổi, không backup | Clone 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.
- Phân biệt Flat vs Indexed (T03)?
- Biết ✗ writeFile trên contacts/products trong Diff?
- Có Clone trước khi để AI migrate list?
Bài tiếp theo
Điều hướng nội bộ (cùng ngôn ngữ)