BSFG
Architecture Decision Record

ADR-0005: Three-Log Topology Emerges in Large Deployments

Status: Accepted · Date: 2026-03-03

Status: Accepted

Date: 2026-03-03

Context

When BSFG is deployed in complex industrial systems, durable data artifacts naturally separate into three roles.

Architectural clarity improves when these roles are explicitly recognized.

Decision

Per direction, the architecture consists of three durable artifacts:

  1. Zone Truth Log
    • application semantic record of events
    • owned by the zone
  2. Store Buffer Log
    • durable transport log
    • guarantees producer non-blocking
  3. Forward Buffer Materialization
    • idempotent deduplicated staging
    • provides local availability to consumers

Data flow:

Zone Truth -> Store Buffer -> Forward Buffer -> Remote Zone Truth

Consequences

Benefits:

Tradeoffs: