diff --git a/dev/api.md b/dev/api.md index bc89bbe..950f6b0 100644 --- a/dev/api.md +++ b/dev/api.md @@ -71,6 +71,7 @@ | POST | `/api/ai/statistics` | 自然语言解析为统计面板参数 | | GET / PUT | `/api/setting/excluded-display-style` | 查询 / 更新「不计入统计」记录展示样式 | | GET / PUT | `/api/setting/show-hidden-data` | 查询 / 更新是否显示已隐藏备注的记录 | +| GET / PUT | `/api/setting/chart-click-navigation` | 查询 / 更新统计面板图表点击是否跳转明细 | | GET / PUT | `/api/setting/pagination-prefs` | 查询 / 更新表格分页候选列表与默认每页条数 | | GET / PUT | `/api/setting/nav-menu` | 查询 / 更新左侧导航顺序与显隐 | | GET / PUT | `/api/setting/bill-source-include-in-stats` | 查询 / 更新按账单来源的「计入统计」默认值 | diff --git a/dev/data-model.md b/dev/data-model.md index 65a018e..32b3c77 100644 --- a/dev/data-model.md +++ b/dev/data-model.md @@ -140,7 +140,7 @@ ### t_user_preference -按用户存储的键值偏好:`pref_key` 为偏好键,`pref_value` 为标量字符串或 JSON。已使用的偏好键包括:`billSourceIncludeInStats`(各来源计入统计默认值)、`excludedDisplayStyle`(不计入记录展示样式)、`showHiddenData`(是否显示已隐藏备注的记录)、`paginationPrefs`(表格分页候选与默认值)、`navMenu`(左侧导航顺序与显隐)。唯一索引 `uk_user_pref (user_id, pref_key)` 保证每个用户每个偏好仅一条。未配置时由应用回退系统默认值。 +按用户存储的键值偏好:`pref_key` 为偏好键,`pref_value` 为标量字符串或 JSON。已使用的偏好键包括:`billSourceIncludeInStats`(各来源计入统计默认值)、`excludedDisplayStyle`(不计入记录展示样式)、`showHiddenData`(是否显示已隐藏备注的记录)、`chartClickNavigation`(统计面板图表点击是否跳转明细)、`paginationPrefs`(表格分页候选与默认值)、`navMenu`(左侧导航顺序与显隐)。唯一索引 `uk_user_pref (user_id, pref_key)` 保证每个用户每个偏好仅一条。未配置时由应用回退系统默认值。 ### t_email_bill_config diff --git a/dev/preferences.md b/dev/preferences.md index 4ef1a88..b5279ef 100644 --- a/dev/preferences.md +++ b/dev/preferences.md @@ -67,6 +67,7 @@ |---|---|---| | `GET/PUT /api/setting/excluded-display-style` | 「不计入统计」记录展示样式 | `components/DisplayConfigPanel.vue` | | `GET/PUT /api/setting/show-hidden-data` | 是否显示已隐藏备注的记录 | `components/DisplayConfigPanel.vue` | +| `GET/PUT /api/setting/chart-click-navigation` | 统计面板图表点击是否跳转明细 | `components/DisplayConfigPanel.vue` / `views/Dashboard.vue` | | `GET/PUT /api/setting/pagination-prefs` | 表格分页候选与默认每页条数 | `components/DisplayConfigPanel.vue` | | `GET/PUT /api/setting/nav-menu` | 左侧导航顺序与显隐 | `components/NavMenuConfigPanel.vue` | | `GET/PUT /api/setting/bill-source-include-in-stats` | 各账单来源「计入统计」默认值 | `components/BillSourceStatsPanel.vue` | @@ -226,6 +227,14 @@ - **前端**:设置页 `components/DisplayConfigPanel.vue` 切换即存;收支列表与 Excel 导出据此过滤(关闭时排除 `remark_hidden = true` 的记录),统计备注搜索不受影响。 - **目的**:统一控制「已隐藏备注的记录」是否出现在列表与导出中。 +### 图表点击跳转明细 + +- **接口**:`GET/PUT /api/setting/chart-click-navigation`(`api/setting.ts`) +- **数据结构**:`{ enabled: boolean }`,默认 `true`(开启)。 +- **存储**:`t_user_preference` 的 `pref_key = chartClickNavigation`,值以 `"true"`/`"false"` 保存;未配置时读取默认开启。 +- **前端**:共享单例 `composables/useChartClickNavigation.ts`(`chartClickEnabled` + `ensureChartClickEnabledLoaded` / `refreshChartClickEnabled`,读取失败回退默认开启);设置页 `components/DisplayConfigPanel.vue` 与统计面板 `views/Dashboard.vue` 筛选区两处开关读写同一状态、即时联动。关闭后 `Dashboard.vue` 的点击跳转入口(`triggerChartNavigation` / `handleTrendBlankClick`)直接返回,并重绘图表以同步光标、隐藏点击提示。 +- **目的**:允许用户关闭统计面板图表的点击下钻交互,跨设备生效。 + ### 表格分页偏好 - **接口**:`GET/PUT /api/setting/pagination-prefs`(`api/setting.ts`) diff --git a/guide/dashboard.md b/guide/dashboard.md index 9a79aaa..7bf39ac 100644 --- a/guide/dashboard.md +++ b/guide/dashboard.md @@ -45,7 +45,7 @@ - **金额区间**:最小 ~ 最大。 - **备注搜索**。 -点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。 +点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。筛选区还提供「**点击图表查看明细**」开关(默认开启),可关闭图表点击下钻,详见 [点击图表查看明细](#点击图表查看明细)。 ## 汇总卡片 @@ -79,6 +79,8 @@ > 触屏设备上,点击趋势柱或饼图扇区会先弹出确认气泡(「查看明细」/「取消」),确认后才跳转,避免滑动或误触直接跳走;趋势图的**「整列可点」在触屏端禁用**,只能点击柱子本体。桌面端行为不变。 +> **可关闭**:在统计面板筛选区或[设置 → 外观设置](/guide/settings#外观设置)中关闭「点击图表查看明细」(默认开启)后,点击任何图表元素都不再跳转,趋势图的「点击柱子查看对应明细」提示与饼图的手型光标也会一并隐藏;两处开关实时同步,重新开启即恢复下钻。 + ![点击趋势柱状图跳转收支记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/dashboard-trend-jump.png) 页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转,便于核对整体明细。 diff --git a/guide/settings.md b/guide/settings.md index 99fd523..fbee910 100644 --- a/guide/settings.md +++ b/guide/settings.md @@ -55,7 +55,7 @@ ![外观设置面板](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/panel-display.png) -外观设置包含三组配置,**修改后自动保存**,无需再点保存按钮: +外观设置包含四组配置,**修改后自动保存**,无需再点保存按钮: **1. 不计入统计的记录样式**:选择「不计入统计」的记录在[收支记录](/guide/transactions)列表中的展示方式: @@ -69,7 +69,13 @@ - 关闭时,备注被隐藏的记录不会出现在收支记录列表与 Excel 导出中。 - 开启后,这些记录会正常显示(备注仍为 `******`,可临时「查看」)。 -**3. 表格每页条数**: +**3. 图表点击查看明细**(默认开启): + +- 开启后,点击[统计面板](/guide/dashboard)的趋势柱子或饼图扇区可跳转查看对应收支明细。 +- 关闭后图表仅用于展示:点击不再跳转,趋势图的「点击柱子查看对应明细」提示与饼图的手型光标一并隐藏。 +- 该开关在统计面板的**筛选条件**区也提供,两处修改实时同步。 + +**4. 表格每页条数**: - **表格每页条数选项**:所有表格分页共用的候选列表,默认 `10 / 20 / 50 / 100`,可自行增删(最多 10 项)。 - **默认每页条数**:从候选中选择,作为各表格未单独记忆时的默认值(默认 20)。