fix: 将导出列表分成三个模块
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 4m40s

This commit is contained in:
luo
2026-07-09 15:20:28 +08:00
parent f27bbacb1e
commit c1a7118d35
19 changed files with 479 additions and 86 deletions

View File

@@ -0,0 +1,67 @@
## Context
导出任务能力已经具备统一 API、通用列表页面、详情页面和创建弹窗。现有列表页面通过 `scene` 搜索项区分设备、IOT 卡和订单任务,但新的产品方案要求用三个固定场景页面替代该筛选方式,并让三个页面按钮权限相互独立。
## Goals / Non-Goals
- Goals: 在导出管理下提供“导出设备”“导出IOT卡”“导出订单”三个页面。
- Goals: 三个页面固定传入各自 `scene`,去掉页面中的“导出场景”筛选。
- Goals: 三个页面及其按钮/操作使用场景级独立权限编码。
- Goals: 尽量复用现有导出任务列表和详情实现,避免复制三份完整页面逻辑。
- Non-Goals: 不新增导出任务后端 API。
- Non-Goals: 不改变创建导出任务的 `scene` 值和 `query` 快照语义。
- Non-Goals: 不调整导出任务状态流转、文件生成或下载地址生成逻辑。
## Decisions
- Decision: 使用一个可复用导出任务列表实现,通过路由配置或组件 props 注入固定场景、页面标题和权限映射。
- Rationale: 三个页面除固定 `scene` 和权限外,分页、状态筛选、时间筛选、下载、取消逻辑一致,复用可以减少重复代码和后续维护成本。
- Decision: 页面查询参数由页面固定注入 `scene`,不从搜索表单读取“导出场景”。
- Rationale: 页面已经按场景拆分,继续暴露场景筛选会造成入口语义冲突,也可能让用户在“导出设备”页面查到 IOT 卡或订单任务。
- Decision: 权限编码按场景和操作拆分,默认建议如下。
- Rationale: 用户明确要求三个界面的按钮权限编码不同;列表访问、详情、下载、取消均需要避免跨场景复用。
| 场景 | 页面访问 | 详情 | 下载 | 取消 |
| --- | --- | --- | --- | --- |
| 导出设备 | `export_task:device:list` | `export_task:device:detail` | `export_task:device:download` | `export_task:device:cancel` |
| 导出IOT卡 | `export_task:iot_card:list` | `export_task:iot_card:detail` | `export_task:iot_card:download` | `export_task:iot_card:cancel` |
| 导出订单 | `export_task:order:list` | `export_task:order:detail` | `export_task:order:download` | `export_task:order:cancel` |
- Decision: 业务列表创建导出任务按钮继续使用来源业务权限,默认建议如下。
- Rationale: 创建导出任务属于来源业务列表能力,不应因为拥有某个导出任务管理页面权限就获得业务列表导出入口。
| 入口 | 创建导出任务权限 | scene |
| --- | --- | --- |
| 设备管理 | `devices:export` | `device` |
| IOT 卡管理 | `iot_card:export` | `iot_card` |
| 订单列表 | `orders:export` | `order` |
- Decision: 详情页可继续复用同一组件,但必须根据任务场景或来源页面使用对应场景的详情、下载、取消权限。
- Rationale: 详情页面本身也包含下载和取消按钮,若继续使用通用权限会绕过三个列表页面的按钮隔离要求。
## Risks / Trade-offs
- Risk: 后端或权限配置已经发放了通用 `export_task:*` 权限,切换为场景级权限后用户可能暂时看不到页面或按钮。
- Mitigation: 实施时同步更新权限种子/菜单配置,并在上线前完成角色权限迁移或重新授权。
- Risk: 订单导出场景提案正在独立推进,可能继续给旧“导出列表”增加订单筛选。
- Mitigation: 实施本变更前先合并范围,保留 `scene=order` 和订单创建入口,移除旧列表中的订单场景筛选实现。
- Risk: 详情页直接通过 URL 打开时缺少来源页面上下文。
- Mitigation: 详情页读取任务详情后按返回的 `scene` 计算对应权限,缺少该场景详情权限时展示无权限提示并阻止后续按钮操作。
## Migration Plan
1. 增加三条导出任务列表路由和菜单项,删除或隐藏旧通用“导出列表”入口。
2. 将导出任务列表改造成固定场景列表,移除“导出场景”搜索项和冗余场景列。
3. 为三页分别注入固定 `scene`、标题和场景级权限映射。
4. 调整导出任务详情页和行操作的权限判断,改用任务场景对应权限。
5. 同步订单导出入口,确保订单导出任务进入“导出订单”页面查看。
6. 更新后端/菜单权限配置并完成角色授权迁移。
## Open Questions
- 最终权限编码是否采用本设计建议,还是需要对齐后端已有权限命名规范。
- 旧通用导出列表路由是否直接移除,还是短期隐藏并重定向到用户有权限的第一个场景页面。

