using Admin.NET.Plugin.AiDOP.Dto.S0.Quality;
using Admin.NET.Plugin.AiDOP.Entity.S0.Quality;
namespace Admin.NET.Plugin.AiDOP.Controllers.S0.Quality;
///
/// 检验规范聚合(主单 + 检验明细)的必填契约守卫。
///
/// 契约来源:UAT-S0-10 拍板(2026-09-02)。此前四张检规表在前端表单、后端 DTO、DB 列三层
/// 都只约束「文件编号」,导致只填文件编号即可落库空壳检规。本守卫是该契约的唯一实现处,
/// Create / Import 两条写入入口共用,避免再次出现「导入宽于表单」。
///
/// 两条入口的规则不同,刻意分成两个方法:
/// · 新增(Create / Import)——必填字段必须全部有值,且至少 1 条有内容的检验明细;
/// · 编辑(Update)——「历史兼容、禁止劣化」:历史记录原本就缺的字段允许继续为空,
/// 但原本有值的必填字段不允许被清空;原本 0 明细允许保持 0,原本有明细不允许删空。
///
/// 【为什么四张检规表的 DTO 上一个 [Required] 都不留】
/// Create 与 Update 共用同一个 UpsertDto。任何 [Required] 都会在 MVC 模型绑定阶段先于本守卫触发,
/// 把 Update 直接挡成 400,从而绕过并破坏 ValidateUpdate(existing, incoming) 的历史兼容语义
/// ——实测 qms_gcjygf 有 3 行 wjbh 为空,正是被遗留的 FileNumber[Required] 锁死不可编辑。
/// 因此「文件编号」的新增必填也统一迁到本守卫,特性层不再承担任何必填职责。
///
/// 【明细归一化】全空明细是 UI 占位行 / Excel 空行,不是业务明细,一律不落库。
/// Create / Update / Import 三条入口都必须先经 Meaningful(...) 过滤,再用过滤结果做数量校验与写入,
/// 保证「校验看到的」与「写进库的」是同一份数据。
///
public static class AdoS0QmsSpecAggregateGuard
{
/// 新增校验。返回 null 表示通过,否则为面向用户的错误文案。
public static string? ValidateCreate(IReadOnlyList<(string Label, string? Value)> requiredFields, int meaningfulItemCount)
{
foreach (var (label, value) in requiredFields)
{
if (string.IsNullOrWhiteSpace(value)) return $"{label}不能为空";
}
return meaningfulItemCount > 0 ? null : "检验明细至少需要 1 条";
}
/// 编辑校验(历史兼容、禁止劣化)。返回 null 表示通过,否则为面向用户的错误文案。
public static string? ValidateUpdate(
IReadOnlyList<(string Label, string? Existing, string? Incoming)> requiredFields,
int existingMeaningfulItemCount,
int incomingMeaningfulItemCount)
{
foreach (var (label, existing, incoming) in requiredFields)
{
// 原本为空 → 放行(不强制本次补齐);原本有值 → 不允许清空。
if (!string.IsNullOrWhiteSpace(existing) && string.IsNullOrWhiteSpace(incoming))
return $"{label}原本已有值,不允许清空";
}
// 两侧都按 meaningful 计:历史若本就 0 条有内容的明细,允许继续保持 0。
if (existingMeaningfulItemCount > 0 && incomingMeaningfulItemCount == 0)
return $"该检规原有 {existingMeaningfulItemCount} 条检验明细,不允许全部删除";
return null;
}
// ==================== 明细归一化 ====================
//
// 两个不同的集合,不可混用:
//
// · Meaningful(...) —— 「有业务内容」的明细。用于 Create 的写入集,以及三条入口的**数量校验**。
// · ForUpdateWrite(...) —— Update 的写入集 = Meaningful ∪ 已持久化行(带 Id)。
//
// 为什么 Update 需要单独一个写入集:Update 的明细是 **delete-all + 全量重建** 语义
// (`AsDeleteable().Where(MasterId==id)` 后逐条 Insert,且 SyncXxxEntriesAsync 不回填 item.Id)。
// 若直接拿 Meaningful 去重建,用户只是编辑一次头字段,库里**历史已存在的空明细就会被静默删掉**
// ——实测 aidopdev 有 10 条这样的空明细,分布在 9 张真实业务主单上(如 W00-1-80 的 69 条明细里有 2 条)。
// 本轮不是历史数据清洗批次,因此按 detail identity 区分:
// 带 Id = 库里已有的行 → 即使为空也照原样写回,不主动删除;
// 无 Id = 本次 UI/Excel 新补的空占位 → 丢弃,不新增空记录。
//
// ⚠️ 已知既有局限(非本轮引入):重建会让所有明细拿到新的雪花 Id,明细身份本就不跨 Update 保持。
// 这里只保证**内容**不被顺手清理;若将来要真正保持身份,需另开批次改成按 Id diff 的增量更新。
public static List Meaningful(IEnumerable items)
=> items.Where(HasValue).ToList();
public static List Meaningful(IEnumerable items)
=> items.Where(HasValue).ToList();
public static List Meaningful(IEnumerable items)
=> items.Where(HasValue).ToList();
public static List Meaningful(IEnumerable items)
=> items.Where(HasValue).ToList();
public static List ForUpdateWrite(IEnumerable items)
=> items.Where(x => HasValue(x) || x.Id.HasValue).ToList();
public static List ForUpdateWrite(IEnumerable items)
=> items.Where(x => HasValue(x) || x.Id.HasValue).ToList();
public static List ForUpdateWrite(IEnumerable items)
=> items.Where(x => HasValue(x) || x.Id.HasValue).ToList();
public static List ForUpdateWrite(IEnumerable items)
=> items.Where(x => HasValue(x) || x.Id.HasValue).ToList();
// 实体侧判据:统计库里**现存的 meaningful 明细数**。
// 「原有 ≥1 明细不许删空」必须按 meaningful 计数,否则一张明细全为空的历史主单
// 会因 raw count>0 而永远保存不了(被自己的空占位锁死)。
public static int CountMeaningful(IEnumerable rows)
=> rows.Count(e => e.Seq.HasValue
|| AnyNotBlank(e.InspectionItem, e.InspectionStandard, e.InspectionMethod, e.ImageCategory,
e.SamplingScheme, e.Remark, e.Attachment, e.UpperLimit, e.LowerLimit));
public static int CountMeaningful(IEnumerable rows)
=> rows.Count(e => e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit));
public static int CountMeaningful(IEnumerable rows)
=> rows.Count(e => e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit));
public static int CountMeaningful(IEnumerable rows)
=> rows.Count(e => e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit));
// ==================== 明细「有内容」判据 ====================
// 整行全空的明细不计数、不落库,否则前端 openCreate 自动补的那一行空明细
// 会让「≥1 条」形同虚设,并持续制造新的空明细脏数据。
//
// 导入行(ImportRow)的重载与实体侧同语义,只是模板列少了图像分类/备注/附件等非模板列——
// 判据仍集中在本类,导入侧不再自带一份定义。
public static bool HasDetailValue(AdoS0QmsRawInspectionSpecImportRow r)
=> r.Seq.HasValue
|| AnyNotBlank(r.InspectionItem, r.InspectionStandard, r.InspectionMethod,
r.SamplingScheme, r.UpperLimit, r.LowerLimit);
public static bool HasDetailValue(AdoS0QmsProcessLikeInspectionSpecImportRow r)
=> AnyNotBlank(r.OperationCode, r.OperationName, r.InspectionItem, r.InspectionMethod,
r.InspectionSpec, r.InspectionFrequency, r.UpperLimit, r.LowerLimit);
public static bool HasValue(AdoS0QmsRawInspectionSpecEntryDto e)
=> e.Seq.HasValue
|| AnyNotBlank(e.InspectionItem, e.InspectionStandard, e.InspectionMethod, e.ImageCategory,
e.SamplingScheme, e.Remark, e.Attachment, e.UpperLimit, e.LowerLimit);
public static bool HasValue(AdoS0QmsProcessInspectionSpecEntryDto e)
=> e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit);
public static bool HasValue(AdoS0QmsFqcInspectionSpecEntryDto e)
=> e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit);
public static bool HasValue(AdoS0QmsOqcInspectionSpecEntryDto e)
=> e.PeelingForce.HasValue
|| AnyNotBlank(e.OperationCode, e.OperationName, e.InspectionItem, e.InspectionMethod, e.InspectionSpec,
e.ImageCategory, e.InspectionFrequency, e.TechnicalStandard, e.UpperLimit, e.LowerLimit);
// ==================== 成品检验规范(qms_ccjygf / qms_ccjygfzb)====================
// 与上面四组同语义,只是字段集不同:成品检规明细不含工序代号/工序名称/图像分类/检验频次/PeelingForce,
// 改为承载 S7 检验单快照真正消费的列(序号/录入类型/上下限/技术要求/仪器/条款/抽样方案/记录/尺寸规格)。
public static List Meaningful(IEnumerable items)
=> items.Where(HasValue).ToList();
public static List ForUpdateWrite(IEnumerable items)
=> items.Where(x => HasValue(x) || x.Id.HasValue).ToList();
public static int CountMeaningful(IEnumerable rows)
=> rows.Count(e => AnyNotBlank(e.SeqNo, e.InspectionItem, e.ResultType, e.UpperLimit, e.LowerLimit,
e.TechnicalRequirement, e.InspectionMethod, e.Instrument, e.InspectionClause,
e.TechnicalStandard, e.SamplingPlan, e.Record, e.SizeSpecifications));
public static bool HasValue(AdoS0QmsFinishedInspectionSpecEntryDto e)
=> AnyNotBlank(e.SeqNo, e.InspectionItem, e.ResultType, e.UpperLimit, e.LowerLimit,
e.TechnicalRequirement, e.InspectionMethod, e.Instrument, e.InspectionClause,
e.TechnicalStandard, e.SamplingPlan, e.Record, e.SizeSpecifications);
public static bool HasDetailValue(AdoS0QmsFinishedInspectionSpecImportRow r)
=> AnyNotBlank(r.SeqNo, r.InspectionItem, r.ResultType, r.UpperLimit, r.LowerLimit,
r.TechnicalRequirement, r.InspectionMethod, r.Instrument,
r.TechnicalStandard, r.SamplingPlan, r.SizeSpecifications);
///
/// 成品检规明细的**运行期可用性**校验(S0 侧前置,避免把注定生成不了检验单的检规存进库)。
/// 口径与 `FqcApplyService.GenerateInspection` 的三条兜底一致:
/// ① 检验项目非空;② lrlx 仅 NUMERIC/NON_NUMERIC/空;③ NUMERIC 的上下限须是数值且 下限≤上限。
/// 返回 null 表示通过。
///
public static string? ValidateFinishedEntries(IReadOnlyList items)
{
foreach (var e in items)
{
if (string.IsNullOrWhiteSpace(e.InspectionItem))
return "存在未填写「检验项目」的明细行,该检规将无法生成检验单";
var type = (e.ResultType ?? string.Empty).Trim().ToUpperInvariant();
if (type.Length > 0 && type != "NUMERIC" && type != "NON_NUMERIC")
return $"检验项目「{e.InspectionItem}」的录入类型非法,只能是 NUMERIC 或 NON_NUMERIC";
var upper = (e.UpperLimit ?? string.Empty).Trim();
var lower = (e.LowerLimit ?? string.Empty).Trim();
var hasLimit = upper.Length > 0 || lower.Length > 0;
if (type == "NON_NUMERIC" && hasLimit)
return $"检验项目「{e.InspectionItem}」是非数值型,不能配置上下限";
if (!hasLimit) continue;
if (!decimal.TryParse(upper, out var u) && upper.Length > 0)
return $"检验项目「{e.InspectionItem}」的上限必须是数值";
if (!decimal.TryParse(lower, out var l) && lower.Length > 0)
return $"检验项目「{e.InspectionItem}」的下限必须是数值";
if (upper.Length > 0 && lower.Length > 0 && l > u)
return $"检验项目「{e.InspectionItem}」的下限不能大于上限";
}
return null;
}
private static bool AnyNotBlank(params string?[] values)
{
foreach (var v in values)
{
if (!string.IsNullOrWhiteSpace(v)) return true;
}
return false;
}
}