Appearance
专题管理插件
专题插件提供将多篇文章组织为一个专题的能力,支持手动关联和自动规则关联,每个专题可独立配置 TDK SEO 信息。
插件信息
| 属性 | 值 |
|---|---|
| 名称 | topic |
| 版本 | 0.1.0 |
| 描述 | 专题管理模块 -- 专题创建、文章关联、自动规则 |
| 管理面板 | 是 |
事件
| 事件名 | 触发时机 |
|---|---|
topic.published | 专题发布 |
topic.article.added | 文章添加到专题 |
数据模型
Topic(专题)
表名: topics
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Title | string(500) | 专题标题 |
| Slug | string(500) | URL 标识,租户内唯一 |
| Description | text | 专题描述 |
| CoverImage | string(1000) | 封面图 |
| Status | string(20) | draft / published / archived |
| SortOrder | int | 排序权重 |
| IsPinned | bool | 是否置顶 |
| ArticleCount | int | 文章数量 |
| ViewCount | int | 浏览次数 |
| TDKTitle | string(200) | TDK 标题 |
| TDKDesc | string(500) | TDK 描述 |
| TDKKeywords | string(500) | TDK 关键词 |
| PublishedAt | *time.Time | 发布时间 |
TopicArticle(专题文章关联)
表名: topic_articles
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| TopicID | uint | 专题 ID |
| ArticleID | uint | 文章 ID |
| SortOrder | int | 排序权重 |
| IsManual | bool | 是否手动关联(默认 true) |
| AutoRuleID | *uint | 关联的自动规则 ID |
TopicAutoRule(自动关联规则)
表名: topic_auto_rules
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| TopicID | uint | 目标专题 |
| Name | string(200) | 规则名称 |
| CategoryID | *uint | 按分类匹配 |
| TagIDs | string(500) | 按标签匹配(逗号分隔) |
| Keyword | string(200) | 按关键词匹配 |
| MaxItems | int | 最大文章数,默认 20 |
| IsActive | bool | 是否启用 |
API 接口
公开接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/topics | 已发布专题列表 |
| GET | /api/v1/topics/:id | 专题详情 |
| GET | /api/v1/topics/:id/articles | 专题文章列表 |
| POST | /api/v1/topics/:id/view | 增加浏览次数 |
管理接口
| 方法 | 路径 | 权限 | 说明 |
|---|---|---|---|
| POST | /api/v1/topics | topic.write | 创建专题 |
| GET | /api/v1/topics/all | topic.read | 全部专题列表 |
| PUT | /api/v1/topics/:id | topic.write | 更新专题(仅创建者) |
| DELETE | /api/v1/topics/:id | topic.write | 删除专题(仅创建者,级联删除关联) |
| POST | /api/v1/topics/:id/articles | topic.write | 添加文章到专题 |
| DELETE | /api/v1/topics/:id/articles/:article_id | topic.write | 从专题移除文章 |
业务规则
- Slug 自动生成: 创建时如未提供 Slug,自动生成
- 首次发布记录时间: 专题首次设为
published时自动设置PublishedAt - 所有权保护: 更新/删除仅限创建者
- 级联删除: 删除专题时自动清理所有
topic_articles关联记录 - 文章计数同步: 添加/移除文章时自动更新
ArticleCount

