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

工作进度-11：新增「质量」模块（工艺执行书 + 样茧试缫）

时间：2026-10-22（承接工作进度-10） 需求：把 D:\AntaiProject - 副本（F9 智慧缫丝 WinForms 版）里 质量模块 → 工艺执行书 与 质量模块 → 样茧试缫 迁移进本系统，并还原随附的 8 张报表版式。 参考实现位置：

• 客户端：WinClient\F9.Business.Prod\Gyzxs\、WinClient\F9.Business.Prod\QC\YJSS\
• 服务端：F9Servic\BBIT.F9\BBIT.F9.Domain\Entities\Business\PROD\QC\、BBIT.F9.Application\CQRS\Business\PROD\QC\YJSS\、Application\Implements\Reports\Prod\QC\RepDt_Qc_Yjss_*
• 报表样例（本次已按 RTF 还原）：封面 / 工艺执行书 / 混剥选茧工艺执行书 / 试缫工艺单 / 试缫与大样模板 / 煮茧工艺执行书 / 自动缫车间生产工艺执行书 / 自动缫大样

---

一、功能地图

质量（新一级菜单，sort=7，图标 Medal）
├── 工艺执行书  /qc/gyzxs   qc/gyzxs/index
│     一行 = 一个工艺庄口；√ 标记 7 张子单据是否已录入
│     ├── 封面            （桑蚕丝工艺设计书：编号/规格/原料总量/生产丝量/生产线时间）
│     ├── 试产            （试缫工艺单：茧质调查 + 自动缫试缫指标 + 试缫煮茧工艺）
│     ├── 选剥茧          （混剥选茧：混茧工艺明细 + 生产/质量/质量控制指标）
│     ├── 试缫与大样      （试缫 vs 大样 两行对比 + 技术措施 + 签署）
│     ├── 煮茧            （庄口原料性能 + 工艺技术指标 + 真空渗透 + 分车间配温 + 副煮车间）
│     ├── 自动缫          （表一：茧质概况 + 生产指标 + 工艺技术指标 + 表二大样）
│     └── 后缫            （工艺执行书：生产指标 9 项 + 工艺条件及控制指标 18 项）
│     打印下拉 = 8 张报表任意一张
└── 样茧试缫    /qc/yjss    qc/yjss/index
      页签：原料小样 / 综合样
      ├── 选茧调查        11 个茧别 重量 + 比例（按茧重重算）
      ├── 解舒调查        多条记录（缫丝参数/纤度丝长/落绪/蛹体/附煮/屑物）
      ├── 茧幅调查        仅综合样（按茧幅分档，算平均/整齐率/均方差）
      ├── 切剖调查        仅综合样（原量/干量/粒数比例，算茧层率/脱胶率）
      ├── 清洁洁净        匀度 + 洁净档位 + 疵点，自动算清洁/洁净/片数
      └── 茧丝百回纤度    仅综合样（按回数批量生成 + 自动汇总标注值）
      打印下拉 = 原料小样报表 / 综合样报表 / 解舒调查报表

---

二、后端

2.1 领域实体（F9WebAiTest.Domain/Entities/QC/）

工艺执行书（Gyzxs/，表前缀 qc_gyzxs_）：

文件	表	说明
GyzxsDocVersion.cs	qc_gyzxs_doc_version	主控：以庄口为键，记录 7 张子单据 Id（列表 √ 来源）
GyzxsFengMian.cs	qc_gyzxs_fengmian	封面（含编号 SJZ-{年}-工艺-{序}、生产时间区间）
GyzxsShichan.cs	qc_gyzxs_shichan	试产：茧质 7 项 + 自动缫 16 项 + 煮茧 11 项
GyzxsXbj.cs	qc_gyzxs_xbj / qc_gyzxs_xbj_hunjian	选剥茧主表 + 混茧比例明细（庄别/重量/包数/比例/混茧包数）
GyzxsXbjSsDy.cs	qc_gyzxs_xbj_ssdy	试缫与大样（Ss*/Dy* 各 10 项 + 技术措施 + 签署）
GyzxsZhuJian.cs	qc_gyzxs_zhujian / _chejian / _fuzhu	煮茧主表 + 分车间配温 + 副煮车间结果
GyzxsZds.cs	qc_gyzxs_zds / qc_gyzxs_zds_dyzl	自动缫表一 + 大样表二
GyzxsHs.cs	qc_gyzxs_hs	后缫（工艺执行书本体）