View File

@@ -0,0 +1,39 @@
# Change: 拆分导出任务列表为固定场景页面
## Why
当前导出管理只有一个“导出列表”页面需要用户通过“导出场景”筛选设备、IOT 卡和订单导出任务。产品希望把该页面拆成三个固定场景页面,入口更直接,并且三个页面及页面按钮使用不同权限编码。
## What Changes
- 将导出管理下的单个“导出列表”替换为三个页面:
- 导出设备
- 导出IOT卡
- 导出订单
- 三个页面分别固定查询 `scene=device``scene=iot_card``scene=order`,页面内不再展示或提交用户可选的“导出场景”筛选项。
- 导出列表中的“场景”列可移除或默认不展示,因为页面本身已经代表固定场景。
- 三个页面的菜单访问、详情、下载、取消等按钮/操作均使用场景级独立权限编码,不再复用同一组通用导出任务按钮权限。
- 业务列表发起导出的按钮权限继续按来源业务隔离设备导出、IOT 卡导出、订单导出使用不同权限编码。
- 订单导出任务仍使用 `scene=order`,并与现有订单导出场景提案合并实施或调整其导出列表筛选相关内容。
## Impact
- Affected specs:
- `export-task-management`
- Affected code:
- `src/router/routesAlias.ts`
- `src/router/routes/asyncRoutes.ts`
- `src/views/asset-management/export-task-management/export-task-list/index.vue`
- `src/views/asset-management/export-task-management/export-task-detail/index.vue`
- `src/types/api/exportTask.ts`
- `src/components/business/ExportTaskCreateDialog.vue`
- `src/views/asset-management/device-list/index.vue`
- `src/views/asset-management/iot-card-management/index.vue`
- `src/views/order-management/order-list/index.vue`
- 菜单、权限和国际化文案配置
- Dependencies:
- 后端导出任务列表接口继续支持 `scene=device``scene=iot_card``scene=order` 过滤。
- 后端/权限配置需要提供三套场景级导出任务权限编码。
- 现有 `add-order-export-scene` 提案与本提案存在重叠:其“在导出列表场景筛选中新增订单”应被本提案的三个固定页面方案替代。
- Breaking changes:
- 原通用“导出列表”菜单入口和 `export_task:list/detail/download/cancel` 这组通用页面操作权限将被场景级页面/按钮权限取代。

View File

