后端迁移Agiso解析模块

apps/backend/src/services/order/agiso-trade-parsing.ts

@@ -1,6 +1,8 @@
 import { parseJsonObject } from '../../utils/json.js'
 
-export function extractAgisoTradePayload(body) {
+type JsonObject = Record<string, unknown>
+
+export function extractAgisoTradePayload(body: unknown): JsonObject {
   const normalizedBody = normalizeRecord(body)
   const rawJson = String(normalizedBody.json || normalizedBody.JSON || '').trim()
 
@@ -11,7 +13,7 @@ export function extractAgisoTradePayload(body) {
   return normalizedBody
 }
 
-export function resolveAgisoTradePlatformOrderId(payload) {
+export function resolveAgisoTradePlatformOrderId(payload: unknown): string {
   const normalizedPayload = normalizeRecord(payload)
   const firstItem = extractAgisoTradeOrderItemSources(normalizedPayload)[0] || {}
 
@@ -28,7 +30,7 @@ export function resolveAgisoTradePlatformOrderId(payload) {
   ])
 }
 
-export function extractAgisoTradeOrderItemSources(payload) {
+export function extractAgisoTradeOrderItemSources(payload: unknown): JsonObject[] {
   const normalizedPayload = normalizeRecord(payload)
   const candidates = [
     normalizedPayload.items,
@@ -52,11 +54,11 @@ export function extractAgisoTradeOrderItemSources(payload) {
   return []
 }
 
-function normalizeRecord(value) {
-  return value && typeof value === 'object' && !Array.isArray(value) ? value : {}
+function normalizeRecord(value: unknown): JsonObject {
+  return value && typeof value === 'object' && !Array.isArray(value) ? value as JsonObject : {}
 }
 
-function pickFirstNonEmpty(values) {
+function pickFirstNonEmpty(values: unknown[]): string {
   for (const value of values) {
     if (typeof value === 'string' && value.trim()) {
       return value.trim()

docs/backend-typescript-migration-plan.md

@@ -381,6 +381,14 @@
     - `npm run typecheck`
     - `npm run build`
     - `npm test` 共 139 个用例通过
+68. Agiso webhook 解析基础模块迁移到 `.ts`：
+    - `src/services/order/agiso-trade-parsing.ts`
+69. Agiso webhook 原始 payload、订单号解析、商品来源数组提取已显式类型化
+70. Docker 内验证通过：
+    - `src/services/order/agiso-trade-parsing.test.js` 与 `src/services/order/webhook-service.test.js` 共 12 个用例通过
+    - `npm run typecheck`
+    - `npm run build`
+    - `npm test` 共 139 个用例通过
 
 ## 下一步建议