优化

src/deployment/nginxConfig.test.ts

@@ -5,6 +5,10 @@ import { describe, expect, it } from 'vitest'
 const config = readFileSync(resolve(process.cwd(), 'nginx/default.conf.template'), 'utf8')
 
 describe('admin nginx deployment config', () => {
+  it('allows qualification uploads with multipart overhead through the API proxy', () => {
+    expect(config).toContain('client_max_body_size 6m;')
+  })
+
   it('prevents the application shell from retaining stale chunk references', () => {
     expect(config).toContain('location = /index.html')
     expect(config).toContain('Cache-Control "no-cache, no-store, must-revalidate"')

src/modules/customers/pages/CustomersView.test.ts

@@ -146,6 +146,21 @@ describe('CustomersView', () => {
     expect(preview?.src).toBe('blob:qualification-preview')
   })
 
+  it('marks only the business license and legal-person ID as required qualifications', async () => {
+    mount(CustomersView, { attachTo: document.body, global: { plugins: [pinia, ElementPlus] } })
+    await flushPromises()
+    tableButtonByText('编辑')?.click()
+    await flushPromises()
+
+    const labels = [...document.querySelectorAll<HTMLElement>('.qualification-label')]
+    expect(labels.map((label) => label.textContent?.replace(/\s/g, ''))).toEqual([
+      '*营业执照',
+      '*法人身份证',
+      '货代资质证书选填',
+      '银行开户许可证选填',
+    ])
+  })
+
   it('does not count rejected or superseded history as a current qualification when resubmitting', async () => {
     const rejectedTenant = { ...fullTenant, status: 'REJECTED' }
     vi.mocked(listPlatformTenants).mockResolvedValue({ records: [rejectedTenant], page: 1, size: 10, total: 1, pages: 1 })

src/modules/customers/pages/CustomersView.vue

@@ -132,8 +132,8 @@ function newQualificationDrafts(): QualificationDraft[] {
   const definitions: Array<Pick<QualificationDraft, 'type' | 'label' | 'required'>> = [
     { type: 'BUSINESS_LICENSE', label: '营业执照', required: true },
     { type: 'LEGAL_PERSON_ID', label: '法人身份证', required: true },
-    { type: 'FREIGHT_FORWARDER_CERTIFICATE', label: '货代资质证书', required: true },
-    { type: 'BANK_ACCOUNT_LICENSE', label: '银行开户许可证', required: true },
+    { type: 'FREIGHT_FORWARDER_CERTIFICATE', label: '货代资质证书', required: false },
+    { type: 'BANK_ACCOUNT_LICENSE', label: '银行开户许可证', required: false },
   ]
   return definitions.map((item) => ({
     ...item,
@@ -648,7 +648,7 @@ onMounted(async () => {
           <div class="qualification-table" role="table" aria-label="客户资质文件">
             <div class="qualification-row qualification-header" role="row"><span role="columnheader">文件类型</span><span role="columnheader">上传文件</span><span role="columnheader">有效期</span></div>
             <div v-for="draft in qualifications" :key="draft.type" class="qualification-row" role="row">
-              <div class="qualification-label" role="cell"><span v-if="draft.required" aria-hidden="true">*</span>{{ draft.label }}<CheckCircle2 v-if="draft.uploaded" :size="16" aria-label="已上传" /></div>
+              <div class="qualification-label" role="cell"><span v-if="draft.required" aria-hidden="true">*</span>{{ draft.label }}<small v-if="!draft.required" class="qualification-optional">选填</small><CheckCircle2 v-if="draft.uploaded" :size="16" aria-label="已上传" /></div>
               <div class="qualification-file" role="cell">
                 <button v-if="draft.file || draft.uploaded" type="button" class="qualification-preview-trigger" :class="{ 'is-loading': draft.previewLoading }" :disabled="draft.previewLoading" :aria-label="`预览${draft.label}：${draft.file?.name || draft.uploadedName}`" @click="openQualificationPreview(draft)">
                   <img v-if="draft.previewUrl && draft.previewKind === 'image' && !draft.previewFailed" :src="draft.previewUrl" :alt="`${draft.label}预览`" @error="handleQualificationPreviewError(draft)" />
@@ -708,6 +708,7 @@ onMounted(async () => {
 .qualification-heading { display:flex; align-items:flex-start; justify-content:space-between; gap:16px; } .qualification-heading h3 { margin-bottom:4px; } .qualification-heading p,.qualification-hint { margin:0; color:var(--cc-muted); font-size:12px; line-height:1.6; } .qualification-hint { margin-top:12px; } .qualification-hint span,.qualification-label > span { color:var(--el-color-danger); }
 .qualification-table { overflow:hidden; margin-top:14px; border:1px solid var(--cc-border); border-radius:8px; } .qualification-row { display:grid; grid-template-columns:180px minmax(300px,1fr) 180px; min-width:0; border-top:1px solid var(--cc-border); } .qualification-row:first-child { border-top:0; } .qualification-row > * { display:flex; min-width:0; min-height:68px; align-items:center; padding:12px 14px; } .qualification-header { min-height:44px; background:#f7f8fc; color:var(--cc-muted); font-size:12px; font-weight:600; } .qualification-header > * { min-height:44px; }
 .qualification-label { gap:5px; font-weight:600; } .qualification-label svg { margin-left:auto; color:var(--el-color-success); }
+.qualification-optional { padding:2px 5px; border-radius:4px; background:var(--el-fill-color-light); color:var(--cc-muted); font-size:10px; font-weight:500; line-height:1.4; }
 .qualification-file { gap:12px; } .qualification-file-control { display:flex; min-width:0; flex:1; flex-wrap:wrap; align-items:center; gap:8px; } .file-picker { position:relative; display:inline-flex; min-height:36px; flex:0 0 auto; align-items:center; gap:7px; overflow:hidden; padding:0 12px; border:1px solid var(--cc-border); border-radius:6px; background:#fff; color:var(--cc-text); cursor:pointer; } .file-picker:focus-within { outline:2px solid color-mix(in srgb,var(--cc-primary) 35%,transparent); outline-offset:2px; } .file-picker.is-disabled { cursor:not-allowed; opacity:.6; } .file-picker input { position:absolute; inset:0; width:100%; height:100%; opacity:0; cursor:inherit; } .qualification-file-name { min-width:0; max-width:180px; overflow:hidden; color:var(--cc-muted); font-size:12px; text-overflow:ellipsis; white-space:nowrap; } .qualification-error { width:100%; color:var(--el-color-danger); line-height:1.4; }
 .qualification-preview-trigger { position:relative; display:grid; width:68px; height:68px; flex:0 0 68px; overflow:hidden; place-items:center; padding:0; border:1px solid var(--cc-border); border-radius:6px; background:#f8fafc; color:var(--cc-muted); cursor:pointer; }
 .qualification-preview-trigger:hover { border-color:var(--cc-primary); color:var(--cc-primary); }

src/shared/api/http.test.ts

@@ -63,6 +63,23 @@ describe('API error diagnostics', () => {
     })
   })
 
+  it('explains a proxy 413 response without a JSON error envelope', () => {
+    const error = new axios.AxiosError('Request failed', 'ERR_BAD_REQUEST', undefined, undefined, {
+      status: 413,
+      statusText: 'Payload Too Large',
+      headers: {},
+      config: { headers: new AxiosHeaders() },
+      data: '<html>Request Entity Too Large</html>',
+    })
+
+    expect(getApiErrorDetails(error)).toEqual({
+      message: '上传文件的请求体过大，服务器已拒绝；请压缩后重试，如文件未超过 5MB，请联系管理员检查网关上传限制',
+      code: 'HTTP_413',
+      requestId: undefined,
+      traceId: undefined,
+    })
+  })
+
   it('notifies session expiry once when concurrent 401 requests share a failed refresh', async () => {
     const refresh = vi.fn(async () => { throw new Error('refresh token expired') })
     const expired = vi.fn()

src/shared/api/http.ts

@@ -123,8 +123,12 @@ export function getApiErrorDetails(error: unknown, fallback = '接口请求失
       requestId?: string | null
       traceId?: string | null
     } | undefined
+    const status = error.response?.status
+    const statusMessage = status === 413
+      ? '上传文件的请求体过大，服务器已拒绝；请压缩后重试，如文件未超过 5MB，请联系管理员检查网关上传限制'
+      : undefined
     return {
-      message: response?.message || response?.error || fallback,
+      message: response?.message || response?.error || statusMessage || fallback,
       code: response?.code || (error.response?.status ? `HTTP_${error.response.status}` : undefined),
       requestId: response?.requestId || undefined,
       traceId: response?.traceId || undefined,