76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
|
# 工作台费用进度详情返回与类型列概念文档
|
||
|
|
|
||
|
|
## 功能一句话
|
||
|
|
|
||
|
|
让用户从首页费用进度进入单据详情后能返回首页，并在费用进度列表中直接看到每笔单据的费用类型。
|
||
|
|
|
||
|
|
## 背景与问题
|
||
|
|
|
||
|
|
当前首页费用进度点击单据后进入详情页，但详情页返回按钮默认回到单据中心，破坏了用户从首页查看进度的上下文。同时费用进度行只展示单号、标题、流程、状态和金额，用户需要点进详情才知道单据属于差旅、招待、办公等哪类费用。
|
||
|
|
|
||
|
|
## 目标与非目标
|
||
|
|
|
||
|
|
目标：
|
||
|
|
|
||
|
|
- 从首页费用进度进入详情时，详情页返回按钮回到个人工作台。
|
||
|
|
- 从单据中心进入详情时，原有返回单据中心逻辑不变。
|
||
|
|
- 在首页费用进度行新增“费用类型”列。
|
||
|
|
- 费用类型优先使用单据已有类型字段，缺失时按标题、场景和备注轻量归类。
|
||
|
|
|
||
|
|
非目标：
|
||
|
|
|
||
|
|
- 不修改详情页主体内容。
|
||
|
|
- 不新增后端接口。
|
||
|
|
- 不改变单据中心列表、审批详情和其他来源的返回逻辑。
|
||
|
|
|
||
|
|
## 用户与场景
|
||
|
|
|
||
|
|
个人员工在首页查看最近费用进度，点击某笔单据进入详情核对处理情况。查看完后点击返回，应回到刚才的首页工作台继续看其他进度项，而不是跳到单据中心列表。
|
||
|
|
|
||
|
|
## 功能能力
|
||
|
|
|
||
|
|
- 首页打开详情时带入 `returnTo=workbench` 来源标记。
|
||
|
|
- 详情页根据来源标记动态显示返回按钮文案并执行返回首页。
|
||
|
|
- 费用进度数据新增 `expenseTypeLabel`。
|
||
|
|
- 费用类型列在桌面端作为独立列展示，窄屏下按移动端布局折行展示。
|
||
|
|
|
||
|
|
## 方案设计
|
||
|
|
|
||
|
|
前端实现：
|
||
|
|
|
||
|
|
- `PersonalWorkbench.vue` 在 `open-document` 事件 payload 中补 `source: 'workbench'` 和 `returnTo: 'workbench'`。
|
||
|
|
- `AppShellRouteView.vue` 接收工作台来源并传给 `openRequestDetail`。
|
||
|
|
- `useAppShell.js` 在打开详情时写入查询参数，在关闭详情时根据查询参数返回工作台或单据中心。
|
||
|
|
- `workbenchSummary.js` 在 `progressItems` 中补费用类型字段。
|
||
|
|
- `personal-workbench.css` 与响应式样式新增费用类型列。
|
||
|
|
|
||
|
|
## 算法与公式
|
||
|
|
|
||
|
|
当前功能不涉及复杂数学公式。
|
||
|
|
|
||
|
|
费用类型归类优先级：
|
||
|
|
|
||
|
|
1. 单据显式字段：`expenseCategory`、`expense_type`、`category` 等。
|
||
|
|
2. 文本规则：从场景、标题、备注和描述中匹配差旅、招待、办公、培训、市场等关键词。
|
||
|
|
3. 兜底为“其他费用”。
|
||
|
|
|
||
|
|
## 测试方案
|
||
|
|
|
||
|
|
- 源码测试确认首页费用进度打开详情时带 `returnTo=workbench`。
|
||
|
|
- 源码测试确认详情返回文案和关闭逻辑支持工作台来源。
|
||
|
|
- 单元测试确认 `progressItems` 输出费用类型字段。
|
||
|
|
- 源码测试确认费用进度模板和样式包含费用类型列。
|
||
|
|
- 运行前端定向测试与构建。
|
||
|
|
|
||
|
|
## 指标与验收
|
||
|
|
|
||
|
|
- 从首页费用进度进入详情后，返回按钮回到个人工作台。
|
||
|
|
- 从单据中心进入详情后，返回按钮仍回到单据中心。
|
||
|
|
- 首页费用进度行可直接看到费用类型。
|
||
|
|
- 相关定向测试与前端构建通过。
|
||
|
|
|
||
|
|
## 风险与开放问题
|
||
|
|
|
||
|
|
- 当前费用类型归类仍是前端轻量归类。后续若后端已有稳定 ontology 类型字段，应优先接入 canonical 字段。
|
||
|
|
- 路由查询参数只用于详情返回来源，不应影响单据筛选和详情数据加载。
|