From 48dbe020ff95becde2b2658190f4be3d0e04c9e0 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Wed, 30 Sep 2026 18:13:53 +0800 Subject: [PATCH] 1 --- src/api/apiapp/apiapp.ts | 60 ++++ src/api/order/order.ts | 15 + src/api/stock.check/stock.check.ts | 281 +++++++++++++--- .../config/components/CheckItemsPanel.vue | 318 ++++++++++++++---- .../stockcheck/config/template-config.ts | 55 ++- src/views/storage/stockcheck/index.vue | 129 +++++-- .../stockcheck/pages/CheckFormDialog.vue | 53 ++- .../pages/CheckStockPickerDialog.vue | 162 +++++++-- .../newview/config/template-config.ts | 19 +- .../newview/pages/ApiAppFormDialog.vue | 114 ++++++- 10 files changed, 1026 insertions(+), 180 deletions(-) diff --git a/src/api/apiapp/apiapp.ts b/src/api/apiapp/apiapp.ts index f6070769..9960170d 100644 --- a/src/api/apiapp/apiapp.ts +++ b/src/api/apiapp/apiapp.ts @@ -15,6 +15,8 @@ export interface ApiAppItem { self_app_secret: string // 列表返回脱敏后的 Secret(如 "ce4f07a1****") self_ip_whitelist: string[] | null callback_url: string | null + /** 承接的出站回调 method 列表(空/未勾选=不承接任何回调) */ + callback_functions?: string[] | null interface_type_id: number rate_limit: number sign_method: string @@ -40,6 +42,8 @@ export interface ApiAppFlatResponse { self_app_secret: string // 创建/重置时是完整密钥,列表/详情时脱敏 self_ip_whitelist: string[] | null callback_url: string | null + /** 承接的出站回调 method 列表(create/update 回显;detail 亦返回) */ + callback_functions?: string[] | null interface_type_id: number rate_limit: number sign_method: string @@ -79,6 +83,11 @@ export interface ApiAppCreateParams { interface_type_id?: number self_ip_whitelist?: string[] callback_url?: string + /** + * 承接的出站回调 method 列表,仅允许注册表(apiApp.listCallbackFunctions)中的方法 + * (如 notify.reply);空数组/不传 = 不承接任何回调 + */ + callback_functions?: string[] rate_limit?: number } @@ -88,6 +97,11 @@ export interface ApiAppUpdateParams { app_name?: string self_ip_whitelist?: string[] callback_url?: string + /** + * 承接的出站回调 method 列表,仅允许注册表中的方法; + * **空数组 = 清空承接(不承接任何回调)** + */ + callback_functions?: string[] rate_limit?: number is_enabled?: number } @@ -197,3 +211,49 @@ export function apiAppRegenerateSecret( isSystemApi: true } as any) } + +// ============================================================ +// 出站回调 method 注册表(apiApp.listCallbackFunctions) +// ============================================================ + +/** 注册表条目:兼容后端返回「字符串数组」或「对象数组」两种形态 */ +export type ApiAppCallbackFunction = + | string + | { + /** 回调 method,如 notify.reply */ + method: string + /** 展示名称(可选) */ + title?: string + /** 说明(可选) */ + description?: string + [key: string]: unknown + } + +/** 列表响应(list/total 在顶层,与 apiApp.list 口径一致) */ +export interface ApiAppListCallbackFunctionsResponse { + flag?: string + code: number + message?: string + list: ApiAppCallbackFunction[] + total: number + timestamp?: number +} + +/** + * 拉取出站回调 method 注册表(代码注册,供管理端多选列表使用) + * + * 应用勾选后由服务端按 method 自动路由出站回调;入参无。 + */ +export function apiAppListCallbackFunctions(): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'apiApp.listCallbackFunctions', + v, + timestamp: Date.now() + }, + data: {}, + isSystemApi: true + } as any) +} diff --git a/src/api/order/order.ts b/src/api/order/order.ts index 995ab809..9d0920f2 100644 --- a/src/api/order/order.ts +++ b/src/api/order/order.ts @@ -238,6 +238,11 @@ export type PendingOrderManualWaybillParams = { waybill_code: string /** 物流接口名称(选填),trim 后为空则传 null */ logistics_interface_name?: string | null + /** + * 快递编码(选填):可为系统编码或仓库自定义编码;传入时同步修改订单的快递信息 + * (行为参考 order.pendingOrder.updateOrderExpress);不传时运单记录沿用订单当前系统快递信息 + */ + express_code?: string | null } export type PendingOrderManualWaybillData = { @@ -247,6 +252,16 @@ export type PendingOrderManualWaybillData = { business_key?: number logistics_interface_name?: string | null create_at?: string + /** 传入的快递编码,未传时不返回 */ + express_code?: string | null + /** 写入订单的系统快递编码,仅在传入 express_code 时返回 */ + sys_logistics_code?: string | null + /** 写入订单的系统快递名称,仅在传入 express_code 时返回 */ + sys_logistics_name?: string | null + /** 写入订单与运单记录的快递编码(自定义或系统),仅在传入 express_code 时返回 */ + logistics_code?: string | null + /** 写入订单与运单记录的快递名称(自定义或系统),仅在传入 express_code 时返回 */ + logistics_name?: string | null } export type PendingOrderManualWaybillResponse = PendingOrderManualWaybillData & { diff --git a/src/api/stock.check/stock.check.ts b/src/api/stock.check/stock.check.ts index 3518c38a..c04ca95d 100644 --- a/src/api/stock.check/stock.check.ts +++ b/src/api/stock.check/stock.check.ts @@ -37,12 +37,21 @@ export type StockCheckStatus = /** 明细盘点进度(主表 detail_status) */ export type StockCheckDetailStatus = 'none_checked' | 'partial_checked' | 'all_checked' -/** 盘点范围类型 */ +/** + * 盘点范围类型 + * + * 明细行形态由 type 决定: + * all / location → 明细为「库位行」(scope_type=location,一行=一个库位,行内按商品聚合 stocks[]) + * store / goods → 明细为「商品行」(scope_type=goods,一行=一个库存商品) + */ export type StockCheckType = - | 'all' // 全盘(缺省) - | 'store' // 按货主 - | 'goods' // 按商品 - | 'location' // 按库位 + | 'all' // 按库位盘点(缺省):添加明细未传库位时由后端自动拉取全仓库启用库位生成盘点范围 + | 'location' // 按库位盘点(指定库位) + | 'store' // 按货主按商品盘点(商品行) + | 'goods' // 按商品盘点(商品行) + +/** 明细行形态(stock.check.detail 的 rows[].scope_type) */ +export type StockCheckScopeType = 'goods' | 'location' /** 盘点方式 */ export type StockCheckMode = @@ -112,7 +121,7 @@ export type StockCheckRecord = { [key: string]: unknown } -/** 明细的库位聚合(stock.check.detail 的 rows[].locations) */ +/** 明细的库位聚合(stock.check.result 的 rows[].locations,按首条记录 id 升序) */ export type StockCheckDetailLocation = { location_id?: number | null /** 库位编码;「无库位」分组为空串或 null */ @@ -122,45 +131,96 @@ export type StockCheckDetailLocation = { } /** - * 盘点明细行(stock.check.detail 返回):商品快照 + 已盘聚合字段 + 作业记录 + * 库位行内的商品聚合(stock.check.result 的 rows[].stocks,按 stock_id 升序) * - * 注意:实盘数量/差异已不是单值,而是按作业记录聚合的 checked_quantity / diff_quantity; - * 库位为多个(location_codes 数组 + locations 按库位聚合;无库位分组的编码为空串/null)。 + * 仅 scope_type=location 的结果行有此字段,且**仅含存在作业记录的商品**; + * 商品行(scope_type=goods)为商品快照本身,无此字段。 */ -export type StockCheckDetailRow = { - id: number - check_id: number - warehouse_id?: number +export type StockCheckDetailStock = { /** 商品库存ID(wms_stock_warehouse.id) */ stock_id: number item_code?: string item_name?: string - spec?: string - batch_no?: string - /** 账面数量(快照) */ - system_quantity?: number - /** 已盘数量 = 该明细作业记录 quantity 合计(无作业记录时为 null) */ + /** 账面数量(查 wms_storage:space_id+stock_id SUM(quantity);location_id 为空时按 0) */ + system_quantity?: number | null + /** 该商品在本库位的实盘数量(作业记录 quantity 合计;无记录时为 null) */ checked_quantity?: number | null - /** 差异数量 = 已盘数量 - 账面快照(无作业记录时为 null) */ + /** 差异数量 = 实盘 - 账面(无记录时为 null) */ diff_quantity?: number | null - /** 是否有差异:0|1(无作业记录时为 null) */ + [key: string]: unknown +} + +/** + * 盘点**范围行**(stock.check.detail 的 rows 元素)—— 纯范围行,**不含任何盘点作业聚合** + * + * 两种形态(看 scope_type): + * - goods(商品行):stock_id 与商品快照有值,location_id/location_code 为 null + * - location(库位行):location_id/location_code 有值,stock_id 与商品快照为 null + * + * ⚠️ 需要 checked_quantity/diff_quantity/is_diff/status/location_codes/checkers/ + * last_checked_at/records/locations/stocks 等盘点结果聚合时,请用 stockCheckResult。 + */ +export type StockCheckDetailRow = { + /** 明细ID */ + id: number + check_id: number + warehouse_id?: number + /** 明细行形态:goods=商品行 / location=库位行 */ + scope_type?: StockCheckScopeType | string + /** 商品库存ID(wms_stock_warehouse.id;仅商品行有值) */ + stock_id?: number | null + /** 库位ID(wms_location_space.id;仅库位行有值) */ + location_id?: number | null + /** 库位编码(仅库位行有值) */ + location_code?: string | null + /** 商品编码(商品快照;库位行为 null) */ + item_code?: string | null + /** 商品名称(商品快照;库位行为 null) */ + item_name?: string | null + /** 规格(商品快照;库位行为 null) */ + spec?: string | null + /** 批次号(商品快照;库位行为 null) */ + batch_no?: string | null + /** 账面数量快照(商品行为快照值,库位行为 0) */ + system_quantity?: number | null + remark?: string | null + created_at?: string + updated_at?: string + [key: string]: unknown +} + +/** + * 盘点**结果行**(stock.check.result 的 rows 元素)= 范围行 + 作业记录聚合 + * + * 两种形态(看 scope_type): + * - goods(商品行):商品快照 + 聚合字段 + * - location(库位行):无商品快照,改为 stocks[] 按商品聚合(仅含存在作业记录的商品) + * + * 共同具备:checked_quantity / diff_quantity / is_diff / status / location_codes / + * checkers / last_checked_at + records + locations; + * 无作业记录时聚合字段为 null、records/locations/stocks 为空数组。 + */ +export type StockCheckResultRow = StockCheckDetailRow & { + /** 已盘数量(商品行=作业记录 quantity 合计;库位行=行内商品实盘合计;无记录为 null) */ + checked_quantity?: number | null + /** 差异数量(商品行=已盘-账面;库位行=行内各商品差异代数和;无记录为 null) */ + diff_quantity?: number | null + /** 是否有差异:0|1(无记录时为 null) */ is_diff?: boolean | number | null - /** 明细状态:checked=有作业记录 / unchecked=未盘 */ + /** 盘点状态:checked=有作业记录 / unchecked=未盘 */ status?: 'checked' | 'unchecked' | string /** 已盘库位编码数组(去重;无库位分组的编码为空串/null) */ location_codes?: string[] /** 盘点人数组(去重) */ checkers?: string[] - /** 最近上报时间 */ + /** 最近上报时间(无记录为 null) */ last_checked_at?: string | null /** 该明细的全部作业记录(无记录时为空数组) */ records?: StockCheckRecord[] - /** 按库位聚合(无记录时为空数组) */ + /** 按库位聚合(无记录时为空数组;空库位记录归 location_code=null 组) */ locations?: StockCheckDetailLocation[] - remark?: string | null - created_at?: string - updated_at?: string - [key: string]: unknown + /** 库位行的商品聚合(商品行为 undefined;无记录时为空数组) */ + stocks?: StockCheckDetailStock[] } // ============ stock.check.create ============ @@ -243,22 +303,34 @@ export function stockCheckList( // ============ stock.check.addDetail ============ -/** stock.check.addDetail 请求参数 */ +/** stock.check.addDetail 请求参数(与任务 type 对齐:商品类传 stock_ids,库位类传 locations) */ export type StockCheckAddDetailParams = { /** 盘点任务ID */ id: number - /** 商品库存ID列表(wms_stock_warehouse.id) */ - stock_ids: number[] + /** + * 商品库存ID列表(wms_stock_warehouse.id):type=store/goods 按商品盘点时使用, + * 与 locations 按任务类型二选一 + */ + stock_ids?: number[] + /** + * 库位编码列表(wms_location_space.space_code):type=all/location 按库位盘点时使用, + * 与 stock_ids 按任务类型二选一;**type=all 未传时由后端自动拉取全仓库启用库位生成盘点范围** + */ + locations?: string[] + /** 库位编码列表(兼容别名;locations 优先,两者都传时以 locations 为准) */ + location_codes?: string[] } /** stock.check.addDetail 响应 */ export type StockCheckAddDetailResponse = { /** 本次新增明细数 */ added: number - /** 已存在被跳过(幂等)的 stock_id 数 */ + /** 已存在被跳过(幂等)的盘点项数 */ skipped: number - /** 无效商品库存ID列表(不存在或不属于当前仓库) */ + /** 无效商品库存ID列表(不存在、不属于当前仓库,或商品货主与任务货主不一致) */ invalid_stock_ids: number[] + /** 无效库位编码列表(当前仓库不存在对应库位编码) */ + invalid_locations: string[] /** 重算后的明细总行数 */ total_items: number } @@ -342,17 +414,22 @@ export type StockCheckDetailParams = { id: number } -/** stock.check.detail 响应 */ +/** stock.check.detail 响应(纯范围行,**不含盘点作业聚合**) */ export type StockCheckDetailResponse = { /** 盘点主表信息 */ check: StockCheckTask - /** 全部明细行 */ + /** 全部范围行 */ rows: StockCheckDetailRow[] /** 明细总条数 */ total: number } -/** stock.check.detail:拉取盘点任务主表 + 全部明细行(不分页) */ +/** + * stock.check.detail:拉取盘点任务主表 + 全部**范围行**(不分页) + * + * rows 为纯范围行(商品行/库位行的商品/库位快照),不含盘点作业聚合; + * 需要已盘/差异/状态/作业记录等「盘点结果」时请用 stockCheckResult。 + */ export function stockCheckDetail( data: StockCheckDetailParams ): Promise }> { @@ -369,21 +446,70 @@ export function stockCheckDetail( } as any) } +// ============ stock.check.result ============ + +/** stock.check.result 请求参数 */ +export type StockCheckResultParams = { + /** 盘点任务ID */ + id: number +} + +/** stock.check.result 响应(范围行 + 盘点作业聚合) */ +export type StockCheckResultResponse = { + /** 盘点主表信息 */ + check: StockCheckTask + /** 全部结果行 */ + rows: StockCheckResultRow[] + /** 明细总条数 */ + total: number +} + +/** + * stock.check.result:拉取盘点明细**结果**(按范围行聚合作业记录) + * + * 与 detail 同结构(check/rows/total),但 rows 额外带: + * checked_quantity / diff_quantity / is_diff / status / location_codes / checkers / + * last_checked_at + records + locations(库位行还有 stocks 按商品聚合)。 + */ +export function stockCheckResult( + data: StockCheckResultParams +): Promise }> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.result', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + // ============ stock.check.report ============ -/** stock.check.report 请求参数(覆盖式:同明细 + 同库位重复上报为更新) */ +/** stock.check.report 请求参数(覆盖式:同明细 + 同商品 + 同库位重复上报为更新) */ export type StockCheckReportParams = { /** 盘点任务ID */ id: number /** 盘点明细ID */ detail_id: number /** - * 库位编码(可空):未传或为空串均写入「无库位」分组(库中 location_code 存空串); + * 库位编码(可空): + * - 商品行(scope_type=goods):未传或为空串均写入「无库位」分组(库中 location_code 存空串) + * - 库位行(scope_type=location):以明细库位为准,**传入时必须与明细库位一致** * 匹配 space_code 时回填 location_id */ location?: string /** 实盘数量(不小于 0 的整数) */ quantity: number + /** + * 商品库存ID(wms_stock_warehouse.id): + * - 商品行:可选(传入必须与明细商品一致,否则报错) + * - 库位行:**必填**,且商品必须属于本仓库 + */ + stock_id?: number } /** stock.check.report 响应 */ @@ -392,7 +518,7 @@ export type StockCheckReportResponse = { record: StockCheckRecord /** 盘点明细ID */ detail_id: number - /** 本次上报模式:created=首次上报新增记录 / updated=同明细+同库位覆盖更新 */ + /** 本次上报模式:created=首次上报新增记录 / updated=同明细+同商品+同库位重复上报更新已有记录 */ mode: 'created' | 'updated' | string total_items: number /** 已盘行数(存在作业记录的明细数) */ @@ -522,13 +648,16 @@ export type StockCheckFinishResponse = { total_items: number /** 已盘行数(存在作业记录的明细数) */ checked_items: number - /** 未盘明细数(无作业记录的明细数,完成时按实盘 0 处理计为盘亏) */ + /** + * 未盘明细数(无作业记录的明细数) + * 口径:未盘**商品行**按实盘 0 处理计为盘亏;未盘**库位行**不计差异 + */ unchecked_items: number - /** 差异行数(含未盘明细按实盘 0 计算的差异) */ + /** 差异行数(商品行:实盘合计与账面快照不一致;库位行:行内任一商品实盘与账面不一致;未盘商品明细按实盘 0 计入) */ diff_items: number - /** 盘盈合计(作业记录数量合计大于账面快照的差异合计) */ + /** 盘盈合计(商品行:实盘合计大于账面快照的差异;库位行:按商品实盘大于 wms_storage 账面的差异) */ profit_total: number - /** 盘亏合计(实盘小于账面快照的差异绝对值合计,含未盘明细的账面快照数) */ + /** 盘亏合计(商品行:实盘小于账面快照的差异绝对值,含未盘明细的账面快照数;库位行:按商品实盘小于 wms_storage 账面的差异绝对值) */ loss_total: number } @@ -670,9 +799,9 @@ export type StockCheckExportResponse = { status: string /** 进度百分比(0-100) */ progress: number - /** 当前已处理明细数 */ + /** 当前已处理明细行数(Sheet2「盘点明细」已写入的作业记录行数) */ current_count: number - /** 明细总行数 */ + /** Sheet2「盘点明细」总行数(作业记录总数,导出前即确定) */ total_count: number message: string /** 任务成功时的结果对象(含 filename/fileKey/url/cdnUrl/cosUrl) */ @@ -684,7 +813,15 @@ export type StockCheckExportResponse = { /** * stock.check.export:提交盘点任务导出任务(异步)。 - * 每个盘点任务一个 Sheet(Sheet 名=盘点单号);单次最多 50 个盘点任务。 + * + * Excel 两个 Sheet: + * - Sheet1「盘点单」:一行一个盘点任务(单号/名称/范围/方式/状态/进度/日期/货主ID/创建人/ + * 明细行数/已盘行数/差异行数/开始时间/结束时间/备注) + * - Sheet2「盘点明细」:一行一条实际盘点记录(作业记录)——单号/商品编码/商品名称/ + * 库位编码(空库位输出为空)/实盘数量/盘点人/盘点时间; + * **未盘的任务范围行不再导出**,商品快照从 wms_stock_warehouse 补齐 + * 进度经 Redis 缓存追踪(key stock_check_export_task_*,TTL 1800 秒),立即返回任务ID; + * 单次最多 50 个盘点任务。 */ export function stockCheckExport( data: StockCheckExportParams = {} @@ -743,3 +880,57 @@ export function stockCheckExportTaskProgress( isSystemApi: true } as any) } + +// ============ stock.check.batchDelete ============ + +/** stock.check.batchDelete 请求参数 */ +export type StockCheckBatchDeleteParams = { + /** + * 盘点任务ID数组(兼容单值;服务端归一化为去重后的正整数,**单次上限 200**) + */ + ids: number[] | number +} + +/** stock.check.batchDelete 响应 */ +export type StockCheckBatchDeleteResponse = { + /** 入参去重后的任务ID数量 */ + total: number + /** 实际删除的任务数量(仅作废任务) */ + deleted_count: number + /** 跳过的任务数量(非作废状态或查不到的任务) */ + skipped_count: number + /** 已删除的任务ID列表(保持入参顺序) */ + deleted_ids: number[] + /** 跳过的任务ID列表(保持入参顺序) */ + skipped_ids: number[] +} + +/** + * stock.check.batchDelete:**批量删除盘点任务**(仅删除「已作废」任务) + * + * - 仅 `status=cancelled`(作废)的任务会被级联删除;其他状态及查不到的任务跳过(计入 skipped_ids) + * - 删除链(事务内):作业记录 wms_stock_check_record → 明细 wms_stock_check_detail → 主表 wms_stock_check + * - warehouse_id 由服务端从登录上下文注入,前端不传;按 id + warehouse_id 做仓库隔离 + * - 单次上限 200 个任务 + */ +export function stockCheckBatchDelete( + data: StockCheckBatchDeleteParams +): Promise< + StockCheckBatchDeleteResponse & { + code?: number + message?: string + data?: Partial + } +> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.batchDelete', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} diff --git a/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue b/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue index fe963c14..155e3420 100644 --- a/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue +++ b/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue @@ -2,14 +2,23 @@ CheckItemsPanel — 盘点明细面板(库存盘点 stock.check) 职责: - 1. 拉取 stock.check.detail,渲染盘点明细行(商品/批次/库位/账面/已盘合计/差异/状态) - 2. 盘点作业:行内或批量上报(stock.check.report,**覆盖式**:同明细 + 同库位重复上报=更新记录) - —— 行上是「上报库位 + 本库位数量」输入,「已盘合计/库位/盘点人/最近上报」为后端按作业记录聚合的只读值 - 3. 完成盘点(stock.check.finish,允许部分未盘完成:未盘明细按实盘 0 计入盘亏) - 4. 「添加商品」交给宿主 index.vue 打开 CheckStockPickerDialog(emit add-items) + 1. 拉取盘点明细并渲染: + - 已有/可能有作业记录的阶段(approved/checking/completed/cancelled)→ **stock.check.result** + (范围行 + 已盘/差异/状态/作业记录聚合) + - 尚未开始作业的阶段(created/rejected/submitted,必然无作业记录)→ **stock.check.detail** + (纯范围行,不含聚合;此时作业类列不渲染,无需多发一次聚合查询) + 行形态由任务 type 决定: + - 商品行(scope_type=goods,type=store/goods):一行一个库存商品(商品快照 + 已盘聚合) + - 库位行(scope_type=location,type=all/location):一行一个库位,行内按商品聚合 stocks[], + 上报需带 stock_id → 展开行内按商品逐条上报 + 2. 盘点作业:行内或批量上报(stock.check.report,**覆盖式**: + 商品行=同明细+同库位;库位行=同明细+同商品+同库位,均重复上报为更新) + 3. 完成盘点(stock.check.finish,允许部分未盘完成: + 未盘商品明细按实盘 0 计入盘亏与差异行数,未盘库位明细不计差异) + 4. 「添加商品 / 添加库位」交给宿主 index.vue 打开 CheckStockPickerDialog(emit add-items) 状态约束(与后端一致): - - created/rejected → 可添加商品(addDetail) + - created/rejected → 可添加明细(addDetail) - approved/checking → 可上报(report)、可完成(finish) - mode=blind 盲盘 → 账面数量/差异在前端不可见 - 明细 status:checked=有作业记录 / unchecked=未盘 @@ -21,7 +30,7 @@
刷新 - 添加商品 + {{ isLocationTask ? '添加库位' : '添加商品' }}
+ 未开始盘点:仅展示盘点范围 盲盘:账面数量不可见 明细 {{ stats.total }} · 已盘 {{ stats.checked }} · 差异 {{ stats.diff }} @@ -65,14 +75,105 @@ :height="tableHeight" > - - - - + + + + + + + + + + + + + - + - + - + - + - + - + - + - + @@ -347,6 +446,25 @@ watch( color: #909399; } +/* 库位模式:预览已识别的库位编码 */ +.location-preview { + display: flex; + flex-wrap: wrap; + align-items: center; + gap: 6px; + max-height: 120px; + overflow-y: auto; +} + +.location-tag { + margin: 0; +} + +.stat-text { + font-size: 12px; + color: #909399; +} + /* 分页器:右对齐 + 「每页条数」下拉与 UpperTable 同宽 80px */ .pagination-container { flex-shrink: 0; diff --git a/src/views/system/setting/basicManagement/newview/config/template-config.ts b/src/views/system/setting/basicManagement/newview/config/template-config.ts index cb99b282..b0c3c27f 100644 --- a/src/views/system/setting/basicManagement/newview/config/template-config.ts +++ b/src/views/system/setting/basicManagement/newview/config/template-config.ts @@ -27,7 +27,7 @@ import ApiAppFormDialog from '../pages/ApiAppFormDialog.vue' import DeliveryPlanFormDialog from '../pages/DeliveryPlanFormDialog.vue' import DefinitionFormDialog from '../pages/DefinitionFormDialog.vue' import DeliveryPlanCopyDialog from '../pages/DeliveryPlanCopyDialog.vue' -import { apiAppList } from '@/api/apiapp/apiapp' +import { apiAppList, apiAppDetail } from '@/api/apiapp/apiapp' import { listDeliveryPlan, listDeliveryLog, @@ -571,6 +571,15 @@ export const FIELD_DICT: Record = { slot: null, detailLabel: '回调URL' }, + /** API应用:承接的出站回调 method 列表(空/未勾选 = 不承接任何回调) */ + callback_functions: { + key: 'callback_functions', + label: '回调方法', + scanBox: null, + table: { minWidth: 180, showOverflowTooltip: true }, + slot: { type: 'pre' }, + detailLabel: '回调方法' + }, /** API应用:创建时间 */ created_at: { key: 'created_at', @@ -1362,8 +1371,8 @@ export const tabPages: TabPageRawConfig[] = [ }, { title: '网络配置', - columnCount: 2, - fieldKeys: ['callback_url', 'self_ip_whitelist'] + columnCount: 3, + fieldKeys: ['callback_url', 'callback_functions', 'self_ip_whitelist'] }, { title: '时间信息', @@ -1373,7 +1382,8 @@ export const tabPages: TabPageRawConfig[] = [ ], api: { list: apiAppList, - detail: { source: 'list' }, + // 明细改用 apiApp.detail:列表未承诺返回 callback_functions,详情才能拿到完整字段 + detail: (payload: any) => apiAppDetail(Number(payload?.id ?? payload)), parseListResponse(res) { return { list: res?.list ?? res?.data?.list ?? [], total: res?.pagination?.total ?? res?.data?.pagination?.total ?? 0 } }, @@ -1398,6 +1408,7 @@ export const tabPages: TabPageRawConfig[] = [ app_name: 'app_name', rate_limit: 'rate_limit', callback_url: 'callback_url', + callback_functions: 'callback_functions', self_ip_whitelist: 'self_ip_whitelist', is_enabled: 'is_enabled' } diff --git a/src/views/system/setting/basicManagement/newview/pages/ApiAppFormDialog.vue b/src/views/system/setting/basicManagement/newview/pages/ApiAppFormDialog.vue index f7cd8df2..dbce9f94 100644 --- a/src/views/system/setting/basicManagement/newview/pages/ApiAppFormDialog.vue +++ b/src/views/system/setting/basicManagement/newview/pages/ApiAppFormDialog.vue @@ -1,6 +1,8 @@ @@ -52,6 +54,27 @@ /> + + + + + +
import { computed, nextTick, reactive, ref, watch } from 'vue' import { ElMessage } from 'element-plus' -import { apiAppCreate, apiAppUpdate } from '@/api/apiapp/apiapp' +import { + apiAppCreate, + apiAppDetail, + apiAppListCallbackFunctions, + apiAppUpdate +} from '@/api/apiapp/apiapp' defineOptions({ name: 'ApiAppFormDialog' }) @@ -139,6 +167,8 @@ const props = defineProps<{ rate_limit?: number callback_url?: string self_ip_whitelist?: string[] + /** 承接的出站回调 method 列表(行数据可能未返回,编辑时会用 apiAppDetail 纠正) */ + callback_functions?: string[] | null is_enabled?: number }>() @@ -164,6 +194,8 @@ const formData = reactive({ app_name: '', rate_limit: 1000, callback_url: '', + /** 承接的出站回调 method 列表(空数组 = 不承接任何回调) */ + callback_functions: [] as string[], self_ip_whitelist: [] as string[], is_enabled: 1 }) @@ -175,15 +207,26 @@ const formRules = { ] } +// ===== 回调方法(注册表多选)===== +// 注:以下响应式声明必须位于下方 immediate watch 之前(watch 会立即调用拉取逻辑) +type CallbackOption = { value: string; label: string } + +const callbackOptions = ref([]) +const callbackLoading = ref(false) +let callbackOptionsLoaded = false + watch(() => props.visible, (v) => { if (v) { createdSecret.value = null formData.app_name = props.app_name ?? '' formData.rate_limit = props.rate_limit ?? 1000 formData.callback_url = props.callback_url ?? '' + formData.callback_functions = toArray(props.callback_functions) formData.self_ip_whitelist = props.self_ip_whitelist ? [...props.self_ip_whitelist] : [] formData.is_enabled = props.is_enabled ?? 1 formRef.value?.clearValidate?.() + void loadCallbackFunctions() + void fillFromDetail() } }, { immediate: true }) @@ -231,6 +274,73 @@ function handleRemoveFormIp(idx: number) { formData.self_ip_whitelist.splice(idx, 1) } +// ===== 回调方法:注册表拉取与详情回填 ===== +/** 兼容「JSON 字符串 / 逗号分隔字符串 / 数组 / null」的列表字段 */ +function toArray(v: any): string[] { + if (Array.isArray(v)) return v.filter((x) => x !== null && x !== undefined).map((x) => String(x)) + if (typeof v === 'string' && v.trim()) { + try { + const parsed = JSON.parse(v) + if (Array.isArray(parsed)) return parsed.map((x) => String(x)) + } catch { + return v.split(',').map((s) => s.trim()).filter(Boolean) + } + } + return [] +} + +/** 注册表条目 → 下拉选项(兼容字符串数组与对象数组,对象优先取 method) */ +function normalizeCallbackOption(item: any): CallbackOption | null { + if (typeof item === 'string') { + const val = item.trim() + return val ? { value: val, label: val } : null + } + const value = String(item?.method ?? item?.value ?? item?.code ?? '').trim() + if (!value) return null + const title = String(item?.title ?? item?.name ?? item?.description ?? '').trim() + return { value, label: title && title !== value ? `${value}(${title})` : value } +} + +/** 拉取回调 method 注册表(注册表是代码注册的静态清单,本弹窗实例首次打开拉一次即复用) */ +async function loadCallbackFunctions() { + if (callbackOptionsLoaded || callbackLoading.value) return + callbackLoading.value = true + try { + const res: any = await apiAppListCallbackFunctions() + const list = res?.list ?? res?.data?.list ?? [] + callbackOptions.value = (Array.isArray(list) ? list : []) + .map(normalizeCallbackOption) + .filter((o: CallbackOption | null): o is CallbackOption => !!o) + callbackOptionsLoaded = true + } catch (e: any) { + console.warn('[ApiAppFormDialog] 拉取回调方法注册表失败', e) + } finally { + callbackLoading.value = false + } +} + +/** + * 编辑时用 apiApp.detail 回填: + * 列表接口未承诺返回 callback_functions,勾选态以详情为准,避免保存时静默清空。 + */ +async function fillFromDetail() { + if (!isEdit.value) return + try { + const res: any = await apiAppDetail(Number(props.id)) + if (!SUCCESS_CODES.includes(res?.code)) return + const d: Record = + res?.data && typeof res.data === 'object' ? { ...res, ...res.data } : (res ?? {}) + if (d.app_name) formData.app_name = String(d.app_name) + if (d.rate_limit !== undefined && d.rate_limit !== null) formData.rate_limit = Number(d.rate_limit) + if (d.callback_url !== undefined) formData.callback_url = d.callback_url ?? '' + if (d.callback_functions !== undefined) formData.callback_functions = toArray(d.callback_functions) + if (Array.isArray(d.self_ip_whitelist)) formData.self_ip_whitelist = [...d.self_ip_whitelist] + if (d.is_enabled !== undefined && d.is_enabled !== null) formData.is_enabled = Number(d.is_enabled) + } catch (e: any) { + console.warn('[ApiAppFormDialog] 拉取应用详情失败,改用行数据回填', e) + } +} + async function handleSubmit() { const valid = await formRef.value?.validate().catch(() => false) if (!valid) return @@ -241,6 +351,8 @@ async function handleSubmit() { app_name: formData.app_name, rate_limit: formData.rate_limit, callback_url: formData.callback_url || undefined, + // 空数组 = 不承接任何回调(编辑时用空数组覆盖以清空承接) + callback_functions: formData.callback_functions, self_ip_whitelist: formData.self_ip_whitelist.length > 0 ? formData.self_ip_whitelist : undefined } if (isEdit.value) {