docs: 告知车队管理列宽与暗色模式问题 (#5131) #28

已合并
wx 2026-07-24 19:09:06 +08:00 将 1 次代码提交从 docs/5131-fleet-team-layout-feedback 合并至 main

查看文件

@ -121,10 +121,30 @@ user-service 在“车务管理”目录下新增子菜单:
## 前端必须修改的范围 ## 前端必须修改的范围
### 2026-07-24 页面复测反馈:列表列宽与暗色模式
测试环境 `/fleet/teams` 页面已经能展示负责人和脱敏电话,但当前样式仍需前端修正,本反馈不涉及后端接口或字段变化:
1. 表格列宽分配失衡。“车队名称”列占用过多空白,把“负责人 / 负责人电话”等核心联系人信息推到页面右侧,首屏信息密度过低。
2. 暗色模式不能只替换页面背景。当前筛选区、表头、行分隔线、空值、状态标签和操作区的层级与对比度不足,部分边界难以辨认。
3. 样式必须复用项目主题 token;禁止在本页写死仅适用于浅色模式的背景色、文字色或边框色。负责人电话仍只展示接口返回的脱敏值,样式调整不得绕过脱敏。
#### 展示矩阵
| 视口 / 主题 | 车队名称 | 负责人 / 负责人电话 | 其他列 | 验收表现 |
| --- | --- | --- | --- | --- |
| `>= 1440px`,浅色 | 弹性列,限制最大占比;超长省略并可查看完整名称 | 建议分别保留约 `120px / 140px`,左对齐 | 类型、付款方式、数量、排序、状态和操作按内容定宽 | 联系人紧邻业务字段,首屏无大段无意义空白 |
| `>= 1440px`,暗色 | 同浅色列宽规则 | 同浅色列宽规则 | 使用暗色主题 token | 页面、筛选区、表头、数据行、状态标签和操作区层级清楚 |
| `1024px - 1439px`,浅色/暗色 | 优先收缩并省略,不能无限占宽 | 不压缩为空或挤出主要阅读区 | 保留操作列可用宽度 | 联系人信息仍可直接阅读 |
| `< 1024px`,浅色/暗色 | 设置表格最小宽度 | 保持可读宽度 | 允许横向滚动 | 不通过隐藏关键列或强行挤压完成适配 |
空负责人和空电话统一显示 `—`。联系人文本左对齐;车辆数、排序、状态和操作居中。浅色与暗色模式都必须覆盖默认、悬停、聚焦、禁用和空数据状态;普通文本与背景建议至少达到 `4.5:1` 对比度,控件边界和状态提示应清晰可辨。
### 管理后台 ### 管理后台
1. 新增 `src/api/fleet/teams.js``src/views/fleet/teams/index.vue`,完成车队分页、新增、编辑、启停和删除: 1. 新增 `src/api/fleet/teams.js``src/views/fleet/teams/index.vue`,完成车队分页、新增、编辑、启停和删除:
- “车队管理”必须显示在“车务管理”目录内,不得作为一级菜单处理。 - “车队管理”必须显示在“车务管理”目录内,不得作为一级菜单处理。
- 按上面的展示矩阵修正表格列宽和明暗主题样式,不能让“车队名称”列挤占联系人信息区域。
- 仅 `vehicleCount === 0` 时展示/启用删除动作;调用删除接口后刷新列表。 - 仅 `vehicleCount === 0` 时展示/启用删除动作;调用删除接口后刷新列表。
- 后端仍会独立校验车辆及未完结司机录入关联,返回 `601107` 时提示“请先完成车辆/司机转移”。 - 后端仍会独立校验车辆及未完结司机录入关联,返回 `601107` 时提示“请先完成车辆/司机转移”。
- 编辑历史迁入车队时补齐负责人、负责人电话、付款方式和排序。 - 编辑历史迁入车队时补齐负责人、负责人电话、付款方式和排序。
@ -189,6 +209,8 @@ DELETE FROM sys_dict_type WHERE dict_type = 'fleet_attribution';
## 验收清单 ## 验收清单
- [ ] 独立车队菜单可分页、新增、编辑、启停,付款方式与资源页选项一致。 - [ ] 独立车队菜单可分页、新增、编辑、启停,付款方式与资源页选项一致。
- [ ] `/fleet/teams` 在桌面端不再由“车队名称”列制造大段空白,负责人和脱敏电话位于首屏连续阅读区;窄屏按展示矩阵滚动而不是隐藏或挤压关键列。
- [ ] `/fleet/teams` 的浅色、暗色模式均使用主题 token,筛选区、表头、数据行、空值、状态标签和操作区在默认/悬停/聚焦/禁用状态下层级清晰。
- [ ] “车队管理”位于“车务管理”目录下;空车队可删除,非空车队删除入口禁用或明确提示后端 `601107` - [ ] “车队管理”位于“车务管理”目录下;空车队可删除,非空车队删除入口禁用或明确提示后端 `601107`
- [ ] 历史迁入车队可通过编辑补齐负责人、负责人电话、付款方式和排序,保存时不允许提交空资料。 - [ ] 历史迁入车队可通过编辑补齐负责人、负责人电话、付款方式和排序,保存时不允许提交空资料。
- [ ] 车辆新增/编辑/筛选/详情/导入均使用动态车队,不再出现固定三项。 - [ ] 车辆新增/编辑/筛选/详情/导入均使用动态车队,不再出现固定三项。