rosercode
d94d4e1ed5
同步近期 ledgerly 功能与配置变更到文档站：新增收支记录页「AI 生成规则」入口的用户与开发说明、补充新接口与规则应用逻辑、修正 CORS/反向代理与运行环境编码说明，并更新邮箱检查进度时间戳描述。 变更内容： - guide/transactions.md 批量操作区新增「AI 生成规则」按钮与「AI 生成规则（从勾选账单）」小节（含「同时应用到勾选账单」），引用新截图。 - guide/ai.md、guide/rules.md、guide/pages.md 补充两处生成入口与「同时应用」说明。 - dev/api.md 新增 POST /api/ai/rule/apply-transactions；dev/rule-engine.md、dev/ai.md 补充 applyToTransactions 与两个生成入口。 - dev/build-deploy.md 将 CORS 更新为放开全部来源并信任反向代理转发头，新增运行环境 UTF-8 locale 说明。 - guide/email-bills.md 补充「立即检查」进度每行带 HH:mm:ss 时间戳。 - scripts/ts/capture-elements.ts 新增 captureAiRuleFromTransactions 截图场景（交易页 AI 生成规则弹窗）。 说明： - 新截图 elements/ai-rule-transactions.png 已上传 OSS，正文以 OSS 长期地址引用。
5.3 KiB
5.3 KiB
页面总览
本节汇总系统的全部页面、用途、入口方式与相互之间的跳转关系。
页面清单
| 页面 | 路由 | 用途 | 入口方式 |
|---|---|---|---|
| 登录 | /login |
用户名密码登录 | 未登录访问受保护页面时自动跳转 |
| 注册 | /register |
创建账号 | 登录页「没有账号？去注册」（注册开启时） |
| 数据库初始化 | /database-setup |
首次配置数据库 | 数据库未配置时自动引导 |
| 日历 | /calendar |
每日收支日历、月/年视图与当日明细 | 登录后默认页；左侧菜单（默认置顶） |
| 统计面板 | /dashboard |
收支汇总与图表 | 左侧菜单 |
| 智能查数 | /smart-query |
自然语言转只读 SQL 查询 | 左侧菜单（AI 启用时） |
| 收支记录 | /transactions |
记录管理与账单导入 | 左侧菜单 |
| 分类管理 | /categories |
收入/支出分类维护 | 左侧菜单 |
| 标签管理 | /tags |
标签维护 | 左侧菜单 |
| 交易渠道管理 | /channels |
自定义交易渠道维护 | 收支记录页「渠道管理」按钮 |
| 规则管理 | /rules |
自动归类规则 | 左侧菜单 |
| 邮箱账单 | /email-bills/* |
邮箱配置 / 发件人规则 / 待处理账单 | 左侧菜单 |
| 设置 | /settings |
账号安全 / 数据库 / 注册 / 账单来源统计 / 外观 / 导航 / AI / 通知配置 | 顶部用户菜单 |
| 模型使用情况 | /ai-usage |
AI 调用统计与明细 | 设置页「AI 模型配置」→ 使用情况 |
| 日志 | /logs/* |
访问 / 登录 / 运行日志 | 顶部用户菜单 |
| 账单导入（独立页） | /bill-import |
手机端上传账单 | 仅由通知邮件链接直达 |
「账单关系」不是独立页面，它是收支记录内的弹窗：由列表「关系」列或「批量操作 → 建立关系」进入，详见账单关系。
全局导航
左侧菜单
日历 → 统计面板 → 智能查数（AI 启用时）→ 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单
左侧菜单的顺序与显隐可自定义（设置 → 导航设置），并在下次进入时还原。
顶部用户菜单
- 日志：
/logs - 设置：
/settings - 退出：清空登录态并返回
/login
「模型使用情况」没有独立菜单入口，需从「设置 → AI 模型配置 → 使用情况」进入。
「交易渠道管理」同样没有独立菜单入口，需从「收支记录 → 渠道管理」进入。
典型跳转路径
- 首次使用：
/database-setup→/register→/login→/calendar - 日历看某天：日历 → 点击某天 → 当日明细浮窗（按当前统计口径）→ 点条目查看账单详情 / 点「在收支记录中查看」跳转收支记录（按当日筛选并沿用统计口径）
- 手动记账：收支记录 → 点击「新增记录」→ 表单弹窗 → 保存
- 查看趋势明细：统计面板 → 点击趋势柱、分类/渠道饼图或「查看收支记录」→ 收支记录（自动带入对应筛选条件）
- 反向跳转：收支记录 → 点击「查看统计」→ 统计面板（还原当前筛选条件）
- 账单导入：收支记录 → 点击「导入账单」→ 解析预览 → 确认导入 → 回到收支记录
- 手机导入：通知邮件链接 →
/bill-import（独立页，非弹窗）→ 上传解析 → 确认导入 - 渠道维护：收支记录 → 点击「渠道管理」→ 新建 / 改名 / 删除自定义渠道 → 返回收支记录
- 账单关系：收支记录「关系」列 → 关系弹窗；或「批量操作」勾选多条 → 建立关系
- 智能查数：左侧菜单「智能查数」→ 输入自然语言 → 查看结果、生成的 SQL 与历史提问
- 自动归类：规则管理配置规则 → 账单导入预览时命中并给出建议
- 邮箱账单：邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
- AI 辅助：设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、收支记录批量操作「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
- 系统维护：顶部菜单 → 设置 / 日志
页面关系说明
- 日历是登录后的默认落地页：按天查看每日收支、切换月/年视图与统计口径，并可点击某天下钻到当日明细与账单详情。
- 收支记录是核心页面：手动记账、账单导入、批量操作、账单关系与 AI 能力都从这里进入，导入完成后也回到该页查看。
- 账单导入有两条独立路径：
- 收支记录页的「导入账单」弹窗（桌面端常用）；
- 通知邮件直达的
/bill-import独立页（面向手机，非弹窗，元素精简，系统内无其他入口）。
- 设置聚合了账号安全、数据库、注册、账单来源统计、外观、导航、AI、通知八类配置；模型用量与日志分别从设置页与顶部菜单进入。
- 交易渠道管理是收支记录页的附属页；账单关系是收支记录内的弹窗，两者都在整理完成后回到收支记录继续操作。