Skip to content

Architecture Decision Records

ADRs capture important architectural decisions with their context and consequences.


What is an ADR?

An Architecture Decision Record documents:

  • Context — Why was this decision needed?
  • Decision — What was decided?
  • Consequences — What are the tradeoffs?

Decision Log

# Decision Status
ADR-001 Group scoping via named query filters Accepted
ADR-002 Domain entities stay POCO Accepted
ADR-003 Optimistic mutations via factory hooks Accepted
ADR-004 Derived translation keys Accepted

Creating an ADR

# ADR-NNN: Short Title

## Status
Proposed | Accepted | Deprecated | Superseded

## Context
Why is this decision needed?

## Decision
What was decided?

## Consequences
What are the positive and negative outcomes?

See also: Architecture for the current system design.