fix(stock.check): 盘点范围排除无头库位(zone 不存在/已删除不入明细与作业视图,0.3.280)
This commit is contained in:
parent
731bc8e9fb
commit
4b8e17c139
@ -23,6 +23,14 @@ const SUBMIT_ALLOWED_STATUSES = Object.freeze([ 'created', 'rejected' ]);
|
||||
/** 允许取消的主表状态 */
|
||||
const CANCEL_ALLOWED_STATUSES = Object.freeze([ 'created', 'submitted', 'rejected' ]);
|
||||
|
||||
/**
|
||||
* 有效库位过滤 SQL(库位未删除且所属 zone 存在且未删除)。
|
||||
* 无头库位(zone 不存在/已删除)不纳入盘点范围:明细生成、商品作业视图库位枚举均按此过滤。
|
||||
*/
|
||||
const VALID_SPACE_SQL = '(SELECT ls.id FROM wms_location_space ls '
|
||||
+ 'JOIN wms_location_zone z ON z.id = ls.zone_id AND z.deleted_at IS NULL '
|
||||
+ 'WHERE ls.deleted_at IS NULL)';
|
||||
|
||||
/** 盘点范围类型中文标签 */
|
||||
const STOCK_CHECK_TYPE_LABELS = Object.freeze({
|
||||
all: '全盘',
|
||||
@ -1135,11 +1143,17 @@ class StockCheckService extends Service {
|
||||
});
|
||||
} else {
|
||||
let codes = locationCodes;
|
||||
// 全盘:未显式传库位时自动拉取全仓库启用库位
|
||||
// 全盘:未显式传库位时自动拉取全仓库启用库位(排除无头库位:zone 必须存在且未删除)
|
||||
if (checkType === 'all' && codes.length === 0) {
|
||||
const enabledSpaces = await ctx.model.LocationSpace.findAll({
|
||||
where: { warehouse_id: Number(warehouseId), is_enabled: true },
|
||||
attributes: [ 'space_code' ],
|
||||
include: [{
|
||||
model: ctx.model.LocationZone,
|
||||
as: 'zone',
|
||||
attributes: [],
|
||||
required: true,
|
||||
}],
|
||||
order: [[ 'id', 'ASC' ]],
|
||||
raw: true,
|
||||
});
|
||||
@ -1309,12 +1323,16 @@ class StockCheckService extends Service {
|
||||
const existingStockIds = new Set(existingRows.map(item => Number(item.stock_id)));
|
||||
|
||||
// 商品在本仓库的启用库存库位(按库位拆分明细行:商品任务必须按库位盘点,
|
||||
// 一个商品多个库位对应多行,各行账面 = 该库位库存 SUM(可用+锁定);无库存库位商品不可盘点)
|
||||
// 一个商品多个库位对应多行,各行账面 = 该库位库存 SUM(可用+锁定);无库存库位商品不可盘点;
|
||||
// 库位有效性:仅统计有效库位(所属 zone 存在且未删除),无头库位(zone 不存在/已删除)不纳入盘点)
|
||||
const storageRows = await ctx.model.Storage.findAll({
|
||||
where: {
|
||||
warehouse_id: Number(warehouseId),
|
||||
stock_id: { [Op.in]: numericStockIds },
|
||||
is_enabled: 1,
|
||||
space_id: {
|
||||
[Op.in]: literal(VALID_SPACE_SQL),
|
||||
},
|
||||
},
|
||||
attributes: [
|
||||
'stock_id',
|
||||
@ -1414,6 +1432,13 @@ class StockCheckService extends Service {
|
||||
space_code: { [Op.in]: codes },
|
||||
},
|
||||
attributes: [ 'id', 'space_code' ],
|
||||
// 库位有效性:zone 必须存在且未删除(无头库位记入 invalidLocations,与不存在同口径)
|
||||
include: [{
|
||||
model: ctx.model.LocationZone,
|
||||
as: 'zone',
|
||||
attributes: [],
|
||||
required: true,
|
||||
}],
|
||||
raw: true,
|
||||
});
|
||||
const spaceByCode = new Map(spaceRows.map(item => [ String(item.space_code), item ]));
|
||||
@ -1485,13 +1510,20 @@ class StockCheckService extends Service {
|
||||
const { ctx } = this;
|
||||
const { Op } = ctx.app.Sequelize;
|
||||
|
||||
// 直接按 ID 查库校验(仓库隔离),查不到的 ID 记入 invalidLocationIds(不报错)
|
||||
// 直接按 ID 查库校验(仓库隔离),查不到的 ID 记入 invalidLocationIds(不报错);
|
||||
// 库位有效性:zone 必须存在且未删除(无头库位同样记入 invalidLocationIds)
|
||||
const spaceRows = await ctx.model.LocationSpace.findAll({
|
||||
where: {
|
||||
id: { [Op.in]: numericLocationIds },
|
||||
warehouse_id: Number(warehouseId),
|
||||
},
|
||||
attributes: [ 'id', 'space_code' ],
|
||||
include: [{
|
||||
model: ctx.model.LocationZone,
|
||||
as: 'zone',
|
||||
attributes: [],
|
||||
required: true,
|
||||
}],
|
||||
raw: true,
|
||||
});
|
||||
const spaceById = new Map(spaceRows.map(item => [ Number(item.id), item ]));
|
||||
@ -3367,6 +3399,8 @@ class StockCheckService extends Service {
|
||||
warehouse_id: Number(warehouseId),
|
||||
stock_id: { [Op.in]: stockIds },
|
||||
is_enabled: 1,
|
||||
// 排除无头库位(与明细生成口径一致)
|
||||
space_id: { [Op.in]: literal(VALID_SPACE_SQL) },
|
||||
},
|
||||
attributes: [
|
||||
'stock_id',
|
||||
@ -3621,6 +3655,8 @@ class StockCheckService extends Service {
|
||||
warehouse_id: Number(warehouseId),
|
||||
stock_id: { [Op.in]: stockIds },
|
||||
is_enabled: 1,
|
||||
// 排除无头库位(与明细生成口径一致)
|
||||
space_id: { [Op.in]: literal(VALID_SPACE_SQL) },
|
||||
},
|
||||
attributes: [
|
||||
'space_id',
|
||||
|
||||
@ -231,7 +231,8 @@ class StockCheckPatternsService extends Service {
|
||||
|
||||
/**
|
||||
* 空库位定式:收集账面为空的启用库位。
|
||||
* 口径:wms_location_space(warehouse_id 匹配、is_enabled=1、未删除)在
|
||||
* 口径:wms_location_space(warehouse_id 匹配、is_enabled=1、未删除、库位有效——
|
||||
* 所属 zone 存在且未删除,排除无头库位)在
|
||||
* wms_storage 不存在任何 quantity>0 且未删除的库存记录(LEFT JOIN 判空)。
|
||||
*
|
||||
* @param {Object} context 收集上下文。
|
||||
@ -244,6 +245,9 @@ class StockCheckPatternsService extends Service {
|
||||
`
|
||||
SELECT ls.id AS location_id, ls.space_code AS location_code
|
||||
FROM wms_location_space ls
|
||||
JOIN wms_location_zone z
|
||||
ON z.id = ls.zone_id
|
||||
AND z.deleted_at IS NULL
|
||||
LEFT JOIN wms_storage st
|
||||
ON st.space_id = ls.id
|
||||
AND st.delete_at IS NULL
|
||||
|
||||
@ -1,4 +1,273 @@
|
||||
[
|
||||
{
|
||||
"version": "0.3.280",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "stock.check 盘点范围排除无头库位(所属 zone 不存在/已删除的库位不纳入盘点明细生成与作业视图库位枚举)(0.3.279 → 0.3.280)",
|
||||
"methods": [
|
||||
"stock.check.addDetail",
|
||||
"stock.check.addLocationDetail",
|
||||
"stock.check.patternCreate",
|
||||
"stock.check.workData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:无头库位(wms_location_space.zone_id 指向的 wms_location_zone 行不存在或已软删)一律不纳入盘点——①addDetail 商品路径仅按有效库位拆行(wms_storage 加 space_id IN 有效库位子查询,启用库存全部在无头库位的商品计入 invalid_stock_ids);②库位编码/ID 路径把无头库位分别计入 invalid_locations/invalid_location_ids(不报错,与不存在同口径);③type=all 全盘自动范围直接排除无头库位;④patternCreate 空库位定式收集 SQL 加 JOIN wms_location_zone 排除无头库位;⑤workData goods/space 视图库位枚举与明细生成同口径过滤。",
|
||||
"代码依据:app/service/systems/stock_check.js#VALID_SPACE_SQL(新增模块常量,wms_location_space JOIN wms_location_zone deleted_at IS NULL;应用于 _addGoodsDetailRows/_buildGoodsWorkRows/_buildSpaceWorkRows 的 storage 查询与 addDetail 全盘自动拉取;_addLocationDetailRows/_addLocationRowsByIds 的 LocationSpace 查询加 include zone required:true)+ app/service/systems/stock_check_patterns.js#collectEmptyLocation(SQL 加 JOIN zone)。",
|
||||
"回归测试:新增 2 用例(无头库位编码计入 invalid_locations 不入库、无头库位 ID 计入 invalid_location_ids 不入库,fixture 直接建 zone_id 不存在的库位并 force 清理);全盘自动范围/空间视图/多库位等既有用例的测试口径同步为有效库位过滤(fetchStockRows/fetchSpaceStockPairs/多库位用例/排序用例改 fetchSpaceStockPairs),stock_check 全量 237 用例通过、ESLint 0 错误。",
|
||||
"文档变更范围:methods/system.json 的 module=stock.check 分组更新 4 条 method(stock.check.addDetail:description/response 无效列表/notes 补无头库位口径;stock.check.addLocationDetail:description 补无头库位记入 invalid_location_ids;stock.check.patternCreate:空库位定式口径与 goods 拆行口径补排除无头库位;stock.check.workData:三视图口径补库位枚举排除无头库位);根版本 0.3.279 → 0.3.280、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位);其余 method 未改动。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.279",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 拣货块汇总改订单表状态口径:团购+散单拣货数=已拣货(池内 pick fin + 配送表今日出库 pick fin,按 wave_scope 1/3 分团购),替代今日任务快照(0.3.278 → 0.3.279)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:groupPicking/scatterPicking 的汇总 orders/goods/sku/wave 由今日创建任务快照(wave_pick_task order_count/wave_count + 任务订单关联表)改为订单表状态口径——池内 pick_status=fin + 配送表今日出库 pick fin,团购=wave_scope IN (1,3)、散单=NOT IN (1,3);团购+散单严格等于 fulfillment 已拣货;top 按人排行保持任务口径(订单表无拣货人)。",
|
||||
"原因:用户反馈团购拣货数+散单拣货数(7372)小于已拣货数(11809),任务快照(创建时抓单数)偏小且部分订单不建任务。生产核算:池内 pick fin 按 wave_scope 拆分 团购 10883 + 散单 926 = 11809 = 已拣货 ✓。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPickingBlock(签名 pickModes→isGroup,summary 改双表订单状态 SQL:step/outbound/status/pick_status/wave_scope 条件,goods/sku=SUM(items_total/items_count)、wave=去重 wave_id;top 与 queryPickingGoodsSku 保持任务口径);ESLint 0 错误;egg 直调 VERIFY_OK(开发库 团购 13280 / 散单 146)。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData 一条(notes 口径);根版本 0.3.278 → 0.3.279、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.278",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 已分配/已打印改订单表状态口径:池内 fin + 配送表今日出库 fin(与已拣货同口径,保证已分配≥已打印≥已拣货的流程约束),替代今日新建运单数/今日打印记录数(0.3.277 → 0.3.278)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 已分配由今日新建运单数(wms_order_express 按 order_id 去重)改为订单表状态口径(池内 post_status=fin + 配送表今日出库 post fin);已打印由今日打印记录订单数(wms_print_record order_ids)改为订单表状态口径(池内 print_status=fin + 配送表今日出库 print fin);与已拣货状态口径统一,保证已分配≥已打印≥已拣货。",
|
||||
"原因:今日作业口径下已打印(4003)< 已拣货(10947)、已分配(12621)与已打印大小关系亦不稳定,用户要求分配/打印/拣货都从订单表获取。生产核算(池内):post fin 14933 ≥ print fin 12816 ≥ pick fin 11597 ✓;配送窗口当前 0。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(todayAllocOrdersPromise/todayPrintOrdersPromise 改为双表状态 count,与 todayPickOrdersPromise 同构);ESLint 0 错误;egg 直调 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData 一条(notes 口径);根版本 0.3.277 → 0.3.278、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.277",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 已拣货改为状态口径:池内 pick_status=fin + 配送表今日出库 pick fin(状态无跨天错位,已拣 ≥ 已复核),替代今日拣货任务订单数快照(0.3.276 → 0.3.277)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 已拣货与 stageOverview 拣货卡 today 由今日拣货任务订单数(wave_pick_task order_count 快照,偏小)改为订单状态口径——池内 pick_status=fin + 配送表今日出库 pick fin;生产核实:状态口径已拣 10947 > 今日复核 9192(今日复核订单全部 pick_status=fin),而任务快照 6098 < 复核 9192 明显不合理(复核必先拣货)。其余环节保持 0.3.276 口径。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(todayPickOrdersPromise 双表 pick fin count)/#queryStageOverview(pickToday 同步);ESLint 0 错误;egg 直调两处 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.276 → 0.3.277、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.276",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 履约链路各环节已* 统一改为今日作业口径:已分配=今日新建运单、已打印=今日打印记录、已拣货=今日拣货任务、已复核=今日复核、已打包=今日打包任务、已出库=今日出库(与打包块一致,消除状态口径跨天错位)(0.3.275 → 0.3.276)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 各环节已* 由「池内 fin + 配送表今日出库 fin」改为今日作业口径——已分配=wms_order_express 今日 create_at 未删除按 order_id 去重;已打印=wms_print_record 今日 type=express 的 data.order_ids 长度求和(面单打印记录无 order_id 列,data JSON 含 order_ids 数组);已拣货=wms_wave_pick_task 今日 order_count 合计(全部 pick_mode);已复核=订单分表 recheck_time 今日双表;已打包=今日打包任务订单数(保持);已出库=配送表今日出库(保持)。未* 保持真实状态口径(池内未完成+配送表未完成)。stageOverview 同步:拣货卡 today 改今日拣货任务订单数(与已拣货一致)、复核卡 today 改 recheck_time 今日双表(与已复核一致)。",
|
||||
"原因:用户反馈团购拣货+散单拣货(3869)比已拣货(8265)少 4396——已拣货状态口径含昨日拣完未出库的池内订单(8440),与今日作业口径天然错位;按打包一致处理并扩展到打印/分配/复核。",
|
||||
"生产核算(窗口 UTC 10-10 22:00 起):已分配 12621、已打印 4003(1073 记录 order_ids 合计)、已拣货 3869、已复核 6789、已打包 4397、已出库 0(当天尚未出库)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(新增 todayAllocOrdersPromise/todayPrintOrdersPromise/todayPickOrdersPromise/todayRecheckOrdersPromise,stageCounts 内 doneTodayMap 按环节字段映射今日作业数);ESLint 0 错误;egg 直调 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.275 → 0.3.276、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.275",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 拣货块 goods/sku 补无关联任务:pick_mode=1 团购任务无 wms_wave_pick_task_order 关联记录导致商品数漏算,改为无关联任务按 wave_id 从订单分表统计(0.3.274 → 0.3.275)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:queryPickingGoodsSku 的 goods/sku 统计改为 UNION 两段——有 wms_wave_pick_task_order 关联的任务走 pto 精确统计;无关联的任务(实测 pick_mode=1 共 60 任务 3862 单 963 波全部无 pto 记录,导致 top 如黎英俊 goods=0)按 wave_id 从订单分表(current/dispatch,status!=cancel)统计波次订单商品;总量与 top 同步。",
|
||||
"核实过程:生产只读窗口内任务 401 个,仅 341 个有 pto 关联;无关联任务全为 pick_mode=1(60 个、orders 快照 3862、waves 963),配送表按 wave join 补数 goods=473/sku=336(current 表另有未出库部分)。orders 快照口径不受影响(与 fulfillment 已拣货 19062 基本一致)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPickingGoodsSku(goodsSkuSelect/topGoodsSkuSelect 改为 UNION ALL 双段,taskWindowWhere2 别名替换);ESLint 0 错误;egg 直调拣货块 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.274 → 0.3.275、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.274",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 小团购归回团购块:groupPacking 范围由 wave_scope=1 改为 IN (1,3)(大团购+小团购,top 按打包台),scatterPacking=NOT IN (1,3);orders 保持按 pack_mode 统计(0.3.273 → 0.3.274)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:groupPacking(团购块)波次范围由 wave_scope=1 改为 wave_scope IN (1,3),小团购(3)从散单块归回团购块(top 仍按打包台聚合);scatterPacking(散单块)= wave_scope NOT IN (1,3)(0 未分配/2 散单/4 单品单件,top 按打包员);orders 口径不变(pack_mode=2 按 pack_quantity 求和、pack_mode=1 每任务 1 单)。",
|
||||
"生产核算(窗口内):团购块=wave_scope 1+3 共 1161 任务/17387 单,散单块=2+4 共 1471 任务/1471 单,合计 18858,与今日出库已打包 18652 仅差约 200(今日打包未出库)✓。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPackingBlock(scopeWhere 改为 IN (1,3) / NOT IN (1,3));ESLint 0 错误;egg 直调 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.273 → 0.3.274、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.273",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 打包订单数修正 wave_scope=3 小团购:orders 改为按打包模式统计(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单),小团购任务不再按 1 单漏算(修正前今日打包 15997,修正后 18847,缺口 2850)(0.3.272 → 0.3.273)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:groupPacking/scatterPacking 与 fulfillment 已打包的订单数口径由「wave_scope=1 SUM(pack_quantity) + 其余每任务 1 单」改为「pack_mode=2(团购模式)按 pack_quantity 求和 + pack_mode=1 散单每任务 1 单」——wave_scope=3(小团购)的打包任务是团购模式(pack_mode=2、pack_quantity=多单),此前按散单每任务 1 单漏算(订单 1032238 日志:小团购波次 B2026101000155 共 12 单按 1 单统计)。",
|
||||
"核实过程:生产只读 wave_scope 分布(窗口内)1=244/2=1173/3=917/4=298,修正前订单数 15997(13654+2343),修正后 18847(13654+1173+3715+298);今日出库已打包 18652,差距由 2655 收敛到约 195(今日打包未出库),三个口径基本自洽。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPackingBlock(ordersExpr 统一 SUM(CASE WHEN pack_mode=2 THEN pack_quantity ELSE 1 END),summary 与两块 top 同步)/#queryFulfillment(packTaskOrdersTodayPromise SQL 同口径);ESLint 0 错误;egg 直调 VERIFY_OK。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.272 → 0.3.273、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.272",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 未打包恢复真实状态口径:未*=池内未打包 + 配送表今日出库未打包(替代 total-已*),与只读核实口径一致(169+458=627);已*仍为今日打包任务数(0.3.271 → 0.3.272)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 打包环节未* 由 total-已* 改回真实状态口径——常用表池内 pack 非 fin + 配送表今日出库 pack 非 fin(与只读核实一致:待处理表 169 + 配送表 458 = 627);已* 保持今日打包任务订单数;未+已 不再强制等于 total(差额为昨日打包今日出库的跨天订单)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(items 组装移除打包环节 undone=finalTotal-done 特判,恢复 stageCounts 真实 undone=池内非fin+配送非fin);ESLint 0 错误;临时验证脚本(非 pack 环节 undone+done=total 断言)通过。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组仅更新 index.getWarehousePanelData(notes 口径);根版本 0.3.271 → 0.3.272、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.271",
|
||||
"date": "2026-10-11",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 修复 stageOverview 解构错位:0.3.269 拣货卡双表求和插入时残留旧任务数 countSql 导致数组多一个元素,后续字段全部错位(pick.doing 错显已拣货数、pick.abnormal 错显拣货中任务数、pack.today 错显复核异常数)(0.3.270 → 0.3.271)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:queryStageOverview 的 Promise.all 数组移除残留的旧拣货任务数 countSql(今日完成拣货任务数),仅保留双表 pick fin 求和作为 pick.today;数组恢复 15 元素与解构一一对应。修复后 pick.today=已拣货订单数(与 fulfillment 同口径)、pick.doing=拣货中任务数、pick.abnormal=池内拣货异常、pack.today=今日打包任务数。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryStageOverview(删除 pick 区域冗余 countSql);ESLint 0 错误;临时验证脚本(queryStageOverview 直调:pick.today=13414 订单数、doing/abnormal 任务数、与 queryFulfillment 已拣货相等断言)通过。",
|
||||
"文档变更范围:methods/system.json 根版本 0.3.270 → 0.3.271、updatedAt 保持 2026-10-11;methods/changes/system.json 新增本条(插入数组首位);接口描述与口径未变。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.270",
|
||||
"date": "2026-10-11",
|
||||
"type": "added",
|
||||
"summary": "新增仓库配置「自然日开始时间」day_start_time(subject_config,HH:mm,默认 06:00):面板全部今日统计窗口改为业务日(昨日 06:00 后的订单视为今日;当前时间早于当日配置点窗口为昨日配置点→当日配置点,否则为当日→次日)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData",
|
||||
"setting.warehouse.getSettings",
|
||||
"setting.warehouse.saveSettings"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:wms_store.subject_config 新增 day_start_time(HH:mm,默认 06:00,范围 00:00-23:59),normalizeSubjectConfig 同步校验(格式非法报错、范围外回退默认、旧数据补默认);WAREHOUSE_SETTING_FIELDS 新增对应字段元信息(getFieldMeta 返回);面板 getWarehousePanelData 的今日统计窗口(fulfillment 配送表今日出库/今日打包任务/退件拆包、stageOverview 各 today、b2b、groupPicking/scatterPicking、groupPacking/scatterPacking)统一改为业务日窗口 [配置点, 次日配置点),当前时间早于当日配置点时窗口从昨日配置点开始;trend(08:00-18:00 小时趋势)与 weeklyEfficiency(7 日)保持自然日。",
|
||||
"代码依据:app/model/store.js(DEFAULT_DAY_START_TIME/DAY_START_TIME_MIN/MAX + DEFAULT_SUBJECT_CONFIG.day_start_time + normalizeSubjectConfig 校验段);app/service/systems/setting/warehouse.js(WAREHOUSE_SETTING_FIELDS 新增 day_start_time);app/service/systems/warehouse_panel.js(新增 getWarehouseDayStartTime(读 subject_config,异常回退 06:00)与 resolveBusinessDayRange,buildPanelData 各块传 businessStart/businessEnd);ESLint 0 错误;临时验证:开发库仓库 100000 配置默认 06:00,当前 2026-10-11 00:19 窗口=[2026-10-10 06:00, 2026-10-11 06:00) 断言通过。",
|
||||
"文档变更范围:methods/system.json 的 module=index 分组更新 index.getWarehousePanelData(notes 补业务日窗口口径)、module=setting.warehouse 分组更新 saveSettings(params 新增 subject_config.day_start_time)与 getFieldMeta(response 新增 data[].day_start_time);根版本 0.3.269 → 0.3.270、updatedAt 2026-10-10 → 2026-10-11;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.269",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 未打包合并配送数据 + 拣货卡对齐:打包环节未*=总数-已*(配送表今日出库未打包/跨天错位并入未*,恢复每环节未+已=total);stageOverview 拣货卡 today 与 fulfillment 已拣货同口径(订单数)(0.3.268 → 0.3.269)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容一:fulfillment 打包环节未* 改为 total - 已*(已*=今日打包任务订单数),配送表今日出库中未打包单与跨天打包出库错位部分全部并入未打包,恢复每环节未+已=total;此前未*=池内未打包+配送表非 fin,未包含跨天错位部分,用户反馈未打包没有合并统计配送数据。",
|
||||
"变更内容二:stageOverview 拣货卡 today 由今日完成拣货任务数(任务维度,团购一任务几十单导致 401 与已拣货 19068 严重不一致)改为与 fulfillment 已拣货同口径:常用表池内 pick_status=fin + 配送表今日出库 pick fin(订单数)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(items 组装时打包环节 undone=Math.max(finalTotal-done,0))/#queryStageOverview(pickToday 改为双表 pick fin Promise.all 求和,替换原 wave_pick_task 任务数 countSql);ESLint 0 错误;临时验证脚本 6 环节 undone+done=total 断言全部通过。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(notes 同步打包环节未* 与拣货卡口径);根版本 0.3.268 → 0.3.269、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.268",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 已打包口径对齐打包任务:打包环节已* 由配送表今日出库 pack_status=fin 叠加改为今日打包任务订单数(团购 SUM(pack_quantity)+散单任务数,与 groupPacking/scatterPacking 严格一致,消除跨天打包出库窗口错位)(0.3.267 → 0.3.268)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 打包环节已* = 常用表池内 pack_status=fin + 今日打包任务订单数(wms_pack_task 今日创建、非异常、未删除:wave_scope=1 按 pack_quantity 求和 + 其余每任务 1 单,与 groupPacking/scatterPacking 同一口径);不再叠加配送表今日出库 pack_status=fin(昨日打包今日出库的订单不计入今日已打包)。未打包口径不变(池内 pack 非 fin + 配送表今日出库 pack 非 fin 的拦截等单)。其余五环节仍按配送表今日出库状态拆分叠加。",
|
||||
"核实过程:生产只读(1000028,UTC 今日)池内 pack fin=0、配送表今日出库 pack fin=17005、今日打包任务订单数=14827,差距 2178 为跨天打包出库窗口错位(昨日打包今日出库 − 今日打包未出库),因此已打包对齐打包任务口径后与 groupPacking+scatterPacking(12924+1885≈14827 北京窗口)一致。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(新增 packTaskOrdersTodayPromise 原生 SQL:SUM(CASE WHEN wave_scope=1 THEN pack_quantity ELSE 1 END) 今日窗口;stageCounts 内 pack_status 环节 done 叠加改用该值);ESLint 0 错误;临时验证脚本(非 pack 环节 undone+done=total 断言)通过。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data/notes 同步打包环节口径);根版本 0.3.267 → 0.3.268、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.267",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData fulfillment 配送表补数按环节状态拆分:今日出库订单状态 fin 计入已*、非 fin 计入未*(未打包即出库的拦截单不再计入已打包,避免已打包虚高且大于团购+散单打包数)(0.3.266 → 0.3.267)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 各环节配送分表今日出库订单(status 非 cancel、outbound_status=fin、delivery_time 今日、dispatch_lane m4/m5)由无条件叠加已* 改为按环节状态字段拆分——状态 fin 计入已*,非 fin 计入未*(打包环节的拦截等未打包即出库单计入未打包);保证每环节未+已=total 且与真实状态一致,已打包不再虚高。",
|
||||
"根因:配送表今日出库中约 9%(1735/18593)pack_status 非 fin(拦截等特殊路径未打包即出库),无条件叠加导致已打包(18564)远大于团购打包数+散单打包数(14743);其余环节(post/print/pick/recheck)配送表今日出库订单状态均为 fin,拆分后与旧口径一致。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(stageCounts 每环节四元组:undoneCurrent/doneCurrent/dispatchFin/dispatchTodayOutbound,undone=池内非fin+配送表非fin、done=池内fin+配送表fin);ESLint 0 错误;临时验证脚本每环节 undone+done=total 断言通过;生产只读验证:配送表今日出库 18593,pack_fin=16858、pack_not_fin=1735,其余环节全 fin。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data/notes 同步拆分口径);根版本 0.3.266 → 0.3.267、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.266",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData groupPacking 订单数修正:orders 由任务数(COUNT(*))改为打包数量快照求和 SUM(pack_quantity)(团购一任务一波次,任务数会严重低估订单数);scatterPacking 保持任务数(0.3.265 → 0.3.266)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:groupPacking 的 orders(summary 与 top 均)由 COUNT(*)(任务数)改为 COALESCE(SUM(pt.pack_quantity),0)——pack_quantity 是创建打包任务时服务端复查落库的波次订单数快照(workbench._packOrder:团购取波次实时订单数,散单默认 1),一任务一波次,任务数口径会把订单数低估为波次数(218 任务显示 218 单);scatterPacking 散单一单一任务,orders 保持 COUNT(*)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPackingBlock(ordersExpr 按 isGroup 分支:团购 SUM(pack_quantity)/散单 COUNT(*);summary 与团购 top 同步替换);ESLint 0 错误;生产只读验证:今日团购任务 220、orders=SUM(pack_quantity)=12743、wave=220。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(notes 补 groupPacking/scatterPacking orders 口径);根版本 0.3.265 → 0.3.266、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.265",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData fulfillment 全环节补配送表:已出库订单迁移到配送分表后,各环节 done 与 total 统一叠加配送表今日出库订单(出库即视为走完前序环节,每环节未+已=total);stageOverview.todayOutbound 同步双表(0.3.264 → 0.3.265)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 的各环节 done(已分配/已打印/已拣货/已复核/已打包/已出库)与 total 在常用分表作业池基础上统一叠加配送分表(wms_order_delivery_{仓库}_dispatch)今日出库订单(status 非 cancel、outbound_status=fin、delivery_time 今日、dispatch_lane m4/m5;已出库即视为走完前序环节),保证每环节未+已=total;stageOverview 的 todayOutbound 同步双表求和(常用表 step=4 今日出库 + 配送表今日出库),totalOrders=待处理+今日出库口径不再偏小。迭代记录:首版仅出库环节与 total 补数,用户反馈五环节已* 未核算已出库部分,改为全环节统一叠加。",
|
||||
"口径说明:配送表今日出库订单中有少量(约 17%)pack_status 非 fin(拦截等特殊路径未打包即出库),按看板口径仍计入各环节已*(出库即视为走完前序环节),以保持每环节未+已=total 一致。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(dispatchTodayBase 配送表今日出库过滤;stageCounts 每环节 done=常用表 fin + 配送表今日出库数,total=常用表待处理 + 配送表今日出库)/#queryStageOverview(todayOutbound 双表 Promise.all 求和);buildPanelData 调用处传入 dispatchModel;ESLint 0 错误;临时验证脚本断言每环节 undone+done=total 通过;生产只读验证:1000028 常用表 pending 3188 + 配送表今日出库 16000 = 19188。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data/notes 同步配送表补数口径);根版本 0.3.264 → 0.3.265、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.264",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData 打包数据区分团购/散单:packingRank 拆分为 groupPacking(wave_scope=1,top 按打包台)与 scatterPacking(其余,top 按打包员)两块(0.3.263 → 0.3.264)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:原 packingRank(散单+团购合并)拆分为两个数据块——groupPacking(pack_task.wave_scope=1 大团购,top 按打包台 wms_workbench.name 聚合,workbench_id 为空归「未指定打包台」)与 scatterPacking(wave_scope 非 1:0 未分配波次/2 散单/3 小团购/4 单品单件,top 按打包员 pack_task_packer.account_name 聚合),每块含 orders/goods/sku/wave/top5(口径不变:今日创建、非异常、未删除);顶层 packingRank 字段移除。迭代记录:区分字段曾先按 pack_mode(废弃语义)实现,后改 wave_scope(先 IN(1,3),用户最终确认 3 归散单、仅 1 为团购);top 口径曾统一按打包员,用户要求团购按打包台、散单按个人。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryPackingPersonal 改为 queryPackingBlock(isGroup 布尔参数,SQL 拼 pt.wave_scope = 1 / != 1;top 查询按 isGroup 分支:团购 LEFT JOIN wms_workbench 按打包台聚合、散单 JOIN wms_pack_task_packer 按打包员聚合);buildPanelData 并行聚合两块(groupPacking/scatterPacking,各自单块容错),data 输出同步替换;ESLint 0 错误。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data/notes 同步打包两块口径);根版本 0.3.263 → 0.3.264、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.263",
|
||||
"date": "2026-10-10",
|
||||
"type": "updated",
|
||||
"summary": "index.getWarehousePanelData fulfillment 新增今日退回收件数与今日拆包件数(追加在 items 数组末尾两项,按 wms_return_received / wms_return_unpack 的 created_at 今日计数;wms_return_unpack 补 (warehouse_id, created_at) 索引)(0.3.262 → 0.3.263)",
|
||||
"methods": [
|
||||
"index.getWarehousePanelData"
|
||||
],
|
||||
"notes": [
|
||||
"变更内容:fulfillment 数据块的 items 数组在 6 环节未/已 12 项之后追加两项——label 今日退回收件 / 今日拆包(icon=returnReceived/returnUnpack,与环节项同构 label/icon/value),口径为按 warehouse_id 隔离 + created_at 落在今日 [00:00, 次日 00:00) 的计数(wms_return_received / wms_return_unpack);wms_return_received 已有 idx_warehouse_created_at,wms_return_unpack 无 created_at 索引,新增迁移 20261010100000-add-created-at-index-to-wms-return-unpack.js(addIndex (warehouse_id, created_at),模型 indexes 同步,开发库已执行核验,生产随发布执行)。",
|
||||
"代码依据:app/service/systems/warehouse_panel.js#queryFulfillment(新增 ReturnReceived/ReturnUnpack 两个 count,结果追加到 items 末尾,buildPanelData 调用处传入 warehouseId/todayStart/tomorrowStart);app/model/return_unpack.js(indexes 增加 idx_warehouse_created_at);ESLint 0 错误;临时验证脚本真实库直调 VERIFY_OK(items=14 项、末两项 label 正确、顶层无新增字段)。迭代记录:首版把两个计数放在 fulfillment 顶层字段(returnReceivedToday/returnUnpackToday),用户纠正为追加到 items 数组(与环节项同构)。",
|
||||
"文档变更范围:methods/system.json 的 module=index 基础模块分组仅更新 index.getWarehousePanelData 一条(response.data/notes 补充 fulfillment items 末尾两项口径);根版本 0.3.262 → 0.3.263、updatedAt 保持 2026-10-10;methods/changes/system.json 新增本条(插入数组首位)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"version": "0.3.262",
|
||||
"date": "2026-10-10",
|
||||
|
||||
@ -1,8 +1,8 @@
|
||||
{
|
||||
"module": "system",
|
||||
"description": "系统接口标准入口,method 对应系统内置方法,全部使用 POST 请求,参数统一放在 body 内",
|
||||
"version": "0.3.262",
|
||||
"updatedAt": "2026-10-10",
|
||||
"version": "0.3.280",
|
||||
"updatedAt": "2026-10-11",
|
||||
"headers": [
|
||||
{
|
||||
"name": "platform",
|
||||
@ -2621,15 +2621,16 @@
|
||||
"name": "data",
|
||||
"type": "object",
|
||||
"required": true,
|
||||
"description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total)、stageOverview(totalOrders/interceptOrders/stages 5 卡:receiving/shelf/pick/recheck/pack)、b2b(orders/goods/sku)、groupPicking、scatterPicking(orders/goods/sku/wave/top5)、packingRank(personal:orders/goods/sku/wave/top5)、trend(max/points 08:00-18:00 共 11 点)、weeklyEfficiency(days 7 天 intercept)"
|
||||
"description": "面板数据对象;is_change=false 时为空对象(节约流量),is_change=true 时输出。已输出字段:title(仓库名)、fulfillment(订单履约链路 6 环节未/已 + total + items 末尾两项今日退件/今日拆包;各环节未/已均含配送表今日出库按环节状态拆分补数,打包环节已* 用今日打包任务口径与 groupPacking/scatterPacking 一致)、stageOverview(totalOrders/interceptOrders/stages 5 卡:receiving/shelf/pick/recheck/pack)、b2b(orders/goods/sku)、groupPicking、scatterPicking(orders/goods/sku/wave/top5)、groupPacking、scatterPacking(各含 orders/goods/sku/wave/top5,按波次范围 wave_scope 区分:团购块 top 按打包台、散单块 top 按打包员)、trend(max/points 08:00-18:00 共 11 点)、weeklyEfficiency(days 7 天 intercept)"
|
||||
}
|
||||
],
|
||||
"errors": [],
|
||||
"notes": [
|
||||
"缓存键 index:warehousePanel:lastChangeAt:{warehouseId},值为 { last_change_at, data },TTL 300 秒。拉取逻辑:缓存有最后更新时间且传入时间戳未过期 → is_change=false + 空 data 不查库;时间戳过期且缓存有数据 → 直接输出缓存数据;时间戳过期但缓存无数据(外部只驱动了时间戳)→ 查库拉数据补入缓存并保留外部时间戳;缓存无最后更新时间(未命中/过期)→ 查库拉数据并设置最后更新时间",
|
||||
"最后更新时间一般由外部驱动:业务数据变化时由外部写入缓存键的 last_change_at(只写时间戳即可,数据由本接口下次拉取时补入)",
|
||||
"未输出字段(数据源或口径未定):履约链路第 7 环节退件签收、stageOverview 质检卡、收货/上架卡的 today/abnormal、weeklyEfficiency 的 throughput/max、packingRank 的 group(组别口径未定)",
|
||||
"口径:fulfillment 各环节按订单分表状态字段(post_status/print_status/pick_status/recheck_status/pack_status/outbound_status)未/已;groupPicking=wave_pick_task pick_mode 1,5,scatterPicking=2,3,4(今日创建任务,orders/wave 取任务快照,goods/sku 经任务订单关联表 join 订单分表 items_total/items_count);packingRank.personal 按 pack_task_packer.account_name 聚合(今日创建且非异常任务);trend 固定 08:00-18:00 按小时补零;weeklyEfficiency.days 时间锚点=COALESCE(intercept_time, create_at)"
|
||||
"未输出字段(数据源或口径未定):履约链路第 7 环节退件签收、stageOverview 质检卡、收货/上架卡的 today/abnormal、weeklyEfficiency 的 throughput/max",
|
||||
"口径:fulfillment 各环节未* = 常用表池内未完成 + 配送分表今日出库未完成(真实状态);已* 口径:分配/打印/拣货均从订单表状态获取(池内 fin + 配送表今日出库 fin,保证已分配≥已打印≥已拣货的流程约束),复核=今日复核时间(recheck_time 双表)、打包=今日打包任务订单数(pack_mode=2 按 pack_quantity 求和 + 散单每任务 1 单,与 groupPacking/scatterPacking 严格一致)、出库=今日出库数;出库环节未+已=total,其余环节已* 为状态/今日作业口径、未* 为真实状态口径;面板全部今日统计窗口按仓库配置自然日开始时间 day_start_time(默认 06:00)划分:今日=[当日06:00, 次日06:00),当前时间早于当日 06:00 时窗口为 [昨日06:00, 当日06:00)(昨日 06:00 后的订单视为今日);trend(08:00-18:00 小时趋势)与 weeklyEfficiency(7 日)仍按自然日;fulfillment 的 items 末尾两项(今日退件/今日拆包)按 wms_return_received/wms_return_unpack 的 warehouse_id 隔离 + created_at 今日 [00:00, 次日 00:00) 计数;",
|
||||
"groupPicking/scatterPicking 汇总(orders/goods/sku/wave)按订单表状态口径:池内 pick fin + 配送表今日出库 pick fin,团购=wave_scope IN (1,3)、散单=NOT IN (1,3),团购+散单=已拣货;top 仍按今日创建任务(pick_mode 1,5 团购 / 2,3,4 散单)按人聚合(任务口径,订单表无拣货人);"
|
||||
]
|
||||
}
|
||||
]
|
||||
@ -15504,6 +15505,12 @@
|
||||
"required": false,
|
||||
"description": "截单时间,格式 HH:mm,默认 18:00,范围 00:00-23:59;作为最后允许自动分配的时间,开始时间晚于截单时间时截单时间视为次日(跨天窗口)"
|
||||
},
|
||||
{
|
||||
"name": "subject_config.day_start_time",
|
||||
"type": "string",
|
||||
"required": false,
|
||||
"description": "自然日开始时间(业务日分界点),格式 HH:mm,默认 06:00,范围 00:00-23:59;今日统计窗口为 [该时间点, 次日该时间点),当前时间早于今日该时间点时窗口从昨日该时间点开始(昨日 06:00 后的订单视为今日)"
|
||||
},
|
||||
{
|
||||
"name": "subject_config.receiving_pending_inbound_notice",
|
||||
"type": "object",
|
||||
@ -29694,6 +29701,12 @@
|
||||
"type": "object",
|
||||
"required": false,
|
||||
"description": "截单时间字段元信息:key=cutoff_order_time,type=string,default=18:00,min=00:00(下限已从 12:00 放开,支持凌晨截单/跨天窗口),max=23:59,maxLength=5"
|
||||
},
|
||||
{
|
||||
"name": "data[].day_start_time",
|
||||
"type": "object",
|
||||
"required": false,
|
||||
"description": "自然日开始时间字段元信息:key=day_start_time,type=string,default=06:00,min=00:00,max=23:59,maxLength=5;今日统计窗口为 [该时间点, 次日该时间点),当前时间早于今日该时间点时窗口从昨日该时间点开始"
|
||||
}
|
||||
],
|
||||
"errors": []
|
||||
@ -38215,7 +38228,7 @@
|
||||
},
|
||||
{
|
||||
"method": "stock.check.addDetail",
|
||||
"description": "添加盘点明细(商品或库位,按任务盘点类型决定):type=store/goods 按 stock_ids 添加商品行(scope_type=goods,商品任务必须按库位盘点:按商品在仓库的启用库存库位(wms_storage is_enabled=1,按 space_id 分组 SUM)拆行——每个「商品+库位」生成一条明细行,location_id/location_code 快照绑定库存库位、system_quantity=该库位库存 SUM,一个商品多个库位对应多行;无启用库存库位的商品计入 invalid_stock_ids 不入明细),商品必须属于本仓库,且任务 store_id 非空时商品货主必须与任务货主一致(不一致的商品记入 invalid_stock_ids);type=all/location 按 locations(库位编码)或 location_ids(库位ID)添加库位行(scope_type=location),location_ids 优先(两者都传时 locations 忽略)——库位ID路径直接按 wms_location_space.id+warehouse_id 查库校验(不再按编码二次解析),查不到的 ID 记入 invalid_location_ids,编码路径按 warehouse_id+space_code 匹配 wms_location_space,不存在的编码记入 invalid_locations;type=all 未传库位且未传库位ID时自动拉取全仓库启用库位生成盘点范围;兼容历史任务:type=all 且已存在商品明细行(scope_type=goods,改造前创建)时继续按商品模式接受 stock_ids,避免旧调用报 400;stock_ids 与 locations/location_ids 按任务类型二选一(传错维度报 400:按库位盘点传 stock_ids 报『当前盘点类型按库位盘点,请传 locations 或 location_ids(如需按商品盘点请创建 type=goods 任务)』,按商品盘点传 locations 报『当前盘点类型按商品盘点,请传 stock_ids』、传 location_ids 报『当前盘点类型按商品盘点,不能添加库位明细』),locations 兼容 location_codes 写法(locations 优先)、location_ids 兼容 locationIds 驼峰写法(location_ids 优先);仅 created/rejected 状态允许;已存在同盘点项(商品行 stock_id / 库位行 location_code)自动跳过(幂等);完成后重算主表 total_items。",
|
||||
"description": "添加盘点明细(商品或库位,按任务盘点类型决定):type=store/goods 按 stock_ids 添加商品行(scope_type=goods,商品任务必须按库位盘点:按商品在仓库的启用库存库位(wms_storage is_enabled=1 且库位有效——库位未删除且所属 zone 存在未删除,排除无头库位,按 space_id 分组 SUM)拆行——每个「商品+库位」生成一条明细行,location_id/location_code 快照绑定库存库位、system_quantity=该库位库存 SUM,一个商品多个库位对应多行;无启用库存库位的商品计入 invalid_stock_ids 不入明细),商品必须属于本仓库,且任务 store_id 非空时商品货主必须与任务货主一致(不一致的商品记入 invalid_stock_ids);type=all/location 按 locations(库位编码)或 location_ids(库位ID)添加库位行(scope_type=location),location_ids 优先(两者都传时 locations 忽略)——库位ID路径直接按 wms_location_space.id+warehouse_id 查库校验(不再按编码二次解析),查不到的 ID 记入 invalid_location_ids,编码路径按 warehouse_id+space_code 匹配 wms_location_space,不存在的编码记入 invalid_locations;库位必须有效(未删除且所属 zone 存在未删除):无头库位(zone 不存在/已删除)分别记入 invalid_location_ids / invalid_locations;type=all 未传库位且未传库位ID时自动拉取全仓库启用且有效库位(排除无头库位)生成盘点范围;兼容历史任务:type=all 且已存在商品明细行(scope_type=goods,改造前创建)时继续按商品模式接受 stock_ids,避免旧调用报 400;stock_ids 与 locations/location_ids 按任务类型二选一(传错维度报 400:按库位盘点传 stock_ids 报『当前盘点类型按库位盘点,请传 locations 或 location_ids(如需按商品盘点请创建 type=goods 任务)』,按商品盘点传 locations 报『当前盘点类型按商品盘点,请传 stock_ids』、传 location_ids 报『当前盘点类型按商品盘点,不能添加库位明细』),locations 兼容 location_codes 写法(locations 优先)、location_ids 兼容 locationIds 驼峰写法(location_ids 优先);仅 created/rejected 状态允许;已存在同盘点项(商品行 stock_id / 库位行 location_code)自动跳过(幂等);完成后重算主表 total_items。",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": true,
|
||||
"headers": [
|
||||
@ -38304,13 +38317,13 @@
|
||||
"name": "invalid_stock_ids",
|
||||
"type": "array",
|
||||
"required": true,
|
||||
"description": "无效商品库存ID列表(不存在、不属于当前仓库、商品货主与任务货主不一致或在仓库无启用库存库位)"
|
||||
"description": "无效商品库存ID列表(不存在、不属于当前仓库、商品货主与任务货主不一致、在仓库无启用库存库位或启用库存全部在无头库位)"
|
||||
},
|
||||
{
|
||||
"name": "invalid_locations",
|
||||
"type": "array",
|
||||
"required": true,
|
||||
"description": "无效库位编码列表(当前仓库不存在对应库位编码)"
|
||||
"description": "无效库位编码列表(当前仓库不存在对应库位编码或无头库位(所属 zone 不存在/已删除))"
|
||||
},
|
||||
{
|
||||
"name": "invalid_location_ids",
|
||||
@ -38344,13 +38357,14 @@
|
||||
}
|
||||
],
|
||||
"notes": [
|
||||
"无头库位排除(本次变更):库位所属 zone 不存在或已删除即视为无头库位,一律不纳入盘点——商品路径仅按有效库位拆行(启用库存全部在无头库位的商品计入 invalid_stock_ids)、库位编码/ID 路径计入 invalid_locations/invalid_location_ids(不报错)、全盘自动范围直接排除;workData goods/space 视图库位枚举与明细生成同口径过滤。代码依据:app/service/systems/stock_check.js#VALID_SPACE_SQL(模块常量:wms_location_space JOIN wms_location_zone deleted_at IS NULL)。",
|
||||
"按类型二选一:type=store/goods 传 stock_ids(传 locations 报『当前盘点类型按商品盘点,请传 stock_ids』、传 location_ids 报『当前盘点类型按商品盘点,不能添加库位明细』);type=all/location 传 locations 或 location_ids(传 stock_ids 报『当前盘点类型按库位盘点,请传 locations 或 location_ids(如需按商品盘点请创建 type=goods 任务)』)。",
|
||||
"location_ids 优先:两者都传时忽略 locations,直接按 wms_location_space.id+warehouse_id 查库校验(不再按 space_code 二次解析),查不到的 ID 记入 invalid_location_ids(不报错)。",
|
||||
"历史任务兼容:改造前创建的 type=all 任务按商品添加明细(明细行 scope_type='goods');判定口径为该任务在 wms_stock_check_detail 中 scope_type='goods' 行存在(count>0)即继续按商品模式接受 stock_ids(此时传 locations/location_ids 分别报『当前盘点类型按商品盘点,请传 stock_ids』/『当前盘点类型按商品盘点,不能添加库位明细』);全新 type=all 任务(无任何商品明细行)维持按库位语义,只能传 locations/location_ids。仅 type=all 走兼容判定,store/goods/location 类型判定不变。",
|
||||
"商品货主限制:任务 store_id 非空时商品 store_id 必须与之一致,不一致计入 invalid_stock_ids(限制非本货主商品加入盘点)。",
|
||||
"全盘自动范围:type=all 且未传库位且未传 location_ids 时,自动拉取当前仓库全部启用库位(is_enabled=true)的 space_code 生成库位行;无启用库位时报 400。",
|
||||
"全盘自动范围:type=all 且未传库位且未传 location_ids 时,自动拉取当前仓库全部启用且有效库位(is_enabled=true 且所属 zone 存在未删除,排除无头库位)的 space_code 生成库位行;无启用库位时报 400。",
|
||||
"幂等:商品行按 check_id+stock_id 整体跳过(同商品重复添加整体跳过,不重复拆行)、库位行按 check_id+location_code 跳过(商品行唯一索引 uk_check_stock_location(check_id, stock_id, location_id),库位行原唯一约束 uk_check_location 已放宽为普通索引 idx_check_location、幂等由应用层查重保证);location_ids 路径跳过项按库位ID记入 skipped。",
|
||||
"商品拆行口径(本次改造,商品任务必须按库位盘点):type=store/goods 传 stock_ids 后按商品在仓库的启用库存库位(wms_storage is_enabled=1,按 space_id 分组 SUM(available_quantity+locked_quantity)(=可用+锁定))拆行——每个「商品+库位」生成一条 scope_type=goods 明细行(location_id/location_code 快照绑定库存库位、system_quantity=该库位库存 SUM(可用+锁定));一个商品多个库位对应多行;无启用库存库位的商品计入 invalid_stock_ids 不入明细;added/total_items 均为拆分明细行数。代码依据:app/service/systems/stock_check.js#_addGoodsDetailRows(Storage.findAll warehouse_id+stock_id in+is_enabled=1、attributes SUM(quantity)、group=[stock_id, space_id];LocationSpace 按 id 取 space_code 快照)。",
|
||||
"商品拆行口径(本次改造,商品任务必须按库位盘点):type=store/goods 传 stock_ids 后按商品在仓库的启用库存库位(wms_storage is_enabled=1 且库位有效(未删除且所属 zone 存在未删除,排除无头库位),按 space_id 分组 SUM(available_quantity+locked_quantity)(=可用+锁定))拆行——每个「商品+库位」生成一条 scope_type=goods 明细行(location_id/location_code 快照绑定库存库位、system_quantity=该库位库存 SUM(可用+锁定));一个商品多个库位对应多行;无启用库存库位的商品计入 invalid_stock_ids 不入明细;added/total_items 均为拆分明细行数。代码依据:app/service/systems/stock_check.js#_addGoodsDetailRows(Storage.findAll warehouse_id+stock_id in+is_enabled=1、attributes SUM(quantity)、group=[stock_id, space_id];LocationSpace 按 id 取 space_code 快照)。",
|
||||
"响应统一 data 层封装(2026-10-02 起):成功 { flag:\"success\", code:1, message:\"ok\", data:<业务数据整体>, timestamp };失败 { flag:\"failure\", code:<业务错误码>, message:<错误文案>, data:null, timestamp }。本方法业务数据整体位于 data 内,data 内字段口径与改造前一致(原顶层业务字段全部移入 data.children)。代码依据:app/service/systemMethods/stock/check.js#_call(22 个方法共用统一包装)+ app/lib/api_response.js#toSuccess(识别标准载荷后顶层补充 timestamp)。"
|
||||
]
|
||||
},
|
||||
@ -38784,7 +38798,7 @@
|
||||
],
|
||||
"notes": [
|
||||
"代码依据:app/service/systemMethods/stock/check.js#workData(warehouse_id 由服务端从 ctx.user.store_id 自动注入,前端无需传递;const { id, is_goods: isGoodsSnake, isGoods: isGoodsCamel, pagination } = data || {},isGoods=is_goods 未定义时回退 isGoods(兼容 isGoods 驼峰写法);不再读取、不再校验 view,透传 { warehouseId, id, isGoods, pagination })+ app/service/systems/stock_check.js#workData(id 非正整数抛 400『盘点任务ID不能为空』;任务不存在(按 id+warehouse_id 查 wms_stock_check)抛 400『盘点任务不存在』;状态守卫:任务状态非 REPORT_ALLOWED_STATUSES(approved/checking)时抛 400『当前状态(xx)不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取』;视图解析:normalizedType=String(check.type||'').trim(),type=location/all 一律 location 视图(无视 view/is_goods),否则 goodsViewRequested=isGoods===true||'true'||1 时 goods 视图、其余默认 space 视图;按解析视图分派 _buildLocationWorkRows/_buildGoodsWorkRows/_buildSpaceWorkRows,统一返回 { check: _formatCheckRow 口径, rows, total: rows.length, page, pageSize })。本次代码已改(view 入参废弃、is_goods 驱动视图)并测试通过 197/197、ESLint 0 错误。",
|
||||
"三视图口径(由任务范围 + is_goods 解析后分派):location=库位结构(库位范围任务一律该视图),以任务库位范围行(scope_type=location)为列表(按明细 id 升序),行内挂该库位盘点作业记录 goods 子列表(已知商品与未知商品记录均入内:已知商品 stock_id 有值,商品信息批量取自 stockWarehouse.getStockDetails 带缓存、货主名 _resolveStoreNameMap 解析;未知商品 stock_id=null,item_code 用条码兜底、item_name 用名称快照兜底条码、store_id/store_name 为 null;已知/未知商品的 images 均为作业记录照片(经 _attachRecordImages 挂载 FileReference business_type=stock_check_record,已知商品不再输出商品主图 image_url)),has_unknown 标记该库位是否含未知商品记录;goods=商品结构(商品范围任务且 is_goods=true 时该视图),以任务商品范围行(scope_type=goods)为列表(按明细 id 升序),行内 locations 为商品所在全部库位列表(商品库存库位取自 wms_storage 启用未删除存储 DISTINCT space_id 按拣货路径排序,无库存但已有作业记录的库位按首条记录 id 升序追加在末尾,空库位归 location_code=null 组排在最后;明盘每库位含 system_quantity 该库位账面数量与 quantity 该库位盘点数量(未盘库位 0),盲盘仅 location_code/checked_at/checker_name/record_ids/images);space=聚合库位列表(商品范围任务默认该视图),库位集合=当前库存库位 ∪ 作业记录库位——当前库存库位:wms_storage(warehouse_id + stock_id 在集合 + is_enabled=1 未删除)DISTINCT space_id;作业记录库位:wms_stock_check_record 的 location_id 已回填直接用、未回填的按 location_code 匹配 wms_location_space.space_code 补查,与库存库位去重后并集;行内 goods 为该库位下的任务商品;盘点前库存已出空但已有盘点作业记录的库位也能展示(该库位商品行账面 system_quantity 按 0、checked_quantity 按该库位实盘合计)。",
|
||||
"三视图口径(由任务范围 + is_goods 解析后分派):location=库位结构(库位范围任务一律该视图),以任务库位范围行(scope_type=location)为列表(按明细 id 升序),行内挂该库位盘点作业记录 goods 子列表(已知商品与未知商品记录均入内:已知商品 stock_id 有值,商品信息批量取自 stockWarehouse.getStockDetails 带缓存、货主名 _resolveStoreNameMap 解析;未知商品 stock_id=null,item_code 用条码兜底、item_name 用名称快照兜底条码、store_id/store_name 为 null;已知/未知商品的 images 均为作业记录照片(经 _attachRecordImages 挂载 FileReference business_type=stock_check_record,已知商品不再输出商品主图 image_url)),has_unknown 标记该库位是否含未知商品记录;goods=商品结构(商品范围任务且 is_goods=true 时该视图),以任务商品范围行(scope_type=goods)为列表(按明细 id 升序),行内 locations 为商品所在全部库位列表(商品库存库位取自 wms_storage 启用未删除存储且库位有效(未删除且所属 zone 存在未删除,排除无头库位)DISTINCT space_id 按拣货路径排序,无库存但已有作业记录的库位按首条记录 id 升序追加在末尾,空库位归 location_code=null 组排在最后;明盘每库位含 system_quantity 该库位账面数量与 quantity 该库位盘点数量(未盘库位 0),盲盘仅 location_code/checked_at/checker_name/record_ids/images);space=聚合库位列表(商品范围任务默认该视图),库位集合=当前库存库位 ∪ 作业记录库位——当前库存库位:wms_storage(warehouse_id + stock_id 在集合 + is_enabled=1 未删除且库位有效(排除无头库位))DISTINCT space_id;作业记录库位:wms_stock_check_record 的 location_id 已回填直接用、未回填的按 location_code 匹配 wms_location_space.space_code 补查,与库存库位去重后并集;行内 goods 为该库位下的任务商品;盘点前库存已出空但已有盘点作业记录的库位也能展示(该库位商品行账面 system_quantity 按 0、checked_quantity 按该库位实盘合计)。",
|
||||
"明盘/盲盘数量控制:明盘(mode=open)goods 视图行返回 system_quantity(明细账面快照)/checked_quantity(已盘合计=locations.quantity 合计)/diff_quantity(已盘-账面,仅存在作业记录的行计算)/is_diff(差异非 0 为 1),locations 各项含 system_quantity(该库位账面数量=可用+锁定,wms_storage 该库位 SUM(available_quantity+locked_quantity),无库存记录库位为 0)、locked_quantity(该库位锁定数量,wms_storage 该库位 SUM(locked_quantity))与 quantity(该库位盘点数量=实盘合计,未盘库位为 0);space 视图 goods 各项含 system_quantity(wms_storage space+stock SUM(available_quantity+locked_quantity) 账面,该库位无库存记录时按 0)/locked_quantity(wms_storage space+stock SUM(locked_quantity))/checked_quantity(该商品在该库位的实盘合计);盲盘(mode=blind)不返回任何数量字段(goods 视图 locations 仅 location_code/checked_at/checker_name/record_ids/images,space 视图 goods 仅商品信息+images/record_ids/status);goods 视图 locations 为商品所在全部库位列表(含未盘库位,无作业记录时各项为空信息),无作业记录的行明盘已盘合计恒 0、差异/is_diff 恒 0(避免未盘行误显盘亏差异)。",
|
||||
"排序口径:space 视图库位仅按库位拣货顺序排序——pick_sequence 升序(pick_priority 与库位 id 均不参与,同值保持库位查询顺序);space 行内 goods 按 stock_id 升序;location/goods 视图行按明细 id 升序;goods 视图 locations 按首条记录 id 升序。",
|
||||
"权限口径:随 ALL_METHOD_NAMES(22 个:create/list/addDetail/addLocationDetail/detailDelete/detail/result/workData/report/markEmpty/recordList/recordDelete/recheckClearLocation/finish/submit/cancel/audit/batchDelete/export/exportTaskProgress/patternList/patternCreate)免 API 权限(isNeedAuth=false)、免仓库有效期鉴权(_noNeedAuth)、必须登录(isNeedLogin=true,免登录清单为空);为查询类方法,加入免日志清单 _noNeedLog(list/detail/result/workData/recordList/export/exportTaskProgress/patternList),不记录操作日志。",
|
||||
@ -40928,13 +40942,13 @@
|
||||
"static 定式静态记录表口径:收集阶段排除 wms_stock_static_check_task 已有记录(未删除)的 stock_id(已进入静态已盘点商品);任务创建成功后把本次命中的 stock_id 批量写入该表(task_time=创建时间),写入失败仅记告警日志、不影响主流程。",
|
||||
"权限口径:免 API 权限(isNeedAuth=false)、免仓库有效期鉴权、必须登录(isNeedLogin=true);patternCreate 为写操作,不在免日志清单(_noNeedLog)中,记录操作日志(patternList 为查询类,免日志)。",
|
||||
"单号生成:check_no=PD+YYYYMMDD+6 位序号(全局递增不按仓库隔离),并发下撞 uk_check_no 唯一键自动重取重试(最多 5 次)。",
|
||||
"goods 定式拆行口径(本次改造):商品类定式(mis_shipment/expiring/static/warning,type=goods)收集到 stock_ids 后走 _addGoodsDetailRows 同款逻辑——按商品在仓库的启用库存库位(wms_storage is_enabled=1,按 space_id 分组 SUM)拆行,每个「商品+库位」一条 scope_type=goods 明细行(location_id/location_code 绑定库存库位、system_quantity=该库位库存 SUM);无启用库存库位的商品不产生明细行,total_items 按拆分行重算。代码依据:app/service/systems/stock_check.js#patternCreate(pattern.type==='goods' 调 _addGoodsDetailRows)。",
|
||||
"goods 定式拆行口径(本次改造):商品类定式(mis_shipment/expiring/static/warning,type=goods)收集到 stock_ids 后走 _addGoodsDetailRows 同款逻辑——按商品在仓库的启用库存库位(wms_storage is_enabled=1 且库位有效(未删除且所属 zone 存在未删除,排除无头库位),按 space_id 分组 SUM)拆行,每个「商品+库位」一条 scope_type=goods 明细行(location_id/location_code 绑定库存库位、system_quantity=该库位库存 SUM);无启用库存库位的商品不产生明细行,total_items 按拆分行重算。代码依据:app/service/systems/stock_check.js#patternCreate(pattern.type==='goods' 调 _addGoodsDetailRows)。",
|
||||
"响应统一 data 层封装(2026-10-02 起):成功 { flag:\"success\", code:1, message:\"ok\", data:<业务数据整体>, timestamp };失败 { flag:\"failure\", code:<业务错误码>, message:<错误文案>, data:null, timestamp }。本方法业务数据整体位于 data 内,data 内字段口径与改造前一致(原顶层业务字段全部移入 data.children)。代码依据:app/service/systemMethods/stock/check.js#_call(22 个方法共用统一包装)+ app/lib/api_response.js#toSuccess(识别标准载荷后顶层补充 timestamp)。"
|
||||
]
|
||||
},
|
||||
{
|
||||
"method": "stock.check.addLocationDetail",
|
||||
"description": "批量添加库位明细(兼容入口,薄封装转调 addDetail 的库位ID直查路径):入参 id(盘点任务ID)+ location_ids(库位ID列表,兼容 locationIds 驼峰写法);服务端直接按 wms_location_space.id+warehouse_id 查库校验,不经过 space_code 二次解析;转发前保留旧口径参数校验(任务ID不能为空、库位ID不能为空、单次上限 200),任务存在性/状态/类型分派校验统一由 addDetail 处理;幂等添加 scope_type=location 明细行,已存在的同库位明细自动跳过;返回结构从 addDetail 映射为 { added, skipped, invalid_location_ids, total_items }(过滤 invalid_locations/invalid_stock_ids),保持原返回口径不变。",
|
||||
"description": "批量添加库位明细(兼容入口,薄封装转调 addDetail 的库位ID直查路径):入参 id(盘点任务ID)+ location_ids(库位ID列表,兼容 locationIds 驼峰写法);服务端直接按 wms_location_space.id+warehouse_id 查库校验(库位必须有效:未删除且所属 zone 存在未删除,无头库位记入 invalid_location_ids),不经过 space_code 二次解析;转发前保留旧口径参数校验(任务ID不能为空、库位ID不能为空、单次上限 200),任务存在性/状态/类型分派校验统一由 addDetail 处理;幂等添加 scope_type=location 明细行,已存在的同库位明细自动跳过;返回结构从 addDetail 映射为 { added, skipped, invalid_location_ids, total_items }(过滤 invalid_locations/invalid_stock_ids),保持原返回口径不变。",
|
||||
"isNeedAuth": false,
|
||||
"isNeedLogin": true,
|
||||
"headers": [
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user