mint/api-v12/app/Http/Controllers/SearchPlusController.php

<?php

namespace App\Http\Controllers;

use App\Services\OpenSearchService;
use Illuminate\Http\Request;
use App\DTO\Search\HitItemDTO;

class SearchPlusController extends Controller
{
    /**
     * 构造函数，注入 OpenSearchService
     *
     * @param  \App\Services\OpenSearchService  $searchService
     */
    public function __construct(protected OpenSearchService $searchService) {}

    /**
     * Display a listing of the resource.
     *
     * 处理搜索请求，支持 fuzzy / exact / semantic / hybrid 四种模式。
     * 接收查询参数并调用 OpenSearchService 执行搜索。
     *
     * 支持 GET 和 POST 请求
     *
     * @param  \Illuminate\Http\Request  $request
     *   - q (string): 搜索关键词
     *   - resource_type (string): 资源类型 (article|term|dictionary|translation|origin_text|nissaya)
     *   - granularity (string): 文档颗粒度 (book|chapter|sutta|section|paragraph|sentence)
     *   - language (string): 语言，如 pali, zh-Hans, zh-Hant, en-US, my
     *   - category (string): 文档分类 (pali|commentary|subcommentary)
     *   - tags (array): 标签过滤
     *   - page_refs (array): 页码标记 ["V3.81","M3.58"]
     *   - related_id (array): 关联 ID，如 ["chapter_93-5","m.n. 38"]
     *   - author (string): 作者或译者 (metadata.author)
     *   - channel (string): 来源渠道 (metadata.channel)
     *   - page (int): 页码，默认 1
     *   - page_size (int): 每页数量，默认 20，最大 100
     *   - search_mode (string): fuzzy|exact|semantic|hybrid，默认 fuzzy
     *
     * @return \Illuminate\Http\JsonResponse
     */
    public function index(Request $request)
    {
        // 获取所有输入参数（自动兼容 GET 和 POST）
        $input = $request->all();

        // 基础参数 - 使用 $input 或直接用 $request->input() (已兼容 GET/POST)
        $query        = $request->input('q', '');
        $page         = max(1, (int) $request->input('page', 1));
        $pageSize     = min(100, (int) $request->input('page_size', 20));
        $searchMode   = $request->input('search_mode', 'fuzzy');
        $resourceType = $request->input('resource_type'); // 资源类型
        $resourceId = $request->input('resource_id'); // 资源类型
        $granularity  = $request->input('granularity');   // 文档颗粒度
        $language     = $request->input('language');      // 语言
        $category     = $request->input('category');      // 分类
        $tags         = $request->has('tags') ? explode(',', $request->input('tags')) : [];      // 标签
        $pageRefs     = $request->input('page_refs', []); // 页码标记
        $relatedId    = $request->input('related_id'); // 关联 ID
        $author       = $request->input('author');        // 作者/译者 (metadata.author)
        $channel      = $request->input('channel');       // 来源渠道 (metadata.channel)

        // 确保数组类型参数正确解析（POST 时可能是 JSON 字符串）
        $tags = is_array($tags) ? $tags : (is_string($tags) ? json_decode($tags, true) ?? [] : []);
        $pageRefs = is_array($pageRefs) ? $pageRefs : (is_string($pageRefs) ? json_decode($pageRefs, true) ?? [] : []);

        // 组装搜索参数
        $params = [
            'query'        => $query,
            'page'         => $page,
            'pageSize'     => $pageSize,
            'searchMode'   => $searchMode,
            'resourceType' => $resourceType,
            'resourceId'   => $resourceId,
            'granularity'  => $granularity,
            'language'     => $language,
            'category'     => $category,
            'tags'         => $tags,
            'pageRefs'     => $pageRefs,
            'relatedId'    => $relatedId,
            'author'       => $author,
            'channel'      => $channel,
        ];

        try {
            // 调用 OpenSearchService 执行搜索
            $result = $this->searchService->search($params);

            return response()->json([
                'success' => true,
                'data'    => $result,
                'query_info' => [
                    'original_query' => $query,
                    'search_mode'    => $searchMode,
                    'request_method' => $request->method(), // 可选：返回请求方法
                ],
            ]);
        } catch (\Exception $e) {
            return response()->json([
                'success' => false,
                'error'   => $e->getMessage(),
            ], 500);
        }
    }

    /**
     * Store a newly created resource in storage.
     *
     * POST 方式调用搜索接口（与 index 方法功能相同）
     *
     * @route POST /api/search
     * @param JSON: 搜索参数（与 index 方法参数相同）
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function store(Request $request)
    {
        // 直接调用 index 方法，复用搜索逻辑
        return $this->index($request);
    }

    /**
     * Display the specified resource.
     *
     * @param  int  $id
     * @return \Illuminate\Http\Response
     */
    public function show($id)
    {
        //
        return $this->ok(HitItemDTO::fromArray($this->searchService->get($id)));
    }

    /**
     * 更新资源
     * @route PUT /api/search/{uid}
     * @param JSON: OpenSearch 格式数据
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, $uid) {}

    /**
     * Remove the specified resource from storage.
     *
     * 删除资源
     * @route DELETE /api/search/{uid}
     * @return \Illuminate\Http\Response
     */
    public function destroy($uid) {}
}