using System.Data;
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 Xunit;
namespace Admin.NET.Test.S8;
///
/// S8-DATASET-PROVIDER-FOUNDATION-1 契约回归。
///
/// 本批目标是建立 Rule → DataAccessMode → Provider → Canonical Row → Evaluator 的稳定边界。
/// 本测试类锁定四件事:
/// A. Legacy 兼容:DataAccessMode 为空(132 条历史规则的现状)必须解析为 LEGACY_SQL;
/// B. 标准数据集契约:三个 evaluator 的判定核心可在完全没有 SQL / DataTable 的情况下运行;
/// C. Tenant/Factory 必须由请求显式携带,不得隐式取值;
/// D. 旧行 DataAccessMode/DatasetCode = NULL 不导致任何解析失败。
///
/// 不接 DB、不接 DI、不触发任何真实规则。
///
public class S8MonitoringDataContractTests
{
// ============================================================
// A / D. Legacy 兼容与向后兼容
// ============================================================
[Fact]
public void DataAccessMode_Null_ResolvesTo_LegacySql()
{
// 132 条历史规则 data_access_mode 列为 NULL,必须继续走原 SQL 路径。
Assert.Equal(S8DataAccessMode.LegacySql, S8DataAccessMode.Resolve(null));
}
[Fact]
public void DataAccessMode_EmptyOrWhitespace_ResolvesTo_LegacySql()
{
Assert.Equal(S8DataAccessMode.LegacySql, S8DataAccessMode.Resolve(""));
Assert.Equal(S8DataAccessMode.LegacySql, S8DataAccessMode.Resolve(" "));
}
[Fact]
public void DataAccessMode_StandardDataset_IsRecognized_CaseInsensitive()
{
Assert.Equal(S8DataAccessMode.StandardDataset, S8DataAccessMode.Resolve("STANDARD_DATASET"));
Assert.Equal(S8DataAccessMode.StandardDataset, S8DataAccessMode.Resolve("standard_dataset"));
}
[Fact]
public void DataAccessMode_UnknownValue_Throws_RatherThanSilentlyRunningLegacySql()
{
// 未知模式静默回落 LEGACY_SQL 会让配置错误伪装成"正常运行",因此必须显式失败。
var ex = Assert.Throws(() => S8DataAccessMode.Resolve("SOMETHING_ELSE"));
Assert.Equal("data_access_mode_invalid", ex.Reason);
}
// ============================================================
// Canonical Row / RowSet 表示层:必须与原 DataTable 读取语义等价
// ============================================================
[Fact]
public void RowSet_FromDataTable_PreservesAllColumns_ForPayloadDump()
{
// payload 依赖"把结果集所有列原样落进 JSON",因此 RowSet 必须保留全部列(含非 canonical 列)。
var table = new DataTable();
table.Columns.Add("source_object_id", typeof(string));
table.Columns.Add("vendor_specific_col", typeof(string));
var row = table.NewRow();
row["source_object_id"] = "SO-1";
row["vendor_specific_col"] = "keep-me";
table.Rows.Add(row);
var rowSet = S8MonitoringRowSet.FromDataTable(table);
Assert.Single(rowSet.Rows);
Assert.True(rowSet.HasColumn("source_object_id"));
Assert.True(rowSet.HasColumn("vendor_specific_col"));
Assert.Equal("keep-me", rowSet.Rows[0].Values["vendor_specific_col"]);
}
[Fact]
public void RowSet_HasColumn_False_ForAbsentColumn_DrivesParamsFallback()
{
// evaluator 的 canonical→params 回退依赖"结果集是否含 canonical 列"这一判断。
var table = new DataTable();
table.Columns.Add("planner_end_date", typeof(DateTime));
var rowSet = S8MonitoringRowSet.FromDataTable(table);
Assert.False(rowSet.HasColumn("due_at"));
Assert.True(rowSet.HasColumn("planner_end_date"));
}
[Fact]
public void Row_GetString_ReturnsNull_ForDbNull_AndTrims()
{
var table = new DataTable();
table.Columns.Add("a", typeof(string));
table.Columns.Add("b", typeof(string));
var r = table.NewRow();
r["a"] = " padded ";
r["b"] = DBNull.Value;
table.Rows.Add(r);
var row = S8MonitoringRowSet.FromDataTable(table).Rows[0];
Assert.Equal("padded", row.GetString("a"));
Assert.Null(row.GetString("b"));
Assert.Null(row.GetString("column_that_does_not_exist"));
}
[Fact]
public void Row_GetDecimal_And_GetDateTime_ParseFromStringLikeLegacyReader()
{
// 旧实现用 Convert.ToString + TryParse,标准 Provider 也可能给出强类型值,两者都要支持。
var row = S8MonitoringRow.FromValues(new Dictionary
{
["num_text"] = "12.5",
["num_typed"] = 7m,
["date_text"] = "2026-01-02 03:04:05",
["date_typed"] = new DateTime(2026, 1, 2, 3, 4, 5),
["not_a_number"] = "abc"
});
Assert.Equal(12.5m, row.GetDecimal("num_text"));
Assert.Equal(7m, row.GetDecimal("num_typed"));
Assert.Equal(new DateTime(2026, 1, 2, 3, 4, 5), row.GetDateTime("date_text"));
Assert.Equal(new DateTime(2026, 1, 2, 3, 4, 5), row.GetDateTime("date_typed"));
Assert.Null(row.GetDecimal("not_a_number"));
}
[Fact]
public void Row_NullValue_IsRealNull_NotTheStringLiteralNull()
{
var row = S8MonitoringRow.FromValues(new Dictionary { ["x"] = null });
Assert.Null(row.GetString("x"));
Assert.NotEqual("null", row.GetString("x"));
}
// ============================================================
// B. 标准数据集契约:evaluator 判定核心脱离 SQL 运行(本批最重要验收)
// ============================================================
private static AdoS8WatchRule NewRule(string ruleType) => new()
{
Id = 900001,
RuleCode = "UT_DATASET_RULE",
SceneCode = "S1",
WatchObjectType = "ORDER",
SourceObjectType = "ORDER",
Severity = "FOLLOW",
RuleType = ruleType
};
[Fact]
public void Timeout_EvaluateRows_ProducesHit_WithoutAnySql()
{
// 关键验收:输入是 canonical rows,没有 expression、没有 DataTable、没有数据源。
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = "SO-OVERDUE",
["related_object_code"] = "SO-OVERDUE",
["due_at"] = new DateTime(2026, 1, 1, 0, 0, 0),
["status"] = "RUNNING"
})
});
var parameters = S8TimeoutParams.Parse(
"""{"dueAtField":"due_at","statusField":"status","completedStates":["COMPLETED"],"exceptionTypeCode":"DELIVERY_DELAY"}""");
var hits = S8TimeoutRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("TIMEOUT"),
tenantId: 11, factoryId: 22, dataSourceId: 0,
detectedAt: new DateTime(2026, 6, 1, 0, 0, 0));
var hit = Assert.Single(hits);
Assert.Equal("SO-OVERDUE", hit.SourceObjectId);
Assert.Equal("ORDER", hit.SourceObjectType);
Assert.Equal("DELIVERY_DELAY", hit.ExceptionTypeCode);
Assert.Equal("T11:F22:RUT_DATASET_RULE:ORDER:SO-OVERDUE", hit.DedupKey);
}
[Fact]
public void Timeout_EvaluateRows_SkipsCompletedStates_SemanticsUnchanged()
{
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = "SO-DONE",
["related_object_code"] = "SO-DONE",
["due_at"] = new DateTime(2026, 1, 1),
["status"] = "COMPLETED"
})
});
var parameters = S8TimeoutParams.Parse(
"""{"dueAtField":"due_at","statusField":"status","completedStates":["COMPLETED"],"exceptionTypeCode":"X"}""");
var hits = S8TimeoutRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("TIMEOUT"), 11, 22, 0, new DateTime(2026, 6, 1));
Assert.Empty(hits);
}
[Fact]
public void Timeout_EvaluateRows_FallsBackToParamsColumn_WhenCanonicalAbsent()
{
// 历史未别名规则:结果集没有 due_at/status,只能按 params 指定的真实列名读取。
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["related_object_code"] = "WO-1",
["planner_end_date"] = new DateTime(2026, 1, 1),
["morder_state"] = "RUNNING"
})
});
var parameters = S8TimeoutParams.Parse(
"""{"dueAtField":"planner_end_date","statusField":"morder_state","exceptionTypeCode":"X"}""");
var hits = S8TimeoutRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("TIMEOUT"), 1, 1, 0, new DateTime(2026, 6, 1));
Assert.Single(hits);
Assert.Equal("WO-1", hits[0].SourceObjectId);
}
[Fact]
public void OutOfRange_EvaluateRows_AboveUpper_WithoutAnySql()
{
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = "ITEM-1",
["related_object_code"] = "ITEM-1",
["measured_value"] = 130m
})
});
var parameters = S8OutOfRangeParams.Parse(
"""{"measuredValueField":"measured_value","upperBound":100,"exceptionTypeCode":"QUALITY_OUT_OF_SPEC"}""");
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("OUT_OF_RANGE"), 11, 22, 0, DateTime.Now);
var hit = Assert.Single(hits);
Assert.Equal("ITEM-1", hit.SourceObjectId);
Assert.Equal("QUALITY_OUT_OF_SPEC", hit.ExceptionTypeCode);
Assert.Contains("超差", hit.Title);
}
[Fact]
public void OutOfRange_EvaluateRows_WithinBounds_NoHit()
{
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = "ITEM-OK",
["related_object_code"] = "ITEM-OK",
["measured_value"] = 50m
})
});
var parameters = S8OutOfRangeParams.Parse(
"""{"measuredValueField":"measured_value","upperBound":100,"lowerBound":10}""");
var hits = S8OutOfRangeRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("OUT_OF_RANGE"), 1, 1, 0, DateTime.Now);
Assert.Empty(hits);
}
[Fact]
public void Shortage_EvaluateRows_WithoutAnySql()
{
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["related_object_code"] = "PO-1",
["target_qty"] = 100m,
["actual_qty"] = 40m
})
});
var parameters = S8ShortageParams.Parse(
"""{"targetQtyField":"target_qty","actualQtyField":"actual_qty","exceptionTypeCode":"MATERIAL_SHORTAGE"}""");
var hits = S8ShortageRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("SHORTAGE"), 11, 22, 0, DateTime.Now);
var hit = Assert.Single(hits);
Assert.Equal("PO-1", hit.SourceObjectId);
Assert.Equal("MATERIAL_SHORTAGE", hit.ExceptionTypeCode);
}
[Fact]
public void EvaluateRows_PayloadStillContainsAllSourceColumns()
{
// 迁移后 payload 仍须保留结果集原始列(下游排查依赖它)。
var rowSet = S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = "SO-P",
["related_object_code"] = "SO-P",
["due_at"] = new DateTime(2026, 1, 1),
["status"] = "RUNNING",
["extra_business_column"] = "must-survive"
})
});
var parameters = S8TimeoutParams.Parse(
"""{"dueAtField":"due_at","statusField":"status","exceptionTypeCode":"X"}""");
var hits = S8TimeoutRuleEvaluator.EvaluateRows(
rowSet, parameters, NewRule("TIMEOUT"), 1, 1, 0, new DateTime(2026, 6, 1));
Assert.Contains("extra_business_column", hits[0].SourcePayload);
Assert.Contains("must-survive", hits[0].SourcePayload);
}
// ============================================================
// C. Tenant / Factory 显式传递
// ============================================================
[Fact]
public void DataRequest_CarriesExplicitTenantAndFactory()
{
var request = new S8MonitoringDataRequest
{
TenantId = 797403760988229,
FactoryId = 1,
DatasetCode = "UT_DATASET",
RuleId = 1,
RuleCode = "UT",
RuleType = "TIMEOUT"
};
Assert.Equal(797403760988229, request.TenantId);
Assert.Equal(1, request.FactoryId);
}
[Fact]
public void DataRequest_RejectsNonPositiveTenantOrFactory()
{
// 禁止 Provider 在缺少作用域时"猜"租户;缺失必须显式失败。
Assert.Throws(() =>
new S8MonitoringDataRequest { TenantId = 0, FactoryId = 1, DatasetCode = "D", RuleCode = "R", RuleType = "TIMEOUT" }.EnsureValid());
Assert.Throws(() =>
new S8MonitoringDataRequest { TenantId = 1, FactoryId = 0, DatasetCode = "D", RuleCode = "R", RuleType = "TIMEOUT" }.EnsureValid());
}
// ============================================================
// Registry / Capability 校验
// ============================================================
private sealed class FakeDatasetProvider : IS8MonitoringDataProvider
{
public string DatasetCode => "UT_FAKE_DATASET";
public S8DatasetCapabilities Capabilities => new() { SupportsTimeout = true };
public Task LoadAsync(S8MonitoringDataRequest request, CancellationToken cancellationToken = default)
{
request.EnsureValid();
return Task.FromResult(S8MonitoringRowSet.FromRows(new[]
{
S8MonitoringRow.FromValues(new Dictionary
{
["source_object_id"] = $"T{request.TenantId}-F{request.FactoryId}",
["related_object_code"] = "R",
["due_at"] = new DateTime(2026, 1, 1),
["status"] = "RUNNING"
})
}));
}
}
[Fact]
public void Registry_ResolvesRegisteredProvider()
{
var registry = new S8MonitoringDataProviderRegistry(new[] { new FakeDatasetProvider() });
Assert.True(registry.IsRegistered("UT_FAKE_DATASET"));
Assert.Equal("UT_FAKE_DATASET", registry.Resolve("UT_FAKE_DATASET").DatasetCode);
}
[Fact]
public void Registry_UnknownDatasetCode_Throws()
{
var registry = new S8MonitoringDataProviderRegistry(new[] { new FakeDatasetProvider() });
Assert.False(registry.IsRegistered("NO_SUCH_DATASET"));
var ex = Assert.Throws(() => registry.Resolve("NO_SUCH_DATASET"));
Assert.Equal("dataset_provider_not_registered", ex.Reason);
}
[Fact]
public void Capabilities_RejectRuleTypeTheDatasetCannotServe()
{
// TIMEOUT 规则挂到不提供 due_at 能力的 Dataset 上,必须在校验期被拒绝,
// 而不是运行期解析不到列后静默不命中。
var caps = new S8DatasetCapabilities { SupportsTimeout = false, SupportsOutOfRange = true };
Assert.False(caps.Supports(S8TimeoutRuleEvaluator.RuleTypeCode));
Assert.True(caps.Supports(S8OutOfRangeRuleEvaluator.RuleTypeCode));
}
[Fact]
public async Task Provider_ReceivesTenantAndFactory_NoImplicitContext()
{
var registry = new S8MonitoringDataProviderRegistry(new[] { new FakeDatasetProvider() });
var provider = registry.Resolve("UT_FAKE_DATASET");
var rowSet = await provider.LoadAsync(new S8MonitoringDataRequest
{
TenantId = 555,
FactoryId = 66,
DatasetCode = "UT_FAKE_DATASET",
RuleId = 1,
RuleCode = "UT",
RuleType = "TIMEOUT"
});
Assert.Equal("T555-F66", rowSet.Rows[0].GetString("source_object_id"));
}
[Fact]
public async Task EndToEnd_StandardDataset_FeedsEvaluator_WithoutSql()
{
// 本批最终验收:Provider → Canonical Row → Evaluator,全程无 SQL 字符串。
var registry = new S8MonitoringDataProviderRegistry(new[] { new FakeDatasetProvider() });
var provider = registry.Resolve("UT_FAKE_DATASET");
var rowSet = await provider.LoadAsync(new S8MonitoringDataRequest
{
TenantId = 11,
FactoryId = 22,
DatasetCode = "UT_FAKE_DATASET",
RuleId = 1,
RuleCode = "UT_DATASET_RULE",
RuleType = "TIMEOUT"
});
var hits = S8TimeoutRuleEvaluator.EvaluateRows(
rowSet,
S8TimeoutParams.Parse("""{"dueAtField":"due_at","statusField":"status","exceptionTypeCode":"X"}"""),
NewRule("TIMEOUT"), 11, 22, 0, new DateTime(2026, 6, 1));
Assert.Single(hits);
Assert.Equal("T11:F22:RUT_DATASET_RULE:ORDER:T11-F22", hits[0].DedupKey);
}
}