数据库
数据库设计¶
初始化与连接¶
Node 主 API 使用 MariaDB/MySQL 保存用户、书籍、评论、用户书架和下载记录。共享 schema 位于 genshin-novel-reader-scripts/sql/init.sql,由 scripts 仓库的 Docker Compose 在 MariaDB 首次初始化空数据目录时执行。已有数据库不会自动应用该文件;当前仓库提供全新初始化,不维护历史迁移脚本。
Python 标签 API 不连接数据库。
当前表结构¶
| 表 | 主要字段和约束 | 用途 |
|---|---|---|
user |
id, name, avatar, email, password, role;email 唯一 |
账号、scrypt 密码哈希和角色 |
book |
id, name, cover_photo, author, brief, detail, created_at, price, size, tag, download_count;tag 和 download_count 有索引 |
书籍元数据及正文;正文使用 LONGTEXT |
comment |
id, book_id, author, detail, created_at;书籍外键及 (book_id, id) 索引 |
书籍评论;作者以邮箱文本保存,未定义用户外键 |
user_book |
userid, bookid;组合唯一键及用户/书籍外键 |
用户保存的书籍关联 |
download_info |
userid, bookid, created_at;(userid, bookid) 唯一键和 bookid 索引,用户/书籍外键 |
用户首次/唯一下载关联记录 |
book.size 是正文的 UTF-16 code unit 数(JavaScript String.length 口径),不是字节数。download_count 是书籍汇总字段。当前 download_info 对同一用户和书籍只允许一条记录,因此它不是每次打开小说的事件流水表。
关系与删除¶
- 用户与书籍通过
user_book建立多对多关系。 - 书籍与评论是一对多关系,评论的
book_id引用书籍。 - 评论作者字段是邮箱快照文本,不是用户外键;用户与评论间没有数据库外键关系。
- 下载关联引用用户和书籍。
- schema 定义外键但未统一声明级联删除;删除数据时应遵守外键并按业务决定先处理关联记录。
Redis¶
Node 使用 Redis 缓存书籍详情(缓存 key 格式为 book-{id})。Redis 由 scripts 仓库的 Compose 管理。它是缓存,不是业务数据的权威存储;更新/删除书籍时应考虑缓存失效。应用真实行为以 Node API 实现为准。
备份与重建¶
重建数据库前应先备份。sql/init.sql 只描述空库初始化,不可当作安全的升级脚本直接覆盖已有 schema。