Giao diện
Nội dung & Media
Trang sinh tự động
Phần nghiệp vụ viết tay; API, dữ liệu, quyền, đường dẫn và file nguồn do bộ sinh điền từ source tại ad83b0aea.
Làm gì
Bài viết, banner, trang tĩnh và SEO, cộng thư viện media. Thân bài lưu hai dạng: JSON do trình soạn gửi lên (được kiểm theo allow-list) và HTML do server render — client không bao giờ gửi HTML.
Quy mô
| Domain API | cms, cms-public, media |
| Query / Mutation | 18 / 10 |
| Nguồn dữ liệu | content_report |
| Bảng | 10 |
| Luật phân quyền | 9 |
| Đường dẫn Web Admin | 14 |
Thao tác (mutation)
| Mutation | Domain | Mô tả |
|---|---|---|
completeMediaUpload | media | Requires the upload permission of the item's purpose, uploader only. READY after the stored object is verified (size, MIME, bytes). |
createMediaUpload | media | Requires media.upload (MD-01/MD-04); PRODUCT_IMAGE requires catalog_media.upload (MD-12), SALE_PROFILE_* requires |
deleteCmsArticle | cms | Requires cms.manage (MK-01). Soft delete of a non-published article. GAP-API-CMS-OPS. |
deleteCmsKeyword | cms | Requires cms.manage (MK-01). Only when unused. GAP-API-CMS-OPS. |
deleteMedia | media | Requires media.delete (own: MD-03/MD-06; another account's PUBLIC media: MD-06); PRODUCT_IMAGE: catalog_media.delete |
publishContent | cms | Requires cms.publish (MK-02). Make the newest version public (article: now or scheduled). |
removeContent | cms | Requires cms.publish (MK-02). Article -> UNPUBLISHED, banner -> HIDDEN; history kept. |
renameCmsKeyword | cms | Requires cms.manage (MK-01). GAP-API-CMS-OPS. |
saveCmsCategory | cms | Requires cms.manage (MK-01). GAP-API-CMS-OPS. |
saveCmsDraft | cms | Requires cms.manage (MK-01). Create a draft or append a new version; the published version never changes. |
Phép đọc (query)
| Query | Domain | Mô tả |
|---|---|---|
cmsArticle | cms | Requires cms.manage (MK-01). Deleted articles are not_found. |
cmsArticles | cms | Requires cms.manage (MK-01). Admin list incl. drafts; newest change first. |
cmsBanner | cms | Requires cms.manage (MK-01). GAP-API-CMS-OPS. |
cmsBanners | cms | Requires cms.manage (MK-01). GAP-API-CMS-OPS. |
cmsBannerScreens | cms | Requires cms.manage (MK-01). Allowed SCREEN destinations, per app. |
cmsCategories | cms | Requires cms.manage (MK-01). Flat tree (parentId). GAP-API-CMS-OPS. |
cmsKeywords | cms | Requires cms.manage (MK-01). Live keywords with usage. GAP-API-CMS-OPS. |
cmsPage | cms | Requires cms.manage (MK-01). |
cmsPages | cms | Requires cms.manage (MK-01). Admin list of content pages incl. drafts; newest change first. |
cmsSeoPolicy | cms | Requires cms.manage (MK-01). |
media | media | Requires media.read (own: MD-02/MD-05; another account's PUBLIC READY media: MD-05). Deleted -> not_found. |
mediaLibrary | media | M-02 AC01: the library. Requires media.read. Lists READY, not-deleted media only (PENDING tickets and |
mediaSignedView | media | Requires media.read. PUBLIC: stable URL. PRIVATE: signed URL (1 hour), never a public URL. |
mediaUploadPolicies | media | U6-P3-38: upload rules (MIME, maxBytes, maxCount) of the purposes the caller's app may create, one line per |
publicArticles | cms-public | Matrix A-04. Published articles, newest first (no body). |
publicBanners | cms-public | Matrix A-04. Banners live now for the REQUEST app (x-pi-app), in display order. |
publicContent | cms-public | Matrix A-04. One published article by slug; draft, scheduled, unpublished and deleted are not_found. |
publicPage | cms-public | Matrix A-04. One published content page by key; draft, scheduled and unpublished are not_found. |
Dữ liệu
- Domain
content_report— 10 bảng, 3 nhóm con: cms (5) · report (2) · bảng đơn lẻ (3) (3)
Bảng được tham chiếu nhiều nhất trong module:
| Bảng | Cột | Được trỏ tới | RLS |
|---|---|---|---|
content_versions | 36 | 3 | ✓ |
cms_articles | 18 | 2 | ✓ |
cms_categories | 11 | 2 | ✓ |
cms_pages | 16 | 2 | ✓ |
cms_banners | 13 | 1 | ✓ |
in_app_events | 14 | 1 | ✓ |
report_export_jobs | 32 | 1 | ✓ |
cms_keywords | 10 | 0 | ✓ |
notification_outbox | 9 | 0 | ✓ |
report_export_snapshots | 3 | 0 | ✓ |
Quyền
| Mã | Quyền | Ứng dụng | Vai trò | Phạm vi | Trạng thái |
|---|---|---|---|---|---|
CMS-01 | cms.read | WEB_ADMIN | ALL | GAP | |
MD-01 | media.upload | APP_USER, APP_SALE | user sale | OWN | PROPOSED |
MD-02 | media.read | APP_USER, APP_SALE | user sale | OWN | PROPOSED |
MD-03 | media.delete | APP_USER, APP_SALE | user sale | OWN | PROPOSED |
MD-04 | media.upload | WEB_ADMIN | admin marketing operations | OWN | PROPOSED |
MD-05 | media.read | WEB_ADMIN | admin marketing operations | ALL | PROPOSED |
MD-06 | media.delete | WEB_ADMIN | admin marketing operations | ALL | PROPOSED |
MK-01 | cms.manage | WEB_ADMIN | marketing | ALL | DEFINED |
MK-02 | cms.publish | WEB_ADMIN | marketing | ALL | PROPOSED |
Danh sách đầy đủ và cách đọc các cờ: Ma trận quyền.
Giao diện Web Admin
| Đường dẫn | Hằng số |
|---|---|
/cms/article-categories | CMS_ARTICLE_CATEGORIES |
/cms/article-keywords | CMS_ARTICLE_KEYWORDS |
/cms/articles | CMS_ARTICLES |
/cms/articles/:id | CMS_ARTICLE_EDIT |
/cms/articles/new | CMS_ARTICLE_NEW |
/cms/banners | CMS_BANNERS |
/cms/banners/:id | CMS_BANNER_EDIT |
/cms/banners/new | CMS_BANNER_NEW |
/cms/media | CMS_MEDIA |
/cms/pages | CMS_PAGES |
/cms/pages/:id | CMS_PAGE_EDIT |
/cms/pages/new | CMS_PAGE_NEW |
/cms/seo | CMS_SEO |
/cms/seo/:id | CMS_SEO_EDIT |
File nguồn
Backend:
code/apps/api/supabase/functions/graphql/domains/cms/code/apps/api/supabase/functions/graphql/domains/cms-public/code/apps/api/supabase/functions/graphql/domains/media/
Dữ liệu: bảng thuộc domain content_report — xem Cơ sở dữ liệu.