bc4318ef97
- Created `StellaOps.TestKit.Tests` project for unit tests related to determinism. - Implemented `DeterminismManifestTests` to validate deterministic output for canonical bytes and strings, file read/write operations, and error handling for invalid schema versions. - Added `SbomDeterminismTests` to ensure identical inputs produce consistent SBOMs across SPDX 3.0.1 and CycloneDX 1.6/1.7 formats, including parallel execution tests. - Updated project references in `StellaOps.Integration.Determinism` to include the new determinism testing library.
37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# Persistence and database
|
|
|
|
StellaOps uses PostgreSQL as the canonical system of record. This document
|
|
summarizes the persistence rules, schema layout, and migration approach.
|
|
|
|
Principles
|
|
- Determinism first: stable ordering, UTC timestamps, canonical JSON for hashes.
|
|
- Tenant isolation: every row carries tenant_id and row level security is used.
|
|
- Gradual migration: Mongo to Postgres via a strangler approach with rollback.
|
|
- JSONB for flexibility: semi structured payloads stay JSONB; core entities are normalized.
|
|
|
|
Schema families (authoritative DDLs)
|
|
- authority, vuln, vex, scheduler, notify, policy
|
|
- packs are included with policy
|
|
- issuer and audit are staged or proposed
|
|
|
|
Operational inputs
|
|
- Config template: docs/db/persistence-config-template.yaml
|
|
- Cluster provisioning: docs/db/cluster-provisioning.md
|
|
- Local dev: docs/db/local-postgres.md
|
|
|
|
Change control and verification
|
|
- Follow rules in docs/db/RULES.md for naming, constraints, and RLS.
|
|
- Use docs/db/SPECIFICATION.md as the schema source of truth.
|
|
- Verify changes using docs/db/VERIFICATION.md before release.
|
|
|
|
Migration notes
|
|
- Conversion planning: docs/db/CONVERSION_PLAN.md
|
|
- Module phased tasks: docs/db/tasks/PHASE_*.md
|
|
- Reports and verification evidence live under docs/db/reports/
|
|
|
|
Related references
|
|
- ADR: docs/adr/0001-postgresql-for-control-plane.md
|
|
- Module architecture: docs/modules/*/architecture.md
|
|
- data/postgresql-operations.md
|
|
- data/postgresql-patterns.md
|