'use strict'; const MainService = require('../main'); /** * 将输入值转换为有限数字。 * * @param {unknown} value 待转换的值。 * @param {number} [defaultValue=0] 默认值。 * @return {number} 转换后的数字。 */ function toNumber(value, defaultValue = 0) { const normalized = Number(value); return Number.isFinite(normalized) ? normalized : defaultValue; } /** * 系统方法层:comboGoods(组合商品接口包装层)。 * 负责参数解构、权限校验出口与统一成功/失败包装。 */ class ComboGoodsMethodService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = ''; const _noNeedLog = ''; const _noNeedAuth = 'list,search'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 组合商品列表查询(分页)。 * * @param {Object} data 请求参数。 * @param {Object} [data.pagination] 分页参数 {page, pageSize}。 * @param {Object} [data.where] 筛选条件 {combo_code, combo_name, status, warehouse_id}。 * @return {Promise} 统一 success 包装的分页列表。 */ async list(data = {}) { const { service } = this; const requestData = this.isPlainObject(data) ? data : {}; const pagination = requestData.pagination || {}; const where = requestData.where || {}; const result = await service.systems.comboGoods.list({ page: toNumber(pagination.page, 1), pageSize: toNumber(pagination.pageSize, 20), combo_code: where.combo_code, combo_name: where.combo_name, status: where.status, warehouse_id: where.warehouse_id, }); return this.success('查询成功', result); } /** * 创建组合商品。 * * @param {Object} data 请求参数。 * @param {string} data.combo_code 组合商品编码。 * @param {string} data.combo_name 组合商品名称。 * @param {number} [data.warehouse_id] 仓库ID。 * @param {string} [data.remark] 备注。 * @param {string} [data.custom_code] 自定义编码。 * @param {Object[]} data.items 子商品明细数组 [{item_goods_sku_id, item_quantity}]。 * @return {Promise} 统一 success 包装的创建结果。 */ async create(data = {}) { const { ctx, service } = this; const requestData = this.isPlainObject(data) ? data : {}; try { const result = await service.systems.comboGoods.create({ combo_code: requestData.combo_code, combo_name: requestData.combo_name, warehouse_id: requestData.warehouse_id, remark: requestData.remark, custom_code: requestData.custom_code, items: requestData.items, creator_id: ctx.user?.id, }); return this.success('创建成功', result); } catch (error) { return this.fail(error.message || '创建失败'); } } /** * 编辑组合商品。 * * @param {Object} data 请求参数。 * @param {number} data.id 组合商品ID(必填)。 * @param {string} [data.combo_name] 组合商品名称。 * @param {number} [data.warehouse_id] 仓库ID。 * @param {string} [data.remark] 备注。 * @param {string} [data.custom_code] 自定义编码。 * @param {number} [data.status] 状态 1-启用 0-停用。 * @param {Object[]} [data.items] 子商品明细数组。 * @return {Promise} 统一 success 包装的编辑结果。 */ async update(data = {}) { const { ctx, service } = this; const requestData = this.isPlainObject(data) ? data : {}; try { const result = await service.systems.comboGoods.update({ id: requestData.id, combo_name: requestData.combo_name, warehouse_id: requestData.warehouse_id, remark: requestData.remark, custom_code: requestData.custom_code, status: requestData.status, items: requestData.items, editor_id: ctx.user?.id, }); return this.success('编辑成功', result); } catch (error) { return this.fail(error.message || '编辑失败'); } } /** * 删除组合商品(软删除)。 * * @param {Object} data 请求参数。 * @param {number} data.id 组合商品ID。 * @return {Promise} 统一 success 包装的删除结果。 */ async delete(data = {}) { const { service } = this; const requestData = this.isPlainObject(data) ? data : {}; try { const result = await service.systems.comboGoods.delete({ id: requestData.id, }); return this.success('删除成功', result); } catch (error) { return this.fail(error.message || '删除失败'); } } /** * 关键字搜索组合商品。 * * @param {Object} data 请求参数。 * @param {string} data.keyword 搜索关键字。 * @param {number} [data.limit=20] 最大返回条数。 * @return {Promise} 统一 success 包装的搜索结果。 */ async search(data = {}) { const { service } = this; const requestData = this.isPlainObject(data) ? data : {}; const result = await service.systems.comboGoods.search({ keyword: requestData.keyword, limit: requestData.limit, }); return this.success('搜索成功', result); } } module.exports = ComboGoodsMethodService;