 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 |
|