Skip to content

快讯插件 ​

快讯插件提供短内容(快讯/新闻)的发布与管理能力,支持分类、标签、时间线视图、趋势标记(热门/上升)。

插件信息 ​

属性值
名称flash
版本0.1.0
描述快讯模块 -- 快讯发布、分类、标签、时间线
管理面板是

事件 ​

事件名触发时机
flash.published快讯发布
flash.updated快讯更新

数据模型 ​

FlashNews(快讯) ​

表名: flash_news

字段类型说明
(BaseModel)embedded
Titlestring(200)标题
Contenttext内容
CategoryID*uint所属分类
Statusstring(20)draft / published / archived
IsPinnedbool是否置顶
IsHighlightedbool是否高亮
Trendstring(20)趋势:normal / hot / rising
Sourcestring(200)来源
SourceURLstring(1000)来源链接
PublishedAt*time.Time发布时间
ViewCountint浏览次数
LikeCountint点赞数
CommentCountint评论数

FlashCategory(快讯分类) ​

表名: flash_categories

字段类型说明
(BaseModel)embedded
Namestring(100)分类名称
Slugstring(100)URL 标识,租户内唯一
Colorstring(20)颜色标识
Iconstring(100)图标
SortOrderint排序权重
IsActivebool是否启用

FlashTag(快讯标签) ​

表名: flash_tags

字段类型说明
(BaseModel)embedded
Namestring(100)标签名,租户内唯一
Slugstring(100)URL 标识
Colorstring(20)颜色标识

FlashNewsTag(关联表) ​

表名: flash_news_tags — 复合主键 (FlashNewsID, FlashTagID)

API 接口 ​

公开接口 ​

方法路径说明
GET/api/v1/flash已发布快讯列表
GET/api/v1/flash/timeline时间线视图(参数 hours,默认 24)
GET/api/v1/flash/:id快讯详情
POST/api/v1/flash/:id/view增加浏览次数
GET/api/v1/flash-categories活跃分类列表
GET/api/v1/flash-categories/:id分类详情

管理接口 ​

方法路径权限说明
GET/api/v1/flash-allflash.read全部快讯列表
POST/api/v1/flashflash.write创建快讯
PUT/api/v1/flash/:idflash.write更新快讯(仅创建者)
DELETE/api/v1/flash/:idflash.write删除快讯(仅创建者,级联删除标签关联)
POST/api/v1/flash-categoriesflash.category.write创建分类
GET/api/v1/flash-categories/allflash.read全部分类列表
PUT/api/v1/flash-categories/:idflash.category.write更新分类(仅创建者)
DELETE/api/v1/flash-categories/:idflash.category.write删除分类(仅创建者)

业务规则 ​

  • 标签自动创建: 创建快讯时提供的 TagNames 如不存在,自动创建新标签
  • 标签同步: 更新快讯时如提供 TagNames,全量替换标签关联
  • 时间线: Timeline 方法返回指定时间窗口内的快讯,hours=0 表示全部
  • 趋势标记: 支持 normal(普通)、hot(热门)、rising(上升)三种趋势
  • 所有权保护: 更新/删除仅限创建者
  • 级联删除: 删除快讯时自动清理 flash_news_tags 关联

Released under the Apache 2.0 License.