后端架构
后端技术点¶
Node 主 API/Web 服务¶
genshin-novel-reader-api-node 基于 Express,连接 MariaDB/MySQL 和 Redis。Express 路由负责用户注册/登录、书籍搜索和详情、书架、评论、批量导入和管理员统计;EJS 提供页面 shell,独立 React 子项目构建登录、注册和管理员界面。
登录成功后服务端签发有效期 1 小时的 JWT。受保护 API 验证 bearer token,并从数据库重新读取当前用户及角色。授权规则包括管理员专属操作、用户仅访问本人资料/书架,以及评论作者或管理员修改/删除评论。密码使用 Node scrypt 哈希;兼容的旧明文密码会在成功登录时升级为哈希。生产部署必须设置强 JWT_SECRET。
MySQL 保存业务数据,Redis 用于书籍详情缓存。Node 定时任务扫描无标签书籍,调用 Python 服务生成标签,再更新书籍记录。
Python 标签服务¶
genshin-novel-reader-api-python 使用 Flask app factory,对外提供 POST /api/tags。服务使用 jieba、本地中文停用词表和原神角色标签表生成标签,不直接访问业务数据库。Node 通过 PYTHON_API_URL 配置服务地址。
相关技术¶
- Node:Express、EJS、mysql、Redis 客户端、
jsonwebtoken、Multer、日志模块。 - Python:Flask、jieba。
- 本地数据库与缓存:scripts 仓库通过 Docker Compose 提供 MariaDB 和 Redis。