商品 goods

模块 goods：共 44 个接口 —— 32 个被前端调用（在用），12 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

GoodsChannelController 10/10 在用

POST /goodsChannel/addGoodsChannel 在用管理后台 #

商品渠道-新增 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#addGoodsChannel
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channelgoods_channel_extend

ControllerGoodsChannelController#addGoodsChannel

转换BeanUtils.map → GoodsChannel ⇒ 表 goods_channel

转换BeanUtils.map → GoodsChannelExtend ⇒ 表 goods_channel_extend

ServiceGoodsChannelService#add （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#insert ⇒ 表 goods_channel

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 6

ChaosTransactionTemplate.executeGoodsCache.getSkuCache.getGoodsChannelService.mustGetShopCache.getGoodsChannelExtendService.addList

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/addGoodsChannel
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/addGoodsChannel
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/addGoodsChannel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
goodsChannelName	String	是	必填	`goods_channel`.`goods_channel_name`	商品渠道名称
goodsId	Long	是	必填	`goods_channel`.`goods_id`	关联商品id
skuId	Long	是	必填	`goods_channel`.`sku_id`	关联skuId
channelShopId	Long	是	必填	`goods_channel`.`channel_shop_id`	渠道商铺id
maxSalesPrice	Integer	是	必填	`goods_channel`.`max_sales_price`	最大销售价格
minSalesPrice	Integer	是	必填	`goods_channel`.`min_sales_price`	最小销售价格/分
stock	Integer	是	必填	`goods_channel`.`stock`	初始库存
introduction	String			`goods_channel`.`introduction`	资源说明
remark	String			`goods_channel`.`remark`	备注
goodsChannelExtendList	List<GoodsChannelExtendAddRequest>	是	必填	—	供货价设置列表
goodsChannelExtendList[].goodsChannelId	Long	是	必填	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
goodsChannelExtendList[].minSalesCount	Integer	是	必填	`goods_channel_extend`.`min_sales_count`	最小销量
goodsChannelExtendList[].maxSalesCount	Integer	是	必填	`goods_channel_extend`.`max_sales_count`	最大销量
goodsChannelExtendList[].supplyPrice	Integer	是	必填	`goods_channel_extend`.`supply_price`	供货价格/分

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/addGoodsChannel

