书籍下载统计¶
当前实现¶
在线用户请求 Node API GET /api/novel-detail?book_id=... 时,服务端尝试记录用户与书籍的下载关联,并更新 book.download_count。详情读取不等同于文件传输次数。当前实现对重复用户/书籍组合执行普通 INSERT,而 schema 有唯一键,因此同一用户再次打开同一本书可能因重复键而导致详情请求失败;并且下载计数更新与记录写入并未作为一个事务完成。此行为应在修复幂等记录/事务逻辑前谨慎解释。
当前初始化 schema(sql/init.sql)中:
CREATE TABLE `download_info` (
`userid` int NOT NULL,
`bookid` int NOT NULL,
`created_at` datetime(6) DEFAULT CURRENT_TIMESTAMP(6),
UNIQUE KEY `uk_download_info_user_book` (`userid`, `bookid`),
KEY `idx_download_info_bookid` (`bookid`),
CONSTRAINT `download_info_user_foreign_key` FOREIGN KEY (`userid`) REFERENCES `user` (`id`),
CONSTRAINT `download_info_book_foreign_key` FOREIGN KEY (`bookid`) REFERENCES `book` (`id`)
);
因此每个用户/书籍组合最多一条下载记录,不包含独立自增 ID,也不保留同一用户反复访问的每次事件。book.download_count 由 Node 依据该表记录数更新。书籍列表接口返回 download_count 并按其降序排列,最多返回 10 条。
管理员统计¶
管理员可调用 GET /api/admin/book-statistics?book_id=... 获取单本书的下载汇总和评论统计。管理员界面还提供全站用户、书籍、评论总数及评论分布图表。当前没有按时间区间统计每次下载事件的功能。
代码位置¶
- Schema:
genshin-novel-reader-scripts/sql/init.sql - 详情读取和下载关联:
genshin-novel-reader-api-node/src/routes/api-novel.js - 管理统计:
genshin-novel-reader-api-node/src/routes/api-admin.js