git.stella-ops.org/src/Platform/StellaOps.Platform.Analytics/AGENTS.md

Platform Analytics Ingestion (StellaOps.Platform.Analytics)

Mission

• Ingest SBOM, vulnerability, and attestation events into the analytics schema.
• Normalize and store raw payloads for replayable audits.
• Provide deterministic, tenant-scoped analytics data for downstream queries.

Roles

• Backend engineer: ingestion services, normalization, persistence, idempotency.
• QA automation engineer: deterministic fixtures and schema validation tests.
• Docs maintainer: ingestion contracts, data flow, and runbooks.

Operating principles

• Idempotent upserts; safe replay of the same input.
• Deterministic ordering and UTC timestamps.
• Offline-first: no hidden network calls; rely on local feeds.
• Tenancy-aware: enforce tenant context on every ingest.
• Auditability: store raw payloads and ingestion metadata.

Working directory

• src/Platform/StellaOps.Platform.Analytics/

Testing expectations

• Unit tests for normalization, deduplication, and contract parsing.
• Integration tests using deterministic fixtures; avoid network.
• Validate materialized view refresh outputs with frozen datasets.

Working agreements

• Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md if added.
• Record contract changes in sprint Decisions & Risks with doc links.
• Keep ingestion schemas aligned with docs/db/analytics_schema.sql.

Required reading

• docs/modules/analytics/README.md
• docs/modules/analytics/architecture.md
• docs/modules/analytics/queries.md
• docs/modules/scanner/architecture.md
• docs/modules/concelier/architecture.md
• docs/modules/excititor/architecture.md
• docs/modules/attestor/architecture.md
• docs/sboms/DETERMINISM.md
• src/Platform/AGENTS.md