chatroom/app/Http/Controllers/Admin/ForbiddenUsernameController.php

<?php

/**
 * 文件功能：禁用用户名管理控制器（站长专用）
 *
 * 管理 username_blacklist 表中 type=permanent 的永久禁用词列表。
 * 包含：国家领导人名称、攻击性词汇、违禁词等不允许注册或改名的词语。
 *
 * 用户在注册（AuthController）和改名（ShopService::useRenameCard）时均会经过该表检测。
 *
 * @author  ChatRoom Laravel
 *
 * @version 1.0.0
 */

namespace App\Http\Controllers\Admin;

use App\Http\Controllers\Controller;
use App\Models\UsernameBlacklist;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Carbon;

class ForbiddenUsernameController extends Controller
{
    /**
     * 分页列出所有永久禁用词。
     * 支持关键词模糊搜索（GET ?q=xxx）。
     */
    public function index(Request $request): \Illuminate\View\View
    {
        $q = $request->query('q', '');

        $items = UsernameBlacklist::permanent()
            ->when($q, fn ($query) => $query->where('username', 'like', "%{$q}%"))
            ->orderByDesc('created_at')
            ->paginate(20)
            ->withQueryString();

        return view('admin.forbidden-usernames.index', [
            'items' => $items,
            'q' => $q,
        ]);
    }

    /**
     * 新增一条永久禁用词。
     *
     * @param  Request  $request  请求体：username（必填），reason（选填）
     */
    public function store(Request $request): JsonResponse
    {
        $validated = $request->validate([
            'username' => ['required', 'string', 'max:50'],
            'reason' => ['nullable', 'string', 'max:100'],
        ], [
            'username.required' => '禁用词不能为空。',
            'username.max' => '禁用词最长50字符。',
        ]);

        $username = trim($validated['username']);

        // 已存在同名的永久记录则不重复插入
        $exists = UsernameBlacklist::permanent()
            ->where('username', $username)
            ->exists();

        if ($exists) {
            return response()->json(['status' => 'error', 'message' => '该词语已在永久禁用列表中。'], 422);
        }

        UsernameBlacklist::create([
            'username' => $username,
            'type' => 'permanent',
            'reserved_until' => null,
            'reason' => $validated['reason'] ?? null,
            'created_at' => Carbon::now(),
        ]);

        return response()->json(['status' => 'success', 'message' => "「{$username}」已加入永久禁用列表。"]);
    }

    /**
     * 更新指定禁用词的原因备注。
     *
     * @param  int  $id  记录 ID
     * @param  Request  $request  请求体：reason
     */
    public function update(Request $request, int $id): JsonResponse
    {
        $item = UsernameBlacklist::permanent()->findOrFail($id);

        $validated = $request->validate([
            'reason' => ['nullable', 'string', 'max:100'],
        ]);

        $item->update(['reason' => $validated['reason']]);

        return response()->json(['status' => 'success', 'message' => '备注已更新。']);
    }

    /**
     * 删除指定永久禁用词。
     *
     * @param  int  $id  记录 ID
     */
    public function destroy(int $id): JsonResponse
    {
        $item = UsernameBlacklist::permanent()->findOrFail($id);
        $name = $item->username;
        $item->delete();

        return response()->json(['status' => 'success', 'message' => "「{$name}」已从永久禁用列表移除。"]);
    }
}