using System.ComponentModel.DataAnnotations; using MiniExcelLibs.Attributes; namespace Admin.NET.Plugin.AiDOP.Dto.S0.Quality; // 检验规范 Excel 导入行 DTO:主表列 + 明细列平铺在一张表内,按“文件编号”分组还原为“一条主单 + 多条明细”。 // 列名([ExcelColumnName])与各检验规范页 qualityConfigs 现有字段一一对齐,导出模板与导入解析共用同一 DTO,保证列头单一来源。 // // 【为什么这里没有 [Required]】——同一主单的多行里,只有「文件编号」(分组键)必须逐行出现, // 其余头字段允许在续行留空。若在行 DTO 上加 [Required],合法续行会被误判为空值非法。 // 因此必填性一律在归组 + 头字段合并之后,由 AdoS0QmsSpecAggregateGuard 按聚合校验。 // // 【[MaxLength] 取值依据】——按 aidopdev 实测列长(information_schema,as_of 2026-09-02)逐列对齐, // 不做 255 一刀切:text 列(65535)不设限,上/下限是 varchar(50), // 且过程/FQC/OQC 的「物料编码」是 text 而原材料的是 varchar(255),两者不同。 /// 原材料检验规范导入行(对应 qms_jygf / qms_jygfzb) public class AdoS0QmsRawInspectionSpecImportRow { [ExcelColumnName("文件编号")] [MaxLength(255)] public string? FileNumber { get; set; } [ExcelColumnName("版本")] [MaxLength(255)] public string? VersionNo { get; set; } [ExcelColumnName("图号")] [MaxLength(255)] public string? DrawingNo { get; set; } [ExcelColumnName("原材料名称")] [MaxLength(255)] public string? RawMaterialName { get; set; } [ExcelColumnName("物料编码")] [MaxLength(255)] public string? MaterialCode { get; set; } [ExcelColumnName("生效日期")] [MaxLength(255)] public string? EffectiveDate { get; set; } [ExcelColumnName("图纸版本")] [MaxLength(255)] public string? DrawingVersion { get; set; } [ExcelColumnName("材质/材料牌号")] [MaxLength(255)] public string? MaterialGrade { get; set; } [ExcelColumnName("穴/模")] [MaxLength(255)] public string? CavityOrMold { get; set; } [ExcelColumnName("附件")] public string? Attachment { get; set; } // fj text [ExcelColumnName("附件文件名")] public string? FileName { get; set; } // filename text [ExcelColumnName("附件标题")] [MaxLength(255)] public string? Title { get; set; } [ExcelColumnName("明细-序号")] public int? Seq { get; set; } [ExcelColumnName("明细-检验项目")] public string? InspectionItem { get; set; } // jyxm text [ExcelColumnName("明细-检验标准")] public string? InspectionStandard { get; set; } // jybz text [ExcelColumnName("明细-检验工具/方法")] public string? InspectionMethod { get; set; } // jygjjyff text [ExcelColumnName("明细-抽样方案")] public string? SamplingScheme { get; set; } // cyfa text [ExcelColumnName("明细-上限")] [MaxLength(50)] public string? UpperLimit { get; set; } [ExcelColumnName("明细-下限")] [MaxLength(50)] public string? LowerLimit { get; set; } } /// 过程 / FQC / OQC 检验规范导入行(三者字段一致,对应 qms_gcjygf(zb) / qms_fqcjygf(zb) / qms_oqcjygf(zb)) public class AdoS0QmsProcessLikeInspectionSpecImportRow { [ExcelColumnName("适用型号")] [MaxLength(255)] public string? ApplicableModel { get; set; } [ExcelColumnName("文件编号")] [MaxLength(255)] public string? FileNumber { get; set; } [ExcelColumnName("版本")] [MaxLength(255)] public string? VersionNo { get; set; } [ExcelColumnName("生效日期")] [MaxLength(255)] public string? EffectiveDate { get; set; } [ExcelColumnName("物料编码")] public string? MaterialCode { get; set; } // wlbm text(与原材料表不同,不设 255) [ExcelColumnName("附件")] public string? Attachment { get; set; } // fj text [ExcelColumnName("附件2")] public string? Attachment2 { get; set; } // fj2 text [ExcelColumnName("版本号")] public int? Version { get; set; } [ExcelColumnName("明细-工序代号")] public string? OperationCode { get; set; } // gxdh text [ExcelColumnName("明细-工序名称")] public string? OperationName { get; set; } // gxmc text [ExcelColumnName("明细-检验项目")] public string? InspectionItem { get; set; } // jyxm text [ExcelColumnName("明细-检验方法")] public string? InspectionMethod { get; set; } // jyff text [ExcelColumnName("明细-检验规格")] public string? InspectionSpec { get; set; } // jygg text [ExcelColumnName("明细-检验频次")] public string? InspectionFrequency { get; set; } // jypc text [ExcelColumnName("明细-上限")] [MaxLength(50)] public string? UpperLimit { get; set; } [ExcelColumnName("明细-下限")] [MaxLength(50)] public string? LowerLimit { get; set; } } /// 检验规范 Excel 导入结果 public class AdoS0QmsSpecImportResultDto { /// 本次导入是否被接受。false 时未写入任何数据(全或无语义)。 public bool Accepted { get; set; } /// 读取到的数据行总数(不含表头) public int TotalRows { get; set; } /// 新增主表(规范)条数。Accepted=false 时恒为 0。 public int ImportedMasters { get; set; } /// 新增明细条数。Accepted=false 时恒为 0。 public int ImportedItems { get; set; } /// 不合格的行/组数量 public int FailedRows { get; set; } /// 跳过行数。全或无语义下不再跳过任何行,保留字段仅为兼容既有响应结构,恒为 0。 public int SkippedRows { get; set; } /// 逐行提示(不合格原因)。注意:不要命名为 errors,前端响应拦截器会把非空 errors 字段判为请求失败。 public List RowMessages { get; set; } = []; /// 汇总文案 public string Message { get; set; } = string.Empty; /// /// 派生映射同步告警(当前仅原材料检规导入使用)。导入本身已成功提交, /// 但 S5 IQC 检规物料桥表同步失败时在此说明,可调用 POST /api/S5IqcSpecMap/rebuild 幂等重建。 /// 恒为可空,既有响应结构向后兼容。 /// public string? SpecMapWarning { get; set; } }