收紧退款人工复核与重试契约

补齐退款事实对比字段与人工复核审计展示
人工复核重放严格校验管理员、原因和错误码
退款占用重试完整匹配管理员与归一化原因
统一退款原因持久化上限并修复刷新恢复
补充前后端回归测试、生成绑定与数据契约文档

apps/admin-web/src/api/adminApiClient.test.ts

@@ -1,4 +1,4 @@
-import {afterEach, expect, test, vi} from 'vitest';
+import { afterEach, expect, test, vi } from 'vitest';
 
 import {
   executeAdminRechargeRefund,
@@ -13,9 +13,9 @@ afterEach(() => {
 
 test('充值订单查询按后台契约序列化筛选参数', async () => {
   const fetchMock = vi.fn().mockResolvedValue(
-    new Response(JSON.stringify({entries: []}), {
+    new Response(JSON.stringify({ entries: [] }), {
       status: 200,
-      headers: {'content-type': 'application/json'},
+      headers: { 'content-type': 'application/json' },
     }),
   );
   vi.stubGlobal('fetch', fetchMock);
@@ -47,12 +47,14 @@ test('充值订单查询按后台契约序列化筛选参数', async () => {
 });
 
 test('用户详情只发送实际提供的用户定位字段', async () => {
-  const fetchMock = vi.fn().mockResolvedValue(
-    new Response(JSON.stringify({userId: 'user-1'}), {status: 200}),
-  );
+  const fetchMock = vi
+    .fn()
+    .mockResolvedValue(
+      new Response(JSON.stringify({ userId: 'user-1' }), { status: 200 }),
+    );
   vi.stubGlobal('fetch', fetchMock);
 
-  await getAdminUserDetail('token-1', {publicUserCode: 'TN1001'});
+  await getAdminUserDetail('token-1', { publicUserCode: 'TN1001' });
 
   const requestUrl = String(fetchMock.mock.calls[0]?.[0]);
   const parsed = new URL(requestUrl, 'http://admin.local');
@@ -63,9 +65,13 @@ test('用户详情只发送实际提供的用户定位字段', async () => {
 });
 
 test('退款执行使用独立 execute 管理员路由', async () => {
-  const fetchMock = vi.fn().mockResolvedValue(
-    new Response(JSON.stringify({outRefundNo: 'refund-1'}), {status: 200}),
-  );
+  const fetchMock = vi
+    .fn()
+    .mockResolvedValue(
+      new Response(JSON.stringify({ outRefundNo: 'refund-1' }), {
+        status: 200,
+      }),
+    );
   vi.stubGlobal('fetch', fetchMock);
 
   await executeAdminRechargeRefund('token-1', {
@@ -92,14 +98,19 @@ test('退款执行使用独立 execute 管理员路由', async () => {
 });
 
 test('退款人工复核使用独立 resolve 管理员路由', async () => {
-  const fetchMock = vi.fn().mockResolvedValue(
-    new Response(JSON.stringify({outRefundNo: 'refund-1'}), {status: 200}),
-  );
+  const fetchMock = vi
+    .fn()
+    .mockResolvedValue(
+      new Response(JSON.stringify({ outRefundNo: 'refund-1' }), {
+        status: 200,
+      }),
+    );
   vi.stubGlobal('fetch', fetchMock);
 
   await resolveAdminRechargeRefundManualReview('token-1', {
     outRefundNo: 'refund-1',
     reason: '已核对微信商户平台原始账单',
+    expectedErrorCode: 'provider_transaction_id_mismatch',
   });
 
   expect(String(fetchMock.mock.calls[0]?.[0])).toBe(
@@ -111,6 +122,7 @@ test('退款人工复核使用独立 resolve 管理员路由', async () => {
       body: JSON.stringify({
         outRefundNo: 'refund-1',
         reason: '已核对微信商户平台原始账单',
+        expectedErrorCode: 'provider_transaction_id_mismatch',
       }),
     }),
   );

apps/admin-web/src/api/adminApiTypes.ts

@@ -785,7 +785,9 @@ export interface AdminProfileWalletPayload {
 export interface AdminRechargeRefundPayload {
   outRefundNo: string;
   providerRefundId: string;
+  providerTransactionId: string;
   providerStatus: string;
+  totalCents: number;
   refundCents: number;
   payerRefundCents: number;
   successAtMicros?: number | null;
@@ -800,6 +802,7 @@ export interface AdminRechargeRefundPayload {
   manualReviewResolvedByAdminUserId?: string | null;
   manualReviewResolutionReason?: string | null;
   manualReviewResolvedAtMicros?: number | null;
+  manualReviewResolvedErrorCode?: string | null;
 }
 
 export interface AdminRechargeRefundHoldPayload {
@@ -882,6 +885,7 @@ export interface AdminRechargeRefundRegisterRequest {
 export interface AdminRechargeRefundManualReviewResolveRequest {
   outRefundNo: string;
   reason: string;
+  expectedErrorCode: string;
 }
 
 export interface AdminWalletRestrictionRequest {