# 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( "/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), )