docs(specs): 新增现场勘察业务相关 spec 文档
- rework-survey-equipment-tree:勘察设备树明细模式重构 - fix-equipment-topology-display:设备拓扑图完整显示修复 - survey-detail-building-select:勘察明细所属建筑下拉 - generate-floor-options-from-building:按建筑楼层生成楼层下拉 - survey-progress-track-detail:进度跟踪跳转勘察明细页 - survey-complete-to-tech-review:勘察完成提交技术复核与复核按钮改名
This commit is contained in:
1 parent
dff366a823
commit
7c915f8946
18 files changed
+553
No files matched your search
@@ -0,0 +1,8 @@
|
||||
# Checklist
|
||||
|
||||
- [x] 勘察明细页中间栏拓扑图 tree 系列已启用 `roam: true`,边距已压缩
|
||||
- [x] 台账详情弹窗拓扑图 tree 系列已启用 `roam: true`,边距已压缩,`.detail-topo-wrap` 高度已增大且空态高度同步
|
||||
- [x] 两处均保持 `initialTreeDepth: -1`(全展开)+ 原 label/symbol 配置不变
|
||||
- [x] `client` 编译通过(`npm run check`)
|
||||
- [x] 浏览器实测:工单 KC20261011001 下,两处拓扑图均可拖拽平移、滚轮缩放查看全部节点,无截断
|
||||
- [x] 无设备时台账详情拓扑区块空态显示正常(逻辑未改,高度同步)
|
||||
@@ -0,0 +1,33 @@
|
||||
# 设备拓扑图完整显示 Spec
|
||||
|
||||
## Why
|
||||
设备拓扑图(勘察明细页中间栏、台账详情弹窗「勘察明细拓扑图」)当前固定容器尺寸且未启用拖拽缩放,设备节点多时树形图超出容器,底部/右侧节点被截断,无法查看完整拓扑。
|
||||
|
||||
## What Changes
|
||||
- 台账详情弹窗「勘察明细拓扑图」(`views/dispatch/survey/index.vue`):ECharts tree 系列启用 `roam: true`(拖拽平移 + 滚轮缩放),全部节点可缩放查看;适当放大容器高度并压缩边距,减少初始截断
|
||||
- 勘察明细页中间栏设备拓扑图(`views/dispatch/survey/detail.vue`):ECharts tree 系列启用 `roam: true`;微调边距/容器高度,配合已有 ResizeObserver 自适应
|
||||
- 两处均保持 `initialTreeDepth: -1`(默认全展开),配合缩放查看全部层级
|
||||
|
||||
## Impact
|
||||
- Affected specs: 勘察派单重构(rework-survey-equipment-tree)交付的拓扑图展示能力
|
||||
- Affected code:
|
||||
- `client/src/views/dispatch/survey/detail.vue`(treeOption 系列配置 + 中间栏容器 CSS)
|
||||
- `client/src/views/dispatch/survey/index.vue`(renderDetailTopo 系列配置 + detail-topo-wrap CSS)
|
||||
|
||||
## ADDED Requirements
|
||||
### Requirement: 拓扑图可缩放查看全部节点
|
||||
两处设备拓扑图 SHALL 支持拖拽平移与缩放(`roam`),使设备树所有节点在超出容器时仍可完整查看。
|
||||
|
||||
#### Scenario: 设备节点多(3 级以上/大量同层节点)
|
||||
- **WHEN** 用户在勘察明细页或台账详情弹窗查看拓扑图,节点超出容器被截断
|
||||
- **THEN** 用户可通过拖拽平移、滚轮/按钮缩放查看全部节点,无节点被永久裁切
|
||||
|
||||
## MODIFIED Requirements
|
||||
### Requirement: 拓扑图容器与边距
|
||||
- 台账详情弹窗拓扑容器高度由 340px 适当增大;tree 系列 `top/left/bottom/right` 边距压缩,扩大有效绘制区
|
||||
- 勘察明细页中间栏拓扑图保持页面自适应,边距压缩以容纳更多节点
|
||||
|
||||
## REMOVED Requirements
|
||||
### Requirement: 无 —— 仅增强现有拓扑图交互与展示
|
||||
**Reason**: 无移除
|
||||
**Migration**: 无
|
||||
@@ -0,0 +1,21 @@
|
||||
# Tasks
|
||||
|
||||
## 前端拓扑图修复
|
||||
- [x] Task 1: 勘察明细页中间栏拓扑图支持缩放(`client/src/views/dispatch/survey/detail.vue`)
|
||||
- [x] 1.1 `treeOption` 中 tree 系列增加 `roam: true`(支持拖拽平移 + 滚轮缩放)
|
||||
- [x] 1.2 压缩系列边距:`right: '16%'` 缩至约 `'10%'`(`top/left/bottom` 视情况微调),扩大有效绘制区
|
||||
- [x] 1.3 保持 `initialTreeDepth: -1`(默认全展开)与现有 ResizeObserver 自适应逻辑不变
|
||||
- [x] Task 2: 台账详情弹窗拓扑图支持缩放(`client/src/views/dispatch/survey/index.vue`)
|
||||
- [x] 2.1 `renderDetailTopo` 中 tree 系列增加 `roam: true`
|
||||
- [x] 2.2 压缩系列边距:`right: '18%'` 缩至约 `'10%'`,`top/left/bottom` 视情况微调
|
||||
- [x] 2.3 `.detail-topo-wrap` 容器高度由 `340px` 增大至约 `440px`(弹窗内可容纳),空态 `.detail-topo-empty` 高度同步调整
|
||||
|
||||
## 验证
|
||||
- [x] Task 3: 编译 + 浏览器实测
|
||||
- [x] 3.1 `client` 编译通过(`npm run check`,vue-tsc)
|
||||
- [x] 3.2 浏览器实测:勘察明细页中间栏拓扑图可拖拽平移、滚轮缩放查看全部节点,无截断
|
||||
- [x] 3.3 浏览器实测:台账详情弹窗「勘察明细拓扑图」可拖拽缩放查看全部节点,无截断;空态逻辑未受影响
|
||||
|
||||
# Task Dependencies
|
||||
- Task 2 与 Task 1 相互独立,可并行修改
|
||||
- Task 3 依赖 Task 1、2
|
||||
Reference in new issue
Block a user