From 4d89cd31d0f8efb8fc0d173820d0bfd755873252 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Thu, 1 Oct 2026 18:02:41 +0800 Subject: [PATCH] 1 --- src/api/stock.check/stock.check.ts | 83 ++++++++++++------- .../stockcheck/config/template-config.ts | 11 ++- .../stockcheck/pages/CheckFormDialog.vue | 3 +- .../stockcheck/pages/CheckPatternDialog.vue | 5 +- 4 files changed, 67 insertions(+), 35 deletions(-) diff --git a/src/api/stock.check/stock.check.ts b/src/api/stock.check/stock.check.ts index b5f8af97..84edc1df 100644 --- a/src/api/stock.check/stock.check.ts +++ b/src/api/stock.check/stock.check.ts @@ -61,12 +61,24 @@ export type StockCheckMode = /** 审核动作 */ export type StockCheckAuditAction = 'approve' | 'reject' -/** 盘点主表行(create 响应 / list rows / detail.check 同构) */ +/** + * 盘点主表行(create 响应 / list rows / detail.check / result.check 同构) + * + * 字段清单以最新文档为准(_formatCheckRow 口径): + * id / check_no / title / type / mode / store_id / status / detail_status / + * start_time / end_time / creator_id / creator_name / total_items / checked_items / + * diff_items / remark / created_at / updated_at + * (list 额外每行带 store_name;warehouse_id / scope_snapshot 为后端附加字段) + * + * ⚠️ 主表已无 check_date(创建不再传、各接口也不再返回),如需盘点时间看 start_time / end_time: + * start_time = 盘点开始时间(第一个盘点明细写入的时间) + * end_time = 盘点结束时间(完成盘点的时间) + */ export type StockCheckTask = { id: number /** 所属仓库ID(服务端按登录上下文注入) */ warehouse_id?: number - /** 盘点单号(PD+YYYYMMDD+6 位序号,按仓库隔离) */ + /** 盘点单号(PD+YYYYMMDD+6 位序号,序号全局递增,按仓库隔离数据) */ check_no: string /** 盘点名称/主题 */ title: string @@ -74,22 +86,18 @@ export type StockCheckTask = { mode: StockCheckMode /** 货主ID(type=store 按货主盘点时有值) */ store_id?: number | null - /** 货主名称(list 回包附加字段,type=store 等场景有值,用于列表「货主名称」列) */ + /** + * 货主名称(list 回包**每行**都有:优先合约货主备注 store_remask,兜底公司全称 company_name) + * 无值时为空串,前端空值统一显示 — + */ store_name?: string | null - /** 盘点范围快照(后端可选字段,常为 null) */ + /** 盘点范围快照(后端附加字段,常为 null) */ scope_snapshot?: unknown status: StockCheckStatus detail_status: StockCheckDetailStatus - /** - * 盘点日期 - * - * ⚠️ stock.check.list 最新回包**已不含该字段**(创建也不再传日期), - * 保留仅作兼容(detail 等回包或历史数据可能仍有值),前端列表/详情不再展示。 - */ - check_date?: string | null - /** 实际开始时间(开始盘点作业后回填) */ + /** 实际开始时间(开始盘点作业后回填;创建时为空) */ start_time?: string | null - /** 实际结束时间(完成盘点后回填) */ + /** 实际结束时间(完成盘点后回填;未完成时为空) */ end_time?: string | null creator_id: number /** 创建人名称快照 */ @@ -239,20 +247,21 @@ export type StockCheckResultRow = StockCheckDetailRow & { /** * stock.check.create 请求参数(warehouse_id 服务端注入,禁止前端传) * - * 注意:前端**统一不传** check_date,由服务端缺省为当天(接口文档标注其为必填, - * 若后续后端收紧校验,需在此恢复必填并在表单中补回日期选择)。 + * 文档最新入参:title / type / mode / store_id / remark(**已无 check_date**,主表也不再返回该字段); + * 盘点时间改由作业流程回填(start_time=首个盘点明细写入时间、end_time=完成盘点时间)。 + * + * mode 口径:按库位盘点(type=all/location)一律盲盘 blind(前端传值被忽略); + * 按商品盘点(type=store/goods)按传入值(默认明盘 open)。 */ export type StockCheckCreateParams = { /** 盘点名称/主题 */ title?: string /** 盘点范围类型,缺省 all */ type?: StockCheckType - /** 盘点方式,缺省 open;blind=盲盘(前端不可见账面数量) */ + /** 盘点方式:open=明盘 / blind=盲盘;库位类(all/location)一律 blind */ mode?: StockCheckMode - /** 货主ID(type=store 时必填) */ + /** 货主ID(type=store 时必填;添加商品明细时商品货主必须与该货主一致) */ store_id?: number - /** 盘点日期(前端不传,服务端缺省当天;传入时须可被 Date 解析) */ - check_date?: string remark?: string } @@ -300,8 +309,10 @@ export type StockCheckPattern = { /** stock.check.patternList 响应(无入参) */ export type StockCheckPatternListResponse = { - /** 内置定式清单 */ + /** 内置定式清单(共 5 条) */ patterns?: StockCheckPattern[] + /** 定式总数(当前为 5) */ + total?: number [key: string]: unknown } @@ -335,32 +346,40 @@ export function stockCheckPatternList(): Promise< /** * stock.check.patternCreate 请求参数 * - * warehouse_id 与创建人均由服务端从登录上下文注入(ctx.user.store_id / id / employees_name), - * 前端**禁止传入**;check_date 可不传(缺省今天),故前端无需选择盘点日期。 + * 只有 4 个可传字段:`pattern_id`(必填,兼容 `patternId` 驼峰)+ `title` / `remark`(可选)。 + * - warehouse_id 与创建人(creator_id / creator_name)由服务端从登录上下文注入 + * (ctx.user.store_id / ctx.user.id / employees_name),前端**禁止传入** + * - 盘点方式(mode)**不传**:由定式范围类型固定 —— 库位类定式(empty_location,type=location) + * 一律盲盘 blind;商品类定式(type=goods,其余 4 个)一律明盘 open + * - 盘点时间**不传**:主表已无 check_date;start_time(首个盘点明细写入时间)/ end_time(完成盘点时间) + * 由盘点作业流程自动回填 */ export type StockCheckPatternCreateParams = { - /** 定式ID:empty_location / mis_shipment / expiring / static / warning(patternId 为驼峰兼容别名) */ + /** 定式ID:empty_location=空库位 / mis_shipment=错发 / expiring=临期 / static=静态 / warning=预警(patternId 为驼峰兼容别名) */ pattern_id: string /** 定式ID(驼峰别名,兼容写法;两者都传时 pattern_id 优先) */ patternId?: string /** 盘点名称/主题,缺省取定式 name */ title?: string - /** 盘点方式,缺省 open:open=明盘 / blind=盲盘 */ - mode?: StockCheckMode - /** 盘点日期(可省略,缺省今天) */ - check_date?: string /** 备注 */ remark?: string } /** stock.check.patternCreate 响应 */ export type StockCheckPatternCreateResponse = { - /** 创建出的盘点任务(部分回包形态下与响应同级) */ + /** + * 创建出的盘点任务(_formatCheckRow 口径:id/check_no/title/type/mode/store_id/status/ + * detail_status/start_time/end_time/creator_id/creator_name/total_items/checked_items/ + * diff_items/remark/created_at/updated_at,**无 check_date**) + * + * status 直接为 `submitted`(待审核);mode 由定式范围类型固定(location→blind、goods→open); + * start_time / end_time 创建时为空(分别由首个盘点明细写入与完成盘点回填)。 + */ check?: StockCheckTask - /** 按定式收集到的盘点对象数量 */ + /** 明细总行数(创建明细后按 wms_stock_check_detail 重算) */ total_items?: number - /** static 定式:批量写入 wms_stock_static_check_task 的命中条数(写入失败不影响主流程) */ - static_written?: number + /** 本次创建使用的定式ID */ + pattern_id?: string [key: string]: unknown } @@ -369,6 +388,8 @@ export type StockCheckPatternCreateResponse = { * * - 入参 `pattern_id`(兼容 `patternId` 驼峰写法,两者都传时 `pattern_id` 优先) * - warehouse_id / 创建人由服务端注入;按定式收集盘点对象(goods 型 → stock_ids,location 型 → 库位列表) + * - 不传 `mode` / 盘点时间:mode 由定式范围类型固定(location→blind、goods→open); + * 主表已无 check_date,start_time / end_time 由盘点作业流程自动回填 * - 无符合条件对象时后端报 400;创建后主表 status 直接为 `submitted`(待审核)、detail_status=none_checked * - static 定式创建成功后会把命中的 stock_id 批量写入 wms_stock_static_check_task(失败不影响主流程) * - 写操作,记录操作日志 diff --git a/src/views/storage/stockcheck/config/template-config.ts b/src/views/storage/stockcheck/config/template-config.ts index 6c67e108..c74e7156 100644 --- a/src/views/storage/stockcheck/config/template-config.ts +++ b/src/views/storage/stockcheck/config/template-config.ts @@ -466,7 +466,10 @@ export const FIELD_DICT: Record = { table: { minWidth: 100 }, slot: null }, - /** 货主名称(列表行回包字段 store_name,仅 type=store 等场景有值) */ + /** + * 货主名称(列表行回包字段 store_name,**每行**都有: + * 优先合约货主备注 store_remask,兜底公司全称 company_name;无值时空串,显示为 —) + */ store_name: { key: 'store_name', label: '货主名称', @@ -798,6 +801,12 @@ export function resolveTabConfig(raw: TabPageRawConfig): TabPageConfig { // 例:{ keyword: { operator: 'like', value: 'PD2026', type: 'text' }, // status: { operator: 'eq', value: 'created', type: 'text' }, // start_time: { operator: 'between', value: ['2026-10-01 00:00:00', '2026-10-01 23:59:59'], type: 'datetimerange' } } +// +// ⚠️ stock.check.list 文档口径写的是「简化值」:where.status / where.type / where.mode 传单值或数组、 +// where.created_at / start_time / end_time 传单值(= gte) 或 [from,to](= between)、keyword 传字符串。 +// 实测两种写法后端均接受且结果一致(2026-10-01 用真实接口逐个对比): +// 单值 ≈ 对象(eq) / 数组 ≈ 对象(in) / [from,to] ≈ 对象(between) / 字符串 ≈ 对象(like) +// 故此处统一走对象协议以保留 operator 表达能力,与项目其他列表页保持一致。 /** 后端 where 条件支持的值类型(其他类型会被忽略,统一按字段类型推导) */ const WHERE_VALUE_TYPES = new Set(['text', 'number', 'boolean', 'date', 'daterange', 'datetimerange']) diff --git a/src/views/storage/stockcheck/pages/CheckFormDialog.vue b/src/views/storage/stockcheck/pages/CheckFormDialog.vue index 31c2cae3..6cdde751 100644 --- a/src/views/storage/stockcheck/pages/CheckFormDialog.vue +++ b/src/views/storage/stockcheck/pages/CheckFormDialog.vue @@ -10,7 +10,8 @@ —— 库位类(all / location)固定为 blind 盲盘且不可更改;商品类(store / goods)默认明盘 - store_id 货主ID(type=store 时必填) - remark 备注 - 盘点日期(check_date)前端**统一不传**,由服务端缺省为当天。 + 盘点时间不在本表单维护:主表已无 check_date,start_time(首个盘点明细写入时间)/ + end_time(完成盘点时间)由盘点作业流程自动回填,前端不传。 warehouse_id 由服务端注入,前端不传。 -->