using System.Reflection;
using System.Text.RegularExpressions;
using Admin.NET.Plugin.AiDOP.Entity.S8;
using Admin.NET.Plugin.AiDOP.Service.S8.Rules;
using Admin.NET.Plugin.AiDOP.Service.S8.Rules.DataAccess;
using Admin.NET.Plugin.AiDOP.Service.S8.Rules.DataAccess.Providers;
using Admin.NET.Plugin.AiDOP.Service.S8.Rules.Definitions;
using Xunit;
namespace Admin.NET.Test.S8;
///
/// S8-RULE02-ORDER-DELIVERY-WARNING-1:订单交付延期预警的结构契约。
///
/// 本文件锁定的每一条,都对应一种「代码照样跑、结论却是错的」的失效形态:
///
/// - ETA 必须来自源系统——一旦有人用「交期前 N 天」「历史均值」「已完工数量倒推」
/// 补一个 ETA,规则会从"预测"退化成"临期提醒",而输出格式完全一样,看不出来。
/// - 只判未到期——去掉 plan_date >= NOW() 会让 385 条历史逾期单一次性涌进来,
/// 且永远不会恢复。这不是"多报几条",是这条规则从预警变成了积压清单。
/// - 身份是订单行——退化成订单号会让同单多行只剩一条异常,其余行静默消失。
/// - DedupKey 预算——超预算的键被数据库截断后,两个订单行折叠成一条异常,无任何报错。
/// - SQL 别名映射——本仓 EnableUnderLine = false,别名写错会静默映射为 null,
/// 行数照常返回但命中恒为 0(Rule 01 真实踩过一次)。
///
///
/// 不接 DB、不接 DI。真库行为已由实施前只读核验覆盖(390 行 / 40 行有 ETA / 命中 2 条),
/// 本文件锁定的是结构。
///
public class S8OrderDeliveryRule02Tests
{
private const long TenantId = 838257186181189;
private const string RuleCode = S8OrderDeliveryRuleDefinitions.OrderDeliveryDelayWarningCode;
private static readonly S8RuleCatalog Catalog =
new(new IS8RuleDefinitionSource[]
{
new S8PurchaseDeliveryRuleDefinitions(),
new S8OrderDeliveryRuleDefinitions()
});
private static S8RuleDefinition Definition => Catalog.GetRequired(RuleCode);
private static AdoS8WatchRule NewRule() => new()
{
Id = 900201,
RuleCode = RuleCode,
SceneCode = "S1",
WatchObjectType = S8OrderDeliveryRuleDefinitions.SalesOrderLineObjectType,
SourceObjectType = S8OrderDeliveryRuleDefinitions.SalesOrderLineObjectType,
Severity = "FOLLOW",
RuleType = S8OutOfRangeRuleEvaluator.RuleTypeCode,
DatasetCode = S8OrderDeliveryDatasetDefinitions.OrderDeliveryRiskCode
};
private static S8EffectiveRule Effective(AdoS8WatchRule rule) =>
S8EffectiveRule.Resolve(rule, Definition);
///
/// 构造一行订单行事实。 是 Provider 在 SQL 里算好的
/// DATEDIFF(sys_capacity_date, plan_date),此处显式传入以便逐值锁定判定边界。
///
private static S8OrderDeliveryDataProvider.OrderDeliveryRow Row(
string billNo, int entrySeq, DateTime planDate, DateTime? sysCapacityDate,
decimal? delayDays, decimal qty = 1000m, string itemName = "集控备机",
string customName = "内部客户") => new()
{
SourceObjectId = $"{billNo}#{entrySeq}",
RelatedObjectCode = billNo,
RelatedObjectName = customName,
DueAt = planDate,
DelayDays = delayDays,
BillNo = billNo,
EntrySeq = entrySeq,
PlanDate = planDate,
SysCapacityDate = sysCapacityDate,
Qty = qty,
ItemNumber = "IT-0001",
ItemName = itemName,
CustomNo = "C-0001",
CustomName = customName,
OrderBillNo = billNo
};
private static S8MonitoringRowSet RowSet(params S8OrderDeliveryDataProvider.OrderDeliveryRow[] rows) =>
S8MonitoringRowSet.FromRows(
rows.Select(r => S8MonitoringRow.FromValues(S8OrderDeliveryDataProvider.ToCanonicalValues(r))));
/// 去掉块注释与行注释后的 SQL —— 断言只应看真正会执行的文本。
private static string SqlWithoutComments() =>
Regex.Replace(
Regex.Replace(S8OrderDeliveryDataProvider.Sql, @"/\*.*?\*/", " ", RegexOptions.Singleline),
@"--[^\n]*", " ");
// ============================================================
// A. 数据集定义与 Provider 的一致性
// ============================================================
[Fact]
public void T1_Dataset_IsDeclared_WithOutOfRangeCapabilityOnly()
{
var definition = Assert.Single(new S8OrderDeliveryDatasetDefinitions().GetDefinitions());
Assert.Equal(S8OrderDeliveryDatasetDefinitions.OrderDeliveryRiskCode, definition.DatasetCode);
Assert.Equal(S8DatasetStatus.Defined, definition.Status);
var c = definition.Capabilities;
Assert.True(c.SupportsOutOfRange);
Assert.True(c.HasMeasuredValue);
Assert.True(c.HasSourceObjectId);
Assert.True(c.HasRelatedObjectCode);
// TIMEOUT / SHORTAGE 必须关闭:本数据集不表达「到期日已过」也不表达「数量缺口」。
// 多声明一项能力会让配置页把跑不通的规则类型列成可选,用户配完才在运行期失败。
Assert.False(c.SupportsTimeout);
Assert.False(c.SupportsShortage);
}
[Fact]
public void T2_Provider_And_Catalog_ShareTheSameCapabilityInstance()
{
var provider = new S8OrderDeliveryDataProvider(null!, null!);
var definition = Assert.Single(new S8OrderDeliveryDatasetDefinitions().GetDefinitions());
// 同一实例而非"值相等":两处各写一份能力声明迟早会漂移,
// 而漂移的表现是 Enable Gate 与 evaluator 对同一数据集有不同认知。
Assert.Same(definition.Capabilities, provider.Capabilities);
Assert.Equal(definition.DatasetCode, provider.DatasetCode);
}
[Fact]
public void T3_RuleDefinition_PointsAtTheRegisteredDataset()
{
Assert.Equal(S8OrderDeliveryDatasetDefinitions.OrderDeliveryRiskCode, Definition.DatasetCode);
Assert.Equal(new S8OrderDeliveryDataProvider(null!, null!).DatasetCode, Definition.DatasetCode);
}
[Fact]
public void T4_RuleCatalog_AcceptsBothRules_WithoutCodeCollision()
{
// Catalog 构造期即做完整性校验 + 重复 rule_code 检测;能构造出来本身就是断言。
Assert.True(Catalog.IsDefined(RuleCode));
Assert.True(Catalog.IsDefined(S8PurchaseDeliveryRuleDefinitions.PurchaseDeliveryDateDelayCode));
Assert.Equal(2, Catalog.Definitions.Count);
}
// ============================================================
// B. SQL 契约:ETA 来源、时间窗、身份粒度
// ============================================================
[Fact]
public void T5_Sql_RequiresRealEta_AndNeverSynthesizesOne()
{
var sql = SqlWithoutComments();
// ETA 必须来自源系统字段,且缺失即出局。
Assert.Contains("e.sys_capacity_date IS NOT NULL", sql, StringComparison.Ordinal);
Assert.Contains("e.sys_capacity_date > e.plan_date", sql, StringComparison.Ordinal);
// 以下任何一个出现,都意味着有人在自造 ETA:
// DATE_ADD / DATE_SUB / INTERVAL → 用「交期前 N 天」冒充预测
// AVG → 用历史均值造 ETA
// QtyCompleted / work_ord → 用工单完工量倒推(该列真库 267 行全为 0)
// deliver_count → 已发数量,真库 100% 为空
foreach (var forbidden in new[]
{
"DATE_ADD", "DATE_SUB", "INTERVAL", "AVG(",
"QtyCompleted", "qty_completed", "work_ord", "WorkOrd", "deliver_count"
})
{
Assert.DoesNotContain(forbidden, sql, StringComparison.OrdinalIgnoreCase);
}
}
[Fact]
public void T6_Sql_OnlyLooksAtOrdersThatHaveNotComeDueYet()
{
var sql = SqlWithoutComments();
// 这一条是「预警」与「逾期清单」的分界。去掉它,真库 385 条历史逾期单会一次涌入,
// 且因为永远不会再变成"未逾期",也永远不会恢复。
Assert.Contains("e.plan_date >= NOW()", sql, StringComparison.Ordinal);
// 时间基准必须与被比较的日期同源(都在库里)。混用应用时钟会在跨时区部署时
// 把"今天到期"判成"已过期",而本规则的价值恰恰建立在"还没到期"上。
Assert.DoesNotContain("@Now", sql, StringComparison.OrdinalIgnoreCase);
}
[Fact]
public void T7_Sql_ScopesByTenant_AndExcludesClosedOrDeletedOrders()
{
var sql = SqlWithoutComments();
Assert.Contains("e.tenant_id = @TenantId", sql, StringComparison.Ordinal);
Assert.Contains("o.closed = 0", sql, StringComparison.Ordinal);
Assert.Contains("o.IsDeleted = 0", sql, StringComparison.Ordinal);
Assert.Contains("e.IsDeleted = 0", sql, StringComparison.Ordinal);
// 租户是唯一的安全边界(Phase 1 拍板)。补 factory_id 过滤会让规则恒返 0 行且不报错。
Assert.DoesNotContain("factory_id", sql, StringComparison.OrdinalIgnoreCase);
}
[Fact]
public void T8_Sql_IsReadOnly()
{
var sql = SqlWithoutComments();
// 必须按整词匹配:软删列名 IsDeleted 内含 "Delete",子串匹配会把一条只读 SQL 判成写操作。
foreach (var write in new[] { "INSERT", "UPDATE", "DELETE", "REPLACE", "TRUNCATE", "ALTER", "DROP" })
Assert.False(Regex.IsMatch(sql, $@"\b{write}\b", RegexOptions.IgnoreCase),
$"取数 SQL 中出现写操作关键字 {write};本 Provider 只允许 SELECT");
}
[Fact]
public void T9_Sql_UsesOrderLineGrain_NotOrderGrain()
{
var sql = SqlWithoutComments();
// 身份 = 单号 + 行号。退化成单号会让同一张订单的多个风险行只留下一条异常。
Assert.Contains("CONCAT(e.bill_no, '#', e.entry_seq)", sql, StringComparison.Ordinal);
Assert.Contains("e.entry_seq IS NOT NULL", sql, StringComparison.Ordinal);
Assert.Contains("e.bill_no <> ''", sql, StringComparison.Ordinal);
// 明细挂在 crm_seorderentry 上;主表只用来取客户与关闭状态。
Assert.Contains("FROM crm_seorderentry e", sql, StringComparison.Ordinal);
Assert.Contains("JOIN crm_seorder o ON o.Id = e.seorder_id", sql, StringComparison.Ordinal);
}
[Fact]
public void T10_Sql_DoesNotReadProgress_BecauseItIsNotCompletionRate()
{
// crm_seorderentry.progress 是字符串状态码(0=再评审 1=新建 2=评审 3=确认),
// 不是完成百分比。把它当进度用会得到一个看起来合理、实际无意义的判据。
Assert.DoesNotContain("progress", SqlWithoutComments(), StringComparison.OrdinalIgnoreCase);
}
// ============================================================
// C. SQL 别名 ↔ POCO 映射(EnableUnderLine = false 的静默失败防线)
// ============================================================
[Fact]
public void T11_EverySelectAlias_MapsToRowProperty_AndViceVersa()
{
var aliases = Regex
.Matches(S8OrderDeliveryDataProvider.Sql, @"\bAS\s+([A-Za-z_][A-Za-z0-9_]*)", RegexOptions.IgnoreCase)
.Select(m => m.Groups[1].Value)
.ToArray();
var props = typeof(S8OrderDeliveryDataProvider.OrderDeliveryRow)
.GetProperties(BindingFlags.Public | BindingFlags.Instance)
.Select(p => p.Name)
.ToArray();
Assert.NotEmpty(aliases);
// Ordinal 比较:SqlSugar 的名字匹配不该靠"大概能对上"来赌。
var unmapped = aliases.Where(a => !props.Contains(a, StringComparer.Ordinal)).ToArray();
Assert.True(unmapped.Length == 0,
"以下 SQL 别名在 OrderDeliveryRow 上找不到同名属性,SqlSugar 会静默映射为 null:\n "
+ string.Join("\n ", unmapped));
var uncovered = props.Where(p => !aliases.Contains(p, StringComparer.Ordinal)).ToArray();
Assert.True(uncovered.Length == 0,
"以下属性没有任何 SQL 别名覆盖,取数后恒为 null:\n " + string.Join("\n ", uncovered));
}
[Fact]
public void T12_CanonicalMapping_PutsDelayDaysIntoMeasuredValue()
{
var values = S8OrderDeliveryDataProvider.ToCanonicalValues(
Row("SO202609030003", 1, new DateTime(2026, 9, 30), new DateTime(2026, 10, 12), 12m));
// measured_value 是判定输入;放错列 = evaluator 拿不到值 = 命中恒为 0。
Assert.Equal(12m, Assert.IsType(values[S8CanonicalColumns.MeasuredValue]));
Assert.Equal("SO202609030003#1", values[S8CanonicalColumns.SourceObjectId]);
Assert.Equal("SO202609030003", values[S8CanonicalColumns.RelatedObjectCode]);
// due_at 随行输出供展示与排序,但不参与判定(数据集能力里 SupportsTimeout=false)。
Assert.Equal(new DateTime(2026, 9, 30), values[S8CanonicalColumns.DueAt]);
// 两个原始日期必须一并落 payload:延期天数是差值,脱离两端就无法复盘。
Assert.Equal(new DateTime(2026, 9, 30), values["plan_date"]);
Assert.Equal(new DateTime(2026, 10, 12), values["sys_capacity_date"]);
}
[Fact]
public void T13_DedupKeyBudget_LeavesRoomForRealOrderLineIds()
{
var request = new S8MonitoringDataRequest
{
TenantId = TenantId,
DatasetCode = S8OrderDeliveryDatasetDefinitions.OrderDeliveryRiskCode,
RuleCode = RuleCode,
RuleType = S8OutOfRangeRuleEvaluator.RuleTypeCode
};
var budget = S8OrderDeliveryDataProvider.ResolveSourceObjectIdBudget(request);
// 预算随租户 / 规则编码变化,故现算而不是写死。真实身份形如 SO202609030003#1(16 字符)。
Assert.True(budget >= "SO202609030003#1".Length,
$"dedup_key 预算 {budget} 已经容不下真实订单行标识,Provider 会开始静默跳过行");
var expectedPrefix =
$"T{TenantId}:R{RuleCode}:{S8OrderDeliveryRuleDefinitions.SalesOrderLineObjectType}:";
Assert.Equal(
S8OrderDeliveryDataProvider.DedupKeyMaxLength - expectedPrefix.Length, budget);
}
// ============================================================
// D. 判定:越界方向、边界值、身份
// ============================================================
[Fact]
public void T14_Hits_WhenSystemEtaIsLaterThanCustomerDueDate()
{
// 真库 dry-run 的两条命中之一:SO202609030003#1,要求 09-30,系统建议 10-12,晚 12 天。
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
RowSet(Row("SO202609030003", 1, new DateTime(2026, 9, 30), new DateTime(2026, 10, 12), 12m)),
Effective(NewRule()), TenantId, new DateTime(2026, 9, 7));
var hit = Assert.Single(hits);
Assert.Equal("ORDER_DELIVERY_DELAY_WARNING", hit.ExceptionTypeCode);
Assert.Equal("SALES_ORDER_LINE", hit.SourceObjectType);
Assert.Equal("SO202609030003#1", hit.SourceObjectId);
Assert.Equal("SO202609030003", hit.RelatedObjectCode);
Assert.Equal("S1", hit.SceneCode);
Assert.Equal("FOLLOW", hit.Severity);
Assert.Equal(
$"T{TenantId}:R{RuleCode}:SALES_ORDER_LINE:SO202609030003#1", hit.DedupKey);
// 方向与偏差必须落 payload:业务看到的"晚几天"就是这个 deviation。
Assert.Contains("\"direction\":\"ABOVE_UPPER\"", hit.SourcePayload, StringComparison.Ordinal);
Assert.Contains("\"deviation\":12", hit.SourcePayload, StringComparison.Ordinal);
Assert.Contains("delay_days", hit.SourcePayload, StringComparison.Ordinal);
}
[Fact]
public void T15_NoHit_WhenEtaEqualsDueDate()
{
// 上限为 0、容差为 0:正好赶上不算延期。这是边界,写错一个符号就会把
// 全部"刚好按期"的订单报成异常。
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
RowSet(Row("SO-ONTIME", 1, new DateTime(2026, 9, 30), new DateTime(2026, 9, 30), 0m)),
Effective(NewRule()), TenantId, new DateTime(2026, 9, 7));
Assert.Empty(hits);
}
[Fact]
public void T16_NoHit_WhenEtaIsEarlierThanDueDate()
{
// 提前完成是好事。LowerBound 未设 → 不存在"太早也算异常"这条判据。
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
RowSet(Row("SO-EARLY", 1, new DateTime(2026, 9, 30), new DateTime(2026, 9, 20), -10m)),
Effective(NewRule()), TenantId, new DateTime(2026, 9, 7));
Assert.Empty(hits);
Assert.Null(Definition.OutOfRange!.LowerBound);
}
[Fact]
public void T17_NoHit_WhenEtaIsMissing()
{
// 没有 ETA = 没有证据。SQL 已经滤掉这类行,此处再锁一次判定层:
// 即便将来有人放宽 SQL,evaluator 也不会凭空判它延期。
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
RowSet(Row("SO-NO-ETA", 1, new DateTime(2026, 9, 30), null, null)),
Effective(NewRule()), TenantId, new DateTime(2026, 9, 7));
Assert.Empty(hits);
}
[Fact]
public void T18_EachOrderLine_GetsItsOwnException()
{
// 真库 dry-run 的两条命中分属两张订单;这里用同一张单的两行,
// 锁住"同单多行不会被折叠成一条"。
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
RowSet(
Row("SO202609030004", 1, new DateTime(2026, 9, 30), new DateTime(2026, 10, 12), 12m),
Row("SO202609030004", 2, new DateTime(2026, 10, 15), new DateTime(2026, 10, 20), 5m)),
Effective(NewRule()), TenantId, new DateTime(2026, 9, 7));
Assert.Equal(2, hits.Count);
Assert.Equal(2, hits.Select(h => h.DedupKey).Distinct(StringComparer.Ordinal).Count());
Assert.Contains(hits, h => h.SourceObjectId == "SO202609030004#1");
Assert.Contains(hits, h => h.SourceObjectId == "SO202609030004#2");
}
// ============================================================
// E. 规则定义契约
// ============================================================
[Fact]
public void T19_Rule_IsOutOfRange_WithZeroUpperBoundAndNoInventedTolerance()
{
Assert.Equal(S8OutOfRangeRuleEvaluator.RuleTypeCode, Definition.RuleType);
var semantics = Definition.OutOfRange!;
Assert.Equal(0m, semantics.UpperBound);
// 容差非 0 意味着"晚 N 天以内不报"——本批没有任何业务依据支持这样一个数字,
// 凭空填值会静默过滤掉真实风险。要放宽必须由业务给出天数。
Assert.Equal(0m, semantics.ToleranceAbs);
Assert.Equal(0m, semantics.ToleranceRatio);
// 行内上下限列未启用:上限是"不延期"这个定义本身,不随行变化。
Assert.Null(semantics.UpperBoundColumn);
Assert.Null(semantics.LowerBoundColumn);
}
[Fact]
public void T20_Rule_DeclaresAllFourReadinessGates()
{
var policy = Definition.Parameters!;
// 每一条都对应一种运行期静默断裂,理由见规则定义处的注释。
Assert.True(policy.RequiresDepartmentDefaultsForEnable); // 数据集无部门列 → 建单必失败
Assert.True(policy.RequiresHandlerPoolForEnable); // 无人认领
Assert.True(policy.RequiresVerification); // 复核候选为空,卡在 IN_PROGRESS
Assert.True(policy.SupportsTimeoutEscalation); // SLA 240 分钟 → 必进升级扫描
// 预警不是事故:客户交期尚未到达,仍有处置窗口。与异常类型自身默认严重度一致。
Assert.Equal("FOLLOW", policy.SeverityDefault);
}
[Fact]
public void T21_Rule_CarriesBusinessFacingCopy_WithoutImplementationLeakage()
{
// 配置页展示的是"这条规则按什么判",不是"它怎么实现的"。
Assert.False(string.IsNullOrWhiteSpace(Definition.JudgementSummary));
Assert.False(string.IsNullOrWhiteSpace(Definition.DedupIdentitySummary));
foreach (var leak in new[]
{
"crm_seorderentry", "crm_seorder", "DATEDIFF",
"sys_capacity_date", "plan_date", "measured_value", "SQL"
})
{
Assert.DoesNotContain(leak, Definition.JudgementSummary!, StringComparison.OrdinalIgnoreCase);
Assert.DoesNotContain(leak, Definition.DedupIdentitySummary!, StringComparison.OrdinalIgnoreCase);
}
}
}