Audit Trail & Compensating Strategies

The Sales / OMS domain is designed to satisfy commercial audit requirements, revenue assurance, and customer dispute resolution. Every state transition and price change is logged, and all corrections follow formal compensating strategies rather than record destruction.

---

1. Regulatory Audit Log

Every mutation within the Sales / OMS context is recorded with immutable context:

Audit Attribute	Purpose
Actor Identity	Identifies the user, channel system, or integration process that performed the action.
Timestamp	Records the precise moment of the action in UTC.
Origin Context	Identifies the channel, user interface, or external system that triggered the change.
Before / After Snapshot	Captures the state of the quotation or order before and after the change.
Reason Code	Captures the business justification for cancellations, price overrides, or returns.

Audit Invariants

• Audit log entries are append-only. They can never be edited or deleted.
• Confirmed orders retain a complete lineage of pricing, discounts, allocations, releases, and deliveries.
• Quotation acceptance events capture the exact version accepted by the customer.
• Cancellation and return actions require a mandatory reason and are permanently traceable.

---

2. Compensating Actions

Changes to confirmed orders are never performed by overwriting the original record. The domain supports three compensating strategies:

Strategy	Use Case
Credit Note	Reduce a customer’s receivable for returns, price corrections, or goodwill adjustments.
Supplementary Order	Add additional items or quantities to a confirmed order through a separate, linked order.
RMA Adjustment Cycle	Process customer returns through authorization, receipt, inspection, and credit or replacement.

Correction Chain Example

Original SO #3000          Supplementary Order #3000-1        RMA #RMA-120
(Initial commitment)       (Customer-requested add-on)        (Return of defective unit)
       |                           |                                |
       └───────────────────────────┴────────────────────────────────┘
                            Order History

Every compensating document references the original order, ensuring complete traceability for auditors, customer service, and financial reconciliation.

---

3. Summary

The Sales & Order Management domain in Obelaw is a rigorous, event-driven bounded context that enforces commercial correctness through financial balance rules, pricing immutability, ATP-based allocation, and disciplined cancellation governance. It remains isolated from Catalog, WMS, TMS, and Accounting contexts via an Anti-Corruption Layer and emits only the commercial events necessary to coordinate fulfillment, logistics, and financial settlement.