__cms_manifest__.json mo trong Code voi schema posts
CMS manifest

DINHDANH Creator · Bài T05 · Thuật ngữ

__cms_manifest__.json
& __cms_ui_contract__.json

Khi 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 TẮT → AI tự chọn tên file flat/indexed theo app
CMS BẬT → bắt buộc đọc __cms_manifest__.json
→ entities.posts.data_file = blog-posts.json (ví dụ)
→ fields, routes.list/detail, frontend.list_html
→ sửa layout HTML → __cms_ui_contract__.json (hooks DOM)
Panel /{url}/cms quản trị theo entities trong manifest

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
__cms_manifest__.jsonBản đồ entity, field, data_file, routesKho file · Panel CMS · tab Thư mục
__cms_ui_contract__.jsonHook layout frontend ↔ CMS injectKhi AI sửa blog-list.html, product-detail.html
entities.*.data_fileTên file indexed bắt buộcForm Loại dữ liệu · File lưu trữ
publish_statedraft / 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 enforceLọc field · chặn guest appendCài đặt CMS

3. Ví dụ manifest (rút gọn)

"entities": {
  "posts": {
    "data_file": "blog-posts.json",
    "routes": { "list": "blog", "detail": "blog/{slug}" },
    "frontend": { "list_html": "blog-list.html", "detail_html": "blog-detail.html" }
  }
}

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ế

  1. 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.
  2. Creator → tab Thư mục → mở __cms_manifest__.json (sau bootstrap CMS).
  3. Prompt: “Đọc __cms_manifest__.json trước. Tuân data_file. Sửa HTML theo __cms_ui_contract__ nếu có.”
  4. Đăng thử bài Đã xuất bản → kiểm route tab Đường dẫn (T08) → preview listing.
  5. 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.
  6. 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ốngSai data_file / thiếu route / AI đọc file khác manifest
Hai nguồn data lệchXó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
  1. Bạn biết khi CMS bật phải đọc manifest trước prompt?
  2. data_file trong code khớp entities.* trong manifest?
  3. 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