第 11 期 · M2 收藏、材质编辑与签到:积分终于对得上账了
· 阅读需 5 分钟
M2 第三部分补齐了皮肤站日常最常用的几件事:收藏别人的材质、管理自己上传的材质、每天签到,以及一个能看到全部数字的用户中心。这一部分的重点是积分:Blessing Skin 在收藏、公开性切换、删除这几处的积分规则各有各的漏洞,这次全部改成按积分流水冲正。
本期完成
- 收藏与取消收藏:收藏扣
score.per_closet_item,上传者(若不是自己)得score.award_per_like。取消收藏时,退费和收回奖励都找到当初那两条流水原样冲正,不按现在的价格重算。收藏自己的材质不会在取消时被扣分,上传者已注销也不会出错(修 BS C05)。收藏数原子增减(C04)。衣柜里可以给材质另起名字。 - 材质编辑(上传者与管理员):
- 改名。
- 改类型:按图片尺寸重新校验;皮肤与披风之间切换时,正在穿它的角色自动脱下(C08)。
- 公开 ↔ 私有:按差额对称计费,来回切换不再丢分(C12)。设为私有时,它会从别人的衣柜和角色上移除并退费。同一张图已经公开过就不能再设为公开。
- 管理员的修改免费,写入审计日志。
- 删除材质:收藏者全部退费;上传者拿回这个材质在流水里的净支出;角色槽位置空。文件只经引用计数删除:最后一个引用消失后,排一个 1 小时后执行的清理任务,只删"没有记录、且 1 小时内没被重新写入"的文件(重新上传同一张图会刷新文件时间)。每天再巡检一次孤儿文件。读请求从不删数据(C06、C10)。
- 删除用户:真正删除账号前先删掉他的私有材质,公开材质保留为"已注销用户"的作品(C09)。
- 签到:
users.last_sign_at上的一条条件更新决定能不能签,并发点十次只成功一次(C03);间隔模式或按site.timezone零点刷新的每日模式;太早返回 409 和Retry-After。 - 用户中心
/user:积分、角色、衣柜、上传与占用空间、签到卡片(下次时间到了自动可点)、公告、常用入口。 - 设计记录:ADR 0019 收藏、材质编辑与删除、签到与用户中心。
本地实测(skinloom up --dev)
站点设置:收藏 5 积分、被收藏奖励 2 积分。alice 上传一个私有皮肤、一个公开皮肤、一个披风,bob 上传一个皮肤。
- bob 打开 alice 的公开皮肤:显示"收藏需要 5 积分,取消收藏时退还"。点收藏:收藏数 1 → 2,按钮变成"取消收藏"。
- bob 的用户中心:积分 989(上传 6、收藏 5)。点签到:+23 积分、按钮变灰、显示下次签到时间。
- bob 的衣柜:改名为
Borrowed立即生效;移出衣柜提示"退还 5 积分"。 - alice 打开自己的皮肤,看到"管理材质",提示"切换需要 9 积分"(私有 10 + 5,公开 1 + 5)。
- 改名:标题与页面标题同时更新。
- 改成披风:提示"这张图片的尺寸不能作为该类型使用",类型不变;改成纤细皮肤成功。
- 设为私有:积分 973 → 964,按钮变成"设为公开",提示"切换会退还 9 积分"。
- 删除:跳回皮肤库,材质消失,接口返回 404;积分 964 → 979(退还上传 6 与私有差额 9);文件仍可访问,等 1 小时后的清理任务删除。
测试
- 收藏:扣费与奖励、重复收藏、看不见的私有材质、收藏自己的材质没有奖励;取消收藏退费、收回奖励、角色脱下;上传者已经花掉奖励时不扣成负数;关闭退费时费用不退。
- 编辑:他人的材质 403;方形图改披风 422;改类型时角色脱下;公开 ↔ 私有的差额与往返对称;设为私有时别人的衣柜被清理并退费;同图已公开时 409;管理员修改免费。
- 删除:收藏者与上传者的退还、角色置空、blob 引用计数;最后一次删除与清理之间又上传了同一张图,文件保留(
TestSweepSparesReuploads);孤儿巡检;删除用户时只删私有材质。 - 签到:区间、间隔、每日模式按站点时区的零点;十个并发签到只成功一次;
TooEarlyError给出下次时间。 - 账号:删除前钩子只在权限检查通过后执行,管理员删除与宽限期清理都会调用。
- HTTP:收藏、改名、移出、编辑、管理员审计、删除、签到与
Retry-After、用户中心未登录 401。 - 全量回归:
go test ./...(含 PostgreSQL 18)、vet、staticcheck、govulncheck;生成代码无差异、迁移无漂移;前端类型检查、单元测试、生产构建、bun audit。
问题与风险
- 删除后文件还会保留 1 小时,知道哈希的人在这段时间里仍能取到图片;这是换取"并发重新上传不误删"的代价。
- 签到的确认对话框与衣柜改名还在用浏览器原生的
confirm/prompt,等 UI 组件库补上对话框后替换。 - 孤儿巡检在启动 24 小时后才第一次运行。
下期计划
M2 第四部分:后台概览(用户、材质、存储统计)、后台材质与角色管理(F32),以及举报流程。