Samir Boulahtit
b5a803cde8
Add stamp-based and points-based loyalty programs for vendors with: Database Models (5 tables): - loyalty_programs: Vendor program configuration - loyalty_cards: Customer cards with stamp/point balances - loyalty_transactions: Immutable audit log - staff_pins: Fraud prevention PINs (bcrypt hashed) - apple_device_registrations: Apple Wallet push tokens Services: - program_service: Program CRUD and statistics - card_service: Customer enrollment and card lookup - stamp_service: Stamp operations with anti-fraud checks - points_service: Points earning and redemption - pin_service: Staff PIN management with lockout - wallet_service: Unified wallet abstraction - google_wallet_service: Google Wallet API integration - apple_wallet_service: Apple Wallet .pkpass generation API Routes: - Admin: /api/v1/admin/loyalty/* (programs list, stats) - Vendor: /api/v1/vendor/loyalty/* (stamp, points, cards, PINs) - Public: /api/v1/loyalty/* (enrollment, Apple Web Service) Anti-Fraud Features: - Staff PIN verification (configurable per program) - Cooldown period between stamps (default 15 min) - Daily stamp limits (default 5/day) - PIN lockout after failed attempts Wallet Integration: - Google Wallet: LoyaltyClass and LoyaltyObject management - Apple Wallet: .pkpass generation with PKCS#7 signing - Apple Web Service endpoints for device registration/updates Also includes: - Alembic migration for all tables with indexes - Localization files (en, fr, de, lu) - Module documentation - Phase 2 interface and user journey plan Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
107 lines
2.1 KiB
Python
107 lines
2.1 KiB
Python
# app/modules/loyalty/schemas/__init__.py
|
|
"""
|
|
Loyalty module Pydantic schemas.
|
|
|
|
Request and response models for the loyalty API endpoints.
|
|
|
|
Usage:
|
|
from app.modules.loyalty.schemas import (
|
|
# Program
|
|
ProgramCreate,
|
|
ProgramUpdate,
|
|
ProgramResponse,
|
|
# Card
|
|
CardEnrollRequest,
|
|
CardResponse,
|
|
# Stamp
|
|
StampRequest,
|
|
StampResponse,
|
|
# Points
|
|
PointsEarnRequest,
|
|
PointsRedeemRequest,
|
|
# PIN
|
|
PinCreate,
|
|
PinVerifyRequest,
|
|
)
|
|
"""
|
|
|
|
from app.modules.loyalty.schemas.program import (
|
|
# Program CRUD
|
|
ProgramCreate,
|
|
ProgramUpdate,
|
|
ProgramResponse,
|
|
ProgramListResponse,
|
|
# Points rewards
|
|
PointsRewardConfig,
|
|
# Stats
|
|
ProgramStatsResponse,
|
|
)
|
|
|
|
from app.modules.loyalty.schemas.card import (
|
|
# Card operations
|
|
CardEnrollRequest,
|
|
CardResponse,
|
|
CardDetailResponse,
|
|
CardListResponse,
|
|
CardLookupResponse,
|
|
)
|
|
|
|
from app.modules.loyalty.schemas.stamp import (
|
|
# Stamp operations
|
|
StampRequest,
|
|
StampResponse,
|
|
StampRedeemRequest,
|
|
StampRedeemResponse,
|
|
)
|
|
|
|
from app.modules.loyalty.schemas.points import (
|
|
# Points operations
|
|
PointsEarnRequest,
|
|
PointsEarnResponse,
|
|
PointsRedeemRequest,
|
|
PointsRedeemResponse,
|
|
)
|
|
|
|
from app.modules.loyalty.schemas.pin import (
|
|
# Staff PIN
|
|
PinCreate,
|
|
PinUpdate,
|
|
PinResponse,
|
|
PinListResponse,
|
|
PinVerifyRequest,
|
|
PinVerifyResponse,
|
|
)
|
|
|
|
__all__ = [
|
|
# Program
|
|
"ProgramCreate",
|
|
"ProgramUpdate",
|
|
"ProgramResponse",
|
|
"ProgramListResponse",
|
|
"PointsRewardConfig",
|
|
"ProgramStatsResponse",
|
|
# Card
|
|
"CardEnrollRequest",
|
|
"CardResponse",
|
|
"CardDetailResponse",
|
|
"CardListResponse",
|
|
"CardLookupResponse",
|
|
# Stamp
|
|
"StampRequest",
|
|
"StampResponse",
|
|
"StampRedeemRequest",
|
|
"StampRedeemResponse",
|
|
# Points
|
|
"PointsEarnRequest",
|
|
"PointsEarnResponse",
|
|
"PointsRedeemRequest",
|
|
"PointsRedeemResponse",
|
|
# PIN
|
|
"PinCreate",
|
|
"PinUpdate",
|
|
"PinResponse",
|
|
"PinListResponse",
|
|
"PinVerifyRequest",
|
|
"PinVerifyResponse",
|
|
]
|