feat(loyalty): implement Phase 2 - company-wide points system

Complete implementation of loyalty module Phase 2 features:

Database & Models:
- Add company_id to LoyaltyProgram for chain-wide loyalty
- Add company_id to LoyaltyCard for multi-location support
- Add CompanyLoyaltySettings model for admin-controlled settings
- Add points expiration, welcome bonus, and minimum redemption fields
- Add POINTS_EXPIRED, WELCOME_BONUS transaction types

Services:
- Update program_service for company-based queries
- Update card_service with enrollment and welcome bonus
- Update points_service with void_points for returns
- Update stamp_service for company context
- Update pin_service for company-wide operations

API Endpoints:
- Admin: Program listing with stats, company detail views
- Vendor: Terminal operations, card management, settings
- Storefront: Customer card/transactions, self-enrollment

UI Templates:
- Admin: Programs dashboard, company detail, settings
- Vendor: Terminal, cards list, card detail, settings, stats, enrollment
- Storefront: Dashboard, history, enrollment, success pages

Background Tasks:
- Point expiration task (daily, based on inactivity)
- Wallet sync task (hourly)

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

app/modules/loyalty/schemas/__init__.py

@@ -33,8 +33,13 @@ from app.modules.loyalty.schemas.program import (
     ProgramListResponse,
     # Points rewards
     PointsRewardConfig,
+    TierConfig,
     # Stats
     ProgramStatsResponse,
+    CompanyStatsResponse,
+    # Company settings
+    CompanySettingsResponse,
+    CompanySettingsUpdate,
 )
 
 from app.modules.loyalty.schemas.card import (
@@ -44,6 +49,9 @@ from app.modules.loyalty.schemas.card import (
     CardDetailResponse,
     CardListResponse,
     CardLookupResponse,
+    # Transactions
+    TransactionResponse,
+    TransactionListResponse,
 )
 
 from app.modules.loyalty.schemas.stamp import (
@@ -52,6 +60,8 @@ from app.modules.loyalty.schemas.stamp import (
     StampResponse,
     StampRedeemRequest,
     StampRedeemResponse,
+    StampVoidRequest,
+    StampVoidResponse,
 )
 
 from app.modules.loyalty.schemas.points import (
@@ -60,6 +70,10 @@ from app.modules.loyalty.schemas.points import (
     PointsEarnResponse,
     PointsRedeemRequest,
     PointsRedeemResponse,
+    PointsVoidRequest,
+    PointsVoidResponse,
+    PointsAdjustRequest,
+    PointsAdjustResponse,
 )
 
 from app.modules.loyalty.schemas.pin import (
@@ -79,23 +93,35 @@ __all__ = [
     "ProgramResponse",
     "ProgramListResponse",
     "PointsRewardConfig",
+    "TierConfig",
     "ProgramStatsResponse",
+    "CompanyStatsResponse",
+    "CompanySettingsResponse",
+    "CompanySettingsUpdate",
     # Card
     "CardEnrollRequest",
     "CardResponse",
     "CardDetailResponse",
     "CardListResponse",
     "CardLookupResponse",
+    "TransactionResponse",
+    "TransactionListResponse",
     # Stamp
     "StampRequest",
     "StampResponse",
     "StampRedeemRequest",
     "StampRedeemResponse",
+    "StampVoidRequest",
+    "StampVoidResponse",
     # Points
     "PointsEarnRequest",
     "PointsEarnResponse",
     "PointsRedeemRequest",
     "PointsRedeemResponse",
+    "PointsVoidRequest",
+    "PointsVoidResponse",
+    "PointsAdjustRequest",
+    "PointsAdjustResponse",
     # PIN
     "PinCreate",
     "PinUpdate",