治理:审核 / 举报 / 回收站
治理能力对内容进行审核流转、违规举报处理与软删除回收,全部位于管理端(/api/cms/admin/...)或专用治理端点。
审核日志(AuditLogController,/api/cms/admin/review-logs)
内容(文章/沸点/评论)经审核状态流转后落审核日志,由 IAuditLogService / IAuditLogManager / IEntityAuditLogManager<> 维护(需 CmsKit.AuditLog.Audit)。
| 方法 | 路由 | 说明 |
|---|---|---|
| GET | / | 审核日志分页列表 |
| PUT | /review | 单条审核(AuditStatusReq) |
| PUT | /batch-review | 批量审核(BatchAuditStatusReq) |
文章/沸点/评论各自的审核入口在对应管理端控制器:
/api/cms/admin/articles(PUT /audit、PUT /batch-audit、PUT /set-recommend、POST /batch-ai-tag)、/api/cms/admin/short-msg(PUT /audit、PUT /batch-audit、PUT /set-editor-index、PUT /set-max-editor-index/{id})、/api/cms/admin/comments(PUT /audit、PUT /batch-audit、PUT /{subjectId}/type/{subjectType})。默认审核状态由设置Article.AuditStatus.Default/ShortMsg.AuditStatus.Default/Comment.AuditStatus.Default控制。
举报(UserReportController)
用户端 /api/cms/user-report(IUserReportService)
| 方法 | 路由 | 说明 |
|---|---|---|
| POST | / | 发起举报(CreateUserReportReq) |
| GET | /my | 我发起的举报列表 |
管理端 /api/cms/admin/user-reports(需 CmsKit.UserReports.Handle)
| 方法 | 路由 | 说明 |
|---|---|---|
| GET | / | 举报分页列表(AdminUserReportQuery) |
| PUT | /{id} | 处理举报(HandleUserReportReq) |
回收站(RecycleBinController,/api/cms/recycle-bin)
删除的文章/沸点先进入回收站,可恢复或彻底删除(IRecycleBinService)。
| 方法 | 路由 | 说明 |
|---|---|---|
| GET | /list | 回收站列表(page/pageSize) |
| POST | /article/{articleId}/restore | 恢复文章 |
| POST | /shortmsg/{shortMsgId}/restore | 恢复沸点 |
| POST | /article/{articleId}/delete | 彻底删除文章 |
| POST | /shortmsg/{shortMsgId}/delete | 彻底删除沸点 |
| POST | /clear | 清空回收站 |
附件同步(AttachmentSyncController,/api/cms/attachment-sync)
CmsKit 的附件通过 Identity.Infrastructure 的通用附件能力挂载到 Article / ShortMsg / UserReport,并由 ICmsKitAttachmentSyncService 提供「同步到 KitFile」的运维入口。
| 方法 | 路由 | 说明 |
|---|---|---|
| PUT | /sync-to-kitfile | 将 CmsKit 附件同步到文件中心(KitFile) |