27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
|
# 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`。
|