save checkpoint: save features

docs/features/checked/platform/scanner-platform-events.md

@@ -0,0 +1,36 @@
+# Scanner Platform Events (Redis Streams)
+
+## Module
+Platform
+
+## Status
+VERIFIED
+
+## Description
+Scanner WebService events are ingested by Platform Analytics from the configured stream. The ingestion path now supports `scanner.event.report.ready` and `scanner.scan.completed`, handles scanner DSSE payload decoding for report-ready content, and resumes from persisted stream checkpoints after restart.
+
+## Implementation Details
+- **AnalyticsIngestionService**: `src/Platform/StellaOps.Platform.Analytics/Services/AnalyticsIngestionService.cs` -- subscribes to scanner stream; supports both `OrchestratorEventKinds.ScannerReportReady` and `OrchestratorEventKinds.ScannerScanCompleted`; resolves report payloads from direct JSON, wrapped `reportReady`, and DSSE envelopes; persists and restores scanner stream checkpoints.
+- **ScannerOrchestratorEvents**: `src/Platform/StellaOps.Platform.Analytics/Models/ScannerOrchestratorEvents.cs` -- scanner event models, including `ScanCompletedEventPayload` and scanner event-kind constants.
+- **AnalyticsIngestionOptions**: `src/Platform/StellaOps.Platform.Analytics/Options/AnalyticsIngestionOptions.cs` -- stream settings include `ResumeFromCheckpoint` and optional `ScannerCheckpointFilePath`.
+- **IEventStream/IEventStreamFactory**: `src/Router/__Libraries/StellaOps.Messaging/Abstractions/IEventStream.cs` -- stream subscription with `StreamPosition.After(entryId)` checkpoint resume support.
+- **Tests**: `src/Platform/__Tests/StellaOps.Platform.Analytics.Tests/ScannerPlatformEventsBehaviorTests.cs`.
+- **Source**: 2025-10-19-scanner-policy.md
+
+## E2E Test Plan
+- [ ] Verify scanner report-ready events (`scanner.event.report.ready`) are consumed and processed by analytics ingestion.
+- [ ] Verify scanner scan-completed events (`scanner.scan.completed`) are accepted and mapped into report-ready ingestion payloads.
+- [ ] Verify DSSE envelope payloads are decoded and parsed into report-ready scanner payloads.
+- [ ] Verify scanner stream checkpoint normalization and subscription position resolution for restart resume.
+- [ ] Verify tenant filtering skips events from non-allowed tenants.
+
+## Verification
+- Verified on 2026-02-11 with `run-003`.
+- Tier 0 source checks passed with scanner event-kind, DSSE parser, and checkpoint resume declarations present.
+- Tier 1 build + tests passed (`185/185`) with code-review parity confirming previously missing scanner-event claims are implemented.
+- Tier 2 behavioral/e2e checks passed (`38/38`) across scanner event behavior tests, Docker-backed analytics schema integration, and tenant normalization checks.
+- Evidence:
+  - `docs/qa/feature-checks/runs/platform/scanner-platform-events/run-003/tier0-source-check.json`
+  - `docs/qa/feature-checks/runs/platform/scanner-platform-events/run-003/tier1-build-check.json`
+  - `docs/qa/feature-checks/runs/platform/scanner-platform-events/run-003/tier2-integration-check.json`
+  - `docs/qa/feature-checks/runs/platform/scanner-platform-events/run-003/retest-result.json`