- 1. Sơ đồ một nguồn sự thật (manifest)
- 2. Bảng thuật ngữ
- 3. Các bước tuần tự
- 4. Giải thích tính năng liên quan
- Manifest = hợp đồng giữa Creator và CMS
- UI contract - layout đổi không mất mapping
- Đã xuất bản vs Bản nháp
- 5. So sánh 3 mô hình tách design/content
- 6. Làm được / không làm được
- 7. Bảo mật đồng bộ CMS
- 8. Bảng sự cố
- 9. Lời khuyên
- 10. Checklist & bài tiếp theo

DINHDANH Creator · Bài K06 · Cấp độ: Kỹ thuật
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:
1. Sơ đồ một nguồn sự thật (manifest)
data_file + field namesdata_file2. Bảng thuật ngữ
| Thuật ngữ | Nghĩa | Nơi UI |
|---|---|---|
| __cms_manifest__ | Schema CMS: entity, file, field, route | File JSON project · đọc qua AI Coder |
| __cms_ui_contract__ | Liên kết selector HTML ↔ field CMS | File JSON · cập nhật khi đổi layout |
| data_file | File JSON chứa bản ghi entity | Khai báo trong manifest |
| Đã xuất bản / Bản nháp | Trạng thái hiển thị trên frontend | Panel CMS khi sửa bài |
| Đường dẫn + Lưu | Cấu hình route listing/detail | Tab Creator (≠ Lưu thay đổi) |
| Theme panel CMS | Màu/spacing CMS admin - không thay HTML Creator | CMS Giao diện |
3. Các bước tuần tự
- 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… - Bước 2 - Đọc manifest trước khi prompt: mode Coder: “Đọc
__cms_manifest__.jsontrước; dùng đúng data_file và field names; cập nhật__cms_ui_contract__nếu sửa layout listing/detail.” - Bước 3 - Routes: tab Đường dẫn - đủ route blog list, chi tiết
/blog/:slug(ví dụ) → nút Lưu (routes only). - Bước 4 - HTML đọc đúng file: listing page gọi readList/readOne trên
data_filemanifest - không hardcode tên file khác. - 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.
- Bước 6 - Preview Creator: preview Thay đổi - bài mới hiện trên frontend nháp.
- 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.
- 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ình | Design vs content | DINHDANH |
|---|---|---|
| WordPress theme + admin | Theme PHP + post DB | Creator HTML + JSON manifest + CMS panel |
| Webflow Designer + Editor | Designer locked · Editor sửa CMS fields | Creator sửa layout · CMS sửa nội dung - manifest liên kết |
| Headless (Next + Strapi) | API riêng · frontend fetch | Cù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
securityenforce 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ống | HTML đọ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 trang | Cập nhật __cms_ui_contract__ · sai tên field vs manifest. |
| Route 404 chi tiết bài | Tab Đường dẫn → Lưu thiếu pattern slug. |
| AI invent file JSON mới | Xóa file lệch · bám manifest · tạo entity ở CMS Kiểu dữ liệu. |
| Liên hệ form vs CMS panel lệch | Cù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
- __cms_manifest__ và __cms_ui_contract__ khác nhau thế nào?
- Tại sao không được hai data_file cùng loại nội dung?
- Lưu (Đường dẫn) vs Lưu thay đổi?
- Bài Bản nháp có hiện frontend public không?
- 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.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · K06 · Đồng bộ frontend ↔ CMS