 admin
|
2a809eb7cc
|
refactor: complete data model v2.0 based on official API docs
数据模型全面重构，基于微信读书官方 8 份 API 文档逐字段比对：
1. 表结构从 18 张扩展到 31 张表：
新增表：shelf_albums(有声书)、shelf_meta(书架元信息)、prefer_publishers(偏好出版社)、
prefer_cps(偏好版权方)、prefer_books(偏好书籍卡片)、read_rank(好友排行)、
medals(勋章)、year_reports(年度报告)、book_best_bookmarks(热门划线)、
book_underlines(划线热度)、similar_books(相似推荐)、public_reviews(公开点评)、
search_sessions(搜索会话)
2. 补全所有遗漏字段：
- reading_stats: +13 个字段 (baseTime, compare, readRate, wrReadTime, wrListenTime 等)
- book_chapters: +8 个字段 (wordCount, level, price, paid, isMPChapter, anchors 等)
- book_reviews: +4 个字段 (abstract, range, chapterUid, chapterIdx)
- recommended_books: +5 个字段 (deepLink, searchIdx, price, payType, type)
- search_results: +8 个字段 (deepLink, payType, price, soldout, scope 等)
- book_details: +2 个字段 (deepLink, newRatingDetail)
- prefer_categories: +2 个字段 (parentCategoryId, categoryType)
3. 时间戳双列设计：
- 所有整型时间戳字段均伴随 _dt TIMESTAMP 列 (如 read_update_time + read_update_time_dt)
- 便于直接查询和展示，无需应用层转换
4. 审计字段：
- 每张表均维护 created_at 和 updated_at
- MySQL 使用 DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
5. 索引优化：
- 主键、唯一约束、查询索引根据实际访问模式重新设计
- 新增复合索引、排序索引、全文检索索引
6. 数据采集脚本更新：
- 覆盖所有新增表和字段的数据采集
- skill_version 升级至 1.0.4
- 有声书/专辑数据采集 (shelf_albums)
- 偏好出版社/版权方/书籍卡片采集
- 勋章、年度报告数据采集
7. 后端适配：
- 移除旧版 ensure_tables 动态建表逻辑
- 所有按需 API INSERT 语句适配新表结构
- 搜索结果入库新增 search_sessions 会话表
- 推荐书籍入库新增 batch_id 批次标识
|
2026-07-17 10:37:07 +08:00 |
|
|
admin
|
507b9c5704
|
feat: switch to MySQL, add Chinese comments, health check, and technical docs
1. 数据源切换至 MySQL：
- app.py 从 SQLite 切换到 PyMySQL，所有 API 读取 MySQL weread_dashboard 数据库
- 新增 db_required 装饰器统一管理数据库连接和异常处理
- 新增 /api/health 健康检查接口，检测 MySQL 连接状态
- MySQL 连接失败时返回 HTTP 503 和告警信息
- 修复 fetched_at 字段 Unix 时间戳到 MySQL TIMESTAMP 的兼容问题
2. 前端数据库连接告警：
- 页面加载时优先调用 /api/health 检查 MySQL 连接
- 连接失败时显示固定告警横幅，阻止后续数据加载
- CSS 告警横幅样式（黄色背景、下滑动画）
3. 代码中文注释：
- app.py：所有函数、API 接口、工具函数添加完整中文文档注释
- fetch_data.py：所有 SQLite 建表语句添加列级中文注释
- migrate_to_mysql.py：保留已有中文注释
4. 技术文档与元数据文档：
- docs/TECHNICAL_DOC.md：项目概述、系统架构、API 设计、部署指南
- docs/METADATA_DOC.md：18 张表完整字段说明、索引、表关系、数据类型规范
|
2026-07-17 10:26:07 +08:00 |
|
|
admin
|
ebfa3a1852
|
feat: add book detail, notes detail, recommendation page and MySQL schema
新增功能：
- 书籍详情弹窗：点击书架书籍展示详细信息（书名、作者、出版社、ISBN、字数、评分、简介、阅读进度），数据实时从微信读书 API 获取并入库
- 笔记详情弹窗：点击有笔记的书展示划线和想法/点评，按章节分组展示，数据实时获取并入库
- 推荐页面：个性化推荐（为你推荐）+ 关键词搜索书籍，数据从微信读书 API 获取并入库
- 修复 Flask 中文 URL 参数编码问题
后端新增 API：
- GET /api/book/detail?book_id=xxx — 书籍详情
- GET /api/book/notes?book_id=xxx — 笔记详情（划线+想法）
- GET /api/recommend?maxIdx=0 — 个性化推荐
- GET /api/search?keyword=xxx — 搜索书籍
数据库新增表：
- book_details, book_progress, book_highlights, book_chapters
- book_reviews, recommended_books, search_results
MySQL 版本建表语句 schema_mysql.sql：
- 18 张表的完整 DDL，含索引、字符集 utf8mb4、字段注释
- 适用于后续从 SQLite 迁移至 MySQL
|
2026-07-17 10:07:05 +08:00 |
|