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`。
This commit is contained in:
@@ -71,6 +71,7 @@
|
|||||||
| POST | `/api/ai/statistics` | 自然语言解析为统计面板参数 |
|
| POST | `/api/ai/statistics` | 自然语言解析为统计面板参数 |
|
||||||
| GET / PUT | `/api/setting/excluded-display-style` | 查询 / 更新「不计入统计」记录展示样式 |
|
| GET / PUT | `/api/setting/excluded-display-style` | 查询 / 更新「不计入统计」记录展示样式 |
|
||||||
| GET / PUT | `/api/setting/show-hidden-data` | 查询 / 更新是否显示已隐藏备注的记录 |
|
| GET / PUT | `/api/setting/show-hidden-data` | 查询 / 更新是否显示已隐藏备注的记录 |
|
||||||
|
| GET / PUT | `/api/setting/chart-click-navigation` | 查询 / 更新统计面板图表点击是否跳转明细 |
|
||||||
| GET / PUT | `/api/setting/pagination-prefs` | 查询 / 更新表格分页候选列表与默认每页条数 |
|
| GET / PUT | `/api/setting/pagination-prefs` | 查询 / 更新表格分页候选列表与默认每页条数 |
|
||||||
| GET / PUT | `/api/setting/nav-menu` | 查询 / 更新左侧导航顺序与显隐 |
|
| GET / PUT | `/api/setting/nav-menu` | 查询 / 更新左侧导航顺序与显隐 |
|
||||||
| GET / PUT | `/api/setting/bill-source-include-in-stats` | 查询 / 更新按账单来源的「计入统计」默认值 |
|
| GET / PUT | `/api/setting/bill-source-include-in-stats` | 查询 / 更新按账单来源的「计入统计」默认值 |
|
||||||
|
|||||||
+1
-1
@@ -140,7 +140,7 @@
|
|||||||
|
|
||||||
### t_user_preference
|
### 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
|
### t_email_bill_config
|
||||||
|
|
||||||
|
|||||||
@@ -67,6 +67,7 @@
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `GET/PUT /api/setting/excluded-display-style` | 「不计入统计」记录展示样式 | `components/DisplayConfigPanel.vue` |
|
| `GET/PUT /api/setting/excluded-display-style` | 「不计入统计」记录展示样式 | `components/DisplayConfigPanel.vue` |
|
||||||
| `GET/PUT /api/setting/show-hidden-data` | 是否显示已隐藏备注的记录 | `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/pagination-prefs` | 表格分页候选与默认每页条数 | `components/DisplayConfigPanel.vue` |
|
||||||
| `GET/PUT /api/setting/nav-menu` | 左侧导航顺序与显隐 | `components/NavMenuConfigPanel.vue` |
|
| `GET/PUT /api/setting/nav-menu` | 左侧导航顺序与显隐 | `components/NavMenuConfigPanel.vue` |
|
||||||
| `GET/PUT /api/setting/bill-source-include-in-stats` | 各账单来源「计入统计」默认值 | `components/BillSourceStatsPanel.vue` |
|
| `GET/PUT /api/setting/bill-source-include-in-stats` | 各账单来源「计入统计」默认值 | `components/BillSourceStatsPanel.vue` |
|
||||||
@@ -226,6 +227,14 @@
|
|||||||
- **前端**:设置页 `components/DisplayConfigPanel.vue` 切换即存;收支列表与 Excel 导出据此过滤(关闭时排除 `remark_hidden = true` 的记录),统计备注搜索不受影响。
|
- **前端**:设置页 `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`)
|
- **接口**:`GET/PUT /api/setting/pagination-prefs`(`api/setting.ts`)
|
||||||
|
|||||||
+3
-1
@@ -45,7 +45,7 @@
|
|||||||
- **金额区间**:最小 ~ 最大。
|
- **金额区间**:最小 ~ 最大。
|
||||||
- **备注搜索**。
|
- **备注搜索**。
|
||||||
|
|
||||||
点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。
|
点击「重置筛选」可清空筛选(保留时间范围与粒度)。筛选条件会记住,下次进入自动还原。筛选区还提供「**点击图表查看明细**」开关(默认开启),可关闭图表点击下钻,详见 [点击图表查看明细](#点击图表查看明细)。
|
||||||
|
|
||||||
## 汇总卡片
|
## 汇总卡片
|
||||||
|
|
||||||
@@ -79,6 +79,8 @@
|
|||||||
|
|
||||||
> 触屏设备上,点击趋势柱或饼图扇区会先弹出确认气泡(「查看明细」/「取消」),确认后才跳转,避免滑动或误触直接跳走;趋势图的**「整列可点」在触屏端禁用**,只能点击柱子本体。桌面端行为不变。
|
> 触屏设备上,点击趋势柱或饼图扇区会先弹出确认气泡(「查看明细」/「取消」),确认后才跳转,避免滑动或误触直接跳走;趋势图的**「整列可点」在触屏端禁用**,只能点击柱子本体。桌面端行为不变。
|
||||||
|
|
||||||
|
> **可关闭**:在统计面板筛选区或[设置 → 外观设置](/guide/settings#外观设置)中关闭「点击图表查看明细」(默认开启)后,点击任何图表元素都不再跳转,趋势图的「点击柱子查看对应明细」提示与饼图的手型光标也会一并隐藏;两处开关实时同步,重新开启即恢复下钻。
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转,便于核对整体明细。
|
页面底部的「**查看收支记录**」按钮则会携带**当前全部筛选条件**跳转,便于核对整体明细。
|
||||||
|
|||||||
+8
-2
@@ -55,7 +55,7 @@
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
外观设置包含三组配置,**修改后自动保存**,无需再点保存按钮:
|
外观设置包含四组配置,**修改后自动保存**,无需再点保存按钮:
|
||||||
|
|
||||||
**1. 不计入统计的记录样式**:选择「不计入统计」的记录在[收支记录](/guide/transactions)列表中的展示方式:
|
**1. 不计入统计的记录样式**:选择「不计入统计」的记录在[收支记录](/guide/transactions)列表中的展示方式:
|
||||||
|
|
||||||
@@ -69,7 +69,13 @@
|
|||||||
- 关闭时,备注被隐藏的记录不会出现在收支记录列表与 Excel 导出中。
|
- 关闭时,备注被隐藏的记录不会出现在收支记录列表与 Excel 导出中。
|
||||||
- 开启后,这些记录会正常显示(备注仍为 `******`,可临时「查看」)。
|
- 开启后,这些记录会正常显示(备注仍为 `******`,可临时「查看」)。
|
||||||
|
|
||||||
**3. 表格每页条数**:
|
**3. 图表点击查看明细**(默认开启):
|
||||||
|
|
||||||
|
- 开启后,点击[统计面板](/guide/dashboard)的趋势柱子或饼图扇区可跳转查看对应收支明细。
|
||||||
|
- 关闭后图表仅用于展示:点击不再跳转,趋势图的「点击柱子查看对应明细」提示与饼图的手型光标一并隐藏。
|
||||||
|
- 该开关在统计面板的**筛选条件**区也提供,两处修改实时同步。
|
||||||
|
|
||||||
|
**4. 表格每页条数**:
|
||||||
|
|
||||||
- **表格每页条数选项**:所有表格分页共用的候选列表,默认 `10 / 20 / 50 / 100`,可自行增删(最多 10 项)。
|
- **表格每页条数选项**:所有表格分页共用的候选列表,默认 `10 / 20 / 50 / 100`,可自行增删(最多 10 项)。
|
||||||
- **默认每页条数**:从候选中选择,作为各表格未单独记忆时的默认值(默认 20)。
|
- **默认每页条数**:从候选中选择,作为各表格未单独记忆时的默认值(默认 20)。
|
||||||
|
|||||||
Reference in New Issue
Block a user