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

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

Admin pages for:
- Platform loyalty programs dashboard
- Merchant loyalty program detail/configuration
- Platform-wide loyalty statistics
"""

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

from app.api.deps import get_db, require_menu_access
from app.modules.core.utils.page_context import get_admin_context
from app.modules.enums import FrontendType
from app.modules.tenancy.models import User
from app.templates_config import templates

router = APIRouter()

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


# ============================================================================
# LOYALTY PROGRAMS DASHBOARD
# ============================================================================


@router.get("/programs", response_class=HTMLResponse, include_in_schema=False)
async def admin_loyalty_programs(
    request: Request,
    current_user: User = Depends(require_menu_access("loyalty-programs", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render loyalty programs dashboard.
    Shows all merchants with loyalty programs and platform-wide statistics.
    """
    return templates.TemplateResponse(
        "loyalty/admin/programs.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/analytics", response_class=HTMLResponse, include_in_schema=False)
async def admin_loyalty_analytics(
    request: Request,
    current_user: User = Depends(require_menu_access("loyalty-analytics", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render loyalty analytics dashboard.
    Shows platform-wide loyalty statistics and trends.
    """
    return templates.TemplateResponse(
        "loyalty/admin/analytics.html",
        get_admin_context(request, db, current_user),
    )


# ============================================================================
# MERCHANT LOYALTY DETAIL
# ============================================================================


@router.get("/wallet-debug", response_class=HTMLResponse, include_in_schema=False)
async def admin_wallet_debug(
    request: Request,
    current_user: User = Depends(require_menu_access("wallet-debug", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """Render wallet diagnostics debug page (super admin only)."""
    return templates.TemplateResponse(
        "loyalty/admin/wallet-debug.html",
        get_admin_context(request, db, current_user),
    )


@router.get(
    "/merchants/{merchant_id}",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def admin_loyalty_merchant_detail(
    request: Request,
    merchant_id: int = Path(..., description="Merchant ID"),
    current_user: User = Depends(require_menu_access("loyalty-programs", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render merchant loyalty program detail page.
    Shows merchant's loyalty program configuration and location breakdown.
    """
    return templates.TemplateResponse(
        "loyalty/admin/merchant-detail.html",
        get_admin_context(request, db, current_user, merchant_id=merchant_id),
    )


@router.get(
    "/merchants/{merchant_id}/program",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def admin_loyalty_program_edit(
    request: Request,
    merchant_id: int = Path(..., description="Merchant ID"),
    current_user: User = Depends(require_menu_access("loyalty-programs", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render program configuration edit page for a merchant.
    Allows admin to create or edit the merchant's loyalty program settings.
    """
    return templates.TemplateResponse(
        "loyalty/admin/program-edit.html",
        get_admin_context(request, db, current_user, merchant_id=merchant_id),
    )


@router.get(
    "/merchants/{merchant_id}/settings",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def admin_loyalty_merchant_settings(
    request: Request,
    merchant_id: int = Path(..., description="Merchant ID"),
    current_user: User = Depends(require_menu_access("loyalty-programs", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render merchant loyalty settings page.
    Admin-controlled settings like staff PIN policy.
    """
    return templates.TemplateResponse(
        "loyalty/admin/merchant-settings.html",
        get_admin_context(request, db, current_user, merchant_id=merchant_id),
    )