用户权限¶
离线模式¶
离线模式不建立在线会话,可导入本地文件并使用阅读器功能。当前没有基于游客身份实施书籍数量配额或 VIP 高级设置限制。
Node 在线 API¶
登录接口公开;注册接口也公开。登录成功后服务端签发有效期 1 小时的 JWT,客户端通过 Authorization: Bearer <token> 访问受保护接口。JWT 中标识用户邮箱;每次授权时 Node 服务会从数据库读取当前用户和角色。令牌过期后需重新登录。
权限类别是实现层面的操作授权,不是订阅套餐:
| 操作 | 未登录 | 已登录普通用户 | 管理员 |
|---|---|---|---|
| 注册、登录 | 允许 | 允许 | 允许 |
| 浏览列表、搜索、读取评论 | 不允许调用受保护 API | 允许 | 允许 |
| 读取书籍详情并记录用户下载 | 不允许 | 允许 | 允许 |
| 读取/修改本人资料和书架 | 不允许 | 仅本人 | 允许管理权限范围内访问 |
| 发布评论 | 不允许 | 允许 | 允许 |
| 修改/删除评论 | 不允许 | 本人评论 | 允许 |
| 新增/删除书籍、批量上传 | 不允许 | 不允许 | 允许 |
| 用户、书籍、评论及统计管理 API | 不允许 | 不允许 | 允许 |
实际 API 中,书籍列表和搜索也位于 JWT 验证中间件之后,因此需要有效登录。具体路径与授权中间件见 Node 仓库的 src/routes/api.js 和 src/middlewares/authorization.js。
角色与安全¶
数据库 user.role 值为 admin 时被视为管理员,其他值按普通用户处理。不要只依赖前端隐藏按钮;所有敏感 API 都必须由服务端验证 JWT、角色和资源所有权。
密码使用 scrypt 哈希存储;生产部署需配置强随机 JWT_SECRET 并通过 HTTPS 传输。不要将 token 放进 URL 查询参数,也不要把角色当作客户端可信输入。
未实现的权限模型¶
当前没有 free/vip 订阅、付费校验、用户书籍数量配额、离线授权等级或按等级开放高级设置。数据库中的 price 字段不构成付费功能。阅读器中存在 VIP 升级提示弹窗,但没有对应的支付和服务端授权实现。