Skip to content

数据库

数据库设计

初始化与连接

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。