mint/api-v13/app/Http/Controllers/TermVocabularyController.php

<?php

namespace App\Http\Controllers;

use App\Http\Resources\TermVocabularyResource;
use App\Models\DhammaTerm;
use App\Services\TermService;
use Illuminate\Http\Request;
use Illuminate\Http\Response;

class TermVocabularyController extends Controller
{
    protected TermService $termService;

    public function __construct(TermService $termService)
    {
        $this->termService = $termService;
    }

    /**
     * Display a listing of the resource.
     *
     * @return Response
     */
    public function index(Request $request)
    {
        // ✅ 数据验证
        $validated = $request->validate([
            'view' => ['required', 'string'],
            'lang' => ['nullable', 'string'],
        ]);

        $view = $validated['view'];
        $lang = $validated['lang'] ?? null;

        // TODO: 下面两条 throw 都会变成 500，客户端因此分不清「我传错了参数」和
        // 「服务端挂了」。2026-08-11 在 next 上实测：view=community / grammar 返回
        // 200，view=my / all / public / user / studio 一律 500。
        //   - 无效取值应是 422：把合法值写进上面的 validate（'view' => [..., 'in:grammar,community']），
        //     由框架拦下，与本控制器已有的 required 校验一致
        //   - studio / user 尚未实现，应返回 501，而不是与「参数写错」同一个状态码
        // ✅ 使用 match 替代 switch
        $data = match ($view) {
            'grammar' => $this->termService->getGrammarGlossary($lang),
            'community' => $this->termService->getCommunityGlossary($lang),
            'studio', 'user' => throw new \Exception('not implemented'),
            default => throw new \InvalidArgumentException('invalid view'),
        };

        return $this->ok([
            'rows' => TermVocabularyResource::collection($data['items']),
            'count' => $data['total'],
        ]);
    }

    /**
     * Store a newly created resource in storage.
     *
     * @return Response
     */
    public function store(Request $request)
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @return Response
     */
    public function show(DhammaTerm $dhammaTerm)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     *
     * @return Response
     */
    public function update(Request $request, DhammaTerm $dhammaTerm)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @return Response
     */
    public function destroy(DhammaTerm $dhammaTerm)
    {
        //
    }
}