카테고리 검색 필터링 + Facet 집계 — Lucene FILTER 절 설계

사용자 검색 요청: GET /api/v1.0/posts/search?q=프로그래밍&page=0&size=20
  → PostService.search(keyword, pageable)
  → TieredCacheService L1(Caffeine) → L2(Redis) → Origin:
    → LuceneSearchService.search(keyword, pageable)
    → buildQuery(keyword):
        MUST:   BM25(title^3, content^1) via MultiFieldQueryParser + Nori
        SHOULD: FeatureField.saturation(viewCount, w=3.0, pivot=1000)
        SHOULD: FeatureField.saturation(likeCount, w=2.0, pivot=100)
        SHOULD: RecencyDecay(halfLife=30일)
    → TopDocs → Lucene doc에서 ID 추출 → DB findAllById → Slice<Post>
  → PostSearchResponse(id, title, snippet, viewCount, likeCount, createdAt)

Document doc = new Document();
doc.add(new KeywordField("id", post.getId().toString(), Field.Store.YES));
doc.add(new TextField("title", post.getTitle(), Field.Store.YES));
doc.add(new TextField("content", post.getContent(), Field.Store.NO));

if (post.getCategoryId() != null) {
    doc.add(new LongField("categoryId", post.getCategoryId(), Field.Store.YES));
}

doc.add(new LongField("viewCount", post.getViewCount(), Field.Store.YES));
doc.add(new LongField("createdAt", post.getCreatedAt().toEpochMilli(), Field.Store.YES));
doc.add(new FeatureField("features", "viewCount", Math.max(post.getViewCount(), 1)));
doc.add(new FeatureField("features", "likeCount", Math.max(post.getLikeCount(), 1)));

posts 테이블:
  category_id BIGINT (nullable) — FK to categories 테이블

categories 테이블:
  id BIGINT PK
  name VARCHAR (NOT NULL, UNIQUE)
  parent_id BIGINT (nullable) — 계층 구조 지원

@GetMapping
public Slice<PostListResponse> getPosts(
    @RequestParam(required = false) Long categoryId,
    Pageable pageable
) {
    if (categoryId != null) {
        return postService.getPostsByCategory(categoryId, pageable);
    }
    return postService.getLatestPosts(pageable);
}

@GetMapping("/search")
public Slice<PostSearchResponse> search(
    @RequestParam String q,
    Pageable pageable
) {
    return postService.search(q, pageable);
}

Google: "프로그래밍" → 탭(전체/이미지/뉴스/동영상) + 도구(기간 필터)
네이버: "프로그래밍" → 탭(통합/블로그/카페/지식iN) + 카테고리 필터
Stack Overflow: 태그 기반 필터링 (java, python, etc.) + 태그별 질문 수 표시
Amazon: 상품 검색 → 좌측 카테고리 트리 + 각 카테고리별 건수

// 현재 buildQuery() — 카테고리 필터 없음
return new BooleanQuery.Builder()
    .add(textQuery, BooleanClause.Occur.MUST)        // 텍스트 매칭
    .add(viewBoost, BooleanClause.Occur.SHOULD)       // 인기도
    .add(likeBoost, BooleanClause.Occur.SHOULD)       // 좋아요
    .add(recencyBoost, BooleanClause.Occur.SHOULD)    // 최신성
    .build();

// build.gradle — 현재
implementation 'org.apache.lucene:lucene-core:10.3.2'
implementation 'org.apache.lucene:lucene-analysis-nori:10.3.2'
implementation 'org.apache.lucene:lucene-queryparser:10.3.2'
implementation 'org.apache.lucene:lucene-queries:10.3.2'
// lucene-facet 없음!

// LuceneSearchService — 변경
public Slice<Post> search(String keyword, Long categoryId, Pageable pageable) throws IOException {
    IndexSearcher searcher = searcherManager.acquire();
    try {
        Query query = buildQuery(keyword, categoryId);  // categoryId 전달
        // ... 기존 로직 동일
    }
}

