chore: 初始化文档站仓库

guide/pages.md

@@ -0,0 +1,55 @@
+# 页面总览
+
+本节汇总系统的全部页面、用途、入口方式与相互之间的跳转关系。
+
+## 页面清单
+
+| 页面 | 路由 | 用途 | 入口方式 |
+|---|---|---|---|
+| 登录 | `/login` | 用户名密码登录 | 未登录访问受保护页面时自动跳转 |
+| 注册 | `/register` | 创建账号 | 登录页「没有账号？去注册」（注册开启时） |
+| 数据库初始化 | `/database-setup` | 首次配置数据库 | 数据库未配置时自动引导 |
+| 统计面板 | `/dashboard` | 收支汇总与图表 | 登录后默认页；左侧菜单 |
+| 收支记录 | `/transactions` | 记录管理与**账单导入** | 左侧菜单 |
+| 分类管理 | `/categories` | 收入/支出分类维护 | 左侧菜单 |
+| 标签管理 | `/tags` | 标签维护 | 左侧菜单 |
+| 规则管理 | `/rules` | 自动归类规则 | 左侧菜单 |
+| 邮箱账单 | `/email-bills/*` | 邮箱配置 / 发件人规则 / 待处理账单 | 左侧菜单 |
+| 系统设置 | `/settings` | 数据库 / 注册 / 账单来源统计 / 外观 / AI / 通知配置 | 顶部用户菜单 |
+| 模型使用情况 | `/ai-usage` | AI 调用统计与明细 | 设置页「AI 模型配置」→ 使用情况 |
+| 系统日志 | `/logs/*` | 访问 / 登录 / 运行日志 | 顶部用户菜单 |
+| 账单导入（独立页） | `/bill-import` | 手机端上传账单 | **仅由通知邮件链接直达** |
+
+## 全局导航
+
+### 左侧菜单
+
+统计面板 → 收支记录 → 分类管理 → 标签管理 → 规则管理 → 邮箱账单
+
+### 顶部用户菜单
+
+- **系统日志**：`/logs`
+- **系统设置**：`/settings`
+- **退出**：清空登录态并返回 `/login`
+
+> 「模型使用情况」没有独立菜单入口，需从「系统设置 → AI 模型配置 → 使用情况」进入。
+
+## 典型跳转路径
+
+- **首次使用**：`/database-setup` → `/register` → `/login` → `/dashboard`
+- **手动记账**：收支记录 → 点击「新增记录」→ 表单弹窗 → 保存
+- **查看趋势明细**：统计面板 → 点击「收支趋势」某一列（柱子或该列空白处）→ 收支记录（自动带入时间范围、类型与当前筛选条件）
+- **账单导入**：收支记录 → 点击「导入账单」→ 解析预览 → 确认导入 → 回到收支记录
+- **手机导入**：通知邮件链接 → `/bill-import`（独立页，非弹窗）→ 上传解析 → 确认导入
+- **自动归类**：规则管理配置规则 → 账单导入预览时命中并给出建议
+- **邮箱账单**：邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
+- **AI 辅助**：系统设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 智能记账 / AI 查询」、分类与标签「AI 推荐」、规则管理「AI 生成规则」
+- **系统维护**：顶部菜单 → 系统设置 / 系统日志
+
+## 页面关系说明
+
+- **收支记录**是核心页面：手动记账、账单导入、批量设置、AI 能力都从这里进入，导入完成后也回到该页查看。
+- **账单导入**有两条独立路径：
+  - 收支记录页的「导入账单」**弹窗**（桌面端常用）；
+  - 通知邮件直达的 **`/bill-import` 独立页**（面向手机，非弹窗，元素精简，系统内无其他入口）。
+- **系统设置**聚合了数据库、注册、账单来源统计、外观、AI、通知六类配置；模型用量与日志分别从设置页与顶部菜单进入。