Skip to content

用户系统 ​

1. 管理员用户系统(Guard: admin) ​

功能说明
管理员登录支持用户名/邮箱/手机号登录,可选微信/Apple 授权登录
Token 管理刷新 Token、查看已签发 Token、销毁指定 Token
管理员信息管理查看和修改个人资料、上传头像
密码管理修改密码、重置密码
状态管理启用/禁用管理员账号
角色分配为管理员分配角色(多对多)
登录历史记录管理员登录历史(IP、设备、浏览器)
权限控制基于 RBAC 的权限管理(spatie/laravel-permission v8)

2. 前台用户系统(Guard: web) ​

功能说明
用户注册支持手机号/邮箱注册
用户认证基于 Sanctum 的 Token 认证
用户信息管理查看和修改个人资料(profile/extra 两张扩展表)
头像管理上传头像(multipart/form-data),服务端自动转换 WebP(质量 60),以用户 ID 命名并按分片目录存储,重复上传覆盖旧图;上传后派发 UserProfileUpdated 事件驱动完善资料任务
密码重置通过邮箱/手机验证码重置密码
联系方式重置通过验证码重置手机号/邮箱
用户状态管理启用、禁用、冻结用户
VIP会员系统支持VIP会员延期功能
积分/金币系统用户积分和金币流水管理(调整余额、查询流水)
钱包系统真实货币余额管理(余额查询、流水明细、充值、提现、冻结/解冻),记录层多态设计支持未来扩展至其他主体
实名认证支持个人认证(姓名+身份证)和企业认证(营业执照+法人信息),多态认证记录,管理员审核通过/驳回,驳回原因字典化管理,认证有效期 3 年
第三方绑定查询用户社交账号绑定记录(前台 GET /api/v1/user/socials + 后台 GET /admin/users/{id}/socials,openid/unionid 脱敏展示)
登录历史记录用户登录历史
用户分群手动分群(人工打标/解标)与规则分群(基于规则 JSON 自动匹配),支持笛卡尔批量打标/解标、规则增量 diff 同步、异步任务跟踪与站内信通知,每日凌晨 2 点自动同步启用的规则分群
访问记录多态访问埋点(记录一次访问 + 我的访问记录列表),用于 PV/UV 与"最近浏览"等业务场景;append-only 模型,无 updated_at、无 unique 约束

详见 实名认证技术方案、访问记录技术方案。


文档来源:PRD 第 3.1 节