# 变更提案: admin-frontend-dashboard-shortcuts

## 元信息
```yaml
类型: 体验增强
方案类型: implementation
优先级: P2
状态: 已完成
创建: 2026-04-25
```

---

## 1. 需求

### 背景
用户希望 `admin-frontend` 仪表盘中的“待处理工单”可以一键进入工单页，不再从左侧菜单二次跳转；同时希望把其他已有明确去向的高频数据卡也补成更顺手的快捷入口。

### 目标
- 让仪表盘顶部指标卡中“待处理工单”支持点击直达工单工作台。
- 为其他已有明确工作台承接的指标补充快捷入口，减少运营后台的重复导航。
- 保持现有 Apple 风格后台语气，只做低噪音、可发现、可键盘操作的交互增强。

### 约束条件
```yaml
范围约束: 仅改动 admin-frontend，保持现有页面结构和路由体系
技术约束: 不新增后端接口，仅复用现有前端路由、查询参数与工作台筛选能力
交互约束: 快捷入口必须保留 hover/focus 可见反馈，避免把普通统计卡误做成无提示的隐形按钮
验证约束: 以 admin-frontend 构建通过为本轮硬验证
```

### 验收标准
- [ ] 仪表盘“待处理工单”卡点击后可直接进入 `#/tickets`
- [ ] 仪表盘“待处理佣金”卡点击后可直接进入订单工作台，并默认落在真实待确认佣金视图
- [ ] 仪表盘“总用户”卡可直接进入用户工作台
- [ ] 可点击指标卡具有明确的快捷入口提示和可见 focus / hover 反馈
- [ ] 工单页与订单页能识别“从仪表盘进入”的上下文，并给出低干扰提示
- [ ] `admin-frontend` 执行构建验证通过
- [ ] `.helloagents` 方案包、模块文档与 CHANGELOG 已同步

---

## 2. 方案

### 核心思路
把仪表盘顶部指标卡从“纯展示”升级为“展示 + 跳转入口”的复合卡片，但只开放那些已有明确落点的卡片，避免为了可点击而过度链接。

### 实施策略
1. 在 `DashboardView.vue` 中为具备落点的指标卡增加 action 元数据。
2. 指标卡渲染层改成“普通卡 / 可点击卡”双态结构：可点击卡使用按钮语义、快捷提示文案与焦点反馈。
3. `TicketsView.vue` 读取 dashboard 来源查询参数，在顶部给出“已从仪表盘进入”的提示。
4. `OrdersView.vue` 扩展路由查询同步逻辑，让 dashboard 快捷入口可以直接落在“真实待确认佣金”工作台。
5. 保持本轮范围在前端增量增强，不重构现有页面信息架构。

### 影响范围
- `admin-frontend/src/views/dashboard/DashboardView.vue`
- `admin-frontend/src/views/tickets/TicketsView.vue`
- `admin-frontend/src/views/subscriptions/OrdersView.vue`

### 风险评估
- 风险较低，主要在于新增的路由查询同步不能误伤原有筛选流程。
- 用户工作台快捷入口若没有清晰提示，可能造成“统计卡误触”；因此必须补齐视觉提示和键盘焦点态。

---

## 3. 成果设计

### 目的与受众
面向运营后台管理员，在高频巡检和处理待办时减少侧边栏往返切换。

### 美学方向
延续当前 Apple 化后台：白色/浅灰指标卡为主，使用单一蓝色强调“可操作性”，避免把指标区做成高噪音按钮墙。

### 记忆点
“能点的指标卡，一眼就知道下一步会把你带去哪里。”

### 视觉要素
- 配色: 保持现有黑白主场，仅对快捷入口提示与 focus 态使用 `#0071e3`
- 布局: 不新增额外操作栏，只在卡片底部补轻量快捷提示
- 动效: hover / active 做轻微抬升与边框响应，focus-visible 保持明确外圈
- 氛围: 维持低噪音运营面板，不引入多余图标装饰和营销式 CTA

---

## 4. 技术决策

### admin-frontend-dashboard-shortcuts#D001: 只把已有明确承接页的指标卡做成快捷入口
**日期**: 2026-04-25
**状态**: ✅采纳
**背景**: 用户明确要求“方便的更改也都加上”，但本轮仍需保持范围克制。
**决策**: 仅开放“待处理工单 / 待处理佣金 / 总用户”三类已有明确工作台承接的指标卡。
**理由**: 这些卡片都有明确落点，不需要新增后端能力，也不会让首页跳转语义变得含混。

### admin-frontend-dashboard-shortcuts#D002: 使用路由查询参数同步仪表盘入口上下文
**日期**: 2026-04-25
**状态**: ✅采纳
**背景**: 快捷入口需要让落地页进入目标视图，而不是只做普通跳转。
**决策**: 通过 `source` / `focus` / `workbench` 查询参数驱动工单页和订单页的初始提示与筛选状态。
**理由**: 复用现有路由体系即可完成上下文传递，改动集中、风险可控，也方便后续继续扩展其他快捷入口。
