f2efeb37b7
Tasks 5 and 6 of the Phase 2 plan, committed together because their test
fallout is entangled — several fixtures construct both stores.
StoreAndForwardStorage and SiteStorageService now take ILocalDb. Connections
come from ILocalDb.CreateConnection(), which hands out an already-open,
pragma-configured connection carrying the zb_hlc_next() UDF the capture triggers
call; a raw connection would lack the UDF and every write to a replicated table
would fail closed. Deleted with the connection strings: S&F's
EnsureDatabaseDirectoryExists and its per-open busy_timeout pragma, and the site
service's BusyTimeoutFloorSeconds normalization — LocalDb owns all of it now.
DI: AddSiteRuntime's string overload is gone (nothing left to supply), so the
Host calls the no-arg form. ScadaBridge:Database:SiteDbPath and
StoreAndForwardOptions.SqliteDbPath survive only as the migrator's source
locations in Tasks 8/9.
Two things the plan did not anticipate, both worth reading:
1. FOUND A REAL LATENT DEFECT, from Phase 1, now fixed. The plan assumed
directory creation simply moved to LocalDb along with file ownership. It did
not: the LocalDb library never creates the parent directory, and
SqliteLocalDb opens the file eagerly in its constructor — so a missing
directory is a hard boot failure ("SQLite Error 14: unable to open database
file"), not a degraded start. The default site config points at the RELATIVE
path ./data/site-localdb.db, so any site node without a pre-existing data/
directory fails to boot. The docker rig escapes only because its volume mount
happens to create /app/data — a coincidence that would have hidden this until
a bare-metal or fresh deployment. This has been latent since Phase 1 made
LocalDb:Path required; deleting S&F's EnsureDatabaseDirectoryExists here
would have widened it. Re-established the guarantee at the layer that now
owns the path (SiteLocalDbDirectory.Ensure, called before AddZbLocalDb) and
pinned it with SiteLocalDbDirectoryTests. Non-vacuity is not assumed: two
tests written against the wrong assumption failed with exactly this
SQLite Error 14 before the fix existed.
2. Test fallout was ~7x the plan's estimate. The plan named "fixtures" in one
project; the constructor change actually reaches 40 files across 7 test
projects, and most used Mode=Memory;Cache=Shared — which LocalDb has no
equivalent for, so every one had to move to a real temp file. Rather than
copy the Phase 1 TestLocalDb fixture into 7 projects, added a shared
tests/ZB.MOM.WW.ScadaBridge.TestSupport library (not a test project) so the
WAL-sidecar cleanup and the "real, not stubbed" rationale live in one place.
Retargeted rather than deleted, in both directions: the S&F WAL test now asserts
against the LocalDb-backed store (WAL genuinely is LocalDb's job), while the
directory-creation test moved to Host.Tests (that guarantee is NOT LocalDb's).
SiteStorageServiceTests.Initialize_EnablesWalJournalMode got the same treatment.
DeploymentManagerMediumFindingsTests induced a persistence failure via an
unopenable path, which no longer reaches the assertion since the fixture now
throws first; it induces the same failure shape via an uninitialized store.
Verified: full solution build 0 warnings; SiteRuntime 532, Host 318,
AuditLog 355, ExternalSystemGateway 142, HealthMonitoring 97,
StoreAndForward 153 — 1597 passed, 0 failed.
Claude-Session: https://claude.ai/code/session_01BL2Vu1ESDQ9SCN4gVKkdts
339 lines
13 KiB
C#
339 lines
13 KiB
C#
using Microsoft.Extensions.Logging;
|
|
using Microsoft.Extensions.Logging.Abstractions;
|
|
using ZB.MOM.WW.ScadaBridge.SiteRuntime.Persistence;
|
|
using ZB.MOM.WW.ScadaBridge.TestSupport;
|
|
|
|
namespace ZB.MOM.WW.ScadaBridge.SiteRuntime.Tests.Persistence;
|
|
|
|
/// <summary>
|
|
/// Tests for SiteStorageService using file-based SQLite (temp files).
|
|
/// Validates the schema, CRUD operations, and constraint behavior.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// The service now takes an <c>ILocalDb</c> rather than a connection string, so the fixture
|
|
/// is a real temp-file LocalDb. It stays a file (never in-memory): LocalDb has no in-memory
|
|
/// mode, and the connections it hands out carry the pragmas and the <c>zb_hlc_next()</c> UDF
|
|
/// the site tables' capture triggers depend on.
|
|
/// </remarks>
|
|
public class SiteStorageServiceTests : IAsyncLifetime, IDisposable
|
|
{
|
|
private readonly TestLocalDb _localDb;
|
|
private SiteStorageService _storage = null!;
|
|
|
|
public SiteStorageServiceTests()
|
|
{
|
|
_localDb = TestLocalDb.CreateTemp("site-storage-test");
|
|
}
|
|
|
|
public async Task InitializeAsync()
|
|
{
|
|
_storage = new SiteStorageService(
|
|
_localDb.Db,
|
|
NullLogger<SiteStorageService>.Instance);
|
|
await _storage.InitializeAsync();
|
|
}
|
|
|
|
public Task DisposeAsync() => Task.CompletedTask;
|
|
|
|
public void Dispose()
|
|
{
|
|
// Dispose first — the master connection anchors the WAL, so the sidecars
|
|
// cannot be removed while it is open.
|
|
var path = _localDb.Path;
|
|
_localDb.Dispose();
|
|
TestLocalDb.DeleteFiles(path);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task InitializeAsync_CreatesTablesWithoutError()
|
|
{
|
|
// Already called in InitializeAsync — just verify no exception
|
|
// Call again to verify idempotency (CREATE IF NOT EXISTS)
|
|
await _storage.InitializeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Initialize_EnablesWalJournalMode()
|
|
{
|
|
// ── Invariant that moved owner ──
|
|
// WAL used to be SiteStorageService's own job (an explicit PRAGMA in
|
|
// InitializeAsync). LocalDb now owns the file and its pragmas, so the service no
|
|
// longer sets it. The guarantee production depends on has NOT moved: without WAL
|
|
// the site's concurrent readers and writers start serializing on "database is
|
|
// locked". So rather than deleting this test with the code that used to provide
|
|
// the pragma, it is retargeted to assert the same guarantee against the new,
|
|
// LocalDb-backed service. journal_mode is persistent and file-scoped, so any
|
|
// connection observes it. A file-backed DB is still required — WAL is not
|
|
// available for :memory: databases, which is also why LocalDb has no in-memory mode.
|
|
await using var conn = _storage.CreateConnection(); // already open — do NOT call OpenAsync
|
|
await using var cmd = conn.CreateCommand();
|
|
cmd.CommandText = "PRAGMA journal_mode;";
|
|
var mode = (string)(await cmd.ExecuteScalarAsync())!;
|
|
Assert.Equal("wal", mode.ToLowerInvariant());
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreAndRetrieve_DeployedConfig_RoundTrips()
|
|
{
|
|
await _storage.StoreDeployedConfigAsync(
|
|
"Pump1", "{\"test\":true}", "dep-001", "sha256:abc", isEnabled: true);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
|
|
Assert.Single(configs);
|
|
Assert.Equal("Pump1", configs[0].InstanceUniqueName);
|
|
Assert.Equal("{\"test\":true}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-001", configs[0].DeploymentId);
|
|
Assert.Equal("sha256:abc", configs[0].RevisionHash);
|
|
Assert.True(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreDeployedConfig_Upserts_OnConflict()
|
|
{
|
|
await _storage.StoreDeployedConfigAsync(
|
|
"Pump1", "{\"v\":1}", "dep-001", "sha256:aaa", isEnabled: true);
|
|
await _storage.StoreDeployedConfigAsync(
|
|
"Pump1", "{\"v\":2}", "dep-002", "sha256:bbb", isEnabled: false);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
|
|
Assert.Single(configs);
|
|
Assert.Equal("{\"v\":2}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-002", configs[0].DeploymentId);
|
|
Assert.False(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task RemoveDeployedConfig_RemovesConfigAndOverrides()
|
|
{
|
|
await _storage.StoreDeployedConfigAsync(
|
|
"Pump1", "{}", "dep-001", "sha256:aaa", isEnabled: true);
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "100");
|
|
|
|
await _storage.RemoveDeployedConfigAsync("Pump1");
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
var overrides = await _storage.GetStaticOverridesAsync("Pump1");
|
|
|
|
Assert.Empty(configs);
|
|
Assert.Empty(overrides);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task SetInstanceEnabled_UpdatesFlag()
|
|
{
|
|
await _storage.StoreDeployedConfigAsync(
|
|
"Pump1", "{}", "dep-001", "sha256:aaa", isEnabled: true);
|
|
|
|
await _storage.SetInstanceEnabledAsync("Pump1", false);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.False(configs[0].IsEnabled);
|
|
|
|
await _storage.SetInstanceEnabledAsync("Pump1", true);
|
|
|
|
configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.True(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task SetInstanceEnabled_NonExistent_DoesNotThrow()
|
|
{
|
|
// Should not throw for a missing instance
|
|
await _storage.SetInstanceEnabledAsync("DoesNotExist", true);
|
|
}
|
|
|
|
// ── Static Override Tests ──
|
|
|
|
[Fact]
|
|
public async Task SetAndGetStaticOverride_RoundTrips()
|
|
{
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "98.6");
|
|
|
|
var overrides = await _storage.GetStaticOverridesAsync("Pump1");
|
|
|
|
Assert.Single(overrides);
|
|
Assert.Equal("98.6", overrides["Temperature"]);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task SetStaticOverride_Upserts_OnConflict()
|
|
{
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "98.6");
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "100.0");
|
|
|
|
var overrides = await _storage.GetStaticOverridesAsync("Pump1");
|
|
|
|
Assert.Single(overrides);
|
|
Assert.Equal("100.0", overrides["Temperature"]);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task ClearStaticOverrides_RemovesAll()
|
|
{
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "98.6");
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Pressure", "50.0");
|
|
|
|
await _storage.ClearStaticOverridesAsync("Pump1");
|
|
|
|
var overrides = await _storage.GetStaticOverridesAsync("Pump1");
|
|
Assert.Empty(overrides);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task GetStaticOverrides_IsolatedPerInstance()
|
|
{
|
|
await _storage.SetStaticOverrideAsync("Pump1", "Temperature", "98.6");
|
|
await _storage.SetStaticOverrideAsync("Pump2", "Pressure", "50.0");
|
|
|
|
var pump1 = await _storage.GetStaticOverridesAsync("Pump1");
|
|
var pump2 = await _storage.GetStaticOverridesAsync("Pump2");
|
|
|
|
Assert.Single(pump1);
|
|
Assert.Single(pump2);
|
|
Assert.True(pump1.ContainsKey("Temperature"));
|
|
Assert.True(pump2.ContainsKey("Pressure"));
|
|
}
|
|
|
|
[Fact]
|
|
public async Task MultipleInstances_IndependentLifecycle()
|
|
{
|
|
await _storage.StoreDeployedConfigAsync("Pump1", "{}", "d1", "h1", true);
|
|
await _storage.StoreDeployedConfigAsync("Pump2", "{}", "d2", "h2", true);
|
|
await _storage.StoreDeployedConfigAsync("Pump3", "{}", "d3", "h3", false);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Equal(3, configs.Count);
|
|
|
|
await _storage.RemoveDeployedConfigAsync("Pump2");
|
|
|
|
configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Equal(2, configs.Count);
|
|
Assert.DoesNotContain(configs, c => c.InstanceUniqueName == "Pump2");
|
|
}
|
|
|
|
// ── Negative Tests ──
|
|
|
|
[Fact]
|
|
public async Task Schema_DoesNotContain_AlarmStateTable()
|
|
{
|
|
// Per design: no alarm state table in site SQLite
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
var overrides = await _storage.GetStaticOverridesAsync("nonexistent");
|
|
|
|
Assert.Empty(configs);
|
|
Assert.Empty(overrides);
|
|
}
|
|
|
|
// ── Task 13: StoreDeployedConfigIfNewerAsync (guarded standby write) ──
|
|
|
|
/// <summary>
|
|
/// Seeds a deployed_configurations row with an explicit deployed_at timestamp using the same
|
|
/// "O" format the service uses, so tests can establish deterministic older/newer/equal rows.
|
|
/// </summary>
|
|
private async Task SeedDeployedConfigAsync(
|
|
string instanceName, string configJson, string deploymentId,
|
|
string revisionHash, bool isEnabled, DateTimeOffset deployedAt)
|
|
{
|
|
// Seeded through the service's own (already-open) LocalDb connection: a raw
|
|
// SqliteConnection would lack the pragmas and the zb_hlc_next() UDF the site
|
|
// tables' capture triggers call.
|
|
await using var conn = _storage.CreateConnection();
|
|
await using var cmd = conn.CreateCommand();
|
|
cmd.CommandText = @"
|
|
INSERT INTO deployed_configurations
|
|
(instance_unique_name, config_json, deployment_id, revision_hash, is_enabled, deployed_at)
|
|
VALUES (@name, @json, @depId, @hash, @enabled, @deployedAt)
|
|
ON CONFLICT(instance_unique_name) DO UPDATE SET
|
|
config_json = excluded.config_json,
|
|
deployment_id = excluded.deployment_id,
|
|
revision_hash = excluded.revision_hash,
|
|
is_enabled = excluded.is_enabled,
|
|
deployed_at = excluded.deployed_at";
|
|
cmd.Parameters.AddWithValue("@name", instanceName);
|
|
cmd.Parameters.AddWithValue("@json", configJson);
|
|
cmd.Parameters.AddWithValue("@depId", deploymentId);
|
|
cmd.Parameters.AddWithValue("@hash", revisionHash);
|
|
cmd.Parameters.AddWithValue("@enabled", isEnabled ? 1 : 0);
|
|
cmd.Parameters.AddWithValue("@deployedAt", deployedAt.ToString("O"));
|
|
await cmd.ExecuteNonQueryAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreDeployedConfigIfNewer_NoExistingRow_Inserts()
|
|
{
|
|
var at = DateTimeOffset.UtcNow;
|
|
|
|
await _storage.StoreDeployedConfigIfNewerAsync(
|
|
"Pump1", "{\"v\":1}", "dep-001", "sha256:aaa", isEnabled: true, deployedAtOverride: at);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Single(configs);
|
|
Assert.Equal("Pump1", configs[0].InstanceUniqueName);
|
|
Assert.Equal("{\"v\":1}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-001", configs[0].DeploymentId);
|
|
Assert.Equal("sha256:aaa", configs[0].RevisionHash);
|
|
Assert.True(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreDeployedConfigIfNewer_ExistingOlderRow_Overwrites()
|
|
{
|
|
var olderAt = new DateTimeOffset(2026, 1, 1, 10, 0, 0, TimeSpan.Zero);
|
|
var newerAt = new DateTimeOffset(2026, 1, 1, 11, 0, 0, TimeSpan.Zero);
|
|
|
|
await SeedDeployedConfigAsync("Pump1", "{\"v\":1}", "dep-001", "sha256:aaa", true, olderAt);
|
|
|
|
await _storage.StoreDeployedConfigIfNewerAsync(
|
|
"Pump1", "{\"v\":2}", "dep-002", "sha256:bbb", isEnabled: false, deployedAtOverride: newerAt);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Single(configs);
|
|
Assert.Equal("{\"v\":2}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-002", configs[0].DeploymentId);
|
|
Assert.Equal("sha256:bbb", configs[0].RevisionHash);
|
|
Assert.False(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreDeployedConfigIfNewer_ExistingNewerRow_IsNoop()
|
|
{
|
|
var newerAt = new DateTimeOffset(2026, 6, 1, 12, 0, 0, TimeSpan.Zero);
|
|
var olderAt = new DateTimeOffset(2026, 5, 1, 12, 0, 0, TimeSpan.Zero);
|
|
|
|
// Seed the row that is already newer than what the standby would write
|
|
await SeedDeployedConfigAsync("Pump1", "{\"v\":2}", "dep-002", "sha256:bbb", false, newerAt);
|
|
|
|
// Guarded write with an older timestamp — must be a NO-OP
|
|
await _storage.StoreDeployedConfigIfNewerAsync(
|
|
"Pump1", "{\"v\":1}", "dep-001", "sha256:aaa", isEnabled: true, deployedAtOverride: olderAt);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Single(configs);
|
|
// The newer seeded row must survive unchanged
|
|
Assert.Equal("{\"v\":2}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-002", configs[0].DeploymentId);
|
|
Assert.Equal("sha256:bbb", configs[0].RevisionHash);
|
|
Assert.False(configs[0].IsEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task StoreDeployedConfigIfNewer_EqualDeployedAt_IsNoop()
|
|
{
|
|
var at = new DateTimeOffset(2026, 3, 15, 9, 30, 0, TimeSpan.Zero);
|
|
|
|
await SeedDeployedConfigAsync("Pump1", "{\"v\":1}", "dep-001", "sha256:aaa", true, at);
|
|
|
|
// Guarded write with the IDENTICAL timestamp — must be a NO-OP (> not >=)
|
|
await _storage.StoreDeployedConfigIfNewerAsync(
|
|
"Pump1", "{\"v\":2}", "dep-002", "sha256:bbb", isEnabled: false, deployedAtOverride: at);
|
|
|
|
var configs = await _storage.GetAllDeployedConfigsAsync();
|
|
Assert.Single(configs);
|
|
// Original row preserved
|
|
Assert.Equal("{\"v\":1}", configs[0].ConfigJson);
|
|
Assert.Equal("dep-001", configs[0].DeploymentId);
|
|
}
|
|
}
|