feat(storefront): expose available promotional coupons and flexible coupon payload

This commit is contained in:
iFixKart Dev 2026-11-06 18:37:45 +05:30
parent 3ac30e702e
commit a98332f185
4 changed files with 97 additions and 3 deletions

View file

@ -44,7 +44,13 @@ class MergeGuestCartRequest(BaseModel):
class ApplyCouponRequest(BaseModel): class ApplyCouponRequest(BaseModel):
code: str code: Optional[str] = None
coupon_code: Optional[str] = None
@property
def coupon_key(self) -> str:
raw = self.code or self.coupon_code or ""
return raw.strip().upper()
def _ensure_stock(db: Session, variant_id: str, requested_qty: int, sku: Optional[str] = None) -> None: def _ensure_stock(db: Session, variant_id: str, requested_qty: int, sku: Optional[str] = None) -> None:
@ -367,7 +373,7 @@ def apply_cart_coupon(
# Validate coupon via Rule Engine # Validate coupon via Rule Engine
res = CouponService.validate_coupon( res = CouponService.validate_coupon(
db=db, db=db,
code=payload.code, code=payload.coupon_key,
customer_id=customer.customer_id, customer_id=customer.customer_id,
items=totals_preview["items"], items=totals_preview["items"],
subtotal=subtotal, subtotal=subtotal,

View file

@ -2,7 +2,7 @@
@router Public Storefront Router (Backend/app/api/v1/routers/storefront.py) @router Public Storefront Router (Backend/app/api/v1/routers/storefront.py)
@purpose Read-only public endpoints for layout widgets, reviews, and settings powered by StorefrontService. @purpose Read-only public endpoints for layout widgets, reviews, and settings powered by StorefrontService.
""" """
from fastapi import APIRouter, Depends, Query, HTTPException, status from fastapi import APIRouter, Depends, Query, HTTPException, status, Request
from sqlalchemy.orm import Session, selectinload from sqlalchemy.orm import Session, selectinload
from sqlalchemy import select from sqlalchemy import select
from typing import List, Dict, Any, Optional from typing import List, Dict, Any, Optional
@ -259,3 +259,89 @@ def get_category_parent_hierarchy(category_id: str, db: Session = Depends(get_db
)) ))
return CategoryParentHierarchyResponse(category_id=category_id, brands=brands_list) return CategoryParentHierarchyResponse(category_id=category_id, brands=brands_list)
@router.get("/coupons")
def get_storefront_available_coupons(
request: Request,
db: Session = Depends(get_db)
):
"""
Returns active promotional coupons available for storefront customers.
Optionally evaluates customer token to flag eligibility (e.g. 1st order rule).
"""
from datetime import datetime
from app.models.CouponModel import Coupon, CouponUsage
from app.models.OrderModel import Order
from app.core.Token import verify_access_token
# 1. Resolve optional customer from Authorization header
customer_id = None
auth_header = request.headers.get("Authorization")
if auth_header and auth_header.startswith("Bearer "):
token = auth_header.split(" ")[1]
try:
payload = verify_access_token(token)
if payload.get("role") == "customer":
customer_id = payload.get("sub")
except Exception:
pass
# Customer orders count if logged in
customer_order_count = 0
if customer_id:
customer_order_count = db.query(Order).filter(
Order.customer_id == customer_id,
Order.status.notin_(["CANCELLED", "PAYMENT_FAILED"])
).count()
now = datetime.now()
coupons = db.query(Coupon).filter(
Coupon.is_active == True,
Coupon.valid_from <= now,
Coupon.valid_to >= now,
Coupon.channel_scope.notin_(["POS_ONLY", "STORE_POS"])
).order_by(Coupon.discount_value.desc()).all()
result = []
for c in coupons:
# Check global cap
if c.usage_limit_total and c.times_used >= c.usage_limit_total:
continue
is_eligible = True
ineligibility_reason = None
if customer_id:
# Check 1st order rule
if c.first_order_only and customer_order_count > 0:
is_eligible = False
ineligibility_reason = "Valid for first purchase only"
# Check per-customer limit
if c.usage_limit_per_customer:
user_usages = db.query(CouponUsage).filter(
CouponUsage.coupon_id == c.coupon_id,
CouponUsage.customer_id == customer_id
).count()
if user_usages >= c.usage_limit_per_customer:
is_eligible = False
ineligibility_reason = "Already redeemed"
result.append({
"coupon_id": c.coupon_id,
"code": c.code,
"title": c.title,
"description": c.description,
"discount_type": c.discount_type,
"discount_value": float(c.discount_value),
"max_discount_cap": float(c.max_discount_cap) if c.max_discount_cap else None,
"min_order_amount": float(c.min_order_amount),
"first_order_only": bool(c.first_order_only),
"valid_to": c.valid_to.isoformat() if c.valid_to else None,
"is_eligible": is_eligible,
"ineligibility_reason": ineligibility_reason
})
return result

View file

@ -61,3 +61,4 @@ class CouponUsage(Base):
coupon = relationship("Coupon", back_populates="usages") coupon = relationship("Coupon", back_populates="usages")
order = relationship("Order", backref="coupon_usage") order = relationship("Order", backref="coupon_usage")

View file

@ -207,3 +207,4 @@ class CouponService:
) )
db.add(usage) db.add(usage)
return usage return usage