# 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`