管理后台与账号体系
04 · 管理后台与账号体系
时间:2026-11-01 · 提交:
5cb2f91(首页图标 + 管理拆分)、5c6af31(头像上传 + 用户管理 + CR 加固)
一、账号体系
- 注册即用:用户名 + 密码,密码 bcrypt 哈希;没有邮箱验证——目标用户是小学生,注册门槛必须一屏内完成;
- JWT 鉴权:
internal/auth/签发,过期时间拉到足够长,孩子不应该每周被迫重新登录; - 管理员账号:启动时确保存在
ADMIN_USERNAME/ADMIN_PASSWORD(默认admin/admin123,生产必改)。
二、头像上传:第一个文件上传功能
internal/api/avatar.go + store 层的文件引用记录。设计要点:
- 上传走 multipart,服务端校验类型与大小上限;
- 文件落
UPLOAD_DIR(容器里是挂载卷/app/data/uploads),数据库只存引用——文件不进库,库不进文件,两边各自可备份可迁移; - 头像 GET 允许公开访问(同源伺服),配合 ETag 缓存。
这是 CR(代码评审)轮里被提意见最多的功能:最初版本没做大小上限、路径拼接可被 ../ 逃逸。加固后:白名单扩展名 + 服务端生成文件名 + 路径清洗。教训记录在案:任何用户文件名都不可直接拼路径。
三、管理后台拆分
初版管理页是一个大杂烩,5cb2f91 拆成三个 Tab:
- 游戏管理:查看各游戏对局量、每日挑战配置;
- 用户管理:搜索、封禁、重置头像、查看成长档案;
- 积分/流水管理:点数与命数账本(ledger)。
拆分动机很实际:家长(管理员)最常干的三件事——看孩子玩得怎么样、处理异常账号、对账——对应三个互不相关的数据面,混在一页里查找效率太低。
四、点数与命数:账本化
internal/store/ledger.go 实现了账本式记账(append-only 流水 + 余额视图),而不是直接 UPDATE user SET points = points - 1:
ledger(id, user_id, kind, delta, reason, created_at)
好处在成长体系上线后变得明显(第 06 篇):
- 每一笔点数变动可追溯(「为什么我有 320 点」→ 查流水);
- 幂等防刷:领奖写流水时带唯一 reason 键,重复领取被
INSERT IGNORE挡掉; - 出 bug 时余额可以从流水重算,而不是从坏数据猜。
「命数」(lives)同样走账本:孩子玩游戏失败扣命数,命数随时间恢复——这是后来「游戏要有代价、失败要有分量」设计的一部分。
五、管理相关的测试
admin_users_test.go、admin_password_test.go、avatar_test.go、ledger_test.go 覆盖了:改管理员密码后旧 token 失效、上传非法文件被拒、并发领取不双发、封禁用户立即无法登录。管理功能是特权面,测试优先级永远排最前。
六、小结
这一天把「能玩」补成了「能管」。有意思的是回看提交顺序:先做了部署(03 篇)再做管理(本篇)——先把东西放到真实服务器上,家长真实用起来,管理需求才不是拍脑袋。后面 11-02 的「触控体验大修」同样是这个路数:先上线,让真实的手指去戳出问题。
- 点赞
- 收藏
- 关注作者
评论(0)