private Query buildQuery(String keyword, Long categoryId) throws ParseException {
    // 기존 BM25 + 인기도 + 최신성 쿼리
    BooleanQuery.Builder builder = new BooleanQuery.Builder()
        .add(textQuery, BooleanClause.Occur.MUST)
        .add(viewBoost, BooleanClause.Occur.SHOULD)
        .add(likeBoost, BooleanClause.Occur.SHOULD)
        .add(recencyBoost, BooleanClause.Occur.SHOULD);

    // 카테고리 필터 추가
    if (categoryId != null) {
        builder.add(LongField.newExactQuery("categoryId", categoryId),
                     BooleanClause.Occur.FILTER);
    }

    return builder.build();
}

// PostController — 검색 엔드포인트에 categoryId 추가
@GetMapping("/search")
public Slice<PostSearchResponse> search(
    @RequestParam String q,
    @RequestParam(required = false) Long categoryId,
    Pageable pageable
) {
    return postService.search(q, categoryId, pageable);
}

// PostService — categoryId를 LuceneSearchService에 전달
public Slice<PostSearchResponse> search(String keyword, Long categoryId, Pageable pageable) {
    // 캐시 키에 categoryId 포함
    String cacheKey = keyword + ":" + categoryId + ":" + pageable.getPageNumber()
                    + ":" + pageable.getPageSize();
    // L1 → L2 → origin 기존 로직 동일, origin에서 categoryId 전달
    Slice<Post> posts = luceneSearchService.search(keyword, categoryId, pageable);
    // ...
}

// PostService — 카테고리 Facet (DB 기반 간이 구현)
public List<CategoryFacet> getCategoryFacets(String keyword, int topN) throws IOException {
    // 1. Lucene에서 검색 결과 전체 ID 추출 (상위 1000건 제한)
    List<Long> postIds = luceneSearchService.searchIds(keyword, 1000);

    // 2. DB에서 카테고리별 건수 집계
    return postRepository.countByCategoryIdIn(postIds).stream()
        .sorted(Comparator.comparing(CategoryFacet::count).reversed())
        .limit(topN)
        .toList();
}

-- PostRepository — 카테고리별 건수 집계
@Query("SELECT new com.wiki.engine.post.dto.CategoryFacet(c.id, c.name, COUNT(p)) " +
       "FROM Post p JOIN Category c ON p.categoryId = c.id " +
       "WHERE p.id IN :postIds " +
       "GROUP BY c.id, c.name " +
       "ORDER BY COUNT(p) DESC")
List<CategoryFacet> countByCategoryIdIn(@Param("postIds") List<Long> postIds);

// PostSearchResponse — categoryId 추가
public record PostSearchResponse(
    Long id,
    String title,
    String snippet,
    Long viewCount,
    Long likeCount,
    Instant createdAt,
    Long categoryId       // 추가
) {}

// CategoryFacet — Facet 집계 결과
public record CategoryFacet(
    Long id,
    String name,
    Long count
) {}

// SearchWithFacetsResponse — 검색 + Facet 통합 응답
public record SearchWithFacetsResponse(
    Slice<PostSearchResponse> results,
    List<CategoryFacet> facets
) {}

기존:  GET /api/v1.0/posts/search?q=프로그래밍&page=0&size=20
변경:  GET /api/v1.0/posts/search?q=프로그래밍&category=42&page=0&size=20

응답:
{
  "data": {
    "results": {
      "content": [
        { "id": 123, "title": "...", "snippet": "...", "categoryId": 42, ... }
      ],
      "hasNext": true
    },
    "facets": [
      { "id": 42, "name": "프로그래밍 언어", "count": 342 },
      { "id": 15, "name": "소프트웨어 공학", "count": 189 },
      { "id": 7, "name": "운영체제", "count": 127 }
    ]
  }
}