f9-web-ai-test/工作进度/工作进度-16.md

工作进度-16：薪资-挡车车头产量计算（CALCLDCCT）及其全部依赖

时间：2026-10-24（承接工作进度-15） 需求：把 D:\AntaiProject - 副本\trunk\WinClient\F9.Business.PayRoll\PAYROLL\CALCLDCCT 模块移植进本系统， 并补齐它依赖的全部功能（配置 + 数据源）。 参考实现：WinClient\F9.Business.PayRoll\PAYROLL\CALCLDCCT\Page_CalcLdcct.cs（3067 行）、Page_CalcLdcct_Edit.cs、 Application\CQRS\Business\PayRoll\CALCLDCCT\（CalcLdcct_SaveCommand / CalcLdcct_DeleteByDateRangeDepCommand …）、 Domain\Entities\Business\PayRoll\（CalcLdcct / CONFGYZK / CONFGZ / CONFDCG / DCXDJK / XinZiJiaGePeiZhi）。 落库表：F9 biz_payroll_calcldcct → 本系统 CalcLdccts。

---

一、功能设计

薪资
├── 挡车车头产量计算        /payroll/calcldcct      本次新增（核心）
├── 工艺庄口薪资配置        /payroll/confgyzk       本次新增（依赖配置）
├── 工种薪资配置            /payroll/confgz         本次新增（依赖配置）
├── 挡车岗位薪资配置        /payroll/confdcg        本次新增（依赖配置）
├── 挡车纤度奖扣            /payroll/dcxdjk        本次新增（依赖配置）
└── 薪资价格配置            /payroll/xzjg          本次新增（依赖配置）

F9 行为	本系统实现
查询：年月（→账期）+ 部门 + 工种 + 姓名/庄口 Like	GET /api/payroll/calcldcct/list
一键计算(挡车工)：部门穿梭框多选 → 逐部门计算 → 对账报告	POST /api/payroll/calcldcct/calc-dcg（单部门；返回条数/丝量/金额/告警）
一键计算(车头工)：强依赖已存的挡车工产量	POST /api/payroll/calcldcct/calc-ctg
录入：单部门计算后弹窗人工微调（可改产量初始值 / 系数 / 金额-产量）	表格内 3 列直接编辑 + 「保存微调」整账期覆盖（POST /save）
删除：按 账期 × 部门 × 工种 整批删除	DELETE /api/payroll/calcldcct?start=&end=&depId=&worktypeId=
5 套薪资配置各自的增删改查	5 个 api/payroll/conf* /dcxdjk /xzjg 控制器

计算口径（全部对齐 F9，服务端兜底重算）

【丝量】
每桶丝量     = 每车丝量(kg) × 1000 / 标准落丝桶数
甲乙合计丝量 = Round(Σ今缫桶数 × 每桶丝量, 0)            （煮茧日报不分班）
班次丝量     = 甲乙合计 × Σ(挡车数×工时)_班 / Σ(挡车数×工时)_机组日      （挡车）
             = 甲乙合计 × Σ(20×工时)_班 / Σ(20×工时)_机组日              （车头，固定 20 台/组）
个人丝量     = 班次丝量 × 挡车数×工时 / Σ(挡车数×工时)_同机组同班        （挡车）
             = 班次丝量 × 工时 / (最长工时 × 2)                          （车头，2 人分摊）
看台时长     = Round(个人工时 × 庄口今缫桶数占比, 1)，单庄口时等于个人工时

【等级】
挡车工：木桶短板法 —— 均方差/总差/清洁分/洁净分/二度/三度各自在「生丝定级指标(标准=个人)」里定级，取最低分
车头工：按挡车工丝量加权平均等级分后回落取整档；无挡车工产量时取庄口配置的 QsDengji/QsDengjifen
未下丝时：等级/等级分/缫折全部回落到庄口配置

【单价】
挡车：绪数 = 挡车数 × 20；<60→50档基数，<70→60档，<100→70档，否则 100 档
      基础单价 = 岗位基数金额 / 标准出勤天数 / 挡车数 / 标准上班时长 / 庄口工艺台产
