fix(loyalty): fix runtime bugs in storefront routes, point expiration, and enforce settings

- Add total_points_voided column to LoyaltyCard with migration (loyalty_002)
- Fix storefront self_enroll to use correct service method signature and schema fields
- Fix get_my_card/get_my_transactions to use get_card_by_customer_and_merchant
- Fix transaction history field reference (balance_after -> points_balance_after)
- Fix point_expiration task: wrong field names and manual balance update -> card.expire_points()
- Register storefront_router in definition.py and export all routers from __init__.py
- Enforce MerchantLoyaltySettings in storefront enrollment, points, and stamp void operations
- Fix test fixture using non-existent balance_after column
- Suppress intentional architecture validator warnings in templates

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/modules/loyalty/definition.py

@@ -31,6 +31,13 @@ def _get_platform_router():
     return platform_router
 
 
+def _get_storefront_router():
+    """Lazy import of storefront router to avoid circular imports."""
+    from app.modules.loyalty.routes.api.storefront import storefront_router
+
+    return storefront_router
+
+
 # Loyalty module definition
 loyalty_module = ModuleDefinition(
     code="loyalty",
@@ -197,6 +204,7 @@ def get_loyalty_module_with_routers() -> ModuleDefinition:
     loyalty_module.admin_router = _get_admin_router()
     loyalty_module.store_router = _get_store_router()
     loyalty_module.platform_router = _get_platform_router()
+    loyalty_module.storefront_router = _get_storefront_router()
     return loyalty_module