第 12 期 · M2 举报与后台:管理员终于有工具了
· 阅读需 5 分钟
M2 第四部分把注意力放到了管理员身上:用户可以举报有问题的材质,管理员在后台处理;后台有了概览图表和角色管理。顺手修了第三部分衣柜积分里的一个漏洞。
本期完成
- 举报(
internal/report):- 只能举报看得见的材质、不能举报自己的,同一材质只能举报一次(唯一索引裁决并发)。
score.reporter_modification可以收费或奖励,score.reporter_reward奖励成立的举报,全部走积分流水。- 处理时:
- 删除材质,与结案在同一个事务里。同一材质的其它举报一并结案,只有被处理的那一条得奖励。
- 封禁上传者,遵守管理权限。
- 驳回,收回提交奖励。
- 两名管理员同时处理,只有一个生效。
- 后台概览
/admin:- 各项总数、待处理举报。
- 最近 31 天每天的注册与上传柱状图:悬停或聚焦看数值,可展开表格。
- 每天是两次索引区间计数,日界按站点时区。
- 后台角色管理
/admin/players:- 按名字开头、UUID、ID 搜索,或查看某个用户的角色。
- 改名、转移、换皮肤披风、删除。
- 换材质同样只能用主人衣柜里的、并校验类型(修 BS C07)。
- 后台衣柜管理接口:管理员免费把材质放进某人衣柜,或移出。
- 前端:材质页举报表单(提前显示费用与奖励)、
/user/reports、/admin/reports;用户管理每行可跳到该用户的角色。 - 修正:收藏费原来按"材质/用户"找流水。站点改为免费以后,反复收藏、取消同一个材质,每次都会再退一次早已退过的旧费用。现在按衣柜条目结算,回归测试在旧代码上能复现每次多退 5 分。
- 设计记录:ADR 0020 举报、后台概览与后台角色、衣柜管理。M2 的拆分顺延:渲染器、站内通知与公告、S3 存储放到第五部分。
本地实测(skinloom up --dev)
站点设置:举报费 5 分,举报成立奖励 10 分。alice 上传两个皮肤,carol 上传一个,bob 建了一个角色并举报了 carol 的皮肤。
- bob 打开 alice 的皮肤,点"举报":表单提示"举报需要 5 积分,举报成立后退还。举报成立另奖励 10 积分。"提交后显示"已提交"。
- bob 的"我的举报"列出两条,都是"待处理"。
- 管理员打开
/admin:用户 4、角色 1、材质 3、待处理举报 2;两张柱状图今天分别是 4 和 3,悬停显示"4 / 2026-10-24"。 /admin/reports:对 carol 的皮肤选"删除材质",对 alice 的选"驳回"。队列清空;carol 的材质返回 404,alice 的还在。bob 的积分是 905:1000 − 100(角色)− 5 − 5 + 5 + 10,被驳回那条的举报费不退。/admin/players:把 Bobby 改名并填一个不在他衣柜里的皮肤:提示材质不在衣柜里,同时行里显示新名字(这里发现并修好了"部分保存成功却不显示"的问题)。用衣柜管理接口把材质给 bob 后再保存,角色穿上了这个皮肤。
测试
- 举报服务:
- 提交时的收费、重复、自己的材质、私有材质、理由长度、积分不足(不留下任何记录);十个并发重复提交只成功一个、只扣一次。
- 删除、驳回、封禁三种处理;其它举报一并结案;材质已被删除时只退费;封禁被拒时什么都不变;上传者已注销。
- 两名管理员同时处理:去掉条件更新里的
status = 'pending',测试就会失败(两次都"成功")。
- 衣柜:新增"免费以后反复收藏不再退旧费用"的回归测试,在旧代码上失败。
- 角色:搜索(名字开头、带连字符的 UUID、ID、按主人、分页)、转移(脱下新主人衣柜里没有的材质、转给已注销账号或不存在的用户、转移后删除不退费)。
- 概览:空站点、31 天范围、上海时间 00:10 的注册算当天、图表开始前的不计入。
- 账号:
MayManageOwned的六种组合。 - HTTP:举报、我的举报、审核队列、封禁后上传者下线、重复处理 409、删除后 404、概览、角色改名/转移/换材质/删除、衣柜管理、审计记录。
- 前端:图表纵轴取整;类型检查、单元测试、生产构建、
bun audit。 - 全量回归:
go test ./...(含 PostgreSQL 18)、vet、staticcheck、govulncheck;生成代码无差异、迁移无漂移。
问题与风险
- 先封禁、后结案:两名管理员同时对同一条举报分别选"封禁"和"驳回"时,可能出现上传者已封禁、举报却被驳回,影响很小,见 ADR。
- 举报表单、确认框仍是简单的表单和浏览器原生对话框,等 UI 组件库补上对话框后替换。
- 概览的总数是每次打开都统计;站点很大时再加缓存。
下期计划
M2 第五部分:服务端渲染器(头像、预览图、OG 图片)、站内通知与公告、S3 兼容存储。