@@ -0,0 +1,111 @@
## ADDED Requirements
### Requirement: Scene-Specific Export Task Pages
The admin frontend SHALL replace the single generic export task list entry with three scene-specific export task pages: 导出设备, 导出IOT卡, and 导出订单.
#### Scenario: Render scene-specific export task navigation
- **GIVEN** 用户打开资产管理下的导出管理菜单
- **WHEN** 系统渲染导出任务导航
- **THEN** 系统 MUST provide separate entries for 导出设备, 导出IOT卡, and 导出订单
- **AND** 系统 MUST NOT expose the old generic 导出列表 menu entry as the primary navigation entry
#### Scenario: Query device export tasks
- **GIVEN** 用户打开导出设备页面
- **WHEN** 页面查询导出任务列表
- **THEN** 系统 MUST call `GET /api/admin/export-tasks` with `scene=device`
- **AND** 用户 MUST NOT be able to change this page to query `iot_card` or `order` tasks through a scene selector
#### Scenario: Query IOT card export tasks
- **GIVEN** 用户打开导出IOT卡页面
- **WHEN** 页面查询导出任务列表
- **THEN** 系统 MUST call `GET /api/admin/export-tasks` with `scene=iot_card`
- **AND** 用户 MUST NOT be able to change this page to query `device` or `order` tasks through a scene selector
#### Scenario: Query order export tasks
- **GIVEN** 用户打开导出订单页面
- **WHEN** 页面查询导出任务列表
- **THEN** 系统 MUST call `GET /api/admin/export-tasks` with `scene=order`
- **AND** 用户 MUST NOT be able to change this page to query `device` or `iot_card` tasks through a scene selector
### Requirement: Remove Export Scene Filtering From Scene Pages
Scene-specific export task pages SHALL remove user-facing export scene filtering because each page has exactly one fixed scene.
#### Scenario: Hide scene search field
- **GIVEN** 用户打开任一导出任务场景页面
- **WHEN** 页面渲染搜索表单
- **THEN** 页面 MUST NOT display a 导出场景 search item
- **AND** reset and search actions MUST keep the page's fixed `scene` unchanged
#### Scenario: Avoid redundant scene column
- **GIVEN** 用户打开任一导出任务场景页面
- **WHEN** 页面渲染任务表格
- **THEN** 页面 SHOULD remove or hide the 场景 column by default
- **AND** 页面 MUST continue to display task number, status, progress, format, row counts, shard progress, error message, and created time
### Requirement: Scene-Specific Export Task Permissions
The admin frontend MUST gate each export task page and page action with scene-specific permission codes so that device, IOT card, and order export task permissions are independent.
#### Scenario: Gate scene pages independently
- **GIVEN** 用户 only has `export_task:device:list`
- **WHEN** 系统渲染导出管理菜单
- **THEN** 系统 MUST show 导出设备
- **AND** 系统 MUST NOT show 导出IOT卡 or 导出订单 unless the user also has `export_task:iot_card:list` or `export_task:order:list`
#### Scenario: Gate device export task actions independently
- **GIVEN** 用户打开导出设备页面
- **WHEN** 页面渲染详情、下载 or 取消操作
- **THEN** 系统 MUST use `export_task:device:detail`, `export_task:device:download`, and `export_task:device:cancel` respectively
- **AND** 系统 MUST NOT treat IOT card or order export task action permissions as sufficient for device actions
#### Scenario: Gate IOT card export task actions independently
- **GIVEN** 用户打开导出IOT卡页面
- **WHEN** 页面渲染详情、下载 or 取消操作
- **THEN** 系统 MUST use `export_task:iot_card:detail`, `export_task:iot_card:download`, and `export_task:iot_card:cancel` respectively
- **AND** 系统 MUST NOT treat device or order export task action permissions as sufficient for IOT card actions
#### Scenario: Gate order export task actions independently
- **GIVEN** 用户打开导出订单页面
- **WHEN** 页面渲染详情、下载 or 取消操作
- **THEN** 系统 MUST use `export_task:order:detail`, `export_task:order:download`, and `export_task:order:cancel` respectively
- **AND** 系统 MUST NOT treat device or IOT card export task action permissions as sufficient for order actions
#### Scenario: Keep business export buttons independent
- **GIVEN** 用户分别访问设备管理、IOT 卡管理 and 订单列表
- **WHEN** 页面渲染创建导出任务按钮
- **THEN** 设备管理 MUST use `devices:export`
- **AND** IOT 卡管理 MUST use `iot_card:export`
- **AND** 订单列表 MUST use `orders:export`
- **AND** possessing one of these permissions MUST NOT reveal or enable the other two export buttons
### Requirement: Scene-Aware Export Task Detail Permissions
The export task detail page SHALL apply detail, download, and cancel permissions according to the task's scene.
#### Scenario: Enforce scene permissions on direct detail access
- **GIVEN** 用户直接打开某个导出任务详情 URL
- **WHEN** 系统加载任务详情 and reads the returned `scene`
- **THEN** 系统 MUST require the matching scene detail permission before showing the detail content
- **AND** 系统 MUST use the matching scene download and cancel permissions before showing detail-page buttons
#### Scenario: Prevent cross-scene action leakage
- **GIVEN** 用户 has only order export task download permission
- **AND** 用户打开 a completed device export task detail
- **WHEN** 页面渲染详情操作区
- **THEN** 页面 MUST NOT show the device task download button
- **AND** 页面 MUST NOT allow downloading that device task through the order download permission

