Task 31 — Симуляция шаблонов

Phase: 2 Status: done Owner: — Slug: template-simulation

Goal

Шаблоны включают replayable sensor/event fixtures и failure scenarios; валидация без реального железа или внешних side-effects.

templates/*/sim/, src/agent/Simulation/, src/agent/Hercules.WebApi/Controllers/SimulationController.cs

Сложность моделирования неисправностей; reuse реальных eval-фикстур.

Добавлено:

src/agent/Simulation/ — 5 файлов:

Models.cs — все типы: SensorReading, EventFixture, FailureScenario (+ FailureType enum), SimulationSession, SimulationResult, SimulationMetrics, AppliedFailure, ReplayMode
ISensorSimulator.cs — интерфейс для загрузки fixtures (читабельный, тестируемый)
FileSensorSimulator.cs — загружает fixtures из templates/{scenario}/sim/; graceful empty на отсутствующие файлы
FailureScenarioEngine.cs — ядро failure injection:
- InjectFailures: applies each failure type (StuckAt/DataLoss/Spike/Noise/Latency/Blackout) to readings within the injection window
- GenerateFailureEvents: creates failure_injected / failure_resolved events from scenarios
- GetFailureCoverage: maps sensors → failure scenarios
- DurationSeconds=0 → no upper boundary (always-on from injection point forward)
- DateTimeStyles.AssumeUniversal | AdjustToUniversal для корректного парсинга “Z”-suffix и “+00:00” timestamps
TemplateSimulationService.cs — DI-friendly orchestrator; управляет активными сессиями в ConcurrentDictionary

Hercules.WebApi/Controllers/SimulationController.cs — 6 endpoints:

GET /api/simulation/templates — список шаблонов с fixtures
GET /api/simulation/templates/{name}/available — проверка наличия fixtures
POST /api/simulation/sessions — начать симуляционную сессию
GET /api/simulation/sessions/{name} — состояние сессии
POST /api/simulation/sessions/{name}/replay — запуск replay (опционально с failure injection)
DELETE /api/simulation/sessions/{name} — остановить сессию
Все request/response DTOs: SimulatableTemplateDto, TemplateAvailabilityDto, StartSessionRequest, ReplayRequest, SimulationSessionDto, SimulationResultDto, AppliedFailureDto, SimulationMetricsDto

DI (CLI + WebAPI):

ISensorSimulator → FileSensorSimulator (TemplatesBaseDir = {AppContext.BaseDirectory}/templates)
FailureScenarioEngine singleton
TemplateSimulationService singleton

Templates fixtures (templates/{greenhouse,cold-chain,server-room,vending}/sim/):

sensors.json — SensorReading[] с timestamp (ISO 8601 “Z”-suffix), sensor name, value, unit, location, status
events.json — EventFixture[] с timestamp, type, description, severity, payload, source
failures.json — FailureScenario[] с id, name, description, type (enum string), affectedSensors, injectAfterSeconds, durationSeconds, faultValue, faultMessage

Bug fix — FailureScenarioEngine boundary condition:

Old: if (elapsed > InjectAfterSeconds + DurationSeconds) — DurationSeconds=0 → always true → ALL readings skipped
New: if (DurationSeconds > 0 && elapsed > InjectAfterSeconds + DurationSeconds) — DurationSeconds=0 → no upper boundary → always-on from injection point

Bug fix — Timestamp parsing:

Added DateTimeStyles.AssumeUniversal | AdjustToUniversal to DateTimeOffset.TryParse to correctly handle “Z”-suffix and “+00:00” roundtrip-format timestamps in all system timezones

Tests — 28 новых тестов:

FailureScenarioEngineTests.cs — 18 тестов: StuckAt, DataLoss, Spike, Noise, Latency, Blackout, boundary (t=3100 at window end), Duration=0 (always-on), case-insensitive, unparseable timestamp, coverage, events
TemplateSimulationServiceTests.cs — 10 тестов: session lifecycle, replay with/without failures, failure events, no-session error, coverage, empty templates

Validation:

dotnet build Hercules.csproj — 0 errors, 0 warnings (NU1902 pre-existing)
dotnet build Hercules.WebApi.csproj — 0 errors, 0 warnings
dotnet test --filter Simulation — 28/28 passed
dotnet test — 866/873 passed (7 pre-existing: OtelService × 5, BudgetGuard × 1, WasmTool × 1 — unrelated to task_031)