From 2d3a279805171c4d0c8ada0f47311fac767aa77c Mon Sep 17 00:00:00 2001 From: yml Date: Thu, 21 May 2026 16:53:08 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8E=E7=AB=AF=E8=BF=81=E7=A7=BB=E5=90=8E?= =?UTF-8?q?=E5=8F=B0=E7=AE=A1=E7=90=86=E5=BA=93=E5=AD=98=E5=86=99=E6=93=8D?= =?UTF-8?q?=E4=BD=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../write/{inventory.js => inventory.ts} | 74 +++++++++---------- docs/backend-typescript-migration-plan.md | 8 ++ 2 files changed, 44 insertions(+), 38 deletions(-) rename apps/backend/src/services/admin/write/{inventory.js => inventory.ts} (68%) diff --git a/apps/backend/src/services/admin/write/inventory.js b/apps/backend/src/services/admin/write/inventory.ts similarity index 68% rename from apps/backend/src/services/admin/write/inventory.js rename to apps/backend/src/services/admin/write/inventory.ts index bd0ff0ab..61f37642 100644 --- a/apps/backend/src/services/admin/write/inventory.js +++ b/apps/backend/src/services/admin/write/inventory.ts @@ -1,5 +1,3 @@ -// @ts-check - import { createInventoryItems, invalidateInventoryItem, @@ -13,17 +11,27 @@ import { mapAdminInventoryListItem, } from '../admin-inventory-read-helpers.js' -/** @typedef {import('../../../types/admin-read-inputs.js').AdminEntityIdInput} AdminEntityIdInput */ -/** @typedef {import('../../../types/admin-write-inputs.js').AdminInventoryCreateInput} AdminInventoryCreateInput */ -/** @typedef {import('../../../types/admin-write-inputs.js').AdminInventoryImportInput} AdminInventoryImportInput */ -/** @typedef {import('../../../types/admin-write-inputs.js').AdminInventoryImportRowInput} AdminInventoryImportRowInput */ -/** @typedef {import('../../../types/admin-write-inputs.js').AdminInventoryInvalidateInput} AdminInventoryInvalidateInput */ -/** @typedef {import('../../../types/admin-write-models.js').AdminInventoryImportResponse} AdminInventoryImportResponse */ -/** @typedef {import('../../../types/admin-write-models.js').AdminInventoryMutationResponse} AdminInventoryMutationResponse */ +import type { AdminEntityIdInput } from '../../../types/admin-read-inputs.js' +import type { + AdminInventoryCreateInput, + AdminInventoryImportInput, + AdminInventoryImportRowInput, + AdminInventoryInvalidateInput, +} from '../../../types/admin-write-inputs.js' +import type { + AdminInventoryImportResponse, + AdminInventoryMutationResponse, +} from '../../../types/admin-write-models.js' +import type { InventoryItemRow } from '../../../types/repository-rows.js' -/** @returns {Promise} */ -/** @param {AdminInventoryCreateInput} [payload] */ -export async function createAdminInventoryItem(payload = /** @type {AdminInventoryCreateInput} */ ({})) { +type NormalizedInventoryImportRow = Required> + +export async function createAdminInventoryItem( + payload: AdminInventoryCreateInput = {}, +): Promise { const skuCode = String(payload.skuCode || '').trim() const displayValue = String(payload.displayValue || '').trim() const batchNo = String(payload.batchNo || '').trim() @@ -70,9 +78,9 @@ export async function createAdminInventoryItem(payload = /** @type {AdminInvento } } -/** @returns {Promise} */ -/** @param {AdminInventoryImportInput} [payload] */ -export async function importAdminInventoryItems(payload = /** @type {AdminInventoryImportInput} */ ({})) { +export async function importAdminInventoryItems( + payload: AdminInventoryImportInput = {}, +): Promise { const rows = normalizeInventoryImportRows(payload) if (rows.length === 0) { @@ -102,9 +110,9 @@ export async function importAdminInventoryItems(payload = /** @type {AdminInvent } } -/** @returns {Promise} */ -/** @param {AdminEntityIdInput} inventoryItemId */ -export async function releaseAdminInventoryItem(inventoryItemId) { +export async function releaseAdminInventoryItem( + inventoryItemId: AdminEntityIdInput, +): Promise { const inventoryItem = await getRequiredInventoryItem(inventoryItemId) if (inventoryItem.status !== 'reserved') { @@ -117,17 +125,14 @@ export async function releaseAdminInventoryItem(inventoryItemId) { const updated = await releaseReservedInventoryItem(inventoryItem.id, nowIso()) return { - inventoryItem: await mapAdminInventoryListItem(updated), + inventoryItem: await mapAdminInventoryListItem(updated as InventoryItemRow), } } -/** @returns {Promise} */ -/** @param {AdminEntityIdInput} inventoryItemId */ -/** @param {AdminInventoryInvalidateInput} [payload] */ export async function invalidateAdminInventoryItem( - inventoryItemId, - payload = /** @type {AdminInventoryInvalidateInput} */ ({}), -) { + inventoryItemId: AdminEntityIdInput, + payload: AdminInventoryInvalidateInput = {}, +): Promise { const inventoryItem = await getRequiredInventoryItem(inventoryItemId) if (inventoryItem.status !== 'available') { @@ -141,16 +146,12 @@ export async function invalidateAdminInventoryItem( const updated = await invalidateInventoryItem(inventoryItem.id, reason, nowIso()) return { - inventoryItem: await mapAdminInventoryListItem(updated), + inventoryItem: await mapAdminInventoryListItem(updated as InventoryItemRow), } } -/** - * @param {AdminInventoryImportInput} payload - * @returns {Array>>} - */ -function normalizeInventoryImportRows(payload) { - const rows = [] +function normalizeInventoryImportRows(payload: AdminInventoryImportInput): NormalizedInventoryImportRow[] { + const rows: NormalizedInventoryImportRow[] = [] const directRows = Array.isArray(payload.rows) ? payload.rows : [] const bulkCodes = Array.isArray(payload.codes) ? payload.codes : [] @@ -195,12 +196,9 @@ function normalizeInventoryImportRows(payload) { return dedupeRows(rows) } -/** - * @param {Array>>} rows - */ -function dedupeRows(rows) { - const seen = new Set() - const output = [] +function dedupeRows(rows: NormalizedInventoryImportRow[]): NormalizedInventoryImportRow[] { + const seen = new Set() + const output: NormalizedInventoryImportRow[] = [] for (const row of rows) { const key = `${row.skuCode}::${row.credentialType || 'tencent_code'}::${row.displayValue}` diff --git a/docs/backend-typescript-migration-plan.md b/docs/backend-typescript-migration-plan.md index b0a12273..952424a1 100644 --- a/docs/backend-typescript-migration-plan.md +++ b/docs/backend-typescript-migration-plan.md @@ -735,6 +735,14 @@ - `npm run typecheck` - `npm run build` - `npm test` 共 139 个用例通过 +183. 后台 Admin 库存写操作迁移到 `.ts`： + - `src/services/admin/write/inventory.ts` +184. Admin 库存新增、批量导入、释放预占库存、作废库存与导入行去重已进入 TS 编译链路；创建 / 导入 / 作废输入、entity id、mutation response、导入行规范化结果与库存 row 补齐类型 +185. Docker 内验证通过： + - `src/services/admin/*.test.js` 共 8 个用例通过 + - `npm run typecheck` + - `npm run build` + - `npm test` 共 139 个用例通过 ## 下一步建议