View File

@@ -0,0 +1,46 @@
## 1. Proposal Review
- [x] 1.1 确认三个页面名称为“导出设备”“导出IOT卡”“导出订单”。
- [x] 1.2 确认固定场景值分别为 `device``iot_card``order`
- [x] 1.3 确认三套页面和按钮权限编码,或按后端权限命名规范替换设计中的默认建议。
- [x] 1.4 确认本提案与 `add-order-export-scene` 合并实施,订单场景不再通过旧导出场景筛选进入。
## 2. Routing And Menu
- [x] 2.1 新增三条导出任务列表路由别名和路由记录。
- [x] 2.2 在导出管理菜单下新增“导出设备”“导出IOT卡”“导出订单”。
- [x] 2.3 删除或隐藏旧“导出列表”菜单入口。
- [x] 2.4 为三条路由分别配置独立页面访问权限。
- [x] 2.5 更新菜单国际化文案和权限配置。
## 3. Export Task List Pages
- [x] 3.1 将现有导出任务列表改造成可复用固定场景列表,支持传入页面标题、固定 `scene` 和权限映射。
- [x] 3.2 移除搜索表单中的“导出场景”筛选项。
- [x] 3.3 列表查询始终携带当前页面固定 `scene`
- [x] 3.4 移除或默认隐藏列表中的“场景”列。
- [x] 3.5 保留任务状态、创建时间、分页、刷新等现有列表能力。
## 4. Scene-Specific Actions
- [x] 4.1 详情入口按当前页面场景检查对应 `detail` 权限。
- [x] 4.2 下载按钮按当前页面场景检查对应 `download` 权限。
- [x] 4.3 取消按钮按当前页面场景检查对应 `cancel` 权限。
- [x] 4.4 导出任务详情页根据任务 `scene` 使用对应详情、下载、取消权限。
- [x] 4.5 验证只有某一场景权限时,不会看到其他场景页面或按钮。
## 5. Business Export Entrypoints
- [x] 5.1 设备管理导出按钮继续使用 `devices:export` 并创建 `scene=device` 任务。
- [x] 5.2 IOT 卡管理导出按钮继续使用 `iot_card:export` 并创建 `scene=iot_card` 任务。
- [x] 5.3 订单列表导出按钮使用 `orders:export` 并创建 `scene=order` 任务。
- [x] 5.4 确认三个业务导出按钮权限编码互不复用。
## 6. Verification
- [x] 6.1 验证“导出设备”页面请求 `GET /api/admin/export-tasks` 时固定携带 `scene=device`
- [x] 6.2 验证“导出IOT卡”页面请求固定携带 `scene=iot_card`
- [x] 6.3 验证“导出订单”页面请求固定携带 `scene=order`
- [x] 6.4 验证三个页面均不展示“导出场景”筛选项。
- [x] 6.5 验证三页详情、下载、取消按钮按各自权限显示和拦截。
- [x] 6.6 运行类型检查、lint 和相关页面手动回归。