
DINHDANH Creator · Bài AS10 · Trung bình · Loạt Aura
vì sao tên file phải khớp
CMS đã có 3 bài “Đã xuất bản” nhưng trang blog trống? Thường vì trang và CMS không cùng một “quyển sổ”.
Mục tiêu: Hiểu bản đồ nội dung (manifest); nhờ AI đọc bản đồ trước khi đặt tên file; tự xử lý “CMS đầy / web trống”.
Trước: AS08 · Sau: AS11 · CMS + Prompt / kiểu tùy chỉnh: AS19-AS21 · ~12 phút
1. Sơ đồ “cùng một quyển sổ”

File __cms_manifest__.json giống mục lục thư viện: nói “sách bài viết nằm kệ nào”. Bạn không cần sửa tay file hệ thống - bảo AI đọc mục lục trước.
2. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơi thấy |
|---|---|---|
| Bản đồ nội dung | Khai báo loại nội dung ↔ tên file dữ liệu (data_file) | __cms_manifest__.json (Thư mục) |
| Hợp đồng giao diện | Trang HTML + hook id (#post-list, #de-item-list…) khi sửa layout | __cms_ui_contract__.json |
| Khớp tên file | Trang web đọc đúng sổ CMS đang ghi - luôn lấy từ bản đồ live, không nhớ miệng | Prompt / code trang |
3. Các bước khi trang trống
- Xác nhận CMS thật sự có bài Đã xuất bản.
- Creator · mode Coder: “Đọc bản đồ nội dung CMS trước; dùng đúng tên file dữ liệu bài viết đã khai báo; sửa trang blog đọc đúng sổ đó.”
- Đối chiếu nhanh: số bài trên CMS vs danh sách trang hiện.
- Lưu thay đổi → cứng refresh trang live.
3b. File “cấm đụng tay” & bảng entity chuẩn (SECTION SYSTEM FILES)
Một số file hệ thống không sửa bằng tay / không đọc-ghi như dữ liệu thường:
| File | Làm đúng cách |
|---|---|
login.json | Chỉ qua đăng nhập / Admin Management / CMS Tài khoản (AS05) |
routes.json | Tab Đường dẫn · Thêm Route (AS04) - không ghi đè file lung tung |
cms-settings.json | Cài đặt CMS / quyền admin - biên tập viên nhẹ thường không sửa |
| Thư mục chia sổ nội bộ | Hệ thống tự quản - không nhờ AI “mở / sửa shard” |
Khi CMS bật, tên sổ chuẩn (đọc từ bản đồ):
| Loại | Tên file thường gặp | Khách thêm dòng? |
|---|---|---|
| Bài viết | blog-posts.json | Không |
| Liên hệ | contacts.json | Có (form) |
| Sản phẩm / Đơn | Thường shop-products.json / shop-orders.json - đọc lại manifest nếu site khác | Đơn: thường có (checkout) |
| Trang / Danh mục / Thẻ | pages.json, blog-categories.json, blog-tags.json | Không |
| Kiểu tùy chỉnh (vd. BĐS) | Theo data_file bạn khai báo (vd. properties.json) | Không (chỉ admin CMS) |
Kiểu tùy chỉnh: tạo trên Panel (AS20) hoặc nhờ AI merge đúng hai file (AS21) - không bịa tên file song song. Tổng quan Prompt + quy tắc: AS19. Coder / bảo mật enforce: AM11. Bảo mật UI: AS11.
status === 'published'. Kiểu tùy chỉnh lọc bằng publish_state === 'published'. Sai field → danh sách trống dù CMS đã có tin.4. So sánh
- WordPress: theme query sai post type → cũng trống dù admin có bài.
- Airtable + frontend: sai tên bảng → UI trống.
5. Giới hạn
Làm được
- Sửa bằng prompt rõ ràng
Không
- Không đào code nội bộ panel CMS
6. Checklist
- Prompt có câu “đọc
__cms_manifest__.jsontrước”? - Khi sửa layout: đã nhắc giữ hook trong
__cms_ui_contract__.json? - Lọc đúng
status(blog) haypublish_state(kiểu tùy chỉnh)? - Đã Lưu thay đổi và refresh live?
Tiếp theo
AS11 - Cài đặt bảo mật nội dung
CMS + Aura chi tiết: AS19 · Kiểu tùy chỉnh / BĐS: AS20 · AI merge hai file: AS21
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Aura · AS10