Decisions

Architecture Decision Records (ADRs) and Product Requirements Documents (PRDs) collected from the component repositories. Each document lives next to the code it governs (docs/adr/, docs/prd/ in the owning repo) and is rendered here via the submodule pins — so this page is as current as the last submodule bump.

ops-db

• ADR 0001 — S3/LTA connection config lives on the DataLocation (self-serve)
• Store JSON columns as jsonb via a generic-JSON-with-postgresql-variant type
• Sanitize U+0000 (NUL) at the JSONB_VARIANT type boundary

ops-db-api

• Live cross-host filesystem-check contract (diagnostics.stat_paths)
• Diagnosis access boundary: detail-free overview, why behind admin gate
• Split archiving into awaiting_archive + archiving: a seven-step funnel
• Celery broker SSL via config dicts, not URL query
• Stale-FAILED packages: an explicit “Inconsistent” bucket, reconciled from ops
• Async request-scoped DB session, secondary-site read-only guard, selectinload convention

• Product Requirements Documents

ops-db-ui

• Product Requirements Documents

data-transfer

• Error breadcrumb storage: per-row error_context + generic OperationFailureEvent
• Filesystem boundary errors: wrap for diagnosis, keep non-retryable
• Uniform pipeline operation model
• Archive recovery: idempotent completion over at-least-once retries

workflow-manager

data-center-documentation

Decisions about the documentation site itself live in this repo (docs/adr/), not in a component submodule.

• Architecture Decision Records