orion/app/modules/loyalty/routes/pages/vendor.py

# app/modules/loyalty/routes/pages/vendor.py
"""
Loyalty Vendor Page Routes (HTML rendering).

Vendor pages for:
- Loyalty terminal (primary daily interface for staff)
- Loyalty members management
- Program settings
- Stats dashboard
"""

import logging

from fastapi import APIRouter, Depends, Path, Request
from fastapi.responses import HTMLResponse
from sqlalchemy.orm import Session

from app.api.deps import get_current_vendor_from_cookie_or_header, get_db
from app.modules.core.services.platform_settings_service import platform_settings_service
from app.templates_config import templates
from app.modules.tenancy.models import User, Vendor

logger = logging.getLogger(__name__)

router = APIRouter()

# Route configuration for module route discovery
ROUTE_CONFIG = {
    "prefix": "/loyalty",
    "tags": ["vendor-loyalty"],
}


# ============================================================================
# HELPER: Build Vendor Context
# ============================================================================


def get_vendor_context(
    request: Request,
    db: Session,
    current_user: User,
    vendor_code: str,
    **extra_context,
) -> dict:
    """Build template context for vendor loyalty pages."""
    # Load vendor from database
    vendor = db.query(Vendor).filter(Vendor.subdomain == vendor_code).first()

    # Get platform defaults
    platform_config = platform_settings_service.get_storefront_config(db)

    # Resolve with vendor override
    storefront_locale = platform_config["locale"]
    storefront_currency = platform_config["currency"]

    if vendor and vendor.storefront_locale:
        storefront_locale = vendor.storefront_locale

    context = {
        "request": request,
        "user": current_user,
        "vendor": vendor,
        "vendor_code": vendor_code,
        "storefront_locale": storefront_locale,
        "storefront_currency": storefront_currency,
        "dashboard_language": vendor.dashboard_language if vendor else "en",
    }

    # Add any extra context
    if extra_context:
        context.update(extra_context)

    return context


# ============================================================================
# LOYALTY TERMINAL (Primary Daily Interface)
# ============================================================================


@router.get(
    "/{vendor_code}/terminal",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_terminal(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render loyalty terminal page.
    Primary interface for staff to look up customers, award points, and process redemptions.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/terminal.html",
        get_vendor_context(request, db, current_user, vendor_code),
    )


# ============================================================================
# LOYALTY MEMBERS
# ============================================================================


@router.get(
    "/{vendor_code}/cards",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_cards(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render loyalty members list page.
    Shows all loyalty card holders for this company.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/cards.html",
        get_vendor_context(request, db, current_user, vendor_code),
    )


@router.get(
    "/{vendor_code}/cards/{card_id}",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_card_detail(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    card_id: int = Path(..., description="Loyalty card ID"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render loyalty card detail page.
    Shows card holder info, transaction history, and actions.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/card-detail.html",
        get_vendor_context(request, db, current_user, vendor_code, card_id=card_id),
    )


# ============================================================================
# PROGRAM SETTINGS
# ============================================================================


@router.get(
    "/{vendor_code}/settings",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_settings(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render loyalty program settings page.
    Allows vendor to configure points rate, rewards, branding, etc.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/settings.html",
        get_vendor_context(request, db, current_user, vendor_code),
    )


# ============================================================================
# STATS DASHBOARD
# ============================================================================


@router.get(
    "/{vendor_code}/stats",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_stats(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render loyalty statistics dashboard.
    Shows vendor's loyalty program metrics and trends.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/stats.html",
        get_vendor_context(request, db, current_user, vendor_code),
    )


# ============================================================================
# ENROLLMENT
# ============================================================================


@router.get(
    "/{vendor_code}/enroll",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def vendor_loyalty_enroll(
    request: Request,
    vendor_code: str = Path(..., description="Vendor code"),
    current_user: User = Depends(get_current_vendor_from_cookie_or_header),
    db: Session = Depends(get_db),
):
    """
    Render customer enrollment page.
    Staff interface for enrolling new customers into the loyalty program.
    """
    return templates.TemplateResponse(
        "loyalty/vendor/enroll.html",
        get_vendor_context(request, db, current_user, vendor_code),
    )