管理后台与账号体系

举报
yd_285387411 发表于 2026/11/13 01:16:35 2026/11/13
【摘要】 04 · 管理后台与账号体系时间:2026-11-01 · 提交:5cb2f91(首页图标 + 管理拆分)、5c6af31(头像上传 + 用户管理 + CR 加固) 一、账号体系注册即用:用户名 + 密码,密码 bcrypt 哈希;没有邮箱验证——目标用户是小学生,注册门槛必须一屏内完成;JWT 鉴权:internal/auth/ 签发,过期时间拉到足够长,孩子不应该每周被迫重新登录;管理...

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:

  1. 游戏管理:查看各游戏对局量、每日挑战配置;
  2. 用户管理:搜索、封禁、重置头像、查看成长档案;
  3. 积分/流水管理:点数与命数账本(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 的「触控体验大修」同样是这个路数:先上线,让真实的手指去戳出问题。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。