车头：基础单价 = 车头岗位金额 / 标准出勤天数 / 9 / 20 / 庄口工艺台产 × 2
等级单价增减 = (等级分 − 工艺等级分) / 0.1 × 等级奖扣单价 / 10 / 1000
实际单价     = 基础单价 + 等级单价增减

【质量】
缫折       = Σ(车台茧量×看台比例) × 100 / Σ(车台丝量×看台比例)
             车台茧量 = 落丝茧量 × 该车台丝量占落丝丝量的比例（茧量只记在落丝层，需按丝量摊到车台）
中心纤度数 = 纤度值 == 生丝规格.中心纤度 的计数 × 看台比例
野纤数     = 纤度 ≤ 野纤下限 或 ≥ 野纤上限 的计数 × 看台比例
清洁扣款片数 = (特大糙 + 大糙 + 长结) × 看台比例
洁净扣款片数 = (85 + 80 + 75 + 70 分档) × 看台比例
二度/三度    = 黑板检验匀二度/匀三度 × 看台比例
两班(甲乙)时：中心纤度/野纤/清洁/洁净/二度/三度及其扣款全部 × 0.5

【金额】
产量金额初始值 = 实际单价 × 丝量；  产量金额 = 实际单价 × 丝量 × 计件系数
缫折考核       = ±2kg 死区不奖不扣，超出扣掉死区后 clamp(挡车 ±10 / 车头 ±3)，每 1kg 每 100kg 丝 5元(挡车)/1元(车头)
中心纤度奖     = 中心纤度数 × 1 元
野纤扣         = −挡车纤度奖扣表扣款（≥2 条取扣款最大的 2 条求和）
清洁扣         = −(特大糙×2 + 大糙×0.5 + 长结×2)
洁净扣         = −(85×0.2 + 80×1 + 75×2 + 70×5)
二度扣/三度扣  = −二度×2 / −三度×20

关键常量：20（每台绪数、车头 20 台/组）、9/2（车头）、0.1（等级分步长）、 0.5（两班折半）、1.0/0.4/0.1（清洁扣分基数）、2（缫折死区）、5/1（缫折单价）、225（F9 弹窗均值折算，本版未移植）。 全程 MidpointRounding.AwayFromZero。

---

二、后端

2.1 实体（Domain/Entities/PayRoll/）

类	文件	表	说明
CalcLdcct	CalcLdcct.cs	CalcLdccts	产量计算明细，唯一键 Date+DepId+Banci+Jizu+EmployeeId+WorktypeId+GyzkId+Guige+Chetai
ConfGyzk	Conf.cs	ConfGyzks	工艺庄口薪资配置，唯一键 Year+Month+GyzkId
ConfGz	Conf.cs	ConfGzs	工种薪资配置（40 项），唯一键 WorkTypeId
ConfDcg	Conf.cs	ConfDcgs	挡车/车头岗位薪资配置，唯一键 DepId
DangCheXianDuJiangKou	Conf.cs	DangCheXianDuJiangKous	挡车纤度奖扣，唯一键 GuiGe+XianDu
XinZiJiaGePeiZhi	Conf.cs	XinZiJiaGePeiZhis	薪资价格配置，唯一键 Group+Key

均继承 BaseEntity，建表沿用 DbSeeder.SyncStructure。

2.2 服务

服务	文件	说明
ICalcLdcctService / CalcLdcctService	Services/PayRoll/CalcLdcctService.cs	列表 + 挡车/车头一键计算 + 保存 + 删除，内含全部计算口径
IConfGyzkService / ConfGyzkService	Services/PayRoll/PayRollConfService.cs	工艺庄口配置 CRUD
IConfGzService / ConfGzService	同上	工种配置 CRUD（含 40 项金额）
IConfDcgService / ConfDcgService	同上	挡车岗位配置 CRUD
IDcxdjkService / DcxdjkService	同上	挡车纤度奖扣 CRUD
IXzjgService / XzjgService	同上	薪资价格 CRUD + GetPriceAsync(group,key)

