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>
125 lines
2.7 KiB
Python
125 lines
2.7 KiB
Python
# app/modules/loyalty/schemas/points.py
|
|
"""
|
|
Pydantic schemas for points operations.
|
|
"""
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class PointsEarnRequest(BaseModel):
|
|
"""Schema for earning points from a purchase."""
|
|
|
|
card_id: int | None = Field(
|
|
None,
|
|
description="Card ID (use this or qr_code)",
|
|
)
|
|
qr_code: str | None = Field(
|
|
None,
|
|
description="QR code data from card scan",
|
|
)
|
|
card_number: str | None = Field(
|
|
None,
|
|
description="Card number (manual entry)",
|
|
)
|
|
|
|
# Purchase info
|
|
purchase_amount_cents: int = Field(
|
|
...,
|
|
gt=0,
|
|
description="Purchase amount in cents",
|
|
)
|
|
order_reference: str | None = Field(
|
|
None,
|
|
max_length=100,
|
|
description="Order reference for tracking",
|
|
)
|
|
|
|
# Authentication
|
|
staff_pin: str | None = Field(
|
|
None,
|
|
min_length=4,
|
|
max_length=6,
|
|
description="Staff PIN for verification",
|
|
)
|
|
|
|
# Optional metadata
|
|
notes: str | None = Field(
|
|
None,
|
|
max_length=500,
|
|
description="Optional note",
|
|
)
|
|
|
|
|
|
class PointsEarnResponse(BaseModel):
|
|
"""Schema for points earning response."""
|
|
|
|
success: bool = True
|
|
message: str = "Points earned successfully"
|
|
|
|
# Points info
|
|
points_earned: int
|
|
points_per_euro: int
|
|
purchase_amount_cents: int
|
|
|
|
# Card state after earning
|
|
card_id: int
|
|
card_number: str
|
|
points_balance: int
|
|
total_points_earned: int
|
|
|
|
|
|
class PointsRedeemRequest(BaseModel):
|
|
"""Schema for redeeming points for a reward."""
|
|
|
|
card_id: int | None = Field(
|
|
None,
|
|
description="Card ID (use this or qr_code)",
|
|
)
|
|
qr_code: str | None = Field(
|
|
None,
|
|
description="QR code data from card scan",
|
|
)
|
|
card_number: str | None = Field(
|
|
None,
|
|
description="Card number (manual entry)",
|
|
)
|
|
|
|
# Reward selection
|
|
reward_id: str = Field(
|
|
...,
|
|
description="ID of the reward to redeem",
|
|
)
|
|
|
|
# Authentication
|
|
staff_pin: str | None = Field(
|
|
None,
|
|
min_length=4,
|
|
max_length=6,
|
|
description="Staff PIN for verification",
|
|
)
|
|
|
|
# Optional metadata
|
|
notes: str | None = Field(
|
|
None,
|
|
max_length=500,
|
|
description="Optional note",
|
|
)
|
|
|
|
|
|
class PointsRedeemResponse(BaseModel):
|
|
"""Schema for points redemption response."""
|
|
|
|
success: bool = True
|
|
message: str = "Reward redeemed successfully"
|
|
|
|
# Reward info
|
|
reward_id: str
|
|
reward_name: str
|
|
points_spent: int
|
|
|
|
# Card state after redemption
|
|
card_id: int
|
|
card_number: str
|
|
points_balance: int
|
|
total_points_redeemed: int
|