from fastapi import APIRouter, Depends, HTTPException, Query, status, Request from sqlalchemy.orm import Session from typing import List, Optional, Any from app.core.database.db_session import get_db from app.core.permissions.RoleChecker import get_current_user from app.models.UserModel import User from app.services.ReviewModerationService import ReviewModerationService from app.schemas.ReviewModeration import ( ReviewCreate, ReviewModerateAction, ReviewResponse, CSATMetricsResponse ) router = APIRouter(prefix="/api/v1/reviews", tags=["Review & Reputation Moderation"]) def get_review_service(request: Request, db: Session = Depends(get_db)) -> ReviewModerationService: tenant_id = getattr(request.state, "tenant_id", "tenant_default") return ReviewModerationService(db=db, tenant_id=tenant_id) @router.post("", response_model=ReviewResponse, status_code=status.HTTP_201_CREATED) def submit_review( payload: ReviewCreate, svc: ReviewModerationService = Depends(get_review_service) ) -> Any: """Submits a customer review for products, repair services, technicians, or store.""" return svc.submit_review(payload) @router.get("", response_model=List[ReviewResponse]) def list_reviews( skip: int = Query(0, ge=0), limit: int = Query(50, ge=1, le=200), moderation_status: Optional[str] = Query(None, alias="status"), target_type: Optional[str] = None, target_id: Optional[str] = None, published_only: bool = False, svc: ReviewModerationService = Depends(get_review_service) ) -> Any: """Lists customer reviews with filtering for admin queue or public storefront.""" return svc.list_reviews( skip=skip, limit=limit, moderation_status=moderation_status, target_type=target_type, target_id=target_id, published_only=published_only ) @router.post("/{review_id}/moderate", response_model=ReviewResponse) def moderate_review( review_id: str, action: ReviewModerateAction, svc: ReviewModerationService = Depends(get_review_service), current_user: User = Depends(get_current_user) ) -> Any: """Moderates a review (APPROVED, REJECTED, or FLAGGED) with audit trail.""" return svc.moderate_review(review_id=review_id, action=action, moderator_id=current_user.id) @router.get("/csat-metrics", response_model=CSATMetricsResponse) def get_csat_metrics( target_type: str = Query(..., description="PRODUCT, REPAIR_SERVICE, TECHNICIAN, STORE"), target_id: str = Query(...), svc: ReviewModerationService = Depends(get_review_service) ) -> Any: """Retrieves CSAT metrics and average rating index for a product or repair technician.""" return svc.get_csat_metrics(target_type=target_type, target_id=target_id)