feat: switch to MySQL, add Chinese comments, health check, and technical docs

Browse Source

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 张表完整字段说明、索引、表关系、数据类型规范

...

This commit is contained in:

admin committed 2026-07-17 10:26:07 +08:00

1 parent 72e9971a69

commit 507b9c5704

8 files changed

+1805 -436

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

app.py

+671 -277

File diff suppressed because it is too large. Load diff