This commit is contained in:
yin 2026-10-01 18:02:41 +08:00
parent 4dc90ac539
commit 4d89cd31d0
4 changed files with 67 additions and 35 deletions

View File

@ -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(失败不影响主流程)
* - 写操作,记录操作日志

View File

@ -466,7 +466,10 @@ export const FIELD_DICT: Record<string, FieldDefinition> = {
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'])

View File

@ -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 由服务端注入,前端不传。
-->
<template>

View File

@ -4,11 +4,12 @@
与 CheckFormDialog(stock.check.create)的区别:
- 无需手选盘点范围:直接选「盘点定式」(后端代码注册的 5 个内置定式),
由后端按定式收集盘点对象(goods 型 → 商品行明细 / location 型 → 库位行明细)
- 无需传入盘点日期(check_date 缺省今天,接口可不传)
- 无需传入盘点方式与盘点时间:mode 由定式范围类型固定(location→盲盘 blind、goods→明盘 open);
主表已无 check_date,start_time/end_time 由盘点作业流程自动回填
- 创建后主表状态直接为 submitted(待审核),明细进度 none_checked,不需要再手动加明细
入参:pattern_id(必填,兼容 patternId 驼峰)+ title/remark(均可选,title 缺省取定式 name)
不传 check_date(缺省今天,弹窗不提供日期选择),也不传 mode(由后端按定式决定)。
不传 mode,也不传任何盘点时间字段。
warehouse_id 与创建人由服务端从登录上下文注入,前端不传。
-->
<template>