Tab Code mo __cms_manifest__.json voi entities va quy tac storage
__cms_manifest__.json

DINHDANH Creator · Bài K06 · Cấp độ: Kỹ thuật

Đồng bộ frontend
với Aura CMS

Creator làm khung HTML; CMS đăng nội dung - cả hai phải chung manifest, không hai nguồn data song song.

Mục tiêu bài học: Đọc __cms_manifest__ và __cms_ui_contract__; đồng bộ HTML listing/detail với panel Bài viết/Liên hệ/Sản phẩm; route Đường dẫn + Lưu; trạng thái Đã xuất bản / Bản nháp.

Thời lượng đọc: khoảng 19 phút.

Điều kiện trước: G02-G04 (CMS setup), T05 (manifest), H01 (publish), K05 (contacts).

Bài trước: K05 - Form guest appendData.

Bài tiếp theo: K07 - Secrets & Backend Function.

Nhãn UI chính:

Bài viết · Liên hệ · Sản phẩm Đã xuất bản · Bản nháp Đường dẫn · Lưu · Lưu thay đổi __cms_manifest__ · __cms_ui_contract__

1. Sơ đồ một nguồn sự thật (manifest)

__cms_manifest__ = tên entity, data_file, fields, routes, security
↓
Creator HTML (listing/detail) đọc đúng data_file + field names
↓
Panel CMS (Bài viết / Liên hệ / Sản phẩm) ghi cùng data_file
↓
__cms_ui_contract__ = mapping DOM ↔ fields (AI cập nhật khi đổi layout)
↓
Tab Đường dẫn → Lưu routes · Creator Lưu thay đổi publish HTML
❌ Không: posts.json tự đặt + manifest posts_data.json - hai nguồn lệch nhau

2. Bảng thuật ngữ

Thuật ngữNghĩaNơi UI
__cms_manifest__Schema CMS: entity, file, field, routeFile JSON project · đọc qua AI Coder
__cms_ui_contract__Liên kết selector HTML ↔ field CMSFile JSON · cập nhật khi đổi layout
data_fileFile JSON chứa bản ghi entityKhai báo trong manifest
Đã xuất bản / Bản nhápTrạng thái hiển thị trên frontendPanel CMS khi sửa bài
Đường dẫn + LưuCấu hình route listing/detailTab Creator (≠ Lưu thay đổi)
Theme panel CMSMàu/spacing CMS admin - không thay HTML CreatorCMS Giao diện

3. Các bước tuần tự

  1. Bước 1 - Mở CMS: truy cập /{url}/cms - xác nhận entity có trong sidebar: Bài viết, Liên hệ, Sản phẩm…
  2. Bước 2 - Đọc manifest trước khi prompt: mode Coder: “Đọc __cms_manifest__.json trước; dùng đúng data_file và field names; cập nhật __cms_ui_contract__ nếu sửa layout listing/detail.”
  3. Bước 3 - Routes: tab Đường dẫn - đủ route blog list, chi tiết /blog/:slug (ví dụ) → nút Lưu (routes only).
  4. Bước 4 - HTML đọc đúng file: listing page gọi readList/readOne trên data_file manifest - không hardcode tên file khác.
  5. Bước 5 - CMS tạo nội dung: tạo bài Đã xuất bản (hoặc Bản nháp để test) - field khớp manifest.
  6. Bước 6 - Preview Creator: preview Thay đổi - bài mới hiện trên frontend nháp.
  7. Bước 7 - Kiểu dữ liệu mới: tạo ở CMS Kiểu dữ liệu trước - không để AI invent entity/file song song manifest.
  8. Bước 8 - Publish: Lưu thay đổi Creator → kiểm URL live - CMS và HTML cùng data.

4. Giải thích tính năng liên quan

Manifest = hợp đồng giữa Creator và CMS

Mọi entity (Bài viết, Sản phẩm, Liên hệ) khai báo data_file, field type, slug rules. HTML và panel CMS đều tuân - sửa schema chỉ ở manifest + CMS Kiểu dữ liệu, rồi cập nhật HTML theo.

UI contract - layout đổi không mất mapping

Khi Inspector/AI đổi class HTML, __cms_ui_contract__ ghi selector mới ↔ field title, body… Dynamic render vẫn bind đúng sau publish.

Đã xuất bản vs Bản nháp

Frontend public chỉ nên list bài Đã xuất bản. Bản nháp dùng staging - kiểm trên preview Thay đổi hoặc admin preview URL.

5. So sánh 3 mô hình tách design/content

Mô hìnhDesign vs contentDINHDANH
WordPress theme + adminTheme PHP + post DBCreator HTML + JSON manifest + CMS panel
Webflow Designer + EditorDesigner locked · Editor sửa CMS fieldsCreator sửa layout · CMS sửa nội dung - manifest liên kết
Headless (Next + Strapi)API riêng · frontend fetchCùng Storage - appifio_client đọc file manifest, không API thứ 3

6. Làm được / không làm được

Làm được

  • Một data_file cho CMS + frontend + form Liên hệ (K05).
  • Thêm entity mới qua CMS Kiểu dữ liệu → cập nhật HTML theo manifest.
  • Theme CMS admin tách khỏi giao diện site Creator.

Không làm được / tránh

  • Hai file JSON cùng loại nội dung (posts.json + articles.json).
  • Sửa field CMS mà không cập nhật HTML/contract.
  • Expect Theme panel CMS thay toàn bộ HTML listing - phải sửa Creator.

7. Bảo mật đồng bộ CMS

  • Manifest security enforce ai được append/read - guest form K05 phải khớp.
  • Không expose draft Bản nháp trên route public - filter status trong HTML.
  • Review Diff khi AI thêm entity/file ngoài manifest - có thể bỏ qua chính sách bảo mật.

8. Bảng sự cố

Sự cốXử lý
CMS có bài, frontend trốngHTML đọc sai data_file · bài chưa Đã xuất bản · chưa Lưu thay đổi.
Field CMS không hiện trên trangCập nhật __cms_ui_contract__ · sai tên field vs manifest.
Route 404 chi tiết bàiTab Đường dẫn → Lưu thiếu pattern slug.
AI invent file JSON mớiXóa file lệch · bám manifest · tạo entity ở CMS Kiểu dữ liệu.
Liên hệ form vs CMS panel lệchCùng data_file contacts trong manifest (K05).

9. Lời khuyên

  • Mọi prompt CMS bắt đầu “đọc __cms_manifest__ trước” - thói quen K01/K06.
  • Sửa layout listing → cập nhật contract trong cùng Diff, không để sau.
  • Test: tạo 1 bài CMS → refresh preview Thay đổi trước Lưu thay đổi.
  • Dynamic types mới: G04 + CMS Kiểu dữ liệu trước, HTML sau - không ngược.

10. Checklist & bài tiếp theo

  1. __cms_manifest__ và __cms_ui_contract__ khác nhau thế nào?
  2. Tại sao không được hai data_file cùng loại nội dung?
  3. Lưu (Đường dẫn) vs Lưu thay đổi?
  4. Bài Bản nháp có hiện frontend public không?
  5. Quy trình thêm entity Sản phẩm từ CMS đến HTML?

Bài tiếp theo

K07 - Secrets & Backend Function

Phần admin-only mà guest form K05 không được gọi - email, payment, logic server bảo mật.

DINHDANH Creator · K06 · Đồng bộ frontend ↔ CMS