跳到主要内容

第 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 的皮肤。

  1. bob 打开 alice 的皮肤,点"举报":表单提示"举报需要 5 积分,举报成立后退还。举报成立另奖励 10 积分。"提交后显示"已提交"。
  2. bob 的"我的举报"列出两条,都是"待处理"。
  3. 管理员打开 /admin:用户 4、角色 1、材质 3、待处理举报 2;两张柱状图今天分别是 4 和 3,悬停显示"4 / 2026-10-24"。
  4. /admin/reports:对 carol 的皮肤选"删除材质",对 alice 的选"驳回"。队列清空;carol 的材质返回 404,alice 的还在。bob 的积分是 905:1000 − 100(角色)− 5 − 5 + 5 + 10,被驳回那条的举报费不退。
  5. /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 兼容存储。