
DINHDANH Creator · Bài AS19 · Aura CMS + Storage
hai file khai báo · Prompt đúng · không Easy
Hiểu nhiệm vụ bảng khai báo nội dung và hợp đồng giao diện - để bạn và AI cùng làm đúng, Panel không lỗi.
Lưu ý quan trọng - Prompt & skills
Backend = Advanced + CMS bật. Creator → Prompt & skills → Mẫu prompt DINHDANH:
- (Tuỳ chọn) Khung chung:
DINHDANH Storage - Shared Prompt Framework (Easy + Aura) - Bắt buộc:
DINHDANH Aura Storage (Advanced) - Complete AI Guide - Bắt buộc khi dùng CMS:
DINHDANH Aura CMS + Storage - Complete AI Guide
Không bật template Easy. CMS không chạy với Easy Storage.
Mục tiêu: Phân biệt hai file khai báo; biết AI đọc/sửa gì; luồng nhờ AI an toàn.
Điều kiện: F01 Advanced · AS01 · AS07 · AS10 (bản đồ nội dung)
Bài sau: AS20 (BĐS / field) · AS21 (AI tự khai báo kiểu - merge hai file)
1. Vì sao không có CMS + Easy?

Aura CMS cần danh sách phân mảnh (readList / appendData / updateData), đăng nhập quản trị, và hai file khai báo trên site. Easy chỉ “một sổ JSON + ghi đè” - không đủ. Bật CMS → hệ thống ép Backend Advanced.
JSON.parse + writeFile cả sổ) → sai. Luôn Aura + bảng khai báo.2. Nhiệm vụ hai file khai báo
| File | Nhiệm vụ | Ai đọc? |
|---|---|---|
__cms_manifest__.jsonBảng khai báo nội dung | Loại nội dung nào · field nào · tên file dữ liệu (data_file) · route · danh mục/thẻ. Nguồn sự thật cho tên file JSON. | Panel /cms (menu + form) · trang khách · AI |
__cms_ui_contract__.jsonHợp đồng giao diện | Trang HTML nào · hook id bắt buộc (#post-list, #de-item-list…) · CSS/JS cần link. Kiểu tùy chỉnh thêm khóa de_…. | AI khi sửa layout · tài liệu CMS · (đồng bộ với trang HTML) |
3. Trang khách vs trang quản trị
| Bề mặt | Được | Không |
|---|---|---|
| Trang khách | Đọc list/file · form công khai appendData (liên hệ…) | writeFile / updateData / ghi HTML / addRoute |
Panel /cms | Sau đăng nhập: CRUD tin, upload, route, sửa khai báo (khi Lưu kiểu) | Đọc/ghi tay file đăng nhập hệ thống |
4. AI được sửa gì / không được sửa gì
| Được | Không |
|---|---|
HTML/CSS/JS trang công khai (blog, shop, properties/…) | Mã nguồn giao diện quản trị /cms của nền tảng |
Gọi Storage đúng data_file trong bảng khai báo | Bịa tên file; trộn API Easy |
| Giữ hook trong hợp đồng giao diện khi làm đẹp layout | Xóa #post-list / #de-item-list… |
| Merge hai file khai báo khi bạn nhờ rõ (AS21) hoặc bạn Lưu kiểu trên Panel (AS20) | Ghi đè cả manifest/contract từ đầu |
5. Loại nội dung có sẵn (nhắc)
Sau khi mở CMS thường có: bài viết, trang tĩnh, danh mục/thẻ blog, sản phẩm, đơn, liên hệ, cài đặt site. Tên file lấy từ bảng khai báo (vd. bài viết thường là blog-posts.json - không nhớ miệng tên cũ kiểu shop-products nếu manifest nói khác).
Lọc trang khách: blog sẵn dùng status === 'published' · kiểu tùy chỉnh dùng publish_state === 'published'.
6. Hai luồng nhờ AI (chọn một)
A - Khuyến nghị
- Panel → Kiểu dữ liệu tùy chỉnh → Lưu (AS20)
- Nhờ AI chỉ chỉnh HTML + bộ lọc
- AI đọc bảng khai báo, không đụng cấu trúc trừ khi bạn nhờ
B - AI tự khai báo
- Bạn nhờ rõ: tạo kiểu + merge hai file
- AI làm đúng AS21 (schema giống Panel)
- Mở
/cmskiểm menu + form không lỗi
7. Checklist trước khi giao AI
- Backend Advanced + CMS bật + đã Lưu thay đổi
- Prompt: Aura Complete + CMS Complete - tắt Easy
- Đã mở
/cms, có tài khoản quản trị (AS07) - Kiểu mới: Panel (AS20) hoặc AI merge (AS21)
- Nhắc AI: đọc
__cms_manifest__.json(+ contract khi sửa HTML) - Không nhờ AI dựng
users.json/ login giả
8. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
AI viết JSON.parse + ghi đè cả sổ | Prompt đang Easy hoặc thiếu CMS guide - tắt Easy, bật lại Aura + CMS Complete |
| CMS có tin, web trống | Sai data_file hoặc lọc nhầm status thay vì publish_state (AS10) |
| Mất blog/shop sau khi “tạo kiểu” | AI đã ghi đè cả file khai báo - khôi phục bản cũ; lần sau chỉ merge (AS21) |
| Panel form kiểu mới lỗi / thiếu menu | Thiếu admin/field_ui hoặc entity ẩn taxonomy - làm lại theo AS20/AS21 |
Bước tiếp
AS20 - Field + ví dụ Bất động sản trên Panel
AS21 - Khi nhờ AI tự khai báo kiểu (merge hai file giống Panel)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · AS19 · CMS + Aura