2026-08-29-01 统一举报上报与治理 MVP(chatx/adminx)
1. 变更摘要
新增举报最小可用能力:
- 前台新增统一上报接口,支持举报用户/群/动态。
- 后台新增举报治理接口,支持分页查询、详情查看、处理举报。
2. 接口变更
2.1 新增接口
| 能力 | 路径 | 状态 | 文档链接 |
|---|---|---|---|
| 提交举报 | /chatx/report/submit | Active | 跳转 |
| 分页查询举报 | /adminx/report/search | Active | 跳转 |
| 举报详情 | /adminx/report/detail | Active | 跳转 |
| 处理举报 | /adminx/report/handle | Active | 跳转 |
2.2 行为要点
targetType统一为user/group/moment。- 举报上报会补齐
reporterUserID、operationID、IP、User-Agent并持久化。 - 处理接口仅允许待处理记录处理一次,处理结果为通过或驳回。
3. 兼容性
- 全部为新增接口,不影响现有路由与返回语义。
- 新能力默认关闭自动处置,不会改变现有用户、群、动态状态。
4. 动作等级
动作等级:可不改
- 需要举报能力的调用方,按新增接口接入即可。
- 不需要举报能力的调用方无需改造。