S1: 数据梳理 — Dashboard Metrics 定义

目标

梳理 wechat-viewer 所有页面及核心指标，生成 /docs/dashboard-metrics.md，为 /api/dashboard 提供数据源定义。

涉及文件

• docs/dashboard-metrics.md (新建)

数据流

wechat-viewer 现有页面 → 每个页面的 API → 对应的 DB 表/查询 → 聚合为 dashboard 指标

步骤

1. 遍历 all routes in app.py，列出每个页面
2. 对每个页面，找到其 API 端点 → DB 查询
3. 定义每个指标的 SQL 查询
4. 写入 docs/dashboard-metrics.md
5. 验证：每个 SQL 在 circle.db 上可执行

验证命令

# 确认文档存在
ls -la ~/wechat-viewer/docs/dashboard-metrics.md
# 验证 SQL 可执行
python3 -c "
import sqlite3
conn = sqlite3.connect(os.path.expanduser('~/wechat-viewer/circle.db'))
conn.execute('SELECT COUNT(*) FROM articles')
conn.close()
print('OK')
"