orion/app/modules/catalog/routes/api/admin.py

# app/modules/catalog/routes/api/admin.py
"""
Admin store product catalog endpoints.

Provides management of store-specific product catalogs:
- Browse products in store catalogs
- View product details with override info
- Create/update/remove products from catalog

All routes require module access control for the 'catalog' module.
"""

import logging

from fastapi import APIRouter, Depends, Query
from sqlalchemy.orm import Session

from app.api.deps import get_current_admin_api, require_module_access
from app.core.database import get_db
from app.modules.billing.services.subscription_service import subscription_service
from app.modules.catalog.schemas import (
    CatalogStore,
    CatalogStoresResponse,
    RemoveProductResponse,
    StoreProductCreate,
    StoreProductCreateResponse,
    StoreProductDetail,
    StoreProductListItem,
    StoreProductListResponse,
    StoreProductStats,
    StoreProductUpdate,
)
from app.modules.catalog.services.store_product_service import store_product_service
from app.modules.enums import FrontendType
from models.schema.auth import UserContext

admin_router = APIRouter(
    prefix="/store-products",
    dependencies=[Depends(require_module_access("catalog", FrontendType.ADMIN))],
)
logger = logging.getLogger(__name__)


# ============================================================================
# Endpoints
# ============================================================================


@admin_router.get("", response_model=StoreProductListResponse)
def get_store_products(
    skip: int = Query(0, ge=0),
    limit: int = Query(50, ge=1, le=500),
    search: str | None = Query(None, description="Search by title or SKU"),
    store_id: int | None = Query(None, description="Filter by store"),
    is_active: bool | None = Query(None, description="Filter by active status"),
    is_featured: bool | None = Query(None, description="Filter by featured status"),
    language: str = Query("en", description="Language for title lookup"),
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """
    Get all products in store catalogs with filtering.

    This endpoint allows admins to browse products that have been
    copied to store catalogs from the marketplace repository.
    """
    products, total = store_product_service.get_products(
        db=db,
        skip=skip,
        limit=limit,
        search=search,
        store_id=store_id,
        is_active=is_active,
        is_featured=is_featured,
        language=language,
    )

    return StoreProductListResponse(
        products=[StoreProductListItem(**p) for p in products],
        total=total,
        skip=skip,
        limit=limit,
    )


@admin_router.get("/stats", response_model=StoreProductStats)
def get_store_product_stats(
    store_id: int | None = Query(None, description="Filter stats by store ID"),
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Get store product statistics for admin dashboard."""
    stats = store_product_service.get_product_stats(db, store_id=store_id)
    return StoreProductStats(**stats)


@admin_router.get("/stores", response_model=CatalogStoresResponse)
def get_catalog_stores(
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Get list of stores with products in their catalogs."""
    stores = store_product_service.get_catalog_stores(db)
    return CatalogStoresResponse(stores=[CatalogStore(**v) for v in stores])


@admin_router.get("/{product_id}", response_model=StoreProductDetail)
def get_store_product_detail(
    product_id: int,
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Get detailed store product information including override info."""
    product = store_product_service.get_product_detail(db, product_id)
    return StoreProductDetail(**product)


@admin_router.post("", response_model=StoreProductCreateResponse)
def create_store_product(
    data: StoreProductCreate,
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Create a new store product."""
    # Check product limit before creating
    subscription_service.check_product_limit(db, data.store_id)

    product = store_product_service.create_product(db, data.model_dump())
    db.commit()
    return StoreProductCreateResponse(
        id=product.id, message="Product created successfully"
    )


@admin_router.patch("/{product_id}", response_model=StoreProductDetail)
def update_store_product(
    product_id: int,
    data: StoreProductUpdate,
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Update a store product."""
    # Only include fields that were explicitly set
    update_data = data.model_dump(exclude_unset=True)
    store_product_service.update_product(db, product_id, update_data)
    db.commit()
    # Return the updated product detail
    product = store_product_service.get_product_detail(db, product_id)
    return StoreProductDetail(**product)


@admin_router.delete("/{product_id}", response_model=RemoveProductResponse)
def remove_store_product(
    product_id: int,
    db: Session = Depends(get_db),
    current_admin: UserContext = Depends(get_current_admin_api),
):
    """Remove a product from store catalog."""
    result = store_product_service.remove_product(db, product_id)
    db.commit()
    return RemoveProductResponse(**result)