Skip to content

Architecture Decision Records

These ADRs capture significant architectural and process decisions, following the lightweight format popularized by Michael Nygard.

# Title Status
0001 Layered architecture enforced by import-linter Superseded by 0007
0002 Fail-safe production configuration validation Accepted
0003 Dependency management: ranges + hashed lockfile Accepted
0004 LLM sample-data privacy (cloud opt-in + PII masking) Accepted
0005 CI quality gates: pragmatic, then strict Accepted
0006 Distribution name vs. the import package Superseded by 0010
0007 Hexagonal architecture (ports & adapters) Accepted
0008 Dialect abstraction and the ODBC (SQL Server) adapter Accepted
0009 Row security, column masking and the audit trail Accepted
0010 One package, one process Accepted
0011 The sync/async bridge: one loop thread owns the OLAP side's gateways Accepted
0012 Row rules and masks on analytical queries, by rewriting the query Accepted
0013 Nothing a model wrote is read until a reviewer certifies it Accepted