后端与全仓代码质量清理（golangci 扩展集 · 测试质量 · 并发安全 · 文档同步）

代码质量全量清理，零行为变化：golangci 扩展集 13 类 linter（gosec/modernize/perfsprint/canonicalheader/usestdlibvars/wastedassign/intrange/errorlint/forcetypeassert/recvcheck/exhaustive/unparam）全量修复，测试代码质量（testifylint/thelper/usetesting）25→0，frpc 进程生命周期真 bug（进程组击杀）、全仓 go test -race 6 类数据竞争（含 1 个生产竞争）、SPDX license 头补齐 131 文件、前端测试套件 next-intl 迁移后 44 失败→全绿、过期 swagger 文档重新生成、pnpm-workspace 构建审批。

Experiments: #2-#17, #18, #20, #21, #23
Metric: total_issues 108 → 8 (-92.6%)

frontend/tests/cloudflare/cloudflare-group-detail.test.tsx

@@ -10,6 +10,8 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { CloudflareGroupDetailPageClient } from '@/app/(main)/cloudflare/groups/[id]/page-client';
 import { CloudflareService, NodeService } from '@/lib/services/openflare';
+import { NextIntlClientProvider } from 'next-intl';
+import zhCN from '@/messages/zh-CN.json';
 
 vi.mock('next/navigation', () => ({
   useParams: () => ({ id: '7' }),
@@ -39,9 +41,11 @@ function renderPage() {
     defaultOptions: { queries: { retry: false, gcTime: 0 } },
   });
   render(
-    <QueryClientProvider client={client}>
-      <CloudflareGroupDetailPageClient />
-    </QueryClientProvider>,
+    <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+      <QueryClientProvider client={client}>
+        <CloudflareGroupDetailPageClient />
+      </QueryClientProvider>
+    </NextIntlClientProvider>,
   );
 }
 

frontend/tests/cloudflare/cloudflare-overview.test.tsx

@@ -1,9 +1,10 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { render, screen } from '@testing-library/react';
-import { createElement } from 'react';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import CloudflarePage from '@/app/(main)/cloudflare/page';
+import { NextIntlClientProvider } from 'next-intl';
+import zhCN from '@/messages/zh-CN.json';
 import { AdminTaskService } from '@/lib/services/admin';
 import { CloudflareService, NodeService } from '@/lib/services/openflare';
 
@@ -42,11 +43,11 @@ function renderPage() {
     defaultOptions: { queries: { retry: false, gcTime: 0 } },
   });
   render(
-    createElement(
-      QueryClientProvider,
-      { client },
-      createElement(CloudflarePage),
-    ),
+    <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+      <QueryClientProvider client={client}>
+        <CloudflarePage />
+      </QueryClientProvider>
+    </NextIntlClientProvider>,
   );
 }
 

frontend/tests/cloudflare/member-add-dialog.test.tsx

@@ -2,6 +2,8 @@ import { fireEvent, render, screen, within } from '@testing-library/react';
 import { describe, expect, it, vi } from 'vitest';
 
 import { MemberAddDialog } from '@/app/(main)/cloudflare/components/member-add-dialog';
+import { NextIntlClientProvider } from 'next-intl';
+import zhCN from '@/messages/zh-CN.json';
 import type { CloudflareAvailableDomain } from '@/lib/services/openflare';
 
 const domains: CloudflareAvailableDomain[] = [
@@ -35,15 +37,17 @@ describe('MemberAddDialog advanced domain picker', () => {
   it('groups domains under top-level zone roots and supports batch select', () => {
     const onSubmit = vi.fn();
     render(
-      <MemberAddDialog
+        <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+          <MemberAddDialog
         open
         onOpenChange={vi.fn()}
         domains={domains}
         defaultProxied
         pending={false}
         onSubmit={onSubmit}
-      />,
-    );
+      />
+        </NextIntlClientProvider>,
+      );
 
     expect(screen.getAllByText('example.com').length).toBeGreaterThan(0);
     expect(screen.getAllByText('other.io').length).toBeGreaterThan(0);
@@ -61,15 +65,17 @@ describe('MemberAddDialog advanced domain picker', () => {
 
   it('filters by keyword across domain and zone root', () => {
     render(
-      <MemberAddDialog
+        <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+          <MemberAddDialog
         open
         onOpenChange={vi.fn()}
         domains={domains}
         defaultProxied={false}
         pending={false}
         onSubmit={vi.fn()}
-      />,
-    );
+      />
+        </NextIntlClientProvider>,
+      );
 
     fireEvent.change(screen.getByPlaceholderText('搜索域名或顶级域…'), {
       target: { value: 'other' },
@@ -83,15 +89,17 @@ describe('MemberAddDialog advanced domain picker', () => {
   it('selects an entire top-level domain group', () => {
     const onSubmit = vi.fn();
     render(
-      <MemberAddDialog
+        <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+          <MemberAddDialog
         open
         onOpenChange={vi.fn()}
         domains={domains}
         defaultProxied
         pending={false}
         onSubmit={onSubmit}
-      />,
-    );
+      />
+        </NextIntlClientProvider>,
+      );
 
     fireEvent.click(
       screen.getByRole('checkbox', { name: '选择顶级域 example.com' }),
@@ -107,15 +115,17 @@ describe('MemberAddDialog advanced domain picker', () => {
   it('toggles individual domains within a group', () => {
     const onSubmit = vi.fn();
     render(
-      <MemberAddDialog
+        <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+          <MemberAddDialog
         open
         onOpenChange={vi.fn()}
         domains={domains}
         defaultProxied={false}
         pending={false}
         onSubmit={onSubmit}
-      />,
-    );
+      />
+        </NextIntlClientProvider>,
+      );
 
     const wwwLabel = screen.getByText('www.example.com').closest('label');
     expect(wwwLabel).toBeTruthy();

frontend/tests/cloudflare/sync-tasks-panel.test.tsx

@@ -5,6 +5,8 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { SyncTasksPanel } from '@/app/(main)/cloudflare/components/sync-tasks-panel';
 import { AdminTaskService } from '@/lib/services/admin';
 import type { TaskExecution } from '@/lib/services/admin';
+import { NextIntlClientProvider } from 'next-intl';
+import zhCN from '@/messages/zh-CN.json';
 
 vi.mock('@/lib/services/admin', async (importOriginal) => {
   const actual = await importOriginal<typeof import('@/lib/services/admin')>();
@@ -24,9 +26,11 @@ function renderPanel() {
     defaultOptions: { queries: { retry: false, gcTime: 0 } },
   });
   render(
-    <QueryClientProvider client={client}>
-      <SyncTasksPanel />
-    </QueryClientProvider>,
+    <NextIntlClientProvider locale='zh-CN' messages={zhCN} timeZone='Asia/Shanghai'>
+      <QueryClientProvider client={client}>
+        <SyncTasksPanel />
+      </QueryClientProvider>
+    </NextIntlClientProvider>,
   );
 }