DINHDANH Bang Pages CMS la ban do noi dung file va route
Ban do trang

DINHDANH Creator · Bài AS10 · Trung bình · Loạt Aura

Bản đồ nội dung
vì sao tên file phải khớp

CMS đã có 3 bài “Đã xuất bản” nhưng trang blog trống? Thường vì trang và CMS không cùng một “quyển sổ”.

Mục tiêu: Hiểu bản đồ nội dung (manifest); nhờ AI đọc bản đồ trước khi đặt tên file; tự xử lý “CMS đầy / web trống”.

Trước: AS08 · Sau: AS11 · CMS + Prompt / kiểu tùy chỉnh: AS19-AS21 · ~12 phút

__cms_manifest__.json __cms_ui_contract__.json Coder Lưu thay đổi Thư mục

1. Sơ đồ “cùng một quyển sổ”

DINHDANH Tab Security CMS liet ke ten kho theo tung kieu noi dung
Danh muc kho
Bản đồ nội dung khai báo: bài viết → file A
CMS ghi vào file A ✓
Trang blog đọc file B ✗ → danh sách trống
Sửa: trang đọc đúng file A (đúng tên đã khai báo)

File __cms_manifest__.json giống mục lục thư viện: nói “sách bài viết nằm kệ nào”. Bạn không cần sửa tay file hệ thống - bảo AI đọc mục lục trước.

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
Bản đồ nội dungKhai báo loại nội dung ↔ tên file dữ liệu (data_file)__cms_manifest__.json (Thư mục)
Hợp đồng giao diệnTrang HTML + hook id (#post-list, #de-item-list…) khi sửa layout__cms_ui_contract__.json
Khớp tên fileTrang web đọc đúng sổ CMS đang ghi - luôn lấy từ bản đồ live, không nhớ miệngPrompt / code trang

3. Các bước khi trang trống

  1. Xác nhận CMS thật sự có bài Đã xuất bản.
  2. Creator · mode Coder: “Đọc bản đồ nội dung CMS trước; dùng đúng tên file dữ liệu bài viết đã khai báo; sửa trang blog đọc đúng sổ đó.”
  3. Đối chiếu nhanh: số bài trên CMS vs danh sách trang hiện.
  4. Lưu thay đổi → cứng refresh trang live.
Không nhờ AI “xóa / viết lại lung tung file hệ thống panel”. Chỉ chỉnh trang đọc đúng sổ đã khai báo.

3b. File “cấm đụng tay” & bảng entity chuẩn (SECTION SYSTEM FILES)

Một số file hệ thống không sửa bằng tay / không đọc-ghi như dữ liệu thường:

FileLàm đúng cách
login.jsonChỉ qua đăng nhập / Admin Management / CMS Tài khoản (AS05)
routes.jsonTab Đường dẫn · Thêm Route (AS04) - không ghi đè file lung tung
cms-settings.jsonCài đặt CMS / quyền admin - biên tập viên nhẹ thường không sửa
Thư mục chia sổ nội bộHệ thống tự quản - không nhờ AI “mở / sửa shard”

Khi CMS bật, tên sổ chuẩn (đọc từ bản đồ):

LoạiTên file thường gặpKhách thêm dòng?
Bài viếtblog-posts.jsonKhông
Liên hệcontacts.jsonCó (form)
Sản phẩm / ĐơnThường shop-products.json / shop-orders.json - đọc lại manifest nếu site khácĐơn: thường có (checkout)
Trang / Danh mục / Thẻpages.json, blog-categories.json, blog-tags.jsonKhông
Kiểu tùy chỉnh (vd. BĐS)Theo data_file bạn khai báo (vd. properties.json)Không (chỉ admin CMS)

Kiểu tùy chỉnh: tạo trên Panel (AS20) hoặc nhờ AI merge đúng hai file (AS21) - không bịa tên file song song. Tổng quan Prompt + quy tắc: AS19. Coder / bảo mật enforce: AM11. Bảo mật UI: AS11.

Blog sẵn lọc bằng status === 'published'. Kiểu tùy chỉnh lọc bằng publish_state === 'published'. Sai field → danh sách trống dù CMS đã có tin.

4. So sánh

  • WordPress: theme query sai post type → cũng trống dù admin có bài.
  • Airtable + frontend: sai tên bảng → UI trống.

5. Giới hạn

Làm được

  • Sửa bằng prompt rõ ràng

Không

  • Không đào code nội bộ panel CMS

6. Checklist

  1. Prompt có câu “đọc __cms_manifest__.json trước”?
  2. Khi sửa layout: đã nhắc giữ hook trong __cms_ui_contract__.json?
  3. Lọc đúng status (blog) hay publish_state (kiểu tùy chỉnh)?
  4. Đã Lưu thay đổi và refresh live?

Tiếp theo

AS11 - Cài đặt bảo mật nội dung

CMS + Aura chi tiết: AS19 · Kiểu tùy chỉnh / BĐS: AS20 · AI merge hai file: AS21

DINHDANH Creator · Loạt Aura · AS10