# 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 上可执行

## 验证命令
```bash
# 确认文档存在
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')
"
```