02강: 쿼리 스코프(Query Scopes) & 도서 다중 필터링/정렬 체이닝

// app/Models/Book.php 내부에 추가
use Illuminate\Database\Eloquent\Builder;

/**
 * 1. 출판 완료된 정상 도서만 조회
 */
public function scopePublished(Builder $query): void
{
    $query->where('status', 'published');
}

/**
 * 2. 실물 재고가 남아있는 도서만 조회 (또는 무제한 전자책)
 */
public function scopeInStock(Builder $query): void
{
    $query->where(function (Builder $q) {
        $q->where('stock_quantity', '>', 0)
          ->orWhere('format', 'ebook');
    });
}

/**
 * 3. 할인 중인 도서만 조회
 */
public function scopeDiscounted(Builder $query): void
{
    $query->whereNotNull('sale_price')
          ->whereColumn('sale_price', '<', 'price');
}

/**
 * 4. 도서명 및 소개글 키워드 검색 스코프
 */
public function scopeSearch(Builder $query, ?string $keyword): void
{
    if (empty($keyword)) {
        return;
    }

    $query->where(function (Builder $q) use ($keyword) {
        $q->where('title', 'like', "%{$keyword}%")
          ->orWhere('isbn', 'like', "%{$keyword}%")
          ->orWhere('description', 'like', "%{$keyword}%");
    });
}

/**
 * 5. 정렬 기준 적용 스코프
 */
public function scopeSortBy(Builder $query, string $sort): void
{
    match ($sort) {
        'price_asc' => $query->orderByRaw('COALESCE(sale_price, price) ASC'),
        'price_desc' => $query->orderByRaw('COALESCE(sale_price, price) DESC'),
        'latest' => $query->orderBy('published_at', 'desc'),
        default => $query->orderBy('id', 'desc'), // 기본 최신순
    };
}

// app/Http/Controllers/BookController.php
use App\Models\Book;
use Illuminate\Http\Request;

public function index(Request $request)
{
    $keyword = $request->string('keyword')->trim()->value();
    $categoryId = $request->integer('category_id');
    $inStockOnly = $request->boolean('in_stock_only', false);
    $discountOnly = $request->boolean('discount_only', false);
    $sort = $request->input('sort', 'latest');

    // 1. 기본 쿼리 빌더 시작 (출판 완료 도서)
    $books = Book::query()
        ->published()
        // 검색어가 있으면 search 스코프 적용
        ->when($keyword, fn ($q) => $q->search($keyword))
        // 카테고리 필터가 있으면 적용
        ->when($categoryId, fn ($q) => $q->where('category_id', $categoryId))
        // 재고 필터 플래그가 켜져 있으면 inStock 적용
        ->when($inStockOnly, fn ($q) => $q->inStock())
        // 할인 도서 플래그
        ->when($discountOnly, fn ($q) => $q->discounted())
        // 정렬 적용
        ->sortBy($sort)
        // 3강에서 배울 12권씩 페이징 적용
        ->paginate(12)
        ->withQueryString(); // 검색 쿼리스트링 파라미터 링크 유지!

    return view('books.index', compact('books', 'keyword', 'categoryId', 'inStockOnly', 'discountOnly', 'sort'));
}