数据源（全部为系统已有模块，本次只做读取）：看台记录 KtjlDcg/KtjlCtg、煮茧日报 ZjrbRecord/ZjrbJizu、 落丝记录 LsjlRecord、秤大丝 CdsLsjl/CdsChetai、纤度检验 XdjyLsjl/XdjyRecord、黑板检验 HbjyRecord、 生丝规格 ShengsiGuige、生丝定级指标 ShengsiDingjizhibiao、工艺庄口 CraftZhuangKou。

2.3 接口

GET    /api/payroll/calcldcct/list?start=&end=&depId=&worktypeId=&like=&pageIndex=&pageSize=
POST   /api/payroll/calcldcct/calc-dcg          一键计算（挡车工）
POST   /api/payroll/calcldcct/calc-ctg          一键计算（车头工）
POST   /api/payroll/calcldcct/save              整账期×部门×工种全量覆盖（人工微调）
DELETE /api/payroll/calcldcct?start=&end=&depId=&worktypeId=

GET    /api/payroll/confgyzk/list?year=&month=      POST /save   GET /{id}   DELETE /{id}
GET    /api/payroll/confgz/list                     POST /save   GET /{id}   DELETE /{id}
GET    /api/payroll/confdcg/list                    POST /save   GET /{id}   DELETE /{id}
GET    /api/payroll/dcxdjk/list?guige=              POST /save   GET /{id}   DELETE /{id}
GET    /api/payroll/xzjg/list?group=                POST /save   GET /{id}   DELETE /{id}

要点：

• 计算与保存都是「整账期 + 部门 + 工种全量覆盖」：先物理删除旧数据再重建，避免唯一索引冲突（与煮茧日报同一策略）；
• 车头工计算必须已有挡车工产量，否则等级回落到庄口配置并给出告警；
• 所有告警通过 CalcLdcctResultDto.Warnings 返回，前端 ElMessageBox.alert 展示。

2.4 菜单

新增一级菜单「薪资」/payroll（排序 8，质量 7 与通知 9 之间），6 个子菜单：

顺序	菜单	路径	组件	权限标识
1	挡车车头产量计算	/payroll/calcldcct	payroll/calcldcct/index	payroll:calcldcct:list
2	工艺庄口薪资配置	/payroll/confgyzk	payroll/confgyzk/index	payroll:confgyzk:list
3	工种薪资配置	/payroll/confgz	payroll/confgz/index	payroll:confgz:list
4	挡车岗位薪资配置	/payroll/confdcg	payroll/confdcg/index	payroll:confdcg:list
5	挡车纤度奖扣	/payroll/dcxdjk	payroll/dcxdjk/index	payroll:dcxdjk:list
6	薪资价格配置	/payroll/xzjg	payroll/xzjg/index	payroll:xzjg:list

同时把一级菜单顺序归一为：/qc 7、/payroll 8、/notification 9、/sys 10、/report 11。

---

三、前端

文件	说明
views/payroll/calcldcct/index.vue	年月(→账期) + 部门 + 工种查询；多级表头（产量 / 质量 / 金额 / 金额-质量）；一键计算(挡车/车头)、保存微调（产量初始值/系数/金额-产量三列直接编辑）、删除；底部显示当前页产量金额合计
views/payroll/confgyzk/index.vue	工艺庄口薪资配置 CRUD，庄口用 CraftZhuangKouSelect 选择
views/payroll/confgz/index.vue	工种薪资配置 CRUD，40 项按「出勤与工时/岗位与奖金/假期与加班/学工/岗位胜任考核/加班工资」分组
views/payroll/confdcg/index.vue	挡车岗位薪资配置 CRUD（50/60/70/100 绪基数金额 + 车头工金额）
views/payroll/dcxdjk/index.vue	挡车纤度奖扣 CRUD
views/payroll/xzjg/index.vue	薪资价格配置 CRUD，薪资.前缫 分组下预置「挡车工/车头工计件等级奖扣单价」
router/index.js	componentMap 注册上述 6 个页面

---

四、验证记录（全部由助手自行执行，无需人工点击）

