Appearance
快讯插件
快讯插件提供短内容(快讯/新闻)的发布与管理能力,支持分类、标签、时间线视图、趋势标记(热门/上升)。
插件信息
| 属性 | 值 |
|---|---|
| 名称 | flash |
| 版本 | 0.1.0 |
| 描述 | 快讯模块 -- 快讯发布、分类、标签、时间线 |
| 管理面板 | 是 |
事件
| 事件名 | 触发时机 |
|---|---|
flash.published | 快讯发布 |
flash.updated | 快讯更新 |
数据模型
FlashNews(快讯)
表名: flash_news
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Title | string(200) | 标题 |
| Content | text | 内容 |
| CategoryID | *uint | 所属分类 |
| Status | string(20) | draft / published / archived |
| IsPinned | bool | 是否置顶 |
| IsHighlighted | bool | 是否高亮 |
| Trend | string(20) | 趋势:normal / hot / rising |
| Source | string(200) | 来源 |
| SourceURL | string(1000) | 来源链接 |
| PublishedAt | *time.Time | 发布时间 |
| ViewCount | int | 浏览次数 |
| LikeCount | int | 点赞数 |
| CommentCount | int | 评论数 |
FlashCategory(快讯分类)
表名: flash_categories
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Name | string(100) | 分类名称 |
| Slug | string(100) | URL 标识,租户内唯一 |
| Color | string(20) | 颜色标识 |
| Icon | string(100) | 图标 |
| SortOrder | int | 排序权重 |
| IsActive | bool | 是否启用 |
FlashTag(快讯标签)
表名: flash_tags
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseModel) | embedded | |
| Name | string(100) | 标签名,租户内唯一 |
| Slug | string(100) | URL 标识 |
| Color | string(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-all | flash.read | 全部快讯列表 |
| POST | /api/v1/flash | flash.write | 创建快讯 |
| PUT | /api/v1/flash/:id | flash.write | 更新快讯(仅创建者) |
| DELETE | /api/v1/flash/:id | flash.write | 删除快讯(仅创建者,级联删除标签关联) |
| POST | /api/v1/flash-categories | flash.category.write | 创建分类 |
| GET | /api/v1/flash-categories/all | flash.read | 全部分类列表 |
| PUT | /api/v1/flash-categories/:id | flash.category.write | 更新分类(仅创建者) |
| DELETE | /api/v1/flash-categories/:id | flash.category.write | 删除分类(仅创建者) |
业务规则
- 标签自动创建: 创建快讯时提供的
TagNames如不存在,自动创建新标签 - 标签同步: 更新快讯时如提供
TagNames,全量替换标签关联 - 时间线:
Timeline方法返回指定时间窗口内的快讯,hours=0表示全部 - 趋势标记: 支持
normal(普通)、hot(热门)、rising(上升)三种趋势 - 所有权保护: 更新/删除仅限创建者
- 级联删除: 删除快讯时自动清理
flash_news_tags关联

