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

static/js/app.js

@@ -14,8 +14,52 @@ function formatHours(seconds) {
     return (seconds / 3600).toFixed(1);
 }
 
+// ===== 数据库健康检查 =====
+/**
+ * 页面加载时检查 MySQL 数据库连接状态。
+ * 如果连接失败，显示告警横幅并阻止后续数据加载。
+ */
+async function checkDBHealth() {
+    try {
+        const resp = await fetch(API_BASE + "/api/health");
+        const data = await resp.json();
+        if (resp.ok && data.database === "connected") {
+            // 数据库连接正常，隐藏告警横幅
+            document.getElementById("dbAlertBanner").style.display = "none";
+            return true;
+        } else {
+            // 数据库连接异常，显示告警横幅
+            showDBAlert(data.message || "数据库连接失败");
+            return false;
+        }
+    } catch (error) {
+        // 健康检查接口本身无法访问
+        showDBAlert("无法连接到服务器，请检查后端服务是否运行。");
+        return false;
+    }
+}
+
+/**
+ * 显示数据库连接告警横幅。
+ * @param {string} message - 告警详情信息
+ */
+function showDBAlert(message) {
+    const banner = document.getElementById("dbAlertBanner");
+    const detail = document.getElementById("dbAlertDetail");
+    if (banner) banner.style.display = "flex";
+    if (detail) detail.textContent = message;
+}
+
 // ===== 初始化 =====
-document.addEventListener("DOMContentLoaded", () => {
+document.addEventListener("DOMContentLoaded", async () => {
+    // 首先检查数据库连接状态
+    const isHealthy = await checkDBHealth();
+    if (!isHealthy) {
+        // 数据库连接失败，不加载后续数据
+        return;
+    }
+
+    // 数据库连接正常，加载所有数据模块
     loadOverview();
     loadYearlyTrend();
     loadTimeDistribution();