Files
rosercode ca1b8c05d5 docs: 补充统计面板图表点击跳转开关说明
统计面板图表的点击下钻交互新增了可关闭开关(默认开启),可在统计面板筛选区或设置页「外观设置」关闭;关闭后点击趋势柱/饼图不再跳转,并隐藏点击提示与饼图手型光标。本次同步更新使用与开发文档,并重截外观设置面板配图。

变更内容:
- `guide/dashboard.md`:筛选条件小节与「点击图表查看明细」小节补充开关说明(两处入口、关闭效果与实时同步)。
- `guide/settings.md`:外观设置由三组改为四组,新增「图表点击查看明细」并对其余分组重新编号;配图 `elements/panel-display.png` 重截并上传 OSS。
- `dev/preferences.md`:后端按用户同步偏好总览表加行,并新增「图表点击跳转明细」小节(接口、默认值、存储键、共享 composable 与消费入口)。
- `dev/api.md`:新增 `GET/PUT /api/setting/chart-click-navigation` 接口。
- `dev/data-model.md`:`t_user_preference` 已用偏好键补充 `chartClickNavigation`。
2026-10-13 16:02:49 +08:00

98 lines
6.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 统计面板
「统计面板」用于查看指定时间范围内的收支汇总与图表,可从左侧菜单进入(登录后的默认首页为[日历](/guide/calendar))。
![统计面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/dashboard.png)
## 时间范围
顶部下拉可选择统计的时间范围:
| 选项 | 含义 |
|---|---|
| 本月 | 当月 1 日 00:00:00 ~ 当月最后一天 23:59:59(默认) |
| 近3月 | 含本月在内向前共 3 个月 |
| 近12月 | 含本月在内向前共 12 个月 |
| 自定义 | 手动选择起止日期(结束日按 23:59:59 计算) |
右侧实时显示当前查询区间。
## 时间粒度
趋势图右上角可选择粒度:**按日 / 按周 / 按月 / 按季 / 按年**。切换时间范围时会给出默认粒度(近12月→按月,近3月→按周,本月→按日)。区间内没有数据的点会补 0,保证趋势连续。
## AI 搜索
启用 AI 后,页面顶部会出现「**AI 搜索**」按钮,点击打开一个**可拖拽、可缩放的浮窗**(非模态)。用一句自然语言描述统计意图,系统会调用大模型解析为统计参数并自动回填、刷新图表,例如:
- 「上个月餐饮花了多少」→ 时间范围 + 分类
- 「近半年交通支出趋势,按周看」→ 时间范围 + 分类 + 按周粒度
- 「今年各类支出占比」→ 时间范围 + 类型
![AI 统计搜索浮窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-query-window.png)
可解析并回填的参数包括:**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径**与**趋势粒度**。浮窗内提供示例问题,输入框会记住历史记录(可一键清空);按 `Ctrl + Enter`(Mac 为 `⌘ + Enter`)或点击提交按钮执行,无可用条件时会提示且不改动当前筛选。详见 [AI 能力](/guide/ai)。
> 想要返回明细的自由问答式查询,可使用[智能查数](/guide/sql-query)。
## 筛选条件
- **统计口径**:仅计入统计(默认)/ 全部记录 / 仅不计入。默认只统计「计入统计」的记录,建议按来源设置(微信/支付宝计入、其他来源不计入),避免多来源重复统计。
- **类型**:支出 / 收入(多选)。
- **分类**:多选,含「未分类」。
- **交易渠道**:多选。
- **标签**:多选,含「无标签」。
- **金额区间**:最小 ~ 最大。
- **备注搜索**。
点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。筛选区还提供「**点击图表查看明细**」开关(默认开启),可关闭图表点击下钻,详见 [点击图表查看明细](#点击图表查看明细)。
## 汇总卡片
第一行展示四项汇总:**总收入**、**总支出**、**结余**、**交易笔数**。
第二行展示派生指标:**日均收入**、**日均支出**、**最大单笔支出**(附带备注摘要)、**平均每笔支出**。
## 图表
| 图表 | 说明 |
|---|---|
| 收支趋势(柱状图) | 按所选粒度展示收入(绿)与支出(红),**点击柱子或该列空白处**跳转查看对应明细 |
| 支出分类占比(环形图) | 各分类支出金额占比,**点击扇区**跳转该分类明细 |
| 收入分类占比(环形图) | 各分类收入金额占比,**点击扇区**跳转该分类明细 |
| 支出交易渠道占比(环形图) | 仅统计支出,按交易渠道,**点击扇区**跳转该渠道明细 |
| 收入交易渠道占比(环形图) | 仅统计收入,按交易渠道,**点击扇区**跳转该渠道明细 |
切换语言时,图表标题、图例与交易渠道名称会实时重绘。
### 点击图表查看明细
所有图表都可点击下钻,跳转到[收支记录](/guide/transactions)并自动带入对应筛选条件:
- **趋势柱状图**:整列可点击——点中柱子,或点击柱子顶端上方的空白处均可。
- **类型**:点中柱子时取该柱子的收入 / 支出;点击空白处时不限定类型(沿用面板当前类型筛选);
- **日期范围**:该列代表的时间桶——按日→当天、按周→周一至周日、按月→当月、按季→当季、按年→当年。
- **分类饼图**:点击某个扇区,按该分类(含「未分类」)与对应收支类型筛选。
- **渠道饼图**:点击某个扇区,按该交易渠道与对应收支类型筛选。
无论从哪张图下钻,都会同时保留面板当前的统计口径、标签、金额区间与备注关键字等筛选。
> 触屏设备上,点击趋势柱或饼图扇区会先弹出确认气泡(「查看明细」/「取消」),确认后才跳转,避免滑动或误触直接跳走;趋势图的**「整列可点」在触屏端禁用**,只能点击柱子本体。桌面端行为不变。
> **可关闭**:在统计面板筛选区或[设置 → 外观设置](/guide/settings#外观设置)中关闭「点击图表查看明细」(默认开启)后,点击任何图表元素都不再跳转,趋势图的「点击柱子查看对应明细」提示与饼图的手型光标也会一并隐藏;两处开关实时同步,重新开启即恢复下钻。
![点击趋势柱状图跳转收支记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/dashboard-trend-jump.png)
页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转,便于核对整体明细。
> 从[收支记录](/guide/transactions)点「查看统计」也会跳回本页,并还原收支记录当前的筛选条件(时间范围会切换为「自定义」)。
跳转后可直接查看对应明细;筛选条件会照常记忆,收支记录页原有的每页条数与排序偏好不受影响。
## 小技巧
- 想知道「上个月餐饮花了多少」,可把时间范围设为「本月」或自定义,并在分类中只勾选「餐饮」。
- 不计入统计的记录(如借款、账户间转账)默认不会计入汇总;如需查看全部,把统计口径切换为「全部记录」。
- 想快速核对某月、某周或某天的明细,直接点击「收支趋势」上对应的列(柱子或该列空白处),即可带着时间范围跳到收支记录。
- 点击分类或渠道饼图的某个扇区,可一键下钻到该分类 / 渠道的明细;点「查看收支记录」则带上当前全部筛选。