{
  "body": {
    "goodsChannelName": "",
    "goodsId": 1,
    "skuId": 1,
    "channelShopId": 1,
    "maxSalesPrice": 0,
    "minSalesPrice": 0,
    "stock": 0,
    "introduction": "",
    "remark": "",
    "goodsChannelExtendList": [
      {
        "goodsChannelId": 1,
        "minSalesCount": 0,
        "maxSalesCount": 0,
        "supplyPrice": 0
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 新增商品渠道

逻辑摘要调用 execute（newTransactionTemplate.execute）；调用 mustGet（goodsChannelService.mustGet）；新增（goodsChannelService.add）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品信息
查询商品sku信息
查询渠道商铺
新增商品渠道
新增商品供货区间
回滚事务
处理异常

前端调用方

dscp-html-manage addGoodsChannel exact

POST /goodsChannel/adjustStock 在用管理后台 #

商品渠道-调整库存 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#adjustStock
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#adjustStock

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

GoodsChannelService.mustGet

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/adjustStock
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/adjustStock
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/adjustStock	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelAdjustStockRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id
adjustNum	Integer	是	必填	—	调整数量

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/adjustStock

{
  "body": {
    "id": 1,
    "adjustNum": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 调整库存

逻辑摘要调用 mustGet（goodsChannelService.mustGet）；更新（goodsChannelService.update）

内联注释

查询商品渠道
更新库存

前端调用方

dscp-html-manage goodsChannelAdjustStock exact

POST /goodsChannel/deleteGoodsChannel 在用管理后台 #

商品渠道-删除 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#deleteGoodsChannel
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#deleteGoodsChannel

ServiceGoodsChannelService#delete （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#deleteById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/deleteGoodsChannel
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/deleteGoodsChannel
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/deleteGoodsChannel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/deleteGoodsChannel

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品渠道

逻辑摘要删除（goodsChannelService.delete）

前端调用方

dscp-html-manage deleteGoodsChannel exact

POST /goodsChannel/getGoodsChannel 在用管理后台 #

商品渠道-详情 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#getGoodsChannel
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#getGoodsChannel

ServiceGoodsChannelService#get （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#selectById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/getGoodsChannel
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/getGoodsChannel
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/getGoodsChannel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsChannelResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`goods_channel`.`id`	id
goodsChannelName	String		`goods_channel`.`goods_channel_name`	商品渠道名称
goodsId	Long		`goods_channel`.`goods_id`	关联商品id
goodsName	String		—	关联商品名称
goodsType	String		—	商品类型
skuId	Long		`goods_channel`.`sku_id`	关联skuId
skuName	String		—	关联sku名称
merchantId	Long		`goods_channel`.`merchant_id`	商品所属商户id
shopId	Long		`goods_channel`.`shop_id`	商铺id(关联shop表id)
shopsName	String		—	商品所属商铺
channelMerchantId	Long		`goods_channel`.`channel_merchant_id`	渠道商户id
channelShopId	Long		`goods_channel`.`channel_shop_id`	渠道商铺id
channelShopsName	String		—	渠道商铺
maxSalesPrice	Integer		`goods_channel`.`max_sales_price`	最大销售价格
minSalesPrice	Integer		`goods_channel`.`min_sales_price`	最小销售价格/分
stock	Integer		`goods_channel`.`stock`	初始库存
introduction	String		`goods_channel`.`introduction`	资源说明
remark	String		`goods_channel`.`remark`	备注
status	GoodsChannelStatus	1已上架2编辑中3已下架	`goods_channel`.`status`	状态(枚举:GoodsChannelStatus)，1已上架，2编辑中，3已下架
goodsChannelExtendList	List<GoodsChannelExtendResponse>		—	供货价设置列表
goodsChannelExtendList[].id	Long		`goods_channel`.`id`	id
goodsChannelExtendList[].goodsChannelId	Long		—	商品渠道id（关联goods_channel表id）
goodsChannelExtendList[].minSalesCount	Integer		—	最小销量
goodsChannelExtendList[].maxSalesCount	Integer		—	最大销量
goodsChannelExtendList[].supplyPrice	Integer		—	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/getGoodsChannel

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsChannelName": "",
    "goodsId": 1,
    "goodsName": "",
    "goodsType": "",
    "skuId": 1,
    "skuName": "",
    "merchantId": 1,
    "shopId": 1,
    "shopsName": "",
    "channelMerchantId": 1,
    "channelShopId": 1,
    "channelShopsName": "",
    "maxSalesPrice": 0,
    "minSalesPrice": 0,
    "stock": 0,
    "introduction": "",
    "remark": "",
    "status": "1",
    "goodsChannelExtendList": [
      {
        "id": 1,
        "goodsChannelId": 1,
        "minSalesCount": 0,
        "maxSalesCount": 0,
        "supplyPrice": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（goodsChannelService.get）

前端调用方

dscp-html-manage getGoodsChannel exact

POST /goodsChannel/goodsChannelOffline 在用管理后台 #

商品渠道-下架 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#goodsChannelOffline
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#goodsChannelOffline

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/goodsChannelOffline
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/goodsChannelOffline
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/goodsChannelOffline	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/goodsChannelOffline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 商品渠道下架

逻辑摘要更新（goodsChannelService.update）

前端调用方

dscp-html-manage goodsChannelOffline exact

POST /goodsChannel/goodsChannelOnline 在用管理后台 #

商品渠道-上架 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#goodsChannelOnline
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#goodsChannelOnline

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/goodsChannelOnline
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/goodsChannelOnline
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/goodsChannelOnline	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/goodsChannelOnline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 商品渠道上架

逻辑摘要更新（goodsChannelService.update）

前端调用方

dscp-html-manage goodsChannelOnline exact

POST /goodsChannel/queryGoodsChannelList 在用管理后台 #

商品渠道-列表查询 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#queryGoodsChannelList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#queryGoodsChannelList

转换BeanUtils.map → GoodsChannelQuery

ServiceGoodsChannelService#queryList （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#selectList ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/queryGoodsChannelList
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/queryGoodsChannelList
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/queryGoodsChannelList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelListRequest

字段	类型	必填	取值/校验	表 / 列	说明
status	GoodsChannelStatus	否	1已上架2编辑中3已下架	`goods_channel`.`status`	状态(枚举:GoodsChannelStatus)，1已上架，2编辑中，3已下架
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsChannelResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`goods_channel`.`id`	id
goodsChannelName	String		`goods_channel`.`goods_channel_name`	商品渠道名称
goodsId	Long		`goods_channel`.`goods_id`	关联商品id
goodsName	String		—	关联商品名称
goodsType	String		—	商品类型
skuId	Long		`goods_channel`.`sku_id`	关联skuId
skuName	String		—	关联sku名称
merchantId	Long		`goods_channel`.`merchant_id`	商品所属商户id
shopId	Long		`goods_channel`.`shop_id`	商铺id(关联shop表id)
shopsName	String		—	商品所属商铺
channelMerchantId	Long		`goods_channel`.`channel_merchant_id`	渠道商户id
channelShopId	Long		`goods_channel`.`channel_shop_id`	渠道商铺id
channelShopsName	String		—	渠道商铺
maxSalesPrice	Integer		`goods_channel`.`max_sales_price`	最大销售价格
minSalesPrice	Integer		`goods_channel`.`min_sales_price`	最小销售价格/分
stock	Integer		`goods_channel`.`stock`	初始库存
introduction	String		`goods_channel`.`introduction`	资源说明
remark	String		`goods_channel`.`remark`	备注
status	GoodsChannelStatus	1已上架2编辑中3已下架	`goods_channel`.`status`	状态(枚举:GoodsChannelStatus)，1已上架，2编辑中，3已下架
goodsChannelExtendList	List<GoodsChannelExtendResponse>		—	供货价设置列表
goodsChannelExtendList[].id	Long		`goods_channel`.`id`	id
goodsChannelExtendList[].goodsChannelId	Long		—	商品渠道id（关联goods_channel表id）
goodsChannelExtendList[].minSalesCount	Integer		—	最小销量
goodsChannelExtendList[].maxSalesCount	Integer		—	最大销量
goodsChannelExtendList[].supplyPrice	Integer		—	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/queryGoodsChannelList

{
  "body": {
    "status": "1",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "goodsChannelName": "",
      "goodsId": 1,
      "goodsName": "",
      "goodsType": "",
      "skuId": 1,
      "skuName": "",
      "merchantId": 1,
      "shopId": 1,
      "shopsName": "",
      "channelMerchantId": 1,
      "channelShopId": 1,
      "channelShopsName": "",
      "maxSalesPrice": 0,
      "minSalesPrice": 0,
      "stock": 0,
      "introduction": "",
      "remark": "",
      "status": "1",
      "goodsChannelExtendList": [
        {
          "id": 1,
          "goodsChannelId": 1,
          "minSalesCount": 0,
          "maxSalesCount": 0,
          "supplyPrice": 0
        }
      ]
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsChannelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsChannelList exact

POST /goodsChannel/queryGoodsChannelPage 在用管理后台 #

商品渠道-分页查询 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#queryGoodsChannelPage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#queryGoodsChannelPage

转换BeanUtils.map → GoodsChannelQuery

ServiceGoodsChannelService#queryPage （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#selectPage ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/queryGoodsChannelPage
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/queryGoodsChannelPage
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/queryGoodsChannelPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
status	GoodsChannelStatus	否	1已上架2编辑中3已下架	`goods_channel`.`status`	状态
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsChannelResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`goods_channel`.`id`	id
goodsChannelName	String		`goods_channel`.`goods_channel_name`	商品渠道名称
goodsId	Long		`goods_channel`.`goods_id`	关联商品id
goodsName	String		—	关联商品名称
goodsType	String		—	商品类型
skuId	Long		`goods_channel`.`sku_id`	关联skuId
skuName	String		—	关联sku名称
merchantId	Long		`goods_channel`.`merchant_id`	商品所属商户id
shopId	Long		`goods_channel`.`shop_id`	商铺id(关联shop表id)
shopsName	String		—	商品所属商铺
channelMerchantId	Long		`goods_channel`.`channel_merchant_id`	渠道商户id
channelShopId	Long		`goods_channel`.`channel_shop_id`	渠道商铺id
channelShopsName	String		—	渠道商铺
maxSalesPrice	Integer		`goods_channel`.`max_sales_price`	最大销售价格
minSalesPrice	Integer		`goods_channel`.`min_sales_price`	最小销售价格/分
stock	Integer		`goods_channel`.`stock`	初始库存
introduction	String		`goods_channel`.`introduction`	资源说明
remark	String		`goods_channel`.`remark`	备注
status	GoodsChannelStatus	1已上架2编辑中3已下架	`goods_channel`.`status`	状态(枚举:GoodsChannelStatus)，1已上架，2编辑中，3已下架
goodsChannelExtendList	List<GoodsChannelExtendResponse>		—	供货价设置列表
goodsChannelExtendList[].id	Long		`goods_channel`.`id`	id
goodsChannelExtendList[].goodsChannelId	Long		—	商品渠道id（关联goods_channel表id）
goodsChannelExtendList[].minSalesCount	Integer		—	最小销量
goodsChannelExtendList[].maxSalesCount	Integer		—	最大销量
goodsChannelExtendList[].supplyPrice	Integer		—	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/queryGoodsChannelPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "status": "1",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "goodsChannelName": "",
        "goodsId": 1,
        "goodsName": "",
        "goodsType": "",
        "skuId": 1,
        "skuName": "",
        "merchantId": 1,
        "shopId": 1,
        "shopsName": "",
        "channelMerchantId": 1,
        "channelShopId": 1,
        "channelShopsName": "",
        "maxSalesPrice": 0,
        "minSalesPrice": 0,
        "stock": 0,
        "introduction": "",
        "remark": "",
        "status": "1",
        "goodsChannelExtendList": [
          {
            "id": 1,
            "goodsChannelId": 1,
            "minSalesCount": 0,
            "maxSalesCount": 0,
            "supplyPrice": 0
          }
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsChannelService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsChannelPage exact

POST /goodsChannel/querySaleShopGoodsChannelList 在用管理后台 #

商品渠道-销售商铺渠道列表查询 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#querySaleShopGoodsChannelList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel

ControllerGoodsChannelController#querySaleShopGoodsChannelList

ServiceGoodsChannelService#queryList （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#selectList ⇒ 表 goods_channel

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SessionUserService.getSessionUser

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/querySaleShopGoodsChannelList
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/querySaleShopGoodsChannelList
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/querySaleShopGoodsChannelList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<SaleShopGoodsChannelResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`goods_channel`.`id`	id
goodsChannelName	String	`goods_channel`.`goods_channel_name`	商品渠道名称

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/querySaleShopGoodsChannelList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "goodsChannelName": ""
    }
  ]
}

处理逻辑

逻辑摘要查询详情（sessionService.getSessionUser）；列表查询（goodsChannelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

获取当前登录用户

前端调用方

dscp-html-manage querySaleShopGoodsChannelList exact

POST /goodsChannel/updateGoodsChannel 在用管理后台 #

商品渠道-更新 · GoodsChannelController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelController#updateGoodsChannel
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channelgoods_channel_extend

ControllerGoodsChannelController#updateGoodsChannel

转换BeanUtils.map → GoodsChannel ⇒ 表 goods_channel

转换BeanUtils.map → GoodsChannelExtend ⇒ 表 goods_channel_extend

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

ServiceGoodsChannelExtendService#queryList （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#selectList ⇒ 表 goods_channel_extend

ServiceGoodsChannelExtendService#delete （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#deleteById ⇒ 表 goods_channel_extend

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

ChaosTransactionTemplate.executeGoodsCache.getShopCache.getGoodsChannelExtendService.addListGoodsChannelExtendService.updateList

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannel/updateGoodsChannel
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannel/updateGoodsChannel
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannel/updateGoodsChannel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel`.`id`	id
goodsChannelName	String	是	必填	`goods_channel`.`goods_channel_name`	商品渠道名称
goodsId	Long	是	必填	`goods_channel`.`goods_id`	关联商品id
skuId	Long	是	必填	`goods_channel`.`sku_id`	关联skuId
merchantId	Long	是	必填	`goods_channel`.`merchant_id`	商品所属商户id
shopId	Long	是	必填	`goods_channel`.`shop_id`	商铺id(关联shop表id)
channelMerchantId	Long	是	必填	`goods_channel`.`channel_merchant_id`	渠道商户id
channelShopId	Long	是	必填	`goods_channel`.`channel_shop_id`	渠道商铺id
maxSalesPrice	Integer	是	必填	`goods_channel`.`max_sales_price`	最大销售价格
minSalesPrice	Integer	是	必填	`goods_channel`.`min_sales_price`	最小销售价格/分
stock	Integer	是	必填	`goods_channel`.`stock`	初始库存
introduction	String			`goods_channel`.`introduction`	资源说明
remark	String			`goods_channel`.`remark`	备注
goodsChannelExtendList	List<GoodsChannelExtendUpdateRequest>	是	必填	—	供货价设置列表
goodsChannelExtendList[].id	Long			`goods_channel`.`id`	id
goodsChannelExtendList[].goodsChannelId	Long	是	必填	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
goodsChannelExtendList[].minSalesCount	Integer	是	必填	`goods_channel_extend`.`min_sales_count`	最小销量
goodsChannelExtendList[].maxSalesCount	Integer	是	必填	`goods_channel_extend`.`max_sales_count`	最大销量
goodsChannelExtendList[].supplyPrice	Integer	是	必填	`goods_channel_extend`.`supply_price`	供货价格/分

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannel/updateGoodsChannel

{
  "body": {
    "id": 1,
    "goodsChannelName": "",
    "goodsId": 1,
    "skuId": 1,
    "merchantId": 1,
    "shopId": 1,
    "channelMerchantId": 1,
    "channelShopId": 1,
    "maxSalesPrice": 0,
    "minSalesPrice": 0,
    "stock": 0,
    "introduction": "",
    "remark": "",
    "goodsChannelExtendList": [
      {
        "id": 1,
        "goodsChannelId": 1,
        "minSalesCount": 0,
        "maxSalesCount": 0,
        "supplyPrice": 0
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 更新商品渠道

逻辑摘要调用 execute（newTransactionTemplate.execute）；更新（goodsChannelService.update）；调用 isNotEmpty（CollectionUtils.isNotEmpty）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品信息
查询渠道商铺
更新商品渠道
更新商品供货区间
查询现有数据
处理删除数据
处理新增数据
处理更新数据

前端调用方

dscp-html-manage updateGoodsChannel exact

GoodsChannelExtendController 6/6 在用

POST /goodsChannelExtend/addGoodsChannelExtend 在用管理后台 #

商品渠道扩展表-新增 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#addGoodsChannelExtend
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#addGoodsChannelExtend

转换BeanUtils.map → GoodsChannelExtend ⇒ 表 goods_channel_extend

ServiceGoodsChannelExtendService#add （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#insert ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/addGoodsChannelExtend
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/addGoodsChannelExtend
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/addGoodsChannelExtend	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelExtendAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
goodsChannelId	Long	是	必填	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	是	必填	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	是	必填	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	是	必填	`goods_channel_extend`.`supply_price`	供货价格/分

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsChannelExtendResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_channel_extend`.`id`	id
goodsChannelId	Long	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	`goods_channel_extend`.`supply_price`	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/addGoodsChannelExtend

{
  "body": {
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0
  }
}

处理逻辑

操作日志goods / 新增商品渠道扩展

逻辑摘要新增（goodsChannelExtendService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage addGoodsChannelExtend exact

POST /goodsChannelExtend/deleteGoodsChannelExtend 在用管理后台 #

商品渠道扩展表-删除 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#deleteGoodsChannelExtend
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#deleteGoodsChannelExtend

ServiceGoodsChannelExtendService#delete （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#deleteById ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/deleteGoodsChannelExtend
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/deleteGoodsChannelExtend
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/deleteGoodsChannelExtend	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel_extend`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/deleteGoodsChannelExtend

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品渠道扩展

逻辑摘要删除（goodsChannelExtendService.delete）

前端调用方

dscp-html-manage deleteGoodsChannelExtend exact

POST /goodsChannelExtend/getGoodsChannelExtend 在用管理后台 #

商品渠道扩展表-详情 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#getGoodsChannelExtend
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#getGoodsChannelExtend

ServiceGoodsChannelExtendService#get （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#selectById ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/getGoodsChannelExtend
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/getGoodsChannelExtend
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/getGoodsChannelExtend	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_channel_extend`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsChannelExtendResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_channel_extend`.`id`	id
goodsChannelId	Long	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	`goods_channel_extend`.`supply_price`	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/getGoodsChannelExtend

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0
  }
}

处理逻辑

逻辑摘要查询详情（goodsChannelExtendService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getGoodsChannelExtend exact

POST /goodsChannelExtend/queryGoodsChannelExtendList 在用管理后台 #

商品渠道扩展表-列表查询 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#queryGoodsChannelExtendList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#queryGoodsChannelExtendList

转换BeanUtils.map → GoodsChannelExtendQuery

ServiceGoodsChannelExtendService#queryList （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#selectList ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendList
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendList
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelExtendListRequest

字段	类型	必填	取值/校验	表 / 列	说明
goodsChannelId	Long	否	可选(@MvcOptional)	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`supply_price`	供货价格/分
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsChannelExtendResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`goods_channel_extend`.`id`	id
goodsChannelId	Long	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	`goods_channel_extend`.`supply_price`	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/queryGoodsChannelExtendList

{
  "body": {
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0,
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "goodsChannelId": 1,
      "minSalesCount": 0,
      "maxSalesCount": 0,
      "supplyPrice": 0
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsChannelExtendService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsChannelExtendList exact

POST /goodsChannelExtend/queryGoodsChannelExtendPage 在用管理后台 #

商品渠道扩展表-分页查询 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#queryGoodsChannelExtendPage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#queryGoodsChannelExtendPage

转换BeanUtils.map → GoodsChannelExtendQuery

ServiceGoodsChannelExtendService#queryPage （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#selectPage ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendPage
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendPage
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/queryGoodsChannelExtendPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelExtendPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
goodsChannelId	Long	否	可选(@MvcOptional)	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	否	可选(@MvcOptional)	`goods_channel_extend`.`supply_price`	供货价格/分
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsChannelExtendResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`goods_channel_extend`.`id`	id
goodsChannelId	Long	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	`goods_channel_extend`.`supply_price`	供货价格/分

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/queryGoodsChannelExtendPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0,
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "goodsChannelId": 1,
        "minSalesCount": 0,
        "maxSalesCount": 0,
        "supplyPrice": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsChannelExtendService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsChannelExtendPage exact

POST /goodsChannelExtend/updateGoodsChannelExtend 在用管理后台 #

商品渠道扩展表-更新 · GoodsChannelExtendController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsChannelExtendController#updateGoodsChannelExtend
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_channel_extend

ControllerGoodsChannelExtendController#updateGoodsChannelExtend

转换BeanUtils.map → GoodsChannelExtend ⇒ 表 goods_channel_extend

ServiceGoodsChannelExtendService#update （GoodsChannelExtendServiceImpl）

MapperGoodsChannelExtendMapper#updateById ⇒ 表 goods_channel_extend

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsChannelExtend/updateGoodsChannelExtend
uat	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/updateGoodsChannelExtend
pro	https://dscp-uat.hn12301.net/manage-api/goodsChannelExtend/updateGoodsChannelExtend	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsChannelExtendUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`goods_channel_extend`.`id`	id
goodsChannelId	Long	是	必填	`goods_channel_extend`.`goods_channel_id`	商品渠道id（关联goods_channel表id）
minSalesCount	Integer	是	必填	`goods_channel_extend`.`min_sales_count`	最小销量
maxSalesCount	Integer	是	必填	`goods_channel_extend`.`max_sales_count`	最大销量
supplyPrice	Integer	是	必填	`goods_channel_extend`.`supply_price`	供货价格/分

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsChannelExtend/updateGoodsChannelExtend

{
  "body": {
    "id": 1,
    "goodsChannelId": 1,
    "minSalesCount": 0,
    "maxSalesCount": 0,
    "supplyPrice": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 更新商品渠道扩展

逻辑摘要更新（goodsChannelExtendService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateGoodsChannelExtend exact

GoodsController 10/10 在用

POST /goods/addGoods 在用管理后台 #

商品-新增 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#addGoods
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsgoods_info

ControllerGoodsController#addGoods

转换BeanUtils.map → Goods ⇒ 表 goods

转换BeanUtils.map → GoodsInfo ⇒ 表 goods_info

ServiceGoodsService#add （GoodsServiceImpl）

MapperGoodsMapper#insert ⇒ 表 goods

ServiceGoodsInfoService#add （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#insert ⇒ 表 goods_info

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ChaosTransactionTemplate.execute

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/addGoods
uat	https://dscp-uat.hn12301.net/manage-api/goods/addGoods
pro	https://dscp-uat.hn12301.net/manage-api/goods/addGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long			`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`goods`.`shop_id`	所属商铺id，关联shop表id
name	String	是	必填	`goods`.`name`	商品名称
mainPic	String			`goods`.`main_pic`	商品主图
typeId	String	是	必填	`goods`.`type_id`	商品大类id
subTypeId	String			`goods`.`sub_type_id`	商品小类id
cardModelId	Long			`goods`.`card_model_id`	卡种id
grade	String			`goods`.`grade`	商品等级
shortName	String			`goods_info`.`short_name`	商品简称
thirdId	String			`goods`.`third_id`	第三方id
thirdName	String			`goods`.`third_name`	第三方名称
weight	Integer			`goods_info`.`weight`	商品权重
tags	String			`goods_info`.`tags`	商品标签
recommendReason	String			`goods_info`.`recommend_reason`
introduction	String			`goods_info`.`introduction`	简介
propagatePic	String			`goods_info`.`propagate_pic`	宣传图片url地址
video	String			`goods_info`.`video`	宣传视频url地址
notice	String			`goods_info`.`notice`	购买须知
tips	String			`goods_info`.`tips`	温馨提示
businessTime	String			`goods_info`.`business_time`	营业时间
expireDate	Date			`goods_info`.`expire_date`
isRefund	Boolean			`goods_info`.`is_refund`
skuList	List<SkuAddRequest>	是	必填	—	sku列表
skuList[].goodsId	Long	是	必填	—	商品ID，关联商品表id
skuList[].goodsChannelId	Long			—	关联商品渠道id
skuList[].skuName	String	是	必填	—	sku名称
skuList[].showPrice	Integer			—	商品挂牌价
skuList[].buyPrice	Integer			—	商品实际售价
skuList[].costPrice	Integer			—	商品成本价
skuList[].buyCount	Integer			—	单次可购买数量
skuList[].stock	Integer			—	库存数量
skuList[].isLogistic	Boolean			—	是否需要物流
skuList[].carriageId	Long			—	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold		1实物商品2虚拟商品3电子卡券	—	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean			—	是否可分销
skuList[].commission	Integer			—	分销佣金
skuList[].isPreferential	Boolean			—	是否可使用优惠券
skuList[].isUseScore	Boolean			—	是否可使用积分抵扣
skuList[].isAddScore	Boolean			—	购买后是否产生积分
skuList[].useScoreRate	BigDecimal			—	抵扣积分倍率
skuList[].addScoreRate	BigDecimal			—	产生积分倍率
skuList[].skuEntranceList	List<SkuEntrance>			—	景区入口
skuEntranceList[].id	Long			`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long			—	所属关联sku表id
skuEntranceList[].entranceName	String			—	景区入口名称
skuEntranceList[].merchantId	Long			`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long			`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long			—	商品ID，关联商品表id
skuEntranceList[].createdBy	String			`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date			`goods`.`created_time`	创建时间
skuList[].cardNum	Integer	否	可选(@MvcOptional)	—	发卡数量，仅旅游卡商品
relationList	List<GoodsRelationAddRequest>			—
relationList[].thirdName	String			`goods`.`third_name`	名称
relationList[].thirdId	String			`goods`.`third_id`
relationList[].channelType	ChannelType		1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goods/addGoods

{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "cardModelId": 1,
    "grade": "",
    "shortName": "",
    "thirdId": "",
    "thirdName": "",
    "weight": 0,
    "tags": "",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "businessTime": "2026-01-01 12:00:00",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false,
    "skuList": [
      {
        "goodsId": 1,
        "goodsChannelId": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "skuEntranceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ],
        "cardNum": 0
      }
    ],
    "relationList": [
      {
        "thirdName": "",
        "thirdId": "",
        "channelType": "1"
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 新增商品

逻辑摘要调用 execute（newTransactionTemplate.execute）；新增（goodsService.add）；新增（goodsInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

新增商品
新增商品信息
新增商品sku
新增关联
回滚事务
处理异常

前端调用方

dscp-html-manage addGoods exact

POST /goods/deleteGoods 在用管理后台 #

商品-删除 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#deleteGoods
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods

ControllerGoodsController#deleteGoods

ServiceGoodsService#delete （GoodsServiceImpl）

MapperGoodsMapper#deleteById ⇒ 表 goods

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/deleteGoods
uat	https://dscp-uat.hn12301.net/manage-api/goods/deleteGoods
pro	https://dscp-uat.hn12301.net/manage-api/goods/deleteGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goods/deleteGoods

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品

逻辑摘要删除（goodsService.delete）

前端调用方

dscp-html-manage deleteGoods exact

POST /goods/getGoods 在用管理后台 #

商品-详情 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#getGoods
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsskusku_entrancegoods_relation

ControllerGoodsController#getGoods

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceSkuEntranceService#queryList （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#selectList ⇒ 表 sku_entrance

ServiceGoodsRelationService#queryList （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectList ⇒ 表 goods_relation

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

GoodsInfoService.mustGet

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/getGoods
uat	https://dscp-uat.hn12301.net/manage-api/goods/getGoods
pro	https://dscp-uat.hn12301.net/manage-api/goods/getGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id，关联shop表id
name	String		`goods`.`name`	商品名称
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类id
cardModelId	Long		`goods`.`card_model_id`	卡种id
subTypeId	String		`goods`.`sub_type_id`	商品小类id
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
shopsName	String		—	商铺名称
shortName	String		—	商品简称
weight	Integer		—	商品权重
tags	String		—	商品标签
buyPrice	Integer		`sku`.`buy_price`	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		—	简介
propagatePic	String		—	宣传图片url地址
video	String		—	宣传视频url地址
notice	String		—	购买须知
tips	String		—	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		`goods`.`id`	商品SKUID，主键
skuList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long		`sku_entrance`.`sku_id`	所属关联sku表id
skuEntranceList[].entranceName	String		`sku_entrance`.`entrance_name`	景区入口名称
skuEntranceList[].merchantId	Long		`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long		`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuEntranceList[].createdBy	String		`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		`goods`.`id`	id
relationList[].goodsId	Long		`sku`.`goods_id`	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		`goods`.`third_id`	第三方id
relationList[].thirdName	String		`goods`.`third_name`	第三方名称
relationList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList[].updatedTime	Date		`goods`.`updated_time`	修改时间
businessTime	String		—	营业时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		—	简介
shop.businessTime	String		—	营业时间
shop.tags	String		—	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		—	宣传图片url地址
shop.video	String		—	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		—	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`

示例

请求示例（自动生成，仅结构参考）

POST /goods/getGoods

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "cardModelId": 1,
    "subTypeId": "",
    "grade": "",
    "status": "1",
    "qrcode": "",
    "shopsName": "",
    "shortName": "",
    "weight": 0,
    "tags": "",
    "buyPrice": 0,
    "salesAmount": 0,
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "skuList": [
      {
        "id": 1,
        "goodsId": 1,
        "goodsChannelId": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "cardNum": 0,
        "skuEntranceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "relationList": [
      {
        "id": 1,
        "goodsId": 1,
        "channelType": "1",
        "thirdId": "",
        "thirdName": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "businessTime": "2026-01-01 12:00:00",
    "thirdId": "",
    "thirdName": "",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false,
    "areaInfo": "",
    "shop": {
      "id": 1,
      "merchantId": 1,
      "merchantType": "1",
      "name": "",
      "logo": "",
      "typeId": 1,
      "subTypeId": 1,
      "status": "1",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "mobile": "13800000000",
      "linkman": "",
      "linkphone": "13800000000",
      "manager": "",
      "level": "",
      "lng": "",
      "lat": "",
      "introduction": "",
      "businessTime": "2026-01-01 12:00:00",
      "tags": "",
      "mainPic": "https://example.com/x.png",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "poster": "",
      "propagateContent": "",
      "description": "",
      "ticketInfo": "",
      "trafficInfo": "",
      "tips": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    }
  }
}

处理逻辑

逻辑摘要查询详情（goodsService.get）；调用 mustGet（goodsInfoService.mustGet）；调用 copyProperties（BeanUtil.copyProperties）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品信息
查询sku
查询relation

前端调用方

dscp-html-manage getGoods exact

POST /goods/getGoodsList 在用管理后台 #

（无摘要） · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#getGoodsList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

调用链路（控制器方法内未解析到 Service/Mapper 调用，可能为接口声明或简单转发）

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/getGoodsList
uat	https://dscp-uat.hn12301.net/manage-api/goods/getGoodsList
pro	https://dscp-uat.hn12301.net/manage-api/goods/getGoodsList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　List<IdRequest>

请求体类型：List<IdRequest>（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		—	商品id，主键
merchantId	Long		—	所属商户id，关联merchant表id
shopId	Long		—	所属商铺id，关联shop表id
name	String		—	商品名称
mainPic	String		—	商品主图
typeId	String		—	商品大类id
cardModelId	Long		—	卡种id
subTypeId	String		—	商品小类id
grade	String		—	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	—	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		—	商品二维码
shopsName	String		—	商铺名称
shortName	String		—	商品简称
weight	Integer		—	商品权重
tags	String		—	商品标签
buyPrice	Integer		—	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		—	简介
propagatePic	String		—	宣传图片url地址
video	String		—	宣传视频url地址
notice	String		—	购买须知
tips	String		—	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		—	商品SKUID，主键
skuList[].goodsId	Long		—	商品ID，关联商品表id
skuList[].goodsChannelId	Long		—	关联商品渠道id
skuList[].skuName	String		—	sku名称
skuList[].showPrice	Integer		—	商品挂牌价
skuList[].buyPrice	Integer		—	商品实际售价
skuList[].costPrice	Integer		—	商品成本价
skuList[].buyCount	Integer		—	单次可购买数量
skuList[].stock	Integer		—	库存数量
skuList[].isLogistic	Boolean		—	是否需要物流
skuList[].carriageId	Long		—	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	—	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		—	是否可分销
skuList[].commission	Integer		—	分销佣金
skuList[].isPreferential	Boolean		—	是否可使用优惠券
skuList[].isUseScore	Boolean		—	是否可使用积分抵扣
skuList[].isAddScore	Boolean		—	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		—	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		—	产生积分倍率
skuList[].cardNum	Integer		—	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		—	ID，主键
skuEntranceList[].skuId	Long		—	所属关联sku表id
skuEntranceList[].entranceName	String		—	景区入口名称
skuEntranceList[].merchantId	Long		—	所属商户id
skuEntranceList[].shopId	Long		—	所属商铺id
skuEntranceList[].goodsId	Long		—	商品ID，关联商品表id
skuEntranceList[].createdBy	String		—	创建人id
skuEntranceList[].createdTime	Date		—	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		—	id
relationList[].goodsId	Long		—	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		—	第三方id
relationList[].thirdName	String		—	第三方名称
relationList[].createdTime	Date		—	创建时间
relationList[].updatedTime	Date		—	修改时间
businessTime	String		—	营业时间
thirdId	String		—	第三方id
thirdName	String		—	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		—	商铺id，主键
shop.merchantId	Long		—	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		—	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		—	商铺大类
shop.subTypeId	Long		—	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	—	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		—	简介
shop.businessTime	String		—	营业时间
shop.tags	String		—	商铺标签
shop.mainPic	String		—	景区主图url地址
shop.propagatePic	String		—	宣传图片url地址
shop.video	String		—	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		—	温馨提示
shop.isDeleted	Boolean		—	是否删除
shop.createdBy	String		—	创建人id
shop.createdTime	Date		—	创建时间
shop.updatedBy	String		—	更新人id
shop.updatedTime	Date		—	修改时间
shop.thirdId	String		—
shop.thirdName	String		—

示例

请求示例（自动生成，仅结构参考）

POST /goods/getGoodsList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "cardModelId": 1,
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "shopsName": "",
      "shortName": "",
      "weight": 0,
      "tags": "",
      "buyPrice": 0,
      "salesAmount": 0,
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "skuList": [
        {
          "id": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "skuEntranceList": [
            {
              "id": 1,
              "skuId": 1,
              "entranceName": "",
              "merchantId": 1,
              "shopId": 1,
              "goodsId": 1,
              "createdBy": "",
              "createdTime": "2026-01-01 12:00:00"
            }
          ]
        }
      ],
      "relationList": [
        {
          "id": 1,
          "goodsId": 1,
          "channelType": "1",
          "thirdId": "",
          "thirdName": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "businessTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false,
      "areaInfo": "",
      "shop": {
        "id": 1,
        "merchantId": 1,
        "merchantType": "1",
        "name": "",
        "logo": "",
        "typeId": 1,
        "subTypeId": 1,
        "status": "1",
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "mobile": "13800000000",
        "linkman": "",
        "linkphone": "13800000000",
        "manager": "",
        "level": "",
        "lng": "",
        "lat": "",
        "introduction": "",
        "businessTime": "2026-01-01 12:00:00",
        "tags": "",
        "mainPic": "https://example.com/x.png",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "poster": "",
        "propagateContent": "",
        "description": "",
        "ticketInfo": "",
        "trafficInfo": "",
        "tips": "",
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      }
    }
  ]
}

处理逻辑

逻辑摘要见下方调用链

前端调用方

dscp-html-manage getGoodsList exact

POST /goods/goodsOffline 在用管理后台 #

商品-下架 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#goodsOffline
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsgoods_channel

ControllerGoodsController#goodsOffline

ServiceGoodsService#update （GoodsServiceImpl）

MapperGoodsMapper#updateById ⇒ 表 goods

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/goodsOffline
uat	https://dscp-uat.hn12301.net/manage-api/goods/goodsOffline
pro	https://dscp-uat.hn12301.net/manage-api/goods/goodsOffline	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goods/goodsOffline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 商品下架

逻辑摘要更新（goodsService.update）；更新（goodsChannelService.update）

前端调用方

dscp-html-manage goodsOffline exact

POST /goods/goodsOnline 在用管理后台 #

商品-上架 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#goodsOnline
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsgoods_channel

ControllerGoodsController#goodsOnline

ServiceGoodsService#update （GoodsServiceImpl）

MapperGoodsMapper#updateById ⇒ 表 goods

ServiceGoodsChannelService#update （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#updateById ⇒ 表 goods_channel

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/goodsOnline
uat	https://dscp-uat.hn12301.net/manage-api/goods/goodsOnline
pro	https://dscp-uat.hn12301.net/manage-api/goods/goodsOnline	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goods/goodsOnline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 商品上架

逻辑摘要更新（goodsService.update）；更新（goodsChannelService.update）

前端调用方

dscp-html-manage goodsOnline exact

POST /goods/goodsTree 在用管理后台 #

商品-商品树查询 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#goodsTree
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodssku

ControllerGoodsController#goodsTree

ServiceGoodsService#queryList （GoodsServiceImpl）

MapperGoodsMapper#selectList ⇒ 表 goods

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SessionUserService.getSessionUser

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/goodsTree
uat	https://dscp-uat.hn12301.net/manage-api/goods/goodsTree
pro	https://dscp-uat.hn12301.net/manage-api/goods/goodsTree	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　KeywordsRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String			—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<CascadeOption>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
value	Object	—	值
label	String	—	显示名称
children	List<CascadeOption>	—	子列表
children[].…	（循环引用，已折叠）	—

示例

请求示例（自动生成，仅结构参考）

POST /goods/goodsTree

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "value": "",
      "label": "",
      "children": [
        {}
      ]
    }
  ]
}

处理逻辑

逻辑摘要查询详情（sessionService.getSessionUser）；列表查询（goodsService.queryList）；列表查询（skuService.queryList）

前端调用方

dscp-html-manage queryGoodsTree exact

POST /goods/queryGoodsList 在用管理后台 #

商品-列表查询 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#queryGoodsList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods

ControllerGoodsController#queryGoodsList

转换BeanUtils.map → GoodsQuery

ServiceGoodsService#queryList （GoodsServiceImpl）

MapperGoodsMapper#selectList ⇒ 表 goods

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/queryGoodsList
uat	https://dscp-uat.hn12301.net/manage-api/goods/queryGoodsList
pro	https://dscp-uat.hn12301.net/manage-api/goods/queryGoodsList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsListRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long			`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`goods`.`shop_id`	所属商铺id，关联shop表id
name	String	否	可选(@MvcOptional)	`goods`.`name`	商品名称
mainPic	String	否	可选(@MvcOptional)	`goods`.`main_pic`	商品主图
typeId	String	否	可选(@MvcOptional)	`goods`.`type_id`	商品大类id
subTypeId	String	否	可选(@MvcOptional)	`goods`.`sub_type_id`	商品小类id
grade	String	否	可选(@MvcOptional)	`goods`.`grade`	商品等级
status	GoodsStatus	否	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String	否	可选(@MvcOptional)	`goods`.`qrcode`	商品二维码
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id，关联shop表id
name	String		`goods`.`name`	商品名称
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类id
cardModelId	Long		`goods`.`card_model_id`	卡种id
subTypeId	String		`goods`.`sub_type_id`	商品小类id
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
shopsName	String		—	商铺名称
shortName	String		—	商品简称
weight	Integer		—	商品权重
tags	String		—	商品标签
buyPrice	Integer		—	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		—	简介
propagatePic	String		—	宣传图片url地址
video	String		—	宣传视频url地址
notice	String		—	购买须知
tips	String		—	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		`goods`.`id`	商品SKUID，主键
skuList[].goodsId	Long		—	商品ID，关联商品表id
skuList[].goodsChannelId	Long		—	关联商品渠道id
skuList[].skuName	String		—	sku名称
skuList[].showPrice	Integer		—	商品挂牌价
skuList[].buyPrice	Integer		—	商品实际售价
skuList[].costPrice	Integer		—	商品成本价
skuList[].buyCount	Integer		—	单次可购买数量
skuList[].stock	Integer		—	库存数量
skuList[].isLogistic	Boolean		—	是否需要物流
skuList[].carriageId	Long		—	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	—	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		—	是否可分销
skuList[].commission	Integer		—	分销佣金
skuList[].isPreferential	Boolean		—	是否可使用优惠券
skuList[].isUseScore	Boolean		—	是否可使用积分抵扣
skuList[].isAddScore	Boolean		—	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		—	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		—	产生积分倍率
skuList[].cardNum	Integer		—	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long		—	所属关联sku表id
skuEntranceList[].entranceName	String		—	景区入口名称
skuEntranceList[].merchantId	Long		`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long		`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long		—	商品ID，关联商品表id
skuEntranceList[].createdBy	String		`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		`goods`.`id`	id
relationList[].goodsId	Long		—	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		`goods`.`third_id`	第三方id
relationList[].thirdName	String		`goods`.`third_name`	第三方名称
relationList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList[].updatedTime	Date		`goods`.`updated_time`	修改时间
businessTime	String		—	营业时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		—	简介
shop.businessTime	String		—	营业时间
shop.tags	String		—	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		—	宣传图片url地址
shop.video	String		—	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		—	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`

示例

请求示例（自动生成，仅结构参考）

POST /goods/queryGoodsList

{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "grade": "",
    "status": "1",
    "qrcode": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "cardModelId": 1,
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "shopsName": "",
      "shortName": "",
      "weight": 0,
      "tags": "",
      "buyPrice": 0,
      "salesAmount": 0,
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "skuList": [
        {
          "id": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "skuEntranceList": [
            {
              "id": 1,
              "skuId": 1,
              "entranceName": "",
              "merchantId": 1,
              "shopId": 1,
              "goodsId": 1,
              "createdBy": "",
              "createdTime": "2026-01-01 12:00:00"
            }
          ]
        }
      ],
      "relationList": [
        {
          "id": 1,
          "goodsId": 1,
          "channelType": "1",
          "thirdId": "",
          "thirdName": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "businessTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false,
      "areaInfo": "",
      "shop": {
        "id": 1,
        "merchantId": 1,
        "merchantType": "1",
        "name": "",
        "logo": "",
        "typeId": 1,
        "subTypeId": 1,
        "status": "1",
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "mobile": "13800000000",
        "linkman": "",
        "linkphone": "13800000000",
        "manager": "",
        "level": "",
        "lng": "",
        "lat": "",
        "introduction": "",
        "businessTime": "2026-01-01 12:00:00",
        "tags": "",
        "mainPic": "https://example.com/x.png",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "poster": "",
        "propagateContent": "",
        "description": "",
        "ticketInfo": "",
        "trafficInfo": "",
        "tips": "",
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      }
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsList exact

POST /goods/queryGoodsPage 在用管理后台 #

商品-分页查询 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#queryGoodsPage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsskuorder_goods

ControllerGoodsController#queryGoodsPage

转换BeanUtils.map → GoodsQuery

ServiceGoodsService#queryPage （GoodsServiceImpl）

MapperGoodsMapper#selectPage ⇒ 表 goods

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceOrderGoodsService#queryList （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#selectList ⇒ 表 order_goods

ServiceOrderGoodsService#querySaledGoods （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#querySaledGoods ⇒ 表 order_goods

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/queryGoodsPage
uat	https://dscp-uat.hn12301.net/manage-api/goods/queryGoodsPage
pro	https://dscp-uat.hn12301.net/manage-api/goods/queryGoodsPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`goods`.`shop_id`	所属商铺id，关联shop表id
name	String	否	可选(@MvcOptional)	`goods`.`name`	商品名称
mainPic	String	否	可选(@MvcOptional)	`goods`.`main_pic`	商品主图
typeId	String	否	可选(@MvcOptional)	`goods`.`type_id`	商品大类id
subTypeId	String	否	可选(@MvcOptional)	`goods`.`sub_type_id`	商品小类id
grade	String	否	可选(@MvcOptional)	`goods`.`grade`	商品等级
status	GoodsStatus	否	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String	否	可选(@MvcOptional)	`goods`.`qrcode`	商品二维码
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id，关联shop表id
name	String		`goods`.`name`	商品名称
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类id
cardModelId	Long		`goods`.`card_model_id`	卡种id
subTypeId	String		`goods`.`sub_type_id`	商品小类id
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
shopsName	String		—	商铺名称
shortName	String		—	商品简称
weight	Integer		—	商品权重
tags	String		—	商品标签
buyPrice	Integer		`sku`.`buy_price`	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		—	简介
propagatePic	String		—	宣传图片url地址
video	String		—	宣传视频url地址
notice	String		—	购买须知
tips	String		—	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		`goods`.`id`	商品SKUID，主键
skuList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long		—	所属关联sku表id
skuEntranceList[].entranceName	String		—	景区入口名称
skuEntranceList[].merchantId	Long		`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long		`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuEntranceList[].createdBy	String		`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		`goods`.`id`	id
relationList[].goodsId	Long		`sku`.`goods_id`	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		`goods`.`third_id`	第三方id
relationList[].thirdName	String		`goods`.`third_name`	第三方名称
relationList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList[].updatedTime	Date		`goods`.`updated_time`	修改时间
businessTime	String		—	营业时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		—	简介
shop.businessTime	String		—	营业时间
shop.tags	String		—	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		—	宣传图片url地址
shop.video	String		—	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		—	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`

示例

请求示例（自动生成，仅结构参考）

POST /goods/queryGoodsPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "grade": "",
    "status": "1",
    "qrcode": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "cardModelId": 1,
        "subTypeId": "",
        "grade": "",
        "status": "1",
        "qrcode": "",
        "shopsName": "",
        "shortName": "",
        "weight": 0,
        "tags": "",
        "buyPrice": 0,
        "salesAmount": 0,
        "recommendReason": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "notice": "",
        "tips": "",
        "skuList": [
          {
            "id": 1,
            "goodsId": 1,
            "goodsChannelId": 1,
            "skuName": "",
            "showPrice": 0,
            "buyPrice": 0,
            "costPrice": 0,
            "buyCount": 0,
            "stock": 0,
            "isLogistic": false,
            "carriageId": 1,
            "mold": "1",
            "isDistributes": false,
            "commission": 0,
            "isPreferential": false,
            "isUseScore": false,
            "isAddScore": false,
            "useScoreRate": 0,
            "addScoreRate": 0,
            "cardNum": 0,
            "skuEntranceList": [
              {
                "id": 1,
                "skuId": 1,
                "entranceName": "",
                "merchantId": 1,
                "shopId": 1,
                "goodsId": 1,
                "createdBy": "",
                "createdTime": "2026-01-01 12:00:00"
              }
            ]
          }
        ],
        "relationList": [
          {
            "id": 1,
            "goodsId": 1,
            "channelType": "1",
            "thirdId": "",
            "thirdName": "",
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00"
          }
        ],
        "businessTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": "",
        "expireDate": "2026-01-01 12:00:00",
        "isRefund": false,
        "areaInfo": "",
        "shop": {
          "id": 1,
          "merchantId": 1,
          "merchantType": "1",
          "name": "",
          "logo": "",
          "typeId": 1,
          "subTypeId": 1,
          "status": "1",
          "provinceId": "",
          "cityId": "",
          "districtId": "",
          "address": "",
          "mobile": "13800000000",
          "linkman": "",
          "linkphone": "13800000000",
          "manager": "",
          "level": "",
          "lng": "",
          "lat": "",
          "introduction": "",
          "businessTime": "2026-01-01 12:00:00",
          "tags": "",
          "mainPic": "https://example.com/x.png",
          "propagatePic": "https://example.com/x.png",
          "video": "",
          "poster": "",
          "propagateContent": "",
          "description": "",
          "ticketInfo": "",
          "trafficInfo": "",
          "tips": "",
          "isDeleted": false,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "thirdId": "",
          "thirdName": ""
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsService.queryPage）；查询详情（skuService.get）；列表查询（orderGoodsService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsPage exact

POST /goods/updateGoods 在用管理后台 #

商品-更新 · GoodsController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsController#updateGoods
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsgoods_infocard_resource_ruleskusku_entrancegoods_channel_snapshotgoods_channel_extend_snapshotgoods_relationchecker_relationsystem_user_relationsystem_operate_log

ControllerGoodsController#updateGoods

转换BeanUtils.map → Goods ⇒ 表 goods

转换BeanUtils.map → GoodsInfo ⇒ 表 goods_info

ServiceGoodsService#update （GoodsServiceImpl）

MapperGoodsMapper#updateById ⇒ 表 goods

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

ServiceGoodsInfoService#update （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#updateById ⇒ 表 goods_info

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceSkuService#delete （SkuServiceImpl）

MapperSkuMapper#deleteById ⇒ 表 sku

ServiceSkuEntranceService#delete （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#deleteById ⇒ 表 sku_entrance

ServiceChannelSnapshotService#delete （ChannelSnapshotServiceImpl）

MapperChannelSnapshotMapper#deleteById ⇒ 表 goods_channel_snapshot

ServiceChannelExtendSnapshotService#delete （ChannelExtendSnapshotServiceImpl）

MapperChannelExtendSnapshotMapper#deleteById ⇒ 表 goods_channel_extend_snapshot

ServiceGoodsRelationService#queryList （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectList ⇒ 表 goods_relation

ServiceGoodsRelationService#delete （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#deleteById ⇒ 表 goods_relation

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceUserRelationService#queryList （UserRelationServiceImpl）

MapperUserRelationMapper#selectList ⇒ 表 system_user_relation

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 8

ChaosTransactionTemplate.executeGoodsService.mustGetShopCache.getDictDataCache.getCardResourceRuleService.updateListCheckerRelationService.updateListUserRelationService.updateListSessionUserService.getSessionUser

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goods/updateGoods
uat	https://dscp-uat.hn12301.net/manage-api/goods/updateGoods
pro	https://dscp-uat.hn12301.net/manage-api/goods/updateGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods`.`id`	商品id，主键
shopId	Long			`goods`.`shop_id`	所属商铺id，关联shop表id
name	String	是	必填	`goods`.`name`	商品名称
mainPic	String			`goods`.`main_pic`	商品主图
typeId	String	是	必填	`goods`.`type_id`	商品大类id
subTypeId	String			`goods`.`sub_type_id`	商品小类id
cardModelId	Long			`goods`.`card_model_id`	卡种id
grade	String			`goods`.`grade`	商品等级
shortName	String			`goods_info`.`short_name`	商品简称
weight	Integer			`goods_info`.`weight`	商品权重
tags	String			`goods_info`.`tags`	商品标签
recommendReason	String			`goods_info`.`recommend_reason`
introduction	String			`goods_info`.`introduction`	简介
propagatePic	String			`goods_info`.`propagate_pic`	宣传图片url地址
video	String			`goods_info`.`video`	宣传视频url地址
notice	String			`goods_info`.`notice`	购买须知
tips	String			`goods_info`.`tips`	温馨提示
businessTime	String			`goods_info`.`business_time`	营业时间
expireDate	Date			`goods_info`.`expire_date`
isRefund	Boolean			`goods_info`.`is_refund`
skuList	List<SkuUpdateRequest>	是	必填	—	sku列表
skuList[].goodsId	Long	是	必填	`card_resource_rule`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long			`sku`.`goods_channel_id`	关联商品渠道id
skuList[].shopId	Long			`goods`.`shop_id`
skuList[].id	Long			`goods`.`id`	商品id，主键
skuList[].skuName	String	是	必填	`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer			`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer			`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer			`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer			`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer			`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean			`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long			`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	是	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean			`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer			`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean			`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean			`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean			`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal			`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal			`sku`.`add_score_rate`	产生积分倍率
skuList[].skuEntranceList	List<SkuEntrance>			—	景区入口
skuEntranceList[].id	Long			`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long			`card_resource_rule`.`sku_id`	所属关联sku表id
skuEntranceList[].entranceName	String			`sku_entrance`.`entrance_name`	景区入口名称
skuEntranceList[].merchantId	Long			`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long			`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long			`card_resource_rule`.`goods_id`	商品ID，关联商品表id
skuEntranceList[].createdBy	String			`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date			`goods`.`created_time`	创建时间
skuList[].cardNum	Integer	否	可选(@MvcOptional)	`sku`.`card_num`	发卡数量，仅旅游卡商品
thirdId	String			`goods`.`third_id`	第三方id
thirdName	String			`goods`.`third_name`	第三方名称
relationList	List<GoodsRelationUpdateRequest>			—
relationList[].id	Long			`goods`.`id`	id
relationList[].thirdName	String			`goods`.`third_name`
relationList[].thirdId	String			`goods`.`third_id`
relationList[].channelType	ChannelType		1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goods/updateGoods

{
  "body": {
    "id": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "cardModelId": 1,
    "grade": "",
    "shortName": "",
    "weight": 0,
    "tags": "",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "businessTime": "2026-01-01 12:00:00",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false,
    "skuList": [
      {
        "goodsId": 1,
        "goodsChannelId": 1,
        "shopId": 1,
        "id": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "skuEntranceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ],
        "cardNum": 0
      }
    ],
    "thirdId": "",
    "thirdName": "",
    "relationList": [
      {
        "id": 1,
        "thirdName": "",
        "thirdId": "",
        "channelType": "1"
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 execute（newTransactionTemplate.execute）；调用 mustGet（goodsService.mustGet）；更新（goodsService.update）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品
更新商品信息
处理商品sku
查询现有数据
处理删除数据
删除sku
删除skuEntrance
skuEntranceService.delete(SkuEntranceQuery.builder().skuId(e).build());

前端调用方

dscp-html-manage updateGoods exact

GoodsInfoController 6/6 在用

POST /goodsInfo/addGoodsInfo 在用管理后台 #

GoodsInfo-新增 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#addGoodsInfo
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#addGoodsInfo

转换BeanUtils.map → GoodsInfo ⇒ 表 goods_info

ServiceGoodsInfoService#add （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#insert ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/addGoodsInfo
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/addGoodsInfo
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/addGoodsInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsInfoAddRequest

字段	类型	表 / 列	说明
shortName	String	`goods_info`.`short_name`	商品简称
weight	Integer	`goods_info`.`weight`	商品权重
tags	String	`goods_info`.`tags`	商品标签
businessTime	String	`goods_info`.`business_time`	营业时间
recommendReason	String	`goods_info`.`recommend_reason`	推荐理由
introduction	String	`goods_info`.`introduction`	简介
propagatePic	String	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	`goods_info`.`video`	宣传视频url地址
notice	String	`goods_info`.`notice`	购买须知
tips	String	`goods_info`.`tips`	温馨提示
expireDate	Date	`goods_info`.`expire_date`
isRefund	Boolean	`goods_info`.`is_refund`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsInfoResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_info`.`id`	商品id，主键
shortName	String	`goods_info`.`short_name`	商品简称
weight	Integer	`goods_info`.`weight`	商品权重
tags	String	`goods_info`.`tags`	商品标签
businessTime	String	`goods_info`.`business_time`	营业时间
recommendReason	String	`goods_info`.`recommend_reason`	推荐理由
introduction	String	`goods_info`.`introduction`	简介
propagatePic	String	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	`goods_info`.`video`	宣传视频url地址
notice	String	`goods_info`.`notice`	购买须知
tips	String	`goods_info`.`tips`	温馨提示
expireDate	Date	`goods_info`.`expire_date`
isRefund	Boolean	`goods_info`.`is_refund`

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/addGoodsInfo

{
  "body": {
    "shortName": "",
    "weight": 0,
    "tags": "",
    "businessTime": "2026-01-01 12:00:00",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "shortName": "",
    "weight": 0,
    "tags": "",
    "businessTime": "2026-01-01 12:00:00",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false
  }
}

处理逻辑

操作日志goods / 新增商品信息

逻辑摘要新增（goodsService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage addGoodsInfo exact

POST /goodsInfo/deleteGoodsInfo 在用管理后台 #

GoodsInfo-删除 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#deleteGoodsInfo
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#deleteGoodsInfo

ServiceGoodsInfoService#delete （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#deleteById ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/deleteGoodsInfo
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/deleteGoodsInfo
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/deleteGoodsInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/deleteGoodsInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品信息

逻辑摘要删除（goodsService.delete）

前端调用方

dscp-html-manage deleteGoodsInfo exact

POST /goodsInfo/getGoodsInfo 在用管理后台 #

GoodsInfo-详情 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#getGoodsInfo
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#getGoodsInfo

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/getGoodsInfo
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/getGoodsInfo
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/getGoodsInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsInfoResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_info`.`id`	商品id，主键
shortName	String	`goods_info`.`short_name`	商品简称
weight	Integer	`goods_info`.`weight`	商品权重
tags	String	`goods_info`.`tags`	商品标签
businessTime	String	`goods_info`.`business_time`	营业时间
recommendReason	String	`goods_info`.`recommend_reason`	推荐理由
introduction	String	`goods_info`.`introduction`	简介
propagatePic	String	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	`goods_info`.`video`	宣传视频url地址
notice	String	`goods_info`.`notice`	购买须知
tips	String	`goods_info`.`tips`	温馨提示
expireDate	Date	`goods_info`.`expire_date`
isRefund	Boolean	`goods_info`.`is_refund`

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/getGoodsInfo

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "shortName": "",
    "weight": 0,
    "tags": "",
    "businessTime": "2026-01-01 12:00:00",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false
  }
}

处理逻辑

逻辑摘要查询详情（goodsService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getGoodsInfo exact

POST /goodsInfo/queryGoodsInfoList 在用管理后台 #

GoodsInfo-列表查询 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#queryGoodsInfoList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#queryGoodsInfoList

转换BeanUtils.map → GoodsInfoQuery

ServiceGoodsInfoService#queryList （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectList ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/queryGoodsInfoList
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/queryGoodsInfoList
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/queryGoodsInfoList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsInfoListRequest

字段	类型	必填	取值/校验	表 / 列	说明
shortName	String	否	可选(@MvcOptional)	`goods_info`.`short_name`	商品简称
weight	Integer	否	可选(@MvcOptional)	`goods_info`.`weight`	商品权重
tags	String	否	可选(@MvcOptional)	`goods_info`.`tags`	商品标签
recommendReason	String			`goods_info`.`recommend_reason`	推荐理由
introduction	String	否	可选(@MvcOptional)	`goods_info`.`introduction`	简介
propagatePic	String	否	可选(@MvcOptional)	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	否	可选(@MvcOptional)	`goods_info`.`video`	宣传视频url地址
notice	String	否	可选(@MvcOptional)	`goods_info`.`notice`	购买须知
tips	String	否	可选(@MvcOptional)	`goods_info`.`tips`	温馨提示
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsInfoResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`goods_info`.`id`	商品id，主键
shortName	String	`goods_info`.`short_name`	商品简称
weight	Integer	`goods_info`.`weight`	商品权重
tags	String	`goods_info`.`tags`	商品标签
businessTime	String	`goods_info`.`business_time`	营业时间
recommendReason	String	`goods_info`.`recommend_reason`	推荐理由
introduction	String	`goods_info`.`introduction`	简介
propagatePic	String	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	`goods_info`.`video`	宣传视频url地址
notice	String	`goods_info`.`notice`	购买须知
tips	String	`goods_info`.`tips`	温馨提示
expireDate	Date	`goods_info`.`expire_date`
isRefund	Boolean	`goods_info`.`is_refund`

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/queryGoodsInfoList

{
  "body": {
    "shortName": "",
    "weight": 0,
    "tags": "",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "shortName": "",
      "weight": 0,
      "tags": "",
      "businessTime": "2026-01-01 12:00:00",
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsInfoList exact

POST /goodsInfo/queryGoodsInfoPage 在用管理后台 #

GoodsInfo-分页查询 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#queryGoodsInfoPage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#queryGoodsInfoPage

转换BeanUtils.map → GoodsInfoQuery

ServiceGoodsInfoService#queryPage （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectPage ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/queryGoodsInfoPage
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/queryGoodsInfoPage
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/queryGoodsInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			—	商户id
shopId	Long			—	商铺id
shortName	String	否	可选(@MvcOptional)	`goods_info`.`short_name`	商品简称
weight	Integer	否	可选(@MvcOptional)	`goods_info`.`weight`	商品权重
tags	String	否	可选(@MvcOptional)	`goods_info`.`tags`	商品标签
recommendReason	String			`goods_info`.`recommend_reason`	推荐理由
introduction	String	否	可选(@MvcOptional)	`goods_info`.`introduction`	简介
propagatePic	String	否	可选(@MvcOptional)	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	否	可选(@MvcOptional)	`goods_info`.`video`	宣传视频url地址
notice	String	否	可选(@MvcOptional)	`goods_info`.`notice`	购买须知
tips	String	否	可选(@MvcOptional)	`goods_info`.`tips`	温馨提示
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsInfoResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`goods_info`.`id`	商品id，主键
shortName	String	`goods_info`.`short_name`	商品简称
weight	Integer	`goods_info`.`weight`	商品权重
tags	String	`goods_info`.`tags`	商品标签
businessTime	String	`goods_info`.`business_time`	营业时间
recommendReason	String	`goods_info`.`recommend_reason`	推荐理由
introduction	String	`goods_info`.`introduction`	简介
propagatePic	String	`goods_info`.`propagate_pic`	宣传图片url地址
video	String	`goods_info`.`video`	宣传视频url地址
notice	String	`goods_info`.`notice`	购买须知
tips	String	`goods_info`.`tips`	温馨提示
expireDate	Date	`goods_info`.`expire_date`
isRefund	Boolean	`goods_info`.`is_refund`

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/queryGoodsInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "shortName": "",
    "weight": 0,
    "tags": "",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "shortName": "",
        "weight": 0,
        "tags": "",
        "businessTime": "2026-01-01 12:00:00",
        "recommendReason": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "notice": "",
        "tips": "",
        "expireDate": "2026-01-01 12:00:00",
        "isRefund": false
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryGoodsInfoPage exact

POST /goodsInfo/updateGoodsInfo 在用管理后台 #

GoodsInfo-更新 · GoodsInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsInfoController#updateGoodsInfo
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_info

ControllerGoodsInfoController#updateGoodsInfo

转换BeanUtils.map → GoodsInfo ⇒ 表 goods_info

ServiceGoodsInfoService#update （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#updateById ⇒ 表 goods_info

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsInfo/updateGoodsInfo
uat	https://dscp-uat.hn12301.net/manage-api/goodsInfo/updateGoodsInfo
pro	https://dscp-uat.hn12301.net/manage-api/goodsInfo/updateGoodsInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsInfoUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_info`.`id`	商品id，主键
shortName	String			`goods_info`.`short_name`	商品简称
weight	Integer			`goods_info`.`weight`	商品权重
tags	String			`goods_info`.`tags`	商品标签
businessTime	String			`goods_info`.`business_time`	营业时间
recommendReason	String			`goods_info`.`recommend_reason`	推荐理由
introduction	String			`goods_info`.`introduction`	简介
propagatePic	String			`goods_info`.`propagate_pic`	宣传图片url地址
video	String			`goods_info`.`video`	宣传视频url地址
notice	String			`goods_info`.`notice`	购买须知
tips	String			`goods_info`.`tips`	温馨提示

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsInfo/updateGoodsInfo

{
  "body": {
    "id": 1,
    "shortName": "",
    "weight": 0,
    "tags": "",
    "businessTime": "2026-01-01 12:00:00",
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 更新商品信息

逻辑摘要更新（goodsService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateGoodsInfo exact

GoodsRelationController 0/6 在用

POST /addGoodsRelation 未使用管理后台 #

商品关系映射-新增 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#addGoodsRelation
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#addGoodsRelation

转换BeanUtils.map → GoodsRelation ⇒ 表 goods_relation

ServiceGoodsRelationService#add （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#insert ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/addGoodsRelation
uat	https://dscp-uat.hn12301.net/manage-api/addGoodsRelation
pro	https://dscp-uat.hn12301.net/manage-api/addGoodsRelation	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsRelationAddRequest

字段	类型	取值/校验	表 / 列	说明
thirdName	String		`goods_relation`.`third_name`	名称
thirdId	String		`goods_relation`.`third_id`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /addGoodsRelation

{
  "body": {
    "thirdName": "",
    "thirdId": "",
    "channelType": "1"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 新增商品关联

逻辑摘要新增（goodsRelationService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /deleteGoodsRelation 未使用管理后台 #

商品关系映射-删除 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#deleteGoodsRelation
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#deleteGoodsRelation

ServiceGoodsRelationService#delete （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#deleteById ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/deleteGoodsRelation
uat	https://dscp-uat.hn12301.net/manage-api/deleteGoodsRelation
pro	https://dscp-uat.hn12301.net/manage-api/deleteGoodsRelation	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_relation`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /deleteGoodsRelation

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品关联

逻辑摘要删除（goodsRelationService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /getGoodsRelation 未使用管理后台 #

商品关系映射-详情 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#getGoodsRelation
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#getGoodsRelation

ServiceGoodsRelationService#get （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectById ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/getGoodsRelation
uat	https://dscp-uat.hn12301.net/manage-api/getGoodsRelation
pro	https://dscp-uat.hn12301.net/manage-api/getGoodsRelation	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_relation`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsRelationResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`goods_relation`.`id`	id
goodsId	Long		`goods_relation`.`goods_id`	goodsId
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
thirdId	String		`goods_relation`.`third_id`	第三方id
thirdName	String		`goods_relation`.`third_name`	第三方名称
createdTime	Date		`goods_relation`.`created_time`	创建时间
updatedTime	Date		`goods_relation`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /getGoodsRelation

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsId": 1,
    "channelType": "1",
    "thirdId": "",
    "thirdName": "",
    "createdTime": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（goodsRelationService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /queryGoodsRelationList 未使用管理后台 #

商品关系映射-列表查询 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#queryGoodsRelationList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#queryGoodsRelationList

转换BeanUtils.map → GoodsRelationQuery

ServiceGoodsRelationService#queryList （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectList ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/queryGoodsRelationList
uat	https://dscp-uat.hn12301.net/manage-api/queryGoodsRelationList
pro	https://dscp-uat.hn12301.net/manage-api/queryGoodsRelationList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsRelationListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsRelationResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`goods_relation`.`id`	id
goodsId	Long		`goods_relation`.`goods_id`	goodsId
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
thirdId	String		`goods_relation`.`third_id`	第三方id
thirdName	String		`goods_relation`.`third_name`	第三方名称
createdTime	Date		`goods_relation`.`created_time`	创建时间
updatedTime	Date		`goods_relation`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /queryGoodsRelationList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "goodsId": 1,
      "channelType": "1",
      "thirdId": "",
      "thirdName": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsRelationService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /queryGoodsRelationPage 未使用管理后台 #

商品关系映射-分页查询 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#queryGoodsRelationPage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#queryGoodsRelationPage

转换BeanUtils.map → GoodsRelationQuery

ServiceGoodsRelationService#queryPage （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectPage ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/queryGoodsRelationPage
uat	https://dscp-uat.hn12301.net/manage-api/queryGoodsRelationPage
pro	https://dscp-uat.hn12301.net/manage-api/queryGoodsRelationPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsRelationPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsRelationResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`goods_relation`.`id`	id
goodsId	Long		`goods_relation`.`goods_id`	goodsId
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
thirdId	String		`goods_relation`.`third_id`	第三方id
thirdName	String		`goods_relation`.`third_name`	第三方名称
createdTime	Date		`goods_relation`.`created_time`	创建时间
updatedTime	Date		`goods_relation`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /queryGoodsRelationPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "goodsId": 1,
        "channelType": "1",
        "thirdId": "",
        "thirdName": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsRelationService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /updateGoodsRelation 未使用管理后台 #

商品关系映射-更新 · GoodsRelationController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsRelationController#updateGoodsRelation
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_relation

ControllerGoodsRelationController#updateGoodsRelation

转换BeanUtils.map → GoodsRelation ⇒ 表 goods_relation

ServiceGoodsRelationService#update （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#updateById ⇒ 表 goods_relation

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/updateGoodsRelation
uat	https://dscp-uat.hn12301.net/manage-api/updateGoodsRelation
pro	https://dscp-uat.hn12301.net/manage-api/updateGoodsRelation	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsRelationUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`goods_relation`.`id`	id
thirdName	String		`goods_relation`.`third_name`
thirdId	String		`goods_relation`.`third_id`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /updateGoodsRelation

{
  "body": {
    "id": 1,
    "thirdName": "",
    "thirdId": "",
    "channelType": "1"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 更新商品关联

逻辑摘要更新（goodsRelationService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

GoodsTypeController 0/6 在用

POST /goodsType/addGoodsType 未使用管理后台 #

GoodsType-新增 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#addGoodsType
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#addGoodsType

转换BeanUtils.map → GoodsType ⇒ 表 goods_type

ServiceGoodsTypeService#add （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#insert ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/addGoodsType
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/addGoodsType
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/addGoodsType	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsTypeAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
parentId	Long	是	必填	`goods_type`.`parent_id`	所属大类ID
typeName	String	是	必填	`goods_type`.`type_name`	类型名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsTypeResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_type`.`id`	主键，类型id
parentId	Long	`goods_type`.`parent_id`	所属大类ID
typeName	String	`goods_type`.`type_name`	类型名称

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/addGoodsType

{
  "body": {
    "parentId": 1,
    "typeName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "parentId": 1,
    "typeName": ""
  }
}

处理逻辑

操作日志goods / 新增商品类型

逻辑摘要新增（goodsService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /goodsType/deleteGoodsType 未使用管理后台 #

GoodsType-删除 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#deleteGoodsType
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#deleteGoodsType

ServiceGoodsTypeService#delete （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#deleteById ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/deleteGoodsType
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/deleteGoodsType
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/deleteGoodsType	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_type`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/deleteGoodsType

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 删除商品类型

逻辑摘要删除（goodsService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /goodsType/getGoodsType 未使用管理后台 #

GoodsType-详情 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#getGoodsType
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#getGoodsType

ServiceGoodsTypeService#get （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#selectById ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/getGoodsType
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/getGoodsType
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/getGoodsType	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_type`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsTypeResponse　（object）

字段	类型	表 / 列	说明
id	Long	`goods_type`.`id`	主键，类型id
parentId	Long	`goods_type`.`parent_id`	所属大类ID
typeName	String	`goods_type`.`type_name`	类型名称

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/getGoodsType

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "parentId": 1,
    "typeName": ""
  }
}

处理逻辑

逻辑摘要查询详情（goodsService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /goodsType/queryGoodsTypeList 未使用管理后台 #

GoodsType-列表查询 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#queryGoodsTypeList
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#queryGoodsTypeList

转换BeanUtils.map → GoodsTypeQuery

ServiceGoodsTypeService#queryList （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#selectList ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/queryGoodsTypeList
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/queryGoodsTypeList
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/queryGoodsTypeList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsTypeListRequest

字段	类型	必填	取值/校验	表 / 列	说明
parentId	Long	否	可选(@MvcOptional)	`goods_type`.`parent_id`	所属大类ID
typeName	String	否	可选(@MvcOptional)	`goods_type`.`type_name`	类型名称
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsTypeResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`goods_type`.`id`	主键，类型id
parentId	Long	`goods_type`.`parent_id`	所属大类ID
typeName	String	`goods_type`.`type_name`	类型名称

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/queryGoodsTypeList

{
  "body": {
    "parentId": 1,
    "typeName": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "parentId": 1,
      "typeName": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /goodsType/queryGoodsTypePage 未使用管理后台 #

GoodsType-分页查询 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#queryGoodsTypePage
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#queryGoodsTypePage

转换BeanUtils.map → GoodsTypeQuery

ServiceGoodsTypeService#queryPage （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#selectPage ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/queryGoodsTypePage
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/queryGoodsTypePage
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/queryGoodsTypePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsTypePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
parentId	Long	否	可选(@MvcOptional)	`goods_type`.`parent_id`	所属大类ID
typeName	String	否	可选(@MvcOptional)	`goods_type`.`type_name`	类型名称
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GoodsTypeResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`goods_type`.`id`	主键，类型id
parentId	Long	`goods_type`.`parent_id`	所属大类ID
typeName	String	`goods_type`.`type_name`	类型名称

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/queryGoodsTypePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "parentId": 1,
    "typeName": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "parentId": 1,
        "typeName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（goodsService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /goodsType/updateGoodsType 未使用管理后台 #

GoodsType-更新 · GoodsTypeController

基本信息

控制器	com.jxxx.dscp.api.controller.goods.GoodsTypeController#updateGoodsType
所属模块	商品 `goods`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_type

ControllerGoodsTypeController#updateGoodsType

转换BeanUtils.map → GoodsType ⇒ 表 goods_type

ServiceGoodsTypeService#update （GoodsTypeServiceImpl）

MapperGoodsTypeMapper#updateById ⇒ 表 goods_type

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/goodsType/updateGoodsType
uat	https://dscp-uat.hn12301.net/manage-api/goodsType/updateGoodsType
pro	https://dscp-uat.hn12301.net/manage-api/goodsType/updateGoodsType	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GoodsTypeUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`goods_type`.`id`	主键，类型id
parentId	Long	是	必填	`goods_type`.`parent_id`	所属大类ID
typeName	String	是	必填	`goods_type`.`type_name`	类型名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /goodsType/updateGoodsType

{
  "body": {
    "id": 1,
    "parentId": 1,
    "typeName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志goods / 更新商品类型

逻辑摘要更新（goodsService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）