Skip to content

CMS 内容管理插件 ​

CMS 插件是 MengStack 的内容管理核心,提供文章、版本控制、频道、分类、标签、媒体资源等完整的内容管理能力。支持多租户隔离、文章版本历史、SEO 字段、定时发布。

插件信息 ​

属性值
名称cms
版本0.2.0
描述内容管理模块 -- 文章、版本、频道、分类、标签、媒体资源
管理面板是
存储权限是(沙箱前缀 cms)

事件 ​

事件名触发时机
article.created文章创建
article.published文章发布
article.updated文章更新
article.version.restored版本恢复

数据模型 ​

Article(文章) ​

表名: cms_articles

字段类型说明
(BaseModel)embeddedID, TenantID, CreatorID, CreatedAt, UpdatedAt, DeletedAt
Titlestring(500)标题
Slugstring(500)URL 标识,租户内唯一
Contenttext正文内容
Excerpttext摘要
Statusstring(20)状态:draft / pending / published / archived
ContentTypestring(50)内容类型:article / page / video / gallery
CoverImagestring(1000)封面图 URL
PublishedAt*time.Time发布时间
ScheduledAt*time.Time定时发布时间
AuthorIDuint作者 ID
ChannelID*uint所属频道
CategoryID*uint所属分类
Tags[]Tag标签(多对多)
Versionint版本号,默认 1
Schemajsonb扩展结构化数据
SEOTitlestring(500)SEO 标题
SEODescriptionstring(1000)SEO 描述
SEOKeywordsstring(500)SEO 关键词
IsPinnedbool是否置顶
IsFeaturedbool是否推荐
ViewCountint64浏览次数
LikeCountint64点赞数
CommentCountint64评论数

ArticleVersion(文章版本) ​

表名: cms_article_versions

字段类型说明
(BaseModel)embedded
ArticleIDuint关联文章
Versionint版本号
Titlestring(500)版本标题快照
Contenttext版本内容快照
Excerpttext版本摘要快照
Slugstring(500)版本 Slug 快照
ChangedByuint修改人
ChangedAttime.Time修改时间
ChangeNotestring(500)修改说明

Channel(频道) ​

表名: cms_channels

字段类型说明
(BaseModel)embedded
Namestring(255)频道名称
Slugstring(255)URL 标识,租户内唯一
Descriptiontext描述
Iconstring(500)图标
SortOrderint排序权重
Statusstring(20)active / inactive
SEOTitle / SEODescription / SEOKeywordsSEO 字段

Category(分类) ​

表名: cms_categories

字段类型说明
(BaseModel)embedded
Namestring(255)分类名称
Slugstring(255)URL 标识,租户内唯一
ParentID*uint父分类 ID(自引用层级)
ChannelID*uint所属频道
SortOrderint排序权重
SEOTitle / SEODescription / SEOKeywordsSEO 字段

Tag(标签) ​

表名: cms_tags

字段类型说明
(BaseModel)embedded
Namestring(255)标签名称
Slugstring(255)URL 标识,租户内唯一
ChannelID*uint所属频道
SEOTitle / SEODescription / SEOKeywordsSEO 字段

Media(媒体) ​

表名: cms_media

字段类型说明
(BaseModel)embedded
FileURLstring(1000)文件 URL
FileTypestring(100)文件类型
FileSizeint64文件大小(字节)
AltTextstring(500)替代文本
UploadedByuint上传者
Width / Heightint图片尺寸
Folderstring(255)文件夹
IsWatermarkedbool是否已加水印

API 接口 ​

公开接口 ​

方法路径说明
GET/api/v1/cms/articles已发布文章列表(分页)
GET/api/v1/cms/articles/:id获取已发布文章
POST/api/v1/cms/articles/:id/view增加浏览次数
GET/api/v1/cms/channels频道列表
GET/api/v1/cms/channels/:id频道详情(含文章/分类计数)
GET/api/v1/cms/categories分类列表
GET/api/v1/cms/categories/:id分类详情(含文章计数)
GET/api/v1/cms/tags标签列表
GET/api/v1/cms/tags/:id标签详情(含文章计数)
GET/api/v1/cms/media媒体列表
GET/api/v1/cms/media/:id媒体详情

管理接口(需认证 + 权限) ​

方法路径权限说明
POST/api/v1/cms/articlescms.article.write创建文章
PUT/api/v1/cms/articles/:idcms.article.write更新文章(自动创建版本)
DELETE/api/v1/cms/articles/:idcms.article.write删除文章(仅创建者)
GET/api/v1/cms/article-versionscms.article.read版本列表(需 article_id 参数)
GET/api/v1/cms/article-versions/:idcms.article.read版本详情
POST/api/v1/cms/article-versions/:id/restorecms.article.write恢复版本
POST/api/v1/cms/channelscms.channel.write创建频道
PUT/api/v1/cms/channels/:idcms.channel.write更新频道
DELETE/api/v1/cms/channels/:idcms.channel.write删除频道(有文章时阻止)
POST/api/v1/cms/categoriescms.category.write创建分类
PUT/api/v1/cms/categories/:idcms.category.write更新分类
DELETE/api/v1/cms/categories/:idcms.category.write删除分类(有子分类时阻止)
POST/api/v1/cms/tagscms.tag.write创建标签
PUT/api/v1/cms/tags/:idcms.tag.write更新标签
DELETE/api/v1/cms/tags/:idcms.tag.write删除标签
POST/api/v1/cms/media/uploadcms.media.write上传媒体文件
PUT/api/v1/cms/media/:idcms.media.write更新媒体元数据
DELETE/api/v1/cms/media/:idcms.media.write删除媒体

业务规则 ​

  • 版本控制: 文章更新时,如果内容发生变化,自动递增版本号并创建版本快照
  • 所有权保护: 文章更新/删除仅限创建者(CreatorID == userID)
  • Slug 自动生成: 文章、分类、标签创建时如未提供 Slug,自动生成
  • 频道删除保护: 频道下有文章时禁止删除
  • 分类删除保护: 分类下有子分类时禁止删除
  • 标签关联: 文章与标签通过 article_tags 中间表多对多关联
  • 三阶段迁移: Phase 1 创建基础表 → Phase 2 添加 UNIQUE 约束 → Phase 3 创建 many2many 关联表

Released under the Apache 2.0 License.