项	结果
dotnet build（Domain / Application / Infrastructure / Api）	✅ 0 错误
npm run build（Node 在 C:\Users\32453\.workbuddy\binaries\node\versions\22.22.2-6）	✅ ✓ built in 14.88s（仅既有 chunk 体积警告）
IDE 诊断（6 个 vue + router）	✅ 0
菜单与权限	✅ /auth/menus 返回「薪资」+ 6 个子菜单
6 个接口连通性	✅ 全部 200（空表）
挡车工一键计算	✅ 生成 1 条/庄口；丝量 = 桶数100 × (10kg×1000/4) = 250000 g
挡车工单价	✅ 挡车数 20 → 绪数 400 → 100 档；基础单价 = 4000/28/20/9/100 = 0.0079365
挡车工等级	✅ 生丝定级指标 192 条参与木桶短板，定出 6A00 / 12；等级增减 = (12−5)/0.1×0.3/10/1000 = 0.0021
挡车工实际单价 / 产量金额	✅ 0.0100365；0.0100365 × 250000 × 1 = 2509.13
挡车工缫折	✅ 落丝茧量 60000 g、秤大丝丝量 25000 g → 缫折 240（修复前为 4800，见下方问题）
挡车工缫折考核	✅ (300−240)−2 = 58 → 封顶 10 → 10 × (250000/1000/100) × 5 = +125
车头工一键计算	✅ 丝量 = 250000 × 9/(9×2) = 125000；基础单价 = 2000/28/9/20/100×2 = 0.0079365；缫折考核 = 3 × 1.25 × 1 = 3.75
车头工依赖挡车工	✅ 无挡车工产量时给出「工种薪资配置缺失」类告警并按配置回落
人工微调保存	✅ 产量初始值改 999.99 后保存，回读 999.99 / 系数1 / 金额999.99
整账期删除	✅ 删除后 total=0，且「删除后重建」不再撞唯一索引
班次显示	✅ 修正为 甲=1 / 乙=2（初版误按 0/1 映射，已修）
测试数据清理	✅ 播种的煮茧日报、看台记录、落丝记录、秤大丝、5 套配置、计算结果全部删除；验证脚本 verify-payroll.ps1 已删除

过程中发现并修复的真实 bug

1. 缫折被放大 20 倍：初版按「车台数 × 落丝茧量」累加分子，导致 20 台时缫折 = 4800（正确 240）。 修正为：茧量只记在落丝层，按「车台丝量 / 落丝丝量」摊到车台后再按看台比例摊到人。
2. 班次名称错位：Prod_Banci_Enum 是 甲=1 / 乙=2，初版按 0/1 映射，甲班被显示成乙班。

---

五、移植取舍与后续

1. 未移植 F9 弹窗顶部的 4 个均值标签（挡60/挡70/挡100/车头平均，Σ金额 / Σ看台时长 × 225）：这是展示用的派生统计， 本版在列表底部给出「当前页产量金额合计」；如需可按同样公式补在弹窗/工具栏。
2. 未移植 F9 的「部门穿梭框多选」一键计算：Web 端改为先选部门再点按钮，单部门计算（语义等价，逐个部门重复操作即可）。
3. 野纤「奖励」分支未使用：与 F9 一致——挡车工路径下 JineZlYexian 只取 -扣款，奖励分支被丢弃。
4. 未移植的 F9 薪资子模块（本次范围外，可按需继续）：CalXz（薪资核算主表）、Cmcl（产量）、QSXSCL、QTKH、SBRYKH 等。
5. 待接入：① Grid++ 打印（报表中心目前只有 lsjl.grf）；② 历史 biz_payroll_calcldcct 数据可按工作进度-13 的 CSV 内嵌 + 幂等策略导入； ③ 本模块产出的「金额-产量 + 金额-质量」可直接作为计件工资与成本核算的数据源。

环境备注

• 本机 node / npm 不在默认 PATH，需先 set PATH=C:\Users\32453\.workbuddy\binaries\node\versions\22.22.2-6;%PATH%。
• Windows PowerShell 5.1 的 Invoke-RestMethod 默认按 ASCII 提交请求体，写中文会变成 ?； 验证脚本改为 [System.Text.Encoding]::UTF8.GetBytes() + application/json; charset=utf-8，并用 UTF-8 BOM 保存脚本。
• 煮茧日报的「已存在相同的煮茧日报」校验会命中已软删记录，删除后无法在同一「日期+车间+庄口+规格」重建（既有模块行为，本次未改动）。