 admin
|
5e4de7a336
|
merge: merge dev into master - MySQL switch, Chinese comments, health check, docs
|
2026-07-17 10:26:14 +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
|
292cb3f9e9
|
merge: merge dev into master - MySQL migration script
|
2026-07-17 10:16:47 +08:00 |
|
|
admin
|
72e9971a69
|
feat: add SQLite to MySQL migration script
- migrate_to_mysql.py：将 weread.db (SQLite) 全部 18 张表数据迁移至 MySQL weread_dashboard 数据库
- 支持时间戳列自动转换（SQLite int -> MySQL TIMESTAMP）
- 共迁移 862 行数据，中文内容 utf8mb4 完整保存
|
2026-07-17 10:16:41 +08:00 |
|
|
admin
|
463b736d13
|
merge: merge dev into master - book detail, notes, recommendation, MySQL schema
合并 dev 分支新功能到 master：
1. 书籍详情弹窗（点击书架书籍查看详情）
2. 笔记详情弹窗（点击笔记书籍查看划线和想法）
3. 推荐页面（个性化推荐 + 关键词搜索）
4. MySQL 版本建表语句
|
2026-07-17 10:07:11 +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 |
|
|
admin
|
1e9c537b86
|
feat: init weread data dashboard
- 数据采集脚本 fetch_data.py：从微信读书 API 拉取书架、阅读统计、笔记数据存入 SQLite
- Flask 后端 app.py：提供 8 个 API 接口（总览、年度趋势、读书排行、偏好分类、偏好作者、时段分布、书架、笔记）
- 前端页面：ECharts 图表（年度趋势、时段分布、分类饼图、作者排行）、书架网格、笔记概览
- 数据规模：404 本书架、339 小时阅读、304 天阅读、1709 条笔记
|
2026-07-17 09:59:37 +08:00 |
|