feat(loyalty): attribute transactions to the acting POS tablet
Adds acting_terminal_device_id to loyalty_transactions so the audit log can distinguish between operations performed via the web terminal (human user JWT) and operations performed via a paired tablet (device JWT). The principal-of-record stays the pairing user — existing reports keep working — and this column adds "which tablet did it" alongside. Threaded through every store-API endpoint that creates a transaction (stamp add/redeem/void, points earn/redeem/void/adjust, enrollment + welcome bonus, card deactivate/reactivate). The route reads current_user.terminal_device_id, which the bearer-auth dep populates when a device JWT is presented. User-token requests leave the column NULL, as covered by the new test. Bulk admin operations (GDPR anonymization, bulk deactivate) and Celery tasks (point expiration) are not threaded — they always come from a human admin or the scheduler, never a tablet. - Migration loyalty_011 + LoyaltyTransaction.acting_terminal_device_id - 9 service signatures gain the optional kwarg - 8 store-API routes pass it through - Integration tests: device JWT populates the column, user JWT leaves it NULL Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -50,6 +50,7 @@ class StampService:
|
||||
ip_address: str | None = None,
|
||||
user_agent: str | None = None,
|
||||
notes: str | None = None,
|
||||
acting_terminal_device_id: int | None = None,
|
||||
) -> dict:
|
||||
"""
|
||||
Add a stamp to a loyalty card.
|
||||
@@ -144,6 +145,7 @@ class StampService:
|
||||
card_id=card.id,
|
||||
store_id=store_id,
|
||||
staff_pin_id=verified_pin.id if verified_pin else None,
|
||||
acting_terminal_device_id=acting_terminal_device_id,
|
||||
category_ids=category_ids,
|
||||
transaction_type=TransactionType.STAMP_EARNED.value,
|
||||
stamps_delta=1,
|
||||
@@ -219,6 +221,7 @@ class StampService:
|
||||
ip_address: str | None = None,
|
||||
user_agent: str | None = None,
|
||||
notes: str | None = None,
|
||||
acting_terminal_device_id: int | None = None,
|
||||
) -> dict:
|
||||
"""
|
||||
Redeem stamps for a reward.
|
||||
@@ -287,6 +290,7 @@ class StampService:
|
||||
card_id=card.id,
|
||||
store_id=store_id,
|
||||
staff_pin_id=verified_pin.id if verified_pin else None,
|
||||
acting_terminal_device_id=acting_terminal_device_id,
|
||||
transaction_type=TransactionType.STAMP_REDEEMED.value,
|
||||
stamps_delta=-stamps_redeemed,
|
||||
stamps_balance_after=card.stamp_count,
|
||||
@@ -339,6 +343,7 @@ class StampService:
|
||||
ip_address: str | None = None,
|
||||
user_agent: str | None = None,
|
||||
notes: str | None = None,
|
||||
acting_terminal_device_id: int | None = None,
|
||||
) -> dict:
|
||||
"""
|
||||
Void stamps for a return.
|
||||
@@ -422,6 +427,7 @@ class StampService:
|
||||
card_id=card.id,
|
||||
store_id=store_id,
|
||||
staff_pin_id=verified_pin.id if verified_pin else None,
|
||||
acting_terminal_device_id=acting_terminal_device_id,
|
||||
transaction_type=TransactionType.STAMP_VOIDED.value,
|
||||
stamps_delta=-actual_voided,
|
||||
stamps_balance_after=card.stamp_count,
|
||||
|
||||
Reference in New Issue
Block a user