样茧试缫（Yjss/，表前缀 qc_yjss_）：main_ylxy、main_zhy、dc_xjdc、dc_jsdc、dc_jfdc_main、dc_jfdc_item、dc_jsbhxd_main、dc_jsbhxd、dc_qpdc、dc_qjjj。

与 F9 的差异（有意为之）：F9 子表只用 yjss_id 外键，依赖雪花全局唯一 Id；本系统主表用自增 Id，原料小样与综合样会重号，因此所有子表增加 YjssType（1 原料小样 / 2 综合样） 判别列，读写一律按 (YjssId, YjssType) 定位。 另：F9 的「综合样茧质」在本系统未单独立表，其指标以冗余字段直接落在选剥茧 / 煮茧 / 自动缫 / 试产表上，报表照常可打。

2.2 服务与接口

服务	主要方法
GyzxsService	GetDocVersionPagedAsync / CreateDocVersionAsync / 7 组 Get*Async+Save*Async / GetPrintDataAsync
YjssService	GetPagedAsync / SaveYlxyAsync / SaveZhyAsync / 6 组子单据读写 / GetFullAsync / GetJsdcSummaryAsync

设计要点：

1. 指针回写：任一张子单据保存后 upsert qc_gyzxs_doc_version 对应列（ZdsDyId 早前漏检已修）；解舒/百回纤度保存后回写主表记录数 JsdcCt/JsbhxdCt。
2. 按「庄口 + 规格」唯一：试产、试缫与大样、自动缫、大样、后缫均以 (GyzkId, Guige) 为业务键；封面、选剥茧、煮茧按庄口唯一。
3. 报表数据包：GetPrintDataAsync(type, gyzkId, guige) 返回 Parameters（中文键）+ Main/Sub1/Sub2，结构与 Grid++ 的 Report_Data 对齐，后续可直接被报表中心 Provider 复用。
4. 编号自增：封面新建时按 SJZ-{年度}-工艺-{n} 预生成。

接口一览（均需登录）：

GET    /api/qc/gyzxs?year=&keyword=&pageIndex=&pageSize=
POST   /api/qc/gyzxs/version?gyzkId=            DELETE /api/qc/gyzxs/version/{id}
GET|POST /api/qc/gyzxs/fengmian                 （gyzkId）
GET|POST /api/qc/gyzxs/shichan                  （gyzkId + guige）
GET|POST /api/qc/gyzxs/xbj                      （主表 + hunJian 明细数组）
GET|POST /api/qc/gyzxs/ssdy                     （gyzkId + guige）
GET|POST /api/qc/gyzxs/zhujian                  （主表 + cheJian + fuZhu）
GET|POST /api/qc/gyzxs/zds                      （zds + dyzl）
GET|POST /api/qc/gyzxs/hs                       （gyzkId + guige）
GET    /api/qc/gyzxs/print/{type}?gyzkId=&guige=    type = fengmian|gyzxs|xbj|shichan|ssdy|zhujian|zds|zdsdy

GET    /api/qc/yjss?type=1|2&year=&keyword=
POST   /api/qc/yjss/ylxy | /zhy                 DELETE /api/qc/yjss/{type}/{id}
GET|POST /api/qc/yjss/xjdc/{yjssId}?type=       /api/qc/yjss/xjdc?type=
GET|POST /api/qc/yjss/jsdc/{yjssId}?type=       /api/qc/yjss/jsdc?type=
DELETE /api/qc/yjss/jsdc/{type}/{id}
GET|POST /api/qc/yjss/jfdc|qpdc|qjjj|jsbhxd    （GET 带 ?type=）
GET    /api/qc/yjss/full/{type}/{id}
GET    /api/qc/yjss/jsdc-summary/{yjssId}?type=

2.3 菜单种子

DbSeeder.SeedQcMenus()：幂等创建 /qc 目录 + 两个页面菜单，admin 角色授权，并把一级目录顺序校正为 基础(3) < 员工(4) < 前缫(5) < 后缫(6) < 质量(7) < 消息(8) < 系统(9) < 报表(10)。

---

三、前端

文件	作用
views/qc/components/SchemaForm.vue	字段驱动表单（text/number/date/textarea，支持 dyzl.xxx 嵌套键）
views/qc/components/QcGrid.vue	字段驱动可编辑表格（对应 WinForms 的 f9AntdUITable）
views/qc/gyzxs/schema.js	7 张子单据 + 8 种报表的字段/版式元数据
views/qc/gyzxs/index.vue	庄口列表（√ 标记、按年度筛、打印下拉、按庄口新增）
views/qc/gyzxs/DocDialog.vue	子单据录入弹窗（含「从指定庄口读取数据」跨庄口复制）
views/qc/gyzxs/PrintDialog.vue	8 张报表版式 + A4 横向打印
views/qc/yjss/index.vue	原料小样 / 综合样双页签列表
views/qc/yjss/schema.js	6 类调查字段 + 计算规则（比例 / 茧幅 / 茧层率 / 清洁洁净）
views/qc/yjss/YjssDocDialog.vue	6 类调查录入（解舒为「列表 + 明细弹窗」）
views/qc/yjss/YjssPrintDialog.vue	原料小样 / 综合样 / 解舒调查 三张报表

业务算法（前端即时计算，保存落库）：

• 选剥茧：按重量重算比例，总官堆 40 包分摊混茧包数，末行取差额。
• 茧幅：平均 = Σ(茧幅×数量)/Σ数量，整齐率 = |茧幅-平均| ≤ 1mm 占比，均方差按加权。
• 茧丝百回纤度：外/中/内三百回为分区间平均，最大/内外开差取极值差。
• 清洁洁净：片数 = Σ洁净档位片数；洁净 = Σ(分值×片数)/片数；清洁 = 100 - (特大糙×3 + 废丝×3 + 大糙×2 + 黏附糙 + 大长结 + 重螺旋)/片数×100。
• 解舒：解舒率 = 解舒丝长 / 一茧丝长，落绪总粒数 = 外+中+内。

---

四、验证记录

项	结果
dotnet build F9WebAiTest.sln	✅ 0 错误（120 条既有 CS8632 可空注解警告）
vite build	✅ 通过（仅既有 chunk 体积/动态导入警告）
IDE 诊断（views/qc/**、router/index.js）	✅ 0
菜单	✅ 质量(sort=7) → 工艺执行书 / 样茧试缫，admin 自动授权
工艺执行书 7 张子单据保存 + 回读	✅ 封面/试产/选剥茧(2 行混茧)/试缫与大样/煮茧(1 分车间+1 副煮)/自动缫(含大样)/后缫
主控 √ 标记	✅ 7 个指针全部回写（zdsDyId 漏检缺陷已修）
8 张报表数据	✅ 每张均返回 title + 参数区（如「工艺执行书」28 个参数），xbj/zhujian/ssdy 有结果集
封面编号	✅ 新庄口预生成 SJZ-2026-工艺-1
样茧试缫（原料小样）	✅ 主表 + 选茧 + 解舒(1 条) + 清洁洁净，解舒汇总正确
样茧试缫（综合样）	✅ 主表 + 茧幅(3 档) + 切剖 + 百回纤度(2 行)，整页参数区完整
两类样品隔离	✅ 同一 yjssId 下 type=1 有数据、type=2 返回空

---

五、后续可做

1. 报表中心对接：8 张报表目前用 HTML 打印（版式已按 RTF 还原，A4 横向）。若要进「报表中心」，可基于 /api/qc/gyzxs/print/{type} 写 8 个 RepDt_* Provider 并制作 .grf 模板，数据结构已预留 Parameters/Main/Sub1/Sub2。
2. 综合样茧质单独立表：目前选剥茧/煮茧/自动缫/试产的茧质指标是冗余存储；若需要「综合样茧质」独立维护与联动，可补一张主表并由保存时回填。
3. 审批状态机：设计/审核/审批目前是文本字段，可升级为流程（参考考勤模块的审批流）。
4. 单位与精度：部分指标沿用 F9 的字符串区间表达（如 185±5、20~38），如后续需要统计，可拆分为「下限/上限/目标值」三列。