rosercode
923d6db5c0
对照 ledgerly 自文档上次更新以来的全部改动，补充新功能文档、修正品牌与版本残留，并新增下载与安装页；配图已重新截取并上传 OSS，本地截图目录不纳入版本管理。 变更内容： - 新增「智能查数」「账单关系」两个使用文档页，并登记侧边栏与总览 - 设置页扩充为八个面板（账号安全、数据库实时进度、外观、导航等）并改为即时保存 - 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗 - 统计面板补充饼图/渠道图下钻与筛选双向联动；规则管理补充批量删除 - AI 能力补充智能查数与关系命名；新增下载与安装页 - 开发文档同步：AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署 - 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案，版本号对齐 0.1 - 截图脚本新增账单详情等场景并更新登记 说明： - download.md 的 OSS 下载链接保持待发布产物回填，暂不调整 - 已通过 npm run docs:build 与 npm run typecheck:scripts
69 lines
4.8 KiB
Markdown
69 lines
4.8 KiB
Markdown
# 页面总览
|
||
|
||
本节汇总系统的全部页面、用途、入口方式与相互之间的跳转关系。
|
||
|
||
## 页面清单
|
||
|
||
| 页面 | 路由 | 用途 | 入口方式 |
|
||
|---|---|---|---|
|
||
| 登录 | `/login` | 用户名密码登录 | 未登录访问受保护页面时自动跳转 |
|
||
| 注册 | `/register` | 创建账号 | 登录页「没有账号？去注册」（注册开启时） |
|
||
| 数据库初始化 | `/database-setup` | 首次配置数据库 | 数据库未配置时自动引导 |
|
||
| 统计面板 | `/dashboard` | 收支汇总与图表 | 登录后默认页；左侧菜单 |
|
||
| 智能查数 | `/smart-query` | 自然语言转只读 SQL 查询 | 左侧菜单（**AI 启用时**） |
|
||
| 收支记录 | `/transactions` | 记录管理与**账单导入** | 左侧菜单 |
|
||
| 分类管理 | `/categories` | 收入/支出分类维护 | 左侧菜单 |
|
||
| 标签管理 | `/tags` | 标签维护 | 左侧菜单 |
|
||
| 交易渠道管理 | `/channels` | 自定义交易渠道维护 | 收支记录页「渠道管理」按钮 |
|
||
| 规则管理 | `/rules` | 自动归类规则 | 左侧菜单 |
|
||
| 邮箱账单 | `/email-bills/*` | 邮箱配置 / 发件人规则 / 待处理账单 | 左侧菜单 |
|
||
| 设置 | `/settings` | 账号安全 / 数据库 / 注册 / 账单来源统计 / 外观 / 导航 / AI / 通知配置 | 顶部用户菜单 |
|
||
| 模型使用情况 | `/ai-usage` | AI 调用统计与明细 | 设置页「AI 模型配置」→ 使用情况 |
|
||
| 日志 | `/logs/*` | 访问 / 登录 / 运行日志 | 顶部用户菜单 |
|
||
| 账单导入（独立页） | `/bill-import` | 手机端上传账单 | **仅由通知邮件链接直达** |
|
||
|
||
> 「账单关系」不是独立页面，它是收支记录内的弹窗：由列表「关系」列或「批量操作 → 建立关系」进入，详见[账单关系](/guide/relations)。
|
||
|
||
## 全局导航
|
||
|
||
### 左侧菜单
|
||
|
||
统计面板 → 智能查数（AI 启用时）→ 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单
|
||
|
||
左侧菜单的**顺序与显隐可自定义**（设置 → 导航设置），并在下次进入时还原。
|
||
|
||
### 顶部用户菜单
|
||
|
||
- **日志**：`/logs`
|
||
- **设置**：`/settings`
|
||
- **退出**：清空登录态并返回 `/login`
|
||
|
||
> 「模型使用情况」没有独立菜单入口，需从「设置 → AI 模型配置 → 使用情况」进入。
|
||
>
|
||
> 「交易渠道管理」同样没有独立菜单入口，需从「收支记录 → 渠道管理」进入。
|
||
|
||
## 典型跳转路径
|
||
|
||
- **首次使用**：`/database-setup` → `/register` → `/login` → `/dashboard`
|
||
- **手动记账**：收支记录 → 点击「新增记录」→ 表单弹窗 → 保存
|
||
- **查看趋势明细**：统计面板 → 点击趋势柱、分类/渠道饼图或「查看收支记录」→ 收支记录（自动带入对应筛选条件）
|
||
- **反向跳转**：收支记录 → 点击「查看统计」→ 统计面板（还原当前筛选条件）
|
||
- **账单导入**：收支记录 → 点击「导入账单」→ 解析预览 → 确认导入 → 回到收支记录
|
||
- **手机导入**：通知邮件链接 → `/bill-import`（独立页，非弹窗）→ 上传解析 → 确认导入
|
||
- **渠道维护**：收支记录 → 点击「渠道管理」→ 新建 / 改名 / 删除自定义渠道 → 返回收支记录
|
||
- **账单关系**：收支记录「关系」列 → 关系弹窗；或「批量操作」勾选多条 → 建立关系
|
||
- **智能查数**：左侧菜单「智能查数」→ 输入自然语言 → 查看结果、生成的 SQL 与历史提问
|
||
- **自动归类**：规则管理配置规则 → 账单导入预览时命中并给出建议
|
||
- **邮箱账单**：邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
|
||
- **AI 辅助**：设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
|
||
- **系统维护**：顶部菜单 → 设置 / 日志
|
||
|
||
## 页面关系说明
|
||
|
||
- **收支记录**是核心页面：手动记账、账单导入、批量操作、账单关系与 AI 能力都从这里进入，导入完成后也回到该页查看。
|
||
- **账单导入**有两条独立路径：
|
||
- 收支记录页的「导入账单」**弹窗**（桌面端常用）；
|
||
- 通知邮件直达的 **`/bill-import` 独立页**（面向手机，非弹窗，元素精简，系统内无其他入口）。
|
||
- **设置**聚合了账号安全、数据库、注册、账单来源统计、外观、导航、AI、通知八类配置；模型用量与日志分别从设置页与顶部菜单进入。
|
||
- **交易渠道管理**是收支记录页的附属页；**账单关系**是收支记录内的弹窗，两者都在整理完成后回到收支记录继续操作。
|