C2-5: POS and till on the contract (ADR 0005)

.gitignore

@@ -65,3 +65,7 @@ __pycache__/
 # Playwright
 web/test-results/
 web/playwright-report/
+
+# Golden drift dumps written beside the recorded transcript on a mismatch
+# (core/internal/characterization): never commit them, re-record instead.
+core/internal/characterization/testdata/goldens/*.actual

core/api/ROUTES.txt

@@ -290,7 +290,10 @@ POST	/api/v1/payments/{id}/applications	internal/payment	h.HandleApply
 POST	/api/v1/payments/{id}/refunds	internal/payment	h.HandleRefund
 POST	/api/v1/payments/{id}/transitions	internal/payment	h.HandleTransition
 GET	/api/v1/pos/catalog	internal/pos	h.GetCatalog
+GET	/api/v1/pos/customers	internal/pos	h.FindCustomers
 GET	/api/v1/pos/products/search	internal/pos	h.SearchProducts
+POST	/api/v1/pos/refund-intents/{id}/payback	internal/pos	h.PaybackRefundIntent
+POST	/api/v1/pos/refund-intents/{id}/resolve	internal/pos	h.ResolveRefundIntent
 GET	/api/v1/pos/returns	internal/pos	h.ListReturns
 POST	/api/v1/pos/returns	internal/pos	h.CreateReturn
 GET	/api/v1/pos/returns/{id}	internal/pos	h.GetReturn
@@ -304,6 +307,7 @@ GET	/api/v1/pos/transactions	internal/pos	h.ListTransactions
 POST	/api/v1/pos/transactions	internal/pos	h.StartTransaction
 GET	/api/v1/pos/transactions/{id}	internal/pos	h.GetTransaction
 POST	/api/v1/pos/transactions/{id}/complete	internal/pos	h.CompleteTransaction
+PUT	/api/v1/pos/transactions/{id}/customer	internal/pos	h.AttachCustomer
 POST	/api/v1/pos/transactions/{id}/items	internal/pos	h.AddItem
 DELETE	/api/v1/pos/transactions/{id}/items/{itemId}	internal/pos	h.RemoveItem
 POST	/api/v1/pos/transactions/{id}/void	internal/pos	h.VoidTransaction

core/api/fragments/payment.yaml

@@ -83,7 +83,9 @@ paths:
         allow) in the same transaction, each application its own entry (DR 2200 / CR
         1020) and subledger row. Refused with 409 and a blocker: exceeds_unapplied,
         exceeds_open_amount, invoice_void, customer_mismatch, currency_mismatch,
-        discount_not_available, period_closed. Writes payment.recorded, then
+        discount_not_available, period_closed, and void_claim_pending when the
+        invoice's sale has a void whose refund claims still stand (the counter's
+        interim; the refusal names the claims). Writes payment.recorded, then
         payment.applied and invoice.partial or invoice.paid per invoice, then
         customer.updated (part balance).
       parameters:
@@ -163,7 +165,9 @@ paths:
         posts its own DR 2200 / CR 1020 entry and a PAYMENT subledger row. The
         precondition is the payment's revision. Refused with 409 exceeds_unapplied,
         exceeds_open_amount, invoice_void, payment_voided, customer_mismatch,
-        currency_mismatch, discount_not_available or period_closed. Writes payment.applied,
+        currency_mismatch, discount_not_available, period_closed, or
+        void_claim_pending when the invoice's sale has a void whose refund claims
+        still stand (the counter's interim; the refusal names the claims). Writes payment.applied,
         invoice.partial or invoice.paid per invoice, and customer.updated.
       parameters:
         - name: id