Add guided Payments operator workspace

2026-08-19 13:17:13 +02:00
parent 630a7d39f7
commit a2dcd8f2dd
16 changed files with 1268 additions and 5 deletions
@@ -39,6 +39,29 @@ closed. Corrections, reversals, refunds, chargebacks, partial payments, and
 overpayments require future append-only adjustment types and must never mutate
 the original evidence silently.

+## Operator workspace
+
+The permission-aware `/payments` workspace is the operator projection of this
+contract. Readers can filter requested and paid obligations and inspect their
+source, Case/Workflow context references, amount, due or settled time, and
+immutable evidence reference. Writers create fixed obligations in a guided
+dialog; the UI supplies an explicit replay key and never copies applicant or
+Form content into Payments.
+
+Reconciliation uses a separate consequential dialog. Amount and currency are
+fixed from the selected obligation rather than editable. The operator records
+the external transaction reference, receipt time, evidence owner, kind, ID,
+and at least one immutable version or checksum. The dialog explains that paid
+state cannot be silently undone and that a governed adjustment is required.
+Missing permissions remain visible with the exact scope and responsible
+administrator.
+
+Reload is always available in the collection action bar. A failed refresh
+preserves the last successful result and labels it stale; an initial failure
+uses a whole-surface retry state. The workspace also distinguishes loading,
+empty, permission-blocked, conflict, replay-success, and ordinary success
+states.
+
 ## Access, privacy, and audit

 Payment readers see obligation and reconciliation metadata. Writers create