Skip to content

评论互动插件 ​

评论互动插件提供通用的评论、点赞、收藏、举报、分享和互动统计能力。支持多目标类型(文章、帖子、快讯等),适用于所有内容模块。

插件信息 ​

属性值
名称comment-interaction
版本0.1.0
描述评论、点赞、收藏、举报、分享、互动统计模块
管理面板是

事件 ​

事件名触发时机
comment.created评论创建
comment.approved评论审核通过
like.toggled点赞/取消点赞
favorite.toggled收藏/取消收藏

数据模型 ​

Comment(评论) ​

表名: comments

字段类型说明
(BaseModel)embedded
TargetTypestring(50)目标类型(如 article、topic),索引
TargetIDuint目标 ID,索引
ParentID*uint父评论 ID(用于回复)
Contenttext评论内容
AuthorNamestring(100)匿名作者名
AuthorEmailstring(255)匿名作者邮箱
AuthorAvatarstring(500)匿名作者头像
UserID*uint登录用户 ID
Statusstring(20)pending / approved / rejected / spam
IPstring(45)客户端 IP(JSON 隐藏)
UserAgentstring(500)浏览器 UA(JSON 隐藏)
LikeCountint点赞数
ReplyCountint回复数

Like(点赞) ​

表名: likes

字段类型说明
(BaseModel)embedded
UserIDuint用户 ID
TargetTypestring(50)目标类型
TargetIDuint目标 ID

唯一部分索引:(tenant_id, user_id, target_type, target_id) WHERE deleted_at IS NULL

Favorite(收藏) ​

表名: favorites — 结构与 likes 相同

Report(举报) ​

表名: reports

字段类型说明
(BaseModel)embedded
TargetType / TargetID目标
ReporterIDuint举报人
Reasonstring(500)举报原因
Descriptiontext详细描述
Statusstring(20)pending / handled / dismissed
HandledBy*uint处理人
HandledNotetext处理备注

Share(分享) ​

表名: shares

字段类型说明
(BaseModel)embedded
UserIDuint分享用户
TargetTypestring(50)目标类型
TargetIDuint目标 ID
Platformstring(50)分享平台
ShareURLstring(1000)分享链接

InteractionStats(互动统计) ​

表名: interaction_stats

字段类型说明
(BaseModel)embedded
TargetType / TargetID目标(复合索引)
ViewCountint浏览数
LikeCountint点赞数
CommentCountint评论数
FavoriteCountint收藏数
ShareCountint分享数
ReportCountint举报数
Scoreint综合得分

API 接口 ​

公开接口 ​

方法路径说明
GET/api/v1/comments/:target_type/:target_id获取目标的评论列表
GET/api/v1/comments/replies/:id获取评论的回复列表
GET/api/v1/likes/:target_type/:target_id/count点赞计数
GET/api/v1/favorites/:target_type/:target_id/count收藏计数
GET/api/v1/shares/:target_type/:target_id/count分享计数
GET/api/v1/stats/:target_type/:target_id获取综合互动统计
POST/api/v1/stats/:target_type/:target_id/view增加浏览次数

认证接口 ​

方法路径权限说明
POST/api/v1/comments—创建评论(登录用户自动通过审核)
DELETE/api/v1/comments/:id—删除评论
POST/api/v1/comments/:id/approvecomment.moderate审核通过
POST/api/v1/comments/:id/rejectcomment.moderate审核拒绝
POST/api/v1/likes/:target_type/:target_id/toggle—点赞/取消点赞(切换)
GET/api/v1/likes/:target_type/:target_id/check—检查当前用户是否已点赞
POST/api/v1/favorites/:target_type/:target_id/toggle—收藏/取消收藏(切换)
GET/api/v1/favorites/:target_type/:target_id/check—检查当前用户是否已收藏
POST/api/v1/reports—提交举报
GET/api/v1/reportscomment.read举报列表(管理)
POST/api/v1/reports/:id/handlecomment.report.manage处理举报
POST/api/v1/shares—记录分享

业务规则 ​

  • 评论自动审核: 登录用户(UserID > 0)创建的评论自动标记为 approved
  • 点赞/收藏切换: Toggle 模式 — 已存在则取消,不存在则创建,返回 true(已操作)/ false(已取消)
  • 统计同步: 点赞、收藏、分享、评论操作自动同步更新 interaction_stats 表对应计数
  • 回复计数: 创建/删除回复时自动更新父评论的 ReplyCount
  • 隐私保护: 评论的 IP 和 UserAgent 字段在 JSON 序列化时隐藏

Released under the Apache 2.0 License.