From f8c59abb9545123b9db4d97f0c8ecc9f47c48969 Mon Sep 17 00:00:00 2001
From: yml <yml@yml.com>
Date: Thu, 21 May 2026 15:47:06 +0800
Subject: [PATCH] =?UTF-8?q?=E5=90=8E=E7=AB=AF=E8=BF=81=E7=A7=BB=E5=BF=AB?=
 =?UTF-8?q?=E6=89=8B=E4=BA=91=E9=A2=86=E5=8F=96=E6=9C=8D=E5=8A=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...-claim-service.js => kuaishou-cloud-claim-service.ts} | 4 +++-
 ...ud-sync-service.js => kuaishou-cloud-sync-service.ts} | 0
 docs/backend-typescript-migration-plan.md                | 9 +++++++++
 3 files changed, 12 insertions(+), 1 deletion(-)
 rename apps/backend/src/services/claim/{kuaishou-cloud-claim-service.js => kuaishou-cloud-claim-service.ts} (98%)
 rename apps/backend/src/services/claim/{kuaishou-cloud-sync-service.js => kuaishou-cloud-sync-service.ts} (100%)

diff --git a/apps/backend/src/services/claim/kuaishou-cloud-claim-service.js b/apps/backend/src/services/claim/kuaishou-cloud-claim-service.ts
similarity index 98%
rename from apps/backend/src/services/claim/kuaishou-cloud-claim-service.js
rename to apps/backend/src/services/claim/kuaishou-cloud-claim-service.ts
index acb414b8..f31ab5af 100644
--- a/apps/backend/src/services/claim/kuaishou-cloud-claim-service.js
+++ b/apps/backend/src/services/claim/kuaishou-cloud-claim-service.ts
@@ -23,7 +23,9 @@ import { getClaimContext, getClaimDetail } from './claim-session-service.js'
 const KUAISHOU_CLOUD_GUIDE_DIR = path.resolve(PROJECT_ROOT, '../../tems/imgs')
 const ALLOWED_GUIDE_FILES = new Set(['1.png', '2.png', '3.png'])
 
-export async function verifyKuaishouCloudClaimTicket(token, payload = {}) {
+type JsonObject = Record<string, any>
+
+export async function verifyKuaishouCloudClaimTicket(token: unknown, payload: JsonObject = {}) {
   const context = await getClaimContext(token)
   const now = nowIso()
 
diff --git a/apps/backend/src/services/claim/kuaishou-cloud-sync-service.js b/apps/backend/src/services/claim/kuaishou-cloud-sync-service.ts
similarity index 100%
rename from apps/backend/src/services/claim/kuaishou-cloud-sync-service.js
rename to apps/backend/src/services/claim/kuaishou-cloud-sync-service.ts
diff --git a/docs/backend-typescript-migration-plan.md b/docs/backend-typescript-migration-plan.md
index 99fb71d9..3a74d7c2 100644
--- a/docs/backend-typescript-migration-plan.md
+++ b/docs/backend-typescript-migration-plan.md
@@ -518,6 +518,15 @@
     - `npm run typecheck`
     - `npm run build`
     - `npm test` 共 139 个用例通过
+114. 快手 Cloud 领取页动作与轮询同步模块迁移到 `.ts`：
+    - `src/services/claim/kuaishou-cloud-claim-service.ts`
+    - `src/services/claim/kuaishou-cloud-sync-service.ts`
+115. 快手 Cloud 核销码校验、指引图片路径、角色确认、领取页兑换触发与领取页轮询补同步已进入 TS 编译链路；核销 payload 补齐动态对象类型
+116. Docker 内验证通过：
+    - `src/services/claim/claim-session-service.test.js` 共 2 个用例通过
+    - `npm run typecheck`
+    - `npm run build`
+    - `npm test` 共 139 个用例通过
 
 ## 下一步建议