From e6771e8e86b619d0dc6036197bfb902764c727fc Mon Sep 17 00:00:00 2001
From: ouyangxq <775153912@qq.com>
Date: Mon, 21 Sep 2026 11:17:11 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                                     |  1 +
 .../inbounds/fee/InboundFeePanel.test.ts      |  1 +
 src/modules/inbounds/fee/InboundFeePanel.vue  | 35 +++++++++++++++----
 3 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index a679be38..385d7d2c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -41,6 +41,7 @@
 | 登录、会话与双区域 Token | `modules/auth/`、`core/auth/` | 国内 `auth/`、`iam/`；海外请求客户端再读 `shared/api/AGENTS.md` |
 | 启动与懒加载资源恢复 | `main.ts`、`core/routing/navigationRecovery.ts` | 仅识别动态模块/Chunk 资源过期；30 秒内同目标最多自动恢复一次，存在未保存编辑时必须先确认 |
 | 工作台与指标 | `modules/dashboard/` | 指标所属模块与服务端，不复制领域契约 |
+| FBA 无匹配价格、人工定价 | `modules/inbounds/fee/api.ts` 的 `createManualInboundQuote`、`types.ts`；页面消费沿 `InboundFeePanel.vue` 核对 | `POST /manual-quote` 提交计费重量、体积、单价、原因和 `Idempotency-Key`；Backend `PlatformFbaPricingController.manualQuote` → `FbaPricingService.manualQuote`，权限 `firstleg:inbound:confirm-send-fee`。仅 FBA、已有实际测量且当前价格未命中时允许，客户已确认费用禁止改价；`MANUAL_QUOTE` 快照允许价格记录与版本为空，不伪造价格簿关联。API 回归 `modules/inbounds/fee/api.test.ts`，不能以 API 存在代替页面接入完成 |
 | PDA版本、APK下载、WGT热更新发布与停发 | `modules/pda-releases/pages/PdaReleasesView.vue`、`modules/pda-releases/api/pdaReleases.ts`、`modules/pda-releases/routes.ts` | 系统菜单 `/system/pda-releases`；列表权限 `platform:pda-release:list`，上传/发布/停发权限 `platform:pda-release:manage`。国内/海外按 `domestic/overseas` 分开查询，上传只创建草稿，发布与停发需确认；管理请求使用国内 HTTP 的 `/platform/v1/files/pda-releases`，后端见 `file/AGENTS.md`，设备安装与重启查对应 PDA 的更新工具 |
 | 客户、企业审核、客户统计 | `modules/customers/` | `iam/`、`auth/`、`file/`、`firstleg/customerstatistics/`；公司联系电话只作企业联系信息，不修改管理员/成员登录手机号且不要求跨企业唯一。审核必填资质仅营业执照与统一社会信用代码；法人身份证选填，可随资质包提交，也可在已有营业执照后单独补传或替换 |
 | 供应商、国内整柜 | `modules/suppliers/`、`modules/domestic-containers/` | Backend `warehouse/` 及对应 OpenAPI |
diff --git a/src/modules/inbounds/fee/InboundFeePanel.test.ts b/src/modules/inbounds/fee/InboundFeePanel.test.ts
index 3930dfb7..c53e01cc 100644
--- a/src/modules/inbounds/fee/InboundFeePanel.test.ts
+++ b/src/modules/inbounds/fee/InboundFeePanel.test.ts
@@ -381,4 +381,5 @@ describe('InboundFeePanel', () => {
     expect(document.body.textContent).toContain('系统已刷新最新快照')
     expect(document.body.textContent).toContain('当前输入仍保留')
   })
+
 })
diff --git a/src/modules/inbounds/fee/InboundFeePanel.vue b/src/modules/inbounds/fee/InboundFeePanel.vue
index ed9609f0..50f7ce59 100644
--- a/src/modules/inbounds/fee/InboundFeePanel.vue
+++ b/src/modules/inbounds/fee/InboundFeePanel.vue
@@ -47,6 +47,7 @@ const loadError = ref<ApiErrorDetails | null>(null)
 const adjustmentError = ref<ApiErrorDetails | null>(null)
 const conflictRefreshed = ref(false)
 const snapshot = ref<InboundFeeSnapshot | null>(null)
+const hasLoadedOnce = ref(false)
 const adjustOpen = ref(false)
 const trialOpen = ref(false)
 const trialLoading = ref(false)
@@ -183,12 +184,25 @@ async function loadFee(options: { preserveAdjustment?: boolean } = {}) {
     if (!options.preserveAdjustment && adjustOpen.value) fillAdjustmentForm(result)
   } catch (error) {
     if (sequence !== loadSequence) return
-    snapshot.value = null
-    emit('loaded', null)
-    if (error instanceof ApiResponseError && error.code === 'A0404') notFound.value = true
-    else loadError.value = getApiErrorDetails(error, '费用快照加载失败，请稍后重试')
+    const hadSnapshot = Boolean(snapshot.value)
+    if (error instanceof ApiResponseError && error.code === 'A0404') {
+      notFound.value = !hadSnapshot
+      if (!hadSnapshot) {
+        snapshot.value = null
+        emit('loaded', null)
+      }
+    } else {
+      loadError.value = getApiErrorDetails(error, '费用快照加载失败，请稍后重试')
+      if (!hadSnapshot) {
+        snapshot.value = null
+        emit('loaded', null)
+      }
+    }
   } finally {
-    if (sequence === loadSequence) loading.value = false
+    if (sequence === loadSequence) {
+      loading.value = false
+      hasLoadedOnce.value = true
+    }
   }
 }
 
@@ -353,6 +367,7 @@ watch(
   () => {
     adjustOpen.value = false
     snapshot.value = null
+    hasLoadedOnce.value = false
     void loadFee()
   },
   { immediate: true },
@@ -435,11 +450,18 @@ defineExpose({ reload: loadFee })
       <p>需要权限：firstleg:fba-pricing:view</p>
     </el-alert>
 
-    <div v-else-if="loading && !snapshot" class="fee-loading" aria-live="polite">
+    <div v-else-if="loading && !snapshot && !hasLoadedOnce" class="fee-loading" aria-live="polite">
       <el-skeleton :rows="6" animated />
       <span class="sr-only">正在加载费用快照</span>
     </div>
 
+    <el-alert v-if="loadError && snapshot" class="fee-refresh-error" type="error" :closable="false" show-icon role="status">
+      <template #title>最新费用快照暂时无法刷新，当前仍显示上一版快照
+      </template>
+      <p>{{ loadError.message }}</p>
+      <ApiErrorMeta :details="loadError" />
+    </el-alert>
+
     <el-alert v-else-if="loadError" type="error" :closable="false" show-icon role="alert">
       <template #title>费用快照加载失败</template>
       <p>{{ loadError.message }}</p>
@@ -597,6 +619,7 @@ defineExpose({ reload: loadFee })
 .fee-heading-actions .el-button { margin-left: 0; }
 .fee-refresh-button .is-spinning { animation: fee-refresh-spin 0.8s linear infinite; }
 .fee-loading { padding: 20px 0; }
+.fee-refresh-error { margin-bottom: 10px; }
 .inbound-fee-panel :deep(.el-alert p) { margin: 5px 0 0; line-height: 1.55; }
 .inbound-fee-panel :deep(.el-alert .el-button) { margin-top: 8px; }
 .empty-note { margin: 0; color: var(--cc-muted); font-size: 12px; }