architecture decision

ADR-021: Deprecate direct inventory adjustments from order flows

Order workflows should reserve and release inventory instead of issuing direct stock adjustment commands.

Decision RecordMarch 27, 2025DeprecatedInventory
This architecture decision has been deprecated

This architecture decision has been marked as deprecated.

Context

Early integrations adjusted stock directly from order and warehouse workflows. This made it hard to explain whether stock changed because of reservation, correction, or restock.

Decision

Direct adjustment commands are deprecated for order-facing workflows. New order flows should use reservation and release semantics.

Consequences

Inventory audit trails become clearer. Existing direct adjustment integrations need migration plans before the commands can be removed.