docs: align vision with reusable desktop template

This commit is contained in:
QiuSW
2026-07-08 15:45:01 +08:00
parent d2eeb049d0
commit 47d3c653c6
15 changed files with 493 additions and 112 deletions
+27 -13
View File
@@ -4,26 +4,40 @@
当前使用 hash history,适配 Wails 桌面窗口。
## 路由表
## 当前路由
| 路由 | 组件 | 窗口 | 职责 |
| --- | --- | --- | --- |
| `#/` | `frontend/src/components/Main/Index.vue` | 主窗口 | 设置中心、导航、主题、语言、快捷键、标签、关于等 |
| `#/second` | `frontend/src/pages/Home/Index.vue` | 第二窗口 | OCR 示例和轻量快捷功能 |
| `#/` | `frontend/src/components/Main/Index.vue` | 主窗口 | 当前设置中心、导航、主题、语言、快捷键、标签、关于等 |
| `#/second` | `frontend/src/pages/Home/Index.vue` | 第二窗口 | 当前 OCR 示例和轻量快捷功能 |
## 主窗口区域
## 目标路由
主窗口当前由 `Main/Index.vue` 组织以下区域:
| 路由 | 页面 | 职责 |
| --- | --- | --- |
| `#/login` | 登录页 | 本地固定账号登录或真实后端登录 |
| `#/dashboard` | 工作台 | 展示 P0 统计指标和最近任务 |
| `#/business/image-optimizer` | 商品图片 AI 优化 | 创建优化任务、查看任务列表、状态、结果和失败原因 |
| `#/logs/audit` | 审计日志 | 查询用户操作记录 |
| `#/logs/app` | 运行日志 | 查询系统错误和排错信息 |
| `#/statistics` | 数据统计 | 查看趋势、成功率、耗时和失败任务 |
| `#/settings` | 设置中心 | 主题、语言、窗口、快捷键、数据目录、日志策略 |
| `#/components` | 组件示例 | 输入框、多选框、下拉框、多行文本、表格、筛选、分页 |
| `#/about` | 关于 | 应用版本、运行环境和文档入口 |
- Dashboard:概览。
- General:通用设置。
- Shortcut:快捷键设置。
- Tags:标签相关展示。
- About:关于信息。
## 主窗口布局
目标主窗口使用三段式布局:
- 侧边导航:模块入口。
- 顶部区域:当前用户、运行状态、快捷动作。
- 内容区:路由页面,填满剩余空间。
Windows 10+ 是主要体验目标。主窗口是否默认最大化需要通过任务确认,但内容区必须能稳定填满空余区域,不能只占左上角小块。
## 页面规则
- 新增页面必须先确认是否属于主窗口长期功能,还是第二窗口轻量功能。
- 主窗口应优先使用可维护的设置布局,不做营销式首页。
- 第二窗口保持小而聚焦,不承载复杂流程。
- 新增页面必须先确认属于模板能力、业务样例还是开发者示例。
- 主业务页面放在主窗口,不放在第二窗口。
- 第二窗口保持轻量快捷功能,不承载长期复杂业务流程。
- 路由变化必须同步本文和相关任务验收。