# 工作进度-12：生产-前缫「看台排班」+ 机组车台/看台排班数据导入

> 时间：2026-10-22（承接工作进度-11）
> 需求：仿照 `D:\AntaiProject - 副本` 生产-前缫的「机组车台 / 看台排班」，在本系统落地看台排班功能，并导入随附的 4 张表数据：
> `biz_prod_qs_jzct`（机组车台）、`biz_prod_qs_ktpb_ctg`（车头工）、`biz_prod_qs_ktpb_dcg`（挡车工）、`biz_prod_qs_ktpb_zbz`（值班长）。
> 参考实现：`WinClient\F9.Business.Prod\QS\KTPB\`（Page_KTPB、Page_KTPBCTG_Edit、Page_KTPBDCG_Edit、Page_KTPBZBZ_Edit）、`Application\CQRS\Business\PROD\QS\KTPB\`、`Domain\Entities\Business\PROD\QS\KTPB\`。

---

## 一、功能设计

```
生产-前缫
├── 落丝记录
├── 车间班次
└── 看台排班（新增）  /prod/qianxian/ktpb
      顶部：车间（职责类型=前缫）+ 班次（甲/乙）+ 机组 + 关键字
      页签：挡车工 / 车头工 / 值班长
      ├── 挡车工：按「车间+班次+机组」整组维护
      │     弹窗内可批量添加挡车工（多选职工），逐行填起止车台，
      │     挡车数自动计算（接壤车台各计 0.5），实时显示「已分配 x / y 台」
      ├── 车头工：一个「车间+班次+机组」一条记录，含车头工1 / 车头工2
      └── 值班长：一个「车间+班次」可有多名值班长
```

与 F9 的对应关系：
| F9 | 本系统 |
|---|---|
| `Page_KTPB`（三个页签 + 车间/班次/机组过滤） | `views/prod/ktpb/index.vue` |
| `Page_KTPBDCG_Edit`（整组批量编辑 + 挡车数计算） | 挡车工弹窗 + `POST /dcg/batch` |
| `Page_KTPBCTG_Edit` / `Page_KTPBZBZ_Edit` | 车头工 / 值班长弹窗 |
| `BatchReplaceKtpbdcgCommand` | `KtpbService.SaveDcgBatchAsync`（先删后建） |

**挡车数算法**（移植 `CalculateSingleDangcheshu`）：每台车权重默认 1；若某车台被多条记录覆盖，且同时是某记录的起点与另一记录的终点（接壤），该车台权重取 0.5，最后四舍五入保留两位。前后端实现完全一致。

---

## 二、后端

### 2.1 实体（`Domain/Entities/PROD/Ktpb.cs`）

| 类 | 表 | 主要字段 |
|---|---|---|
| `KtpbCtg` | `KtpbCtgs` | DeptId、Banci、Jizu、Ygid1、Ygid2 |
| `KtpbDcg` | `KtpbDcgs` | DeptId、Banci、Jizu、ChetaiStart、ChetaiEnd、YgId、Dangcheshu |
| `KtpbZbz` | `KtpbZbzs` | DeptId、Banci、YgId |

### 2.2 服务与接口（`KtpbService` / `KtpbController`，路由 `api/prod/ktpb`）

```
GET    qianxian-deps                     车间下拉（DutyType=前缫）
GET    jizu-options?depId=               机组下拉（含车台范围，取机组车台）
GET    ctg?depId=&banci=&jizu=&like=     车头工分页
POST   ctg | PUT ctg/{id} | DELETE ctg/{id}
GET    dcg?depId=&banci=&jizu=&like=     挡车工分页
GET    dcg/group?depId=&banci=&jizu=     某机组整组排班
POST   dcg/batch                         整组替换（空集合=清空）
DELETE dcg/{id}
GET    zbz?depId=&banci=&like=           值班长分页
POST   zbz | PUT zbz/{id} | DELETE zbz/{id}
```

校验规则：
- 车头工：同「车间+班次+机组」唯一，车头工1 必填。
- 挡车工：起始车台>0、结束≥起始、必须落在该机组车台范围内；保存时服务端重算挡车数。
- 值班长：同「车间+班次+值班长」不重复。

### 2.3 数据导入（`ProdSeedData`，幂等）

新增 3 个内嵌资源 `SeedData/biz_prod_qs_ktpb_ctg.json`、`_dcg.json`、`_zbz.json`，并把 `biz_prod_qs_jzct.json` 按本次导出数据重新生成。

映射规则：
- **部门**：xlsx 中的 `dep_id` 是 F9 部门 Id，经 `BusinessSeedData.DeptData`（F9 Id → 部门名）映射到本系统 `Departments.Id`；
- **职工**：F9 职工导出时保留了原始雪花 Id，本系统 `Employees.Id` 与之一致，直接按 Id 关联（不存在的职工行跳过）；
- **清洗**：剔除 `deleted_at` 非空的软删除行（4 张表中大量为测试/删除数据）、部门无法映射或不在前缫四车间的行、机组/车台号非法行；
- **去重**：机组车台按「车间+机组」保留规范行（优先 `起始号 = (机组-1)*20+1`）；车头工按「车间+班次+机组」；值班长按「车间+班次+值班长」；挡车工按整行；
- **幂等**：机组车台按「车间+机组」upsert；车头工按「车间+班次+机组」upsert；挡车工按「车间+班次+机组」整组已存在则跳过；值班长按唯一键跳过。

导入结果（本次启动日志）：

```
[ProdSeed] 机组车台：来源 24 条，新增 0，更新 0（此前已导入）
[ProdSeed] 车头工看台排班：来源 33 条，新增 33 条
[ProdSeed] 挡车工看台排班：来源 202 条，新增 202 条（34 组）
[ProdSeed] 值班长看台排班：来源 7 条，新增 7 条
```

> 原始 xlsx 行数：机组车台 35、车头工 75、挡车工 4543、值班长 13；其中挡车工 4341 行是 F9 里已软删除的历史/测试数据，故有效数据仅 202 行。

### 2.4 菜单

`DbSeeder.SeedProdMenus` 在生产-前缫下新增第 3 个子菜单「看台排班」，权限标识 `prod:ktpb:list`，admin 自动授权。

---

## 三、前端

| 文件 | 说明 |
|---|---|
| `views/prod/ktpb/index.vue` | 看台排班主页面（三页签 + 过滤 + 分页 + 三个弹窗） |
| `components/select/EmployeeSelect.vue` | 职工选择弹窗（单选/多选，支持按部门过滤与姓名/工号搜索） |
| `router/index.js` | 注册 `prod/ktpb/index` 路由组件 |

前端交互要点：
- 挡车工维护必须先在顶部选定「车间 + 机组」，弹窗内展示该机组车台范围；
- 弹窗顶部实时显示「已分配 x / y 台」，未满额时标签变黄，避免漏排；
- 起止车台用 `el-input-number` 限制在机组范围内，改动即刷新挡车数；
- 车头工/值班长新建时默认带出当前过滤的车间与班次。

---

## 四、验证记录

| 项 | 结果 |
|---|---|
| `dotnet build` | ✅ 0 错误 |
| `vite build` | ✅ 通过（仅既有体积/SignalR 注释警告） |
| 菜单 | ✅ 生产-前缫 → 落丝记录 / 车间班次 / 看台排班 |
| 车间下拉 | ✅ 前缫车间、前缫一~四车间 |
| 机组下拉（前缫一车间） | ✅ 机组1-6，车台 1-20 / 21-40 / … / 101-120 |
| 挡车工列表 | ✅ 202 条，姓名/车台/挡车数正确（3.5、3、3.5…） |
| 车头工列表 | ✅ 33 条 |
| 值班长列表 | ✅ 7 条 |
| 整组保存 + 挡车数重算 | ✅ 行1 1-10、行2 10-20 → 9.5 / 10.5（接壤车台各 0.5） |
| 超范围校验 | ✅ 车台 1-99 于机组1（1-20）返回 400「超出该机组车台范围 1-20」 |
| 测试数据清理 | ✅ 临时数据删除后组内 0 行 |

---

## 五、说明与后续

1. 职工姓名沿用 F9 档案原文（部分带「宁兴」等后缀，如「谢群生宁兴」），属于基础数据层面的既有情况，本次未改动。
2. 「机组车台」维护页面仍在 基础数据 下（`/base/jizuchetai`）；F9 是放在生产-前缫组内。如需完全对齐，可把该菜单整体平移到生产-前缫（数据接口不变）。
3. 挡车工排班目前按「整组替换」保存，没有保留历史版本；若需要留痕，可增加排班生效日期 + 版本表。
4. 后续若要支持「按班组/按日期」排班（F9 另有班组维度），可在现有三张表上扩展 BanCi 组合键。