
DINHDANH Creator · Bài T05 · Thuật ngữ
__cms_manifest__.json&
__cms_ui_contract__.jsonKhi Aura CMS bật, đây là “luật chơi” bắt buộc: AI không được tự đặt tên file entity - phải theo manifest.
Mục tiêu: Phân biệt CMS tắt vs bật; đọc entities/fields/routes/frontend; khi nào cần UI contract.
Thời lượng: 13-15 phút · Trước: G01, G04, T03 · Sau: T06
UI CMS: Tổng quan · Loại dữ liệu · Giao diện · Cài đặt · Danh mục nội dung · Bài viết · Sản phẩm
1. Sơ đồ
__cms_manifest__.jsonentities.posts.data_file = blog-posts.json (ví dụ)__cms_ui_contract__.json (hooks DOM)2. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơi thấy |
|---|---|---|
| __cms_manifest__.json | Bản đồ entity, field, data_file, routes | Kho file · Panel CMS · tab Thư mục |
| __cms_ui_contract__.json | Hook layout frontend ↔ CMS inject | Khi AI sửa blog-list.html, product-detail.html |
| entities.*.data_file | Tên file indexed bắt buộc | Form Loại dữ liệu · File lưu trữ |
| publish_state | draft / published / private / trash - kiểu tùy chỉnh (blog sẵn dùng status) | Form tin kiểu tùy chỉnh trong CMS |
| Security enforce | Lọc field · chặn guest append | Cài đặt CMS |
3. Ví dụ manifest (rút gọn)
Frontend phải readList('blog-posts.json') - không đọc my-posts.json do AI tự đặt.
4. Các bước thực tế
- Mở
/{url}/cms→ đăng nhập → nav Bài viết, Sản phẩm, Loại dữ liệu khớp entity nào. - Creator → tab Thư mục → mở
__cms_manifest__.json(sau bootstrap CMS). - Prompt: “Đọc __cms_manifest__.json trước. Tuân data_file. Sửa HTML theo __cms_ui_contract__ nếu có.”
- Đăng thử bài Đã xuất bản → kiểm route tab Đường dẫn (T08) → preview listing.
- Thêm kiểu tùy chỉnh: CMS → Loại dữ liệu / Kiểu dữ liệu tùy chỉnh → Lưu (AS20). Không để AI tạo file song song tên khác. Nếu nhờ AI tự khai báo: merge hai file theo AS21.
- Lưu thay đổi Creator sau khi AI sửa frontend.
5. So sánh · Giới hạn · Bảo mật
- WordPress CPT + ACF: manifest ≈ đăng ký post type + fields.
- Strapi content-types: schema JSON tương tự entities.
- Webflow CMS collections: AI DINHDANH phải bám schema khi CMS on.
Làm được: đồng bộ Panel ↔ frontend. Không: invent my-posts.json khi manifest chỉ blog-posts.json.
Bảo mật: Security enforce ẩn field nhạy cảm với guest; đừng hardcode hiện hết field admin ra public HTML.
5b. Lời khuyên
- Prompt AI luôn bắt đầu: “CMS ON - đọc __cms_manifest__.json”.
- Khi sửa listing HTML, kiểm __cms_ui_contract__ cho selector hook trước khi đổi class tùy ý.
6. Sự cố · Checklist
| Sự cố | Xử lý |
|---|---|
| CMS có bài nhưng trang trống | Sai data_file / thiếu route / AI đọc file khác manifest |
| Hai nguồn data lệch | Xóa file tự đặt tên; thống nhất manifest |
| Listing HTML không khớp field mới | Đọc lại manifest fields + ui_contract hooks |
- Bạn biết khi CMS bật phải đọc manifest trước prompt?
- data_file trong code khớp entities.* trong manifest?
- Bạn phân biệt manifest (data) vs ui_contract (layout hooks)?
Thực hành CMS + AI
AS19 · AS20 · AS21
Prompt stack · Panel tạo kiểu · AI merge hai file Panel-safe
Thuật ngữ tiếp: T06 - Easy vs Advanced Storage
Điều hướng nội bộ (cùng ngôn ngữ)