- 1. Nhắc lại: mỗi file làm gì?
- 2. Quy tắc vàng: chỉ MERGE
- 3. Thứ tự AI phải làm (giống Panel Lưu)
- 4. Trong bảng khai báo - entity chính phải có
- 5. Entity ẩn danh mục (bắt buộc nếu bật Categories)
- 6. Trong hợp đồng giao diện - khóa bắt buộc
- 7. Checklist “Panel đọc không lỗi”
- 8. Prompt mẫu nhờ AI tự khai báo (BĐS)

DINHDANH Creator · Bài AS21 · AI khai báo kiểu · Panel-safe
merge đúng · Panel đọc không lỗi
Khi bạn nhờ AI tạo kiểu mà không bấm Lưu trên Panel - AI phải cập nhật hai file khai báo cùng quy ước Panel, rồi tạo HTML + route.
Khi nào dùng bài này?
Chỉ khi bạn nhờ rõ AI tự tạo kiểu (không qua màn Kiểu dữ liệu tùy chỉnh). Cách an toàn hơn vẫn là AS20 (Panel Lưu).
Prompt bắt buộc: DINHDANH Aura CMS + Storage - Complete AI Guide (+ Aura Complete). Không bật Easy.
Mục tiêu: Biết AI phải merge gì vào hai file; checklist để mở /cms thấy menu + form đúng.
Trước: AS19 (nhiệm vụ hai file) · AS20 (field + BĐS trên Panel)
1. Nhắc lại: mỗi file làm gì?

__cms_manifest__.json- bảng khai báo nội dung: entity, field,data_file, route, taxonomy. Panel đọc để hiện menu và form.__cms_ui_contract__.json- hợp đồng giao diện: trang HTML, hook id, asset. Kiểu mới thêm khóade_{mã}_list/detail…
2. Quy tắc vàng: chỉ MERGE
- Đăng nhập quản trị (AI ghi file trang / gắn route cần quyền).
- Đọc từng file khai báo hiện có → parse nếu là chuỗi.
- Không ghi file mới từ đầu (mất blog/shop).
- Chỉ thêm/cập nhật khóa của kiểu mới; giữ nguyên phần sẵn.
- Ghi HTML list/detail khớp hook ·
addRoutelist. - Mở
/cmskiểm menu + form thêm tin.
3. Thứ tự AI phải làm (giống Panel Lưu)
2. Merge bảng khai báo: entities.{key} với custom:true
3. Nếu bật danh mục/thẻ → thêm entity ẩn {key}__cat / {key}__tag
4. Merge hợp đồng giao diện: de_{key}_list / detail (+ category/tag)
5. Ghi HTML list + detail (giữ #de-item-list / #de-item-detail)
6. addRoute danh sách (+ taxonomy nếu có)
7. Tự kiểm checklist mục 6
4. Trong bảng khai báo - entity chính phải có
AI phải viết đủ các khối (không thiếu admin.form / field_ui):
custom: true·label·data_filefields- chỉ field nghiệp vụ; không nhétid/slug/created_at/updated_atadmin: icon, list columns,form.groups,field_ui(widget)frontend:list_fields+public_filter: { publish_state: "published" }routes: list_page, list_route, detail_page, detail_route (có{slug}nếu cần)
publish_state không nằm trong fields - gắn khi lưu từng tin. Enum dùng mảng enum: ["sale","rent"].
5. Entity ẩn danh mục (bắt buộc nếu bật Categories)
Ví dụ kiểu properties + danh mục - cần cả hai:
- Trên entity cha: khối
taxonomy.categories(enabled,data_file,list_route,list_page,entity_key) - Entity con khóa
properties__cat:hidden: true,parent_entity: "properties",taxonomy_role: "category", fieldname/slug/description,admin.enabled: false
Thẻ tương tự: properties__tag, taxonomy_role: "tag". Thiếu entity ẩn → Panel quản danh mục dễ lỗi.
6. Trong hợp đồng giao diện - khóa bắt buộc
| Trang | Khóa pages/routes | Hook HTML |
|---|---|---|
| Danh sách | de_{key}_list | #de-item-list |
| Chi tiết | de_{key}_detail (+ dynamic: true) | #de-item-detail |
| Danh mục | de_{key}_category | #de-tax-item-list |
| Thẻ | de_{key}_tag | #de-tax-item-list |
Mỗi page trong contract cần: file, route, body_attrs (có data-aura-cms-root + entity), mảng assets (cms-public.css, engagement, store), required_hooks.
7. Checklist “Panel đọc không lỗi”
Manifest
- Không xóa entities sẵn (posts, products…)
custom: true+ đủ fields / admin / frontend / routespublic_filter.publish_state === "published"- Bật danh mục ⇒ có cả taxonomy trên cha +
{key}__catẩn
UI contract
- Chỉ thêm
de_*, không xóa blog/shop - Hook + body_attrs + assets đủ
Đi kèm
- HTML có đúng id hook
addRoutelist OK- Mở
/cms→ thấy kiểu mới → form hiện đúng field
8. Prompt mẫu nhờ AI tự khai báo (BĐS)
“CMS Aura đang bật. Hãy tạo kiểu tùy chỉnh properties (Bất động sản): field title, description, listing_type enum sale/rent, price, area_m2, bedrooms, bathrooms, address, city, cover_image; bật taxonomy categories. Merge (không ghi đè cả file) vào __cms_manifest__.json và __cms_ui_contract__.json đúng quy ước Panel: entity ẩn properties__cat, khóa contract de_properties_*, hook #de-item-list / #de-item-detail. Tạo HTML + addRoute. Sau đó xác nhận mở /cms thấy menu và form. Không dùng Easy.”
Tài liệu AI đầy đủ schema
DINHDANH Aura CMS + Storage - Complete AI Guide · mục 0A-0E (merge + JSON mẫu)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · AS21 · AI khai báo kiểu · Panel-safe