DINHDANH Man Custom data types CMS AI nen dung thay vi sua le mot file
Uu tien Save Panel

DINHDANH Creator · Bài AS21 · AI khai báo kiểu · Panel-safe

AI tự khai báo kiểu tùy chỉnh
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ì?

DINHDANH Ban do Pages CMS de kiem route van khop sau khi doi kieu
Kiem sau merge
  • __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óa de_{mã}_list / detail…

2. Quy tắc vàng: chỉ MERGE

  1. Đăng nhập quản trị (AI ghi file trang / gắn route cần quyền).
  2. Đọc từng file khai báo hiện có → parse nếu là chuỗi.
  3. Không ghi file mới từ đầu (mất blog/shop).
  4. Chỉ thêm/cập nhật khóa của kiểu mới; giữ nguyên phần sẵn.
  5. Ghi HTML list/detail khớp hook · addRoute list.
  6. Mở /cms kiểm menu + form thêm tin.
Ghi đè cả file khai báo = hỏng site CMS. Luôn merge.

3. Thứ tự AI phải làm (giống Panel Lưu)

1. Kiểm tra mã kiểu hợp lệ (không trùng posts/products/…)
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_file
  • fields - chỉ field nghiệp vụ; không nhét id/slug/created_at/updated_at
  • admin: 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", field name/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

TrangKhóa pages/routesHook HTML
Danh sáchde_{key}_list#de-item-list
Chi tiếtde_{key}_detail (+ dynamic: true)#de-item-detail
Danh mụcde_{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 / routes
  • public_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
  • addRoute list 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)

DINHDANH Creator · AS21 · AI khai báo kiểu · Panel-safe