Architecture Decision Record

ADR-0007: Boundary Fact Transport Is Log-Centric

Status: Accepted · Date: 2026-03-06

Status: Accepted

Date: 2026-03-06

Context

BSFG transports durable facts across independent zones (Enterprise, IDMZ, Plants). The boundary layer must guarantee:

The buffering substrate therefore determines whether the system naturally preserves audit-grade historical evidence or behaves primarily as a task queue.

Options Considered

Option Description Benefits Drawbacks
Queue-centric messaging Traditional broker queues (consume-and-delete semantics).

|

| | Database-backed event table | Append events into relational database tables. |

|

| | Log-centric streaming substrate (Selected) | Append-only fact streams retained for replay. |

|

|

Decision

BSFG will use a log-centric fact transport. Facts are appended to retained streams and replicated between zones.

Each zone operates its own JetStream domain containing a small fixed set of streams:

Streams are partitioned by subject prefix rather than proliferating streams.

Consequences

Benefits:

Tradeoffs: