# Client 工作台模块指引

## 路径基准与读取顺序

- 本文件适用于 `src/modules/dashboard/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`。
- 只有 `views/DashboardView.vue` 与 `overview.ts`；路由为空路径（登录后默认页）。
- 后端按卡片来源分别查 `order/`、`firstleg/`、`lastleg-service/`；本模块只做聚合展示。

## 页面与入口

| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 业务总览卡片与快捷入口 | `views/DashboardView.vue` | `overview.ts`；按卡片对应的服务 |
| 卡片数据映射与跳转 | `overview.ts` | 各业务模块的公开 API |

## 关键边界

- 只展示服务端或既有模块返回的数据，不在首页二次统计或补算。
- 快捷入口跳转带明确业务筛选，不用标题文字反推状态。
- 首页不新增跨客户对比或内部经营指标；客户只能看到本企业数据。
- 卡片加载失败要单卡片降级，不阻塞整页。

## 验证

- 定向：`pnpm test src/modules/dashboard/<目标测试>`。
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。