Skip to content

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 APIcms, cms-public, media
Query / Mutation18 / 10
Nguồn dữ liệucontent_report
Bảng10
Luật phân quyền9
Đường dẫn Web Admin14

Thao tác (mutation) ​

MutationDomainMô tả
completeMediaUploadmediaRequires the upload permission of the item's purpose, uploader only. READY after the stored object is verified (size, MIME, bytes).
createMediaUploadmediaRequires media.upload (MD-01/MD-04); PRODUCT_IMAGE requires catalog_media.upload (MD-12), SALE_PROFILE_* requires
deleteCmsArticlecmsRequires cms.manage (MK-01). Soft delete of a non-published article. GAP-API-CMS-OPS.
deleteCmsKeywordcmsRequires cms.manage (MK-01). Only when unused. GAP-API-CMS-OPS.
deleteMediamediaRequires media.delete (own: MD-03/MD-06; another account's PUBLIC media: MD-06); PRODUCT_IMAGE: catalog_media.delete
publishContentcmsRequires cms.publish (MK-02). Make the newest version public (article: now or scheduled).
removeContentcmsRequires cms.publish (MK-02). Article -> UNPUBLISHED, banner -> HIDDEN; history kept.
renameCmsKeywordcmsRequires cms.manage (MK-01). GAP-API-CMS-OPS.
saveCmsCategorycmsRequires cms.manage (MK-01). GAP-API-CMS-OPS.
saveCmsDraftcmsRequires cms.manage (MK-01). Create a draft or append a new version; the published version never changes.

Phép đọc (query) ​

QueryDomainMô tả
cmsArticlecmsRequires cms.manage (MK-01). Deleted articles are not_found.
cmsArticlescmsRequires cms.manage (MK-01). Admin list incl. drafts; newest change first.
cmsBannercmsRequires cms.manage (MK-01). GAP-API-CMS-OPS.
cmsBannerscmsRequires cms.manage (MK-01). GAP-API-CMS-OPS.
cmsBannerScreenscmsRequires cms.manage (MK-01). Allowed SCREEN destinations, per app.
cmsCategoriescmsRequires cms.manage (MK-01). Flat tree (parentId). GAP-API-CMS-OPS.
cmsKeywordscmsRequires cms.manage (MK-01). Live keywords with usage. GAP-API-CMS-OPS.
cmsPagecmsRequires cms.manage (MK-01).
cmsPagescmsRequires cms.manage (MK-01). Admin list of content pages incl. drafts; newest change first.
cmsSeoPolicycmsRequires cms.manage (MK-01).
mediamediaRequires media.read (own: MD-02/MD-05; another account's PUBLIC READY media: MD-05). Deleted -> not_found.
mediaLibrarymediaM-02 AC01: the library. Requires media.read. Lists READY, not-deleted media only (PENDING tickets and
mediaSignedViewmediaRequires media.read. PUBLIC: stable URL. PRIVATE: signed URL (1 hour), never a public URL.
mediaUploadPoliciesmediaU6-P3-38: upload rules (MIME, maxBytes, maxCount) of the purposes the caller's app may create, one line per
publicArticlescms-publicMatrix A-04. Published articles, newest first (no body).
publicBannerscms-publicMatrix A-04. Banners live now for the REQUEST app (x-pi-app), in display order.
publicContentcms-publicMatrix A-04. One published article by slug; draft, scheduled, unpublished and deleted are not_found.
publicPagecms-publicMatrix A-04. One published content page by key; draft, scheduled and unpublished are not_found.

Dữ liệu ​

Bảng được tham chiếu nhiều nhất trong module:

BảngCộtĐược trỏ tớiRLS
content_versions363✓
cms_articles182✓
cms_categories112✓
cms_pages162✓
cms_banners131✓
in_app_events141✓
report_export_jobs321✓
cms_keywords100✓
notification_outbox90✓
report_export_snapshots30✓

Quyền ​

MãQuyềnỨng dụngVai tròPhạm viTrạng thái
CMS-01cms.readWEB_ADMINALLGAP
MD-01media.uploadAPP_USER, APP_SALEuser saleOWNPROPOSED
MD-02media.readAPP_USER, APP_SALEuser saleOWNPROPOSED
MD-03media.deleteAPP_USER, APP_SALEuser saleOWNPROPOSED
MD-04media.uploadWEB_ADMINadmin marketing operationsOWNPROPOSED
MD-05media.readWEB_ADMINadmin marketing operationsALLPROPOSED
MD-06media.deleteWEB_ADMINadmin marketing operationsALLPROPOSED
MK-01cms.manageWEB_ADMINmarketingALLDEFINED
MK-02cms.publishWEB_ADMINmarketingALLPROPOSED

Danh sách đầy đủ và cách đọc các cờ: Ma trận quyền.

Giao diện Web Admin ​

Đường dẫnHằng số
/cms/article-categoriesCMS_ARTICLE_CATEGORIES
/cms/article-keywordsCMS_ARTICLE_KEYWORDS
/cms/articlesCMS_ARTICLES
/cms/articles/:idCMS_ARTICLE_EDIT
/cms/articles/newCMS_ARTICLE_NEW
/cms/bannersCMS_BANNERS
/cms/banners/:idCMS_BANNER_EDIT
/cms/banners/newCMS_BANNER_NEW
/cms/mediaCMS_MEDIA
/cms/pagesCMS_PAGES
/cms/pages/:idCMS_PAGE_EDIT
/cms/pages/newCMS_PAGE_NEW
/cms/seoCMS_SEO
/cms/seo/:idCMS_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.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17