This commit is contained in:
zlwu committed 2026-08-02 17:18:33 +08:00
1 parent c00f19f8bd
commit 272c68af4b
134 files changed
+930389 -38617

No files matched your search

@@ -0,0 +1,43 @@
# 计划列表产品信息拆列 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** 将运输计划 / 计划归档 / 计划证件列表的「产品信息」合并列拆成产品名称、型号/规格、数量、单位四列。
**Architecture:** 扩展 `PlPlanListProductCell` 支持 `field` 按字段渲染;三页列表替换列定义与模板;列设置 key 从 `products` 改为四个独立 prop。
**Tech Stack:** Vue 3 + Element Plus(web-admin)
**Spec:** `docs/superpowers/specs/2026-08-02-pl-plan-list-product-columns-design.md`
---
### Task 1: 扩展 PlPlanListProductCell
**Files:**
- Modify: `web-admin/src/components/business/pl-plan-list-product-cell/index.vue`
- [x] **Step 1:** 增加 `field?: 'name' | 'spec' | 'qty' | 'unit'`;未传时保持现有整行拼接。
- [x] **Step 2:** `field` 有值时按字段渲染多行堆叠;`name` 带危化 Tag;`qty`/`unit` 用 `getPlanProductQuantity` / 字典标签;空产品显示 `—`。
- [x] **Step 3:** 从 `pl-display` 引入 `getPlanProductSpec`、`getPlanProductQuantity`(有 `field` 时不再依赖整行 `formatPlanProductListText`)。
### Task 2: 运输计划列表
**Files:**
- Modify: `web-admin/src/views/pl/plan/index.vue`
- [x] **Step 1:** `listColumnDefs` 将 `products` 换成 `productName` / `productSpec` / `productQty` / `productUnit`。
- [x] **Step 2:** 模板中「产品信息」列替换为四列,分别传 `field="name|spec|qty|unit"`;数量右对齐、单位居中;min-width 140/120/90/80。
### Task 3: 计划归档 + 计划证件列表
**Files:**
- Modify: `web-admin/src/views/pl/plan-archive/index.vue`
- Modify: `web-admin/src/views/pl/plan-cert/index.vue`
- [x] **Step 1:** 两页同样替换 `listColumnDefs` 与表格列(证件页在原「产品信息」位置拆四列,不重排其它列)。
### Task 4: 验证与图谱
- [x] **Step 1:** 目视/类型检查三页无模板错误;确认 `PlPlanListProductCell` 无其它调用方需同步(三页 + 组件声明)。
- [x] **Step 2:** 运行 `./scripts/update-graph.sh frontend`(或 `graphify update` 于 web-admin)。
@@ -0,0 +1,104 @@
# 运输计划列表「产品信息」拆列设计
**日期**:2026-08-02
**状态**:已实现
**范围**:web-admin 计划列表三页(运输计划 / 计划归档 / 计划证件)
## 背景
当前三页列表将多字段拼成一列「产品信息」,单元格内用 `PlPlanListProductCell` + `formatPlanProductListText` 渲染为:
`产品名称(型号/规格),数量单位` + 危化 Tag(毒 / 爆)
用户需要按字段拆成独立表格列,便于扫读与列显隐控制。
## 目标
将「产品信息」拆为四个独立 `el-table-column`:
| 列标题 | 字段来源 | 展示规则 |
|--------|----------|----------|
| 产品名称 | `productName` | 名称 + 危化 Tag(毒 / 爆,与现列表一致) |
| 型号/规格 | `model \|\| packageSpec` | 空则 `—`(同 `getPlanProductSpec`) |
| 数量 | 数量取值 | 同 `getPlanProductQuantity`:实际数量存在且非 0 用实际,否则计划/预估数量;空则 `—` |
| 单位 | `unit` | 字典 `crm_product_unit` 标签;空则 `—` |
多产品计划:四列各自按 `products` 数组顺序纵向堆叠多行,**同一索引行对齐**(行间距与现产品单元格一致)。
## 非目标
- 不改查看弹窗、表单产品表、安排运输等场景的产品展示
- 不改后端 API / `PlanProduct` 数据结构
- 不改 `formatPlanProductListText` 在文案拼接场景(确认框、打印摘要等)的用法
- 不引入排序、筛选产品字段
## 方案(已确认:方案 A)
四个真正的表格列;列设置中各自独立开关。
### 涉及页面
1. `web-admin/src/views/pl/plan/index.vue` — 运输计划
2. `web-admin/src/views/pl/plan-archive/index.vue` — 计划归档
3. `web-admin/src/views/pl/plan-cert/index.vue` — 计划证件
三页当前均为:
```vue
<el-table-column ... label="产品信息">
<PlPlanListProductCell :products="row.products" />
</el-table-column>
```
替换为四列(顺序接在「客户名称」后;证件页按该页原「产品信息」位置替换,不重排无关列)。
### 列设置(`usePersistedListColumns`)
原单项:
```ts
{ prop: 'products', label: '产品信息' }
```
改为:
```ts
{ prop: 'productName', label: '产品名称' },
{ prop: 'productSpec', label: '型号/规格' },
{ prop: 'productQty', label: '数量' },
{ prop: 'productUnit', label: '单位' }
```
- 默认全部可见
- 持久化 key 仍用各页现有 storage key(如 `pl-plan-list-columns`);旧配置中的 `products` 失效后自然不再匹配,四列走默认可见,无需迁移脚本
### 组件复用
扩展或拆分 `PlPlanListProductCell`,避免三页复制模板:
- 推荐:组件增加 `field` prop:`'name' | 'spec' | 'qty' | 'unit'`
- 各列:`<PlPlanListProductCell :products="row.products" field="name" />` 等
- `field` 未传时:保留现有整行拼接行为(供其他潜在引用;本三页改为传 `field`)
- 数量 / 单位对齐:数量列 `align="right"`,单位列 `align="center"`;名称 / 规格左对齐
- 名称列保留危化 Tag;其余列不展示 Tag
- 无产品时四列均显示 `—`
列宽建议(`min-width`):名称 140、规格 120、数量 90、单位 80。
### 样式
多行堆叠沿用现有 `.pl-plan-list-product-cell` 纵向 gap;四列共用同一行高节奏,避免某一列多出额外间距导致错位。
## 验收
1. 三页列表不再出现「产品信息」合并列,改为上述四列
2. 单产品、多产品计划行内容正确,多产品时四列行序一致
3. 危化产品名称旁仍显示毒 / 爆 Tag
4. 列设置可分别显隐四列;重置后四列均显示
5. 数量取值与拆列前一致(实际优先逻辑不变)
6. 「计划附件」列行为不变(仍用 `PlPlanListCertCell` + `hide-product`)
## 实现备注
- 字典标签:继续 `useDictStore().getLabel('crm_product_unit', unit)` 或页内已有 `DictTag` 模式,与列表其它单位展示一致即可
- 改完后按仓库约定更新 graphify(`./scripts/update-graph.sh frontend` 或等价)
+17 -8
View File
@@ -400,10 +400,19 @@
- **`max-height: min(520px, calc(100vh - 300px))`**(可按页面微调)
- `-webkit-overflow-scrolling: touch`
### 7.7 状态标签 `.tag`
### 7.7 状态标签(`el-tag` / `.tag`)
- **默认**:`display: inline-block`,`padding: 2px 8px`,圆角 **6px**,`12px`,`600`,背景 `var(--primary-bg)`,字 `var(--primary-dark)`
- **`.muted`**:背景 `var(--table-head)`,字 `var(--text-muted)`,字重 **500**
业务状态、结论、类型等 **SHALL** 使用 Element Plus `el-tag`,全局样式为 **深色底 + 白字**(实现见 `web-admin/src/assets/styles/core/el-ui.scss`):
| Tag type | 背景 | 文字 |
|----------|------|------|
| `success` / `primary` / 默认 | `#059669` | `#fff` |
| `warning` | `#d97706` | `#fff` |
| `danger` | `#dc2626` | `#fff` |
| `info` | 透明(无背景) | `var(--mint-text)` `#1e293b` |
- 圆角 **6px**,`padding: 2px 8px`,字号 **12px**,字重 **600**,无边框
- HTML demo 自绘 **`.tag`**:默认可对齐上表 success;**`.muted`** 仍可用浅底 `var(--table-head)` + `var(--text-muted)`(非业务枚举 Tag)
### 7.8 分页(HTML demo:`.list-pager`)
@@ -600,12 +609,12 @@
## 12. 业务状态色(与订单/配送枚举)
主品牌仍为绿;列表/标签建议:
主品牌仍为绿;列表 `el-tag` 建议(**深色底 + 白字**,见 **§7.7**):
- **进行中 / 主状态**:浅绿底 + 深绿字(同 `.tag`)
- **成功 / 完结**:略深绿(可与 `--primary-dark` 协调)
- **警告 / 待支付**:琥珀 `#d97706` 系
- **危险 / 异常**:红系用于强提醒;取消/信息可用 **`.tag.muted`** 或 slate
- **进行中 / 主状态 / 成功 / 完结**:深绿底 `#059669` + 白字(`success` / `primary`)
- **警告 / 待支付**:琥珀底 `#d97706` + 白字(`warning`)
- **危险 / 异常**:红底 `#dc2626` + 白字(`danger`)
- **中性 / 停用 / 待生效**:无背景 + 标准正文色 `#1e293b`(`info`)
(与 `.cursorrules` 中订单/配送状态表配合时,**颜色类**映射到上列语义即可。)