fix: id兼容, 通知入口

src/utils/business/id.ts

@@ -0,0 +1,58 @@
+/**
+ * 兼容后端实体 ID 字段的大小写差异。
+ * 后端历史接口可能返回 `ID`，新接口返回 `id`，前端统一优先使用小写 id。
+ */
+export type CompatibleId = number | string
+
+export interface CompatibleIdFields {
+  id?: CompatibleId | null
+  ID?: CompatibleId | null
+}
+
+/** 从实体中读取兼容的 ID 字段。0 也是有效 ID，不能使用 ||。 */
+export const getCompatibleId = (value: CompatibleIdFields | null | undefined) => {
+  const id = value?.id ?? value?.ID
+  return id === null || id === undefined || id === '' ? undefined : id
+}
+
+/** 读取并转换为数字 ID，供只接受 number 的接口参数使用。 */
+export const getCompatibleNumericId = (
+  value: CompatibleIdFields | null | undefined
+): number | undefined => {
+  const id = getCompatibleId(value)
+  if (id === undefined) return undefined
+
+  const numericId = Number(id)
+  return Number.isFinite(numericId) ? numericId : undefined
+}
+
+const isPlainObject = (value: unknown): value is Record<string, unknown> => {
+  if (value === null || typeof value !== 'object') return false
+  const prototype = Object.getPrototypeOf(value)
+  return prototype === Object.prototype || prototype === null
+}
+
+/** 递归补齐响应中的 id/ID 别名，不影响 Blob、FormData、Date 等特殊数据。 */
+export const syncCompatibleIdFields = <T>(value: T): T => {
+  if (Array.isArray(value)) {
+    value.forEach((item) => syncCompatibleIdFields(item))
+    return value
+  }
+
+  if (!isPlainObject(value)) return value
+
+  const record = value as Record<string, unknown>
+  const hasId = Object.prototype.hasOwnProperty.call(record, 'id')
+  const hasUpperId = Object.prototype.hasOwnProperty.call(record, 'ID')
+
+  if (hasId || hasUpperId) {
+    const id = record.id ?? record.ID
+    if (id !== null && id !== undefined && id !== '') {
+      if (!hasId) record.id = id
+      if (!hasUpperId) record.ID = id
+    }
+  }
+
+  Object.values(record).forEach((item) => syncCompatibleIdFields(item))
+  return value
+}

src/utils/business/index.ts

@@ -9,3 +9,4 @@ export * from './voucher'
 export * from './apiRateLimit'
 export * from './approvalSummary'
 export * from './expiryEstimate'
+export * from './id'