核销 checker

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

CheckerConfigController 0/6 在用

POST /checker/addCheckerConfig 未使用管理后台 #

核销人员核销配置表-新增 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#addCheckerConfig

转换BeanUtils.map → CheckerConfig ⇒ 表 checker_config

ServiceCheckerConfigService#add （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#insert ⇒ 表 checker_config

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConfigAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerConfig

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销配置

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

前端调用方

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

POST /checker/deleteCheckerConfig 未使用管理后台 #

核销人员核销配置表-删除 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#deleteCheckerConfig

ServiceCheckerConfigService#delete （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#deleteById ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerConfig

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销配置

逻辑摘要删除（checkerConfigService.delete）

前端调用方

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

POST /checker/getCheckerConfig 未使用管理后台 #

核销人员核销配置表-详情 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#getCheckerConfig

ServiceCheckerConfigService#get （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectById ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerConfigResponse　（object）

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

示例

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

POST /checker/getCheckerConfig

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

响应示例

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

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerConfigList 未使用管理后台 #

核销人员核销配置表-列表查询 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#queryCheckerConfigList

转换BeanUtils.map → CheckerConfigQuery

ServiceCheckerConfigService#queryList （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectList ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConfigListRequest

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

响应参数

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

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

data 结构　List<CheckerConfigResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`checker_config`.`id`	id

示例

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

POST /checker/queryCheckerConfigList

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerConfigPage 未使用管理后台 #

核销人员核销配置表-分页查询 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#queryCheckerConfigPage

转换BeanUtils.map → CheckerConfigQuery

ServiceCheckerConfigService#queryPage （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectPage ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConfigPageRequest

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

响应参数

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

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

data 结构　PageInfo<CheckerConfigResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`checker_config`.`id`	id

示例

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

POST /checker/queryCheckerConfigPage

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerConfig 未使用管理后台 #

核销人员核销配置表-更新 · CheckerConfigController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_config

ControllerCheckerConfigController#updateCheckerConfig

转换BeanUtils.map → CheckerConfig ⇒ 表 checker_config

ServiceCheckerConfigService#update （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#updateById ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConfigUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerConfig

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销配置

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

前端调用方

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

CheckerConsumeRecordController 2/8 在用

POST /checker/addCheckerConsumeRecord 未使用App #

核销员核销记录表-新增 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#addCheckerConsumeRecord
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#addCheckerConsumeRecord

转换BeanUtils.map → CheckerConsumeRecord ⇒ 表 checker_consume_record

ServiceCheckerConsumeRecordService#add （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#insert ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRecordAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerConsumeRecord

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增消费记录

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

前端调用方

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

ANY /checker/cardCheckStat 在用App #

核销记录-核销端核销数据统计 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#checkerCardCheckStat
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_checkchecker_consume_recordchecker_relation

ControllerCheckerConsumeRecordController#checkerCardCheckStat

MapperCardCheckService.getMapper#queryList ⇒ 表 card_check

MapperCheckerConsumeRecordService.getMapper#queryList ⇒ 表 checker_consume_record

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceCardCheckService#queryList （CardCheckServiceImpl）

MapperCardCheckMapper#selectList ⇒ 表 card_check

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

AuthService.getAuthAccIdCardCheckService.applyWrapperCheckerConsumeRecordService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerCardCheckStatRequest

字段	类型	必填	取值/校验	表 / 列	说明
skuId	String	是	必填	`card_check`.`sku_id`	景区id

响应参数

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

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

data 结构　CheckerCardCheckStatBean　（object）

字段	类型	表 / 列	说明
dayCheckPersonNum	Integer	—	当日入园人数
dayCardCheckCnt	Integer	—	当日核销次数
checkerCardCheckCnt	Integer	—	当前操作员核销次数

示例

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

ANY /checker/cardCheckStat

{
  "body": {
    "skuId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "dayCheckPersonNum": 0,
    "dayCardCheckCnt": 0,
    "checkerCardCheckCnt": 0
  }
}

处理逻辑

逻辑摘要查询详情（authService.getAuthAccId）；列表查询（checkerRelationService.queryList）；调用 beginOfDay（DateUtil.beginOfDay）

内联注释

获取登录用户id
.checkTimeRange(dateRange).build());
QueryWrapperX<CardCheck> cardCheckQueryWrapperX = new QueryWrapperX<>();
cardCheckQueryWrapperX.inIfPresent("resource_id", )

前端调用方

writeoff cardCheckStat exact

POST /checker/deleteCheckerConsumeRecord 未使用App #

核销员核销记录表-删除 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#deleteCheckerConsumeRecord
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#deleteCheckerConsumeRecord

ServiceCheckerConsumeRecordService#delete （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#deleteById ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerConsumeRecord

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除消费记录

逻辑摘要删除（checkerConsumeRecordService.delete）

前端调用方

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

POST /checker/getCheckerConsumeRecord 未使用App #

核销员核销记录表-详情 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#getCheckerConsumeRecord
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#getCheckerConsumeRecord

ServiceCheckerConsumeRecordService#get （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#selectById ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerConsumeRecordResponse　（object）

字段	类型	表 / 列	说明
id	Long	`checker_consume_record`.`id`	id
cardNum	String	`checker_consume_record`.`card_num`	卡号
cardName	String	`checker_consume_record`.`card_name`	卡种名称
mcId	String	`checker_consume_record`.`mc_id`	景区id
mcName	String	`checker_consume_record`.`mc_name`	景区名称
cmId	String	`checker_consume_record`.`cm_id`	景点ID
cmName	String	`checker_consume_record`.`cm_name`	景点名称
entranceName	String	`checker_consume_record`.`entrance_name`	景区入口名称
consumeNum	Integer	`checker_consume_record`.`consume_num`	核销数量
checkerId	Long	`checker_consume_record`.`checker_id`	核销人
checkerName	String	`checker_consume_record`.`checker_name`	核销人姓名
touristName	String	`checker_consume_record`.`tourist_name`
touristMobile	String	`checker_consume_record`.`tourist_mobile`
touristCardNo	String	`checker_consume_record`.`tourist_card_no`
touristFacePhoto	String	`checker_consume_record`.`tourist_face_photo`	游客人脸照片
status	Integer	`checker_consume_record`.`status`	状态
isDeleted	Boolean	`checker_consume_record`.`is_deleted`	是否删除
checkTime	Date	`checker_consume_record`.`check_time`	核销时间
createdBy	Long	`checker_consume_record`.`created_by`	创建人
createdTime	Date	`checker_consume_record`.`created_time`	创建时间
updatedBy	Long	`checker_consume_record`.`updated_by`	修改人
updatedTime	Date	`checker_consume_record`.`updated_time`	修改时间
checkType	Integer	`checker_consume_record`.`check_type`	核销类型

示例

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

POST /checker/getCheckerConsumeRecord

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardNum": "",
    "cardName": "",
    "mcId": "",
    "mcName": "",
    "cmId": "",
    "cmName": "",
    "entranceName": "",
    "consumeNum": 0,
    "checkerId": 1,
    "checkerName": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCardNo": "",
    "touristFacePhoto": "",
    "status": 0,
    "isDeleted": false,
    "checkTime": "2026-01-01 12:00:00",
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "checkType": 0
  }
}

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerConsumeRecord 在用App #

（无摘要） · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#queryCheckerConsumeRecord
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCheckerConsumeRecordController#queryCheckerConsumeRecord

转换BeanUtils.map → CardCheckQuery

转换BeanUtils.map → CardCheckResponse

ServiceCardCheckService#queryPage （CardCheckServiceImpl）

MapperCardCheckMapper#selectPage ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
skuId	Long	是	必填	`card_check`.`sku_id`	skuId
checkerId	Long	否	可选(@MvcOptional)	`card_check`.`checker_id`	核销员id
keywords	String	否	可选(@MvcOptional)	—	关键字
createdTimeRange	Date[]	否	可选(@MvcOptional)	—

响应参数

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

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

data 结构　PageInfo<CardCheckResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`card_check`.`id`	id
cardId	Long	`card_check`.`card_id`	卡id，关联card卡池表id
cardModelId	Long	`card_check`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	`card_check`.`card_model_name`	卡种名称
entranceId	Long	`card_check`.`entrance_id`	景区入口id
entranceName	String	`card_check`.`entrance_name`	景区入口名称
cardNumber	String	`card_check`.`card_number`	卡号
memberId	Long	`card_check`.`member_id`	持卡人ID
name	String	`card_check`.`name`	持卡人姓名
phone	String	`card_check`.`phone`	手机号码
identityNo	String	`card_check`.`identity_no`	身份证号码
checkTime	Date	`card_check`.`check_time`	核销时间
checkerId	Long	`card_check`.`checker_id`	核销人id
checkerName	String	`card_check`.`checker_name`	核销人员姓名
resourceName	String	`card_check`.`resource_name`	预约景区名称
facePhoto	String	`card_check`.`face_photo`	人脸图片地址
isDeleted	Boolean	`card_check`.`is_deleted`

示例

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

POST /checker/queryCheckerConsumeRecord

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "skuId": 1,
    "checkerId": 1,
    "keywords": "",
    "createdTimeRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardId": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "entranceId": 1,
        "entranceName": "",
        "cardNumber": "",
        "memberId": 1,
        "name": "",
        "phone": "13800000000",
        "identityNo": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": "",
        "resourceName": "",
        "facePhoto": "",
        "isDeleted": false
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

查询景区信息
query.setOrderby("created_time desc");

前端调用方

writeoff queryCheckerConsumeRecord exact

POST /checker/queryCheckerConsumeRecord1 未使用App #

核销员核销记录表-分页查询 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#queryCheckerConsumeRecord1
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#queryCheckerConsumeRecord1

转换BeanUtils.map → CheckerConsumeRecordQuery

转换BeanUtils.map → CheckerConsumeRecordResponse

ServiceCheckerConsumeRecordService#queryPage （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#selectPage ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
skuId	Long	是	必填	`checker_consume_record`.`sku_id`	skuId
checkerId	Long	否	可选(@MvcOptional)	`checker_consume_record`.`checker_id`	核销员id
keywords	String	否	可选(@MvcOptional)	—	关键字
createdTimeRange	Date[]	否	可选(@MvcOptional)	—

响应参数

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

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

data 结构　PageInfo<CheckerConsumeRecordResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`checker_consume_record`.`id`	id
cardNum	String	`checker_consume_record`.`card_num`	卡号
cardName	String	`checker_consume_record`.`card_name`	卡种名称
mcId	String	`checker_consume_record`.`mc_id`	景区id
mcName	String	`checker_consume_record`.`mc_name`	景区名称
cmId	String	`checker_consume_record`.`cm_id`	景点ID
cmName	String	`checker_consume_record`.`cm_name`	景点名称
entranceName	String	`checker_consume_record`.`entrance_name`	景区入口名称
consumeNum	Integer	`checker_consume_record`.`consume_num`	核销数量
checkerId	Long	`checker_consume_record`.`checker_id`	核销人
checkerName	String	`checker_consume_record`.`checker_name`	核销人姓名
touristName	String	`checker_consume_record`.`tourist_name`
touristMobile	String	`checker_consume_record`.`tourist_mobile`
touristCardNo	String	`checker_consume_record`.`tourist_card_no`
touristFacePhoto	String	`checker_consume_record`.`tourist_face_photo`	游客人脸照片
status	Integer	`checker_consume_record`.`status`	状态
isDeleted	Boolean	`checker_consume_record`.`is_deleted`	是否删除
checkTime	Date	`checker_consume_record`.`check_time`	核销时间
createdBy	Long	`checker_consume_record`.`created_by`	创建人
createdTime	Date	`checker_consume_record`.`created_time`	创建时间
updatedBy	Long	`checker_consume_record`.`updated_by`	修改人
updatedTime	Date	`checker_consume_record`.`updated_time`	修改时间
checkType	Integer	`checker_consume_record`.`check_type`	核销类型

示例

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

POST /checker/queryCheckerConsumeRecord1

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "skuId": 1,
    "checkerId": 1,
    "keywords": "",
    "createdTimeRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardNum": "",
        "cardName": "",
        "mcId": "",
        "mcName": "",
        "cmId": "",
        "cmName": "",
        "entranceName": "",
        "consumeNum": 0,
        "checkerId": 1,
        "checkerName": "",
        "touristName": "",
        "touristMobile": "13800000000",
        "touristCardNo": "",
        "touristFacePhoto": "",
        "status": 0,
        "isDeleted": false,
        "checkTime": "2026-01-01 12:00:00",
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "checkType": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

查询景区信息

前端调用方

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

POST /checker/queryCheckerConsumeRecordList 未使用App #

核销员核销记录表-列表查询 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#queryCheckerConsumeRecordList
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#queryCheckerConsumeRecordList

转换BeanUtils.map → CheckerConsumeRecordQuery

ServiceCheckerConsumeRecordService#queryList （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#selectList ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
checkerId	String	否	可选(@MvcOptional)	`checker_consume_record`.`checker_id`	关键字

响应参数

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

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

data 结构　List<CheckerConsumeRecordResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`checker_consume_record`.`id`	id
cardNum	String	`checker_consume_record`.`card_num`	卡号
cardName	String	`checker_consume_record`.`card_name`	卡种名称
mcId	String	`checker_consume_record`.`mc_id`	景区id
mcName	String	`checker_consume_record`.`mc_name`	景区名称
cmId	String	`checker_consume_record`.`cm_id`	景点ID
cmName	String	`checker_consume_record`.`cm_name`	景点名称
entranceName	String	`checker_consume_record`.`entrance_name`	景区入口名称
consumeNum	Integer	`checker_consume_record`.`consume_num`	核销数量
checkerId	Long	`checker_consume_record`.`checker_id`	核销人
checkerName	String	`checker_consume_record`.`checker_name`	核销人姓名
touristName	String	`checker_consume_record`.`tourist_name`
touristMobile	String	`checker_consume_record`.`tourist_mobile`
touristCardNo	String	`checker_consume_record`.`tourist_card_no`
touristFacePhoto	String	`checker_consume_record`.`tourist_face_photo`	游客人脸照片
status	Integer	`checker_consume_record`.`status`	状态
isDeleted	Boolean	`checker_consume_record`.`is_deleted`	是否删除
checkTime	Date	`checker_consume_record`.`check_time`	核销时间
createdBy	Long	`checker_consume_record`.`created_by`	创建人
createdTime	Date	`checker_consume_record`.`created_time`	创建时间
updatedBy	Long	`checker_consume_record`.`updated_by`	修改人
updatedTime	Date	`checker_consume_record`.`updated_time`	修改时间
checkType	Integer	`checker_consume_record`.`check_type`	核销类型

示例

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

POST /checker/queryCheckerConsumeRecordList

{
  "body": {
    "checkerId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "cardNum": "",
      "cardName": "",
      "mcId": "",
      "mcName": "",
      "cmId": "",
      "cmName": "",
      "entranceName": "",
      "consumeNum": 0,
      "checkerId": 1,
      "checkerName": "",
      "touristName": "",
      "touristMobile": "13800000000",
      "touristCardNo": "",
      "touristFacePhoto": "",
      "status": 0,
      "isDeleted": false,
      "checkTime": "2026-01-01 12:00:00",
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "checkType": 0
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerConsumeRecord 未使用App #

核销员核销记录表-更新 · CheckerConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerConsumeRecordController#updateCheckerConsumeRecord
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_consume_record

ControllerCheckerConsumeRecordController#updateCheckerConsumeRecord

转换BeanUtils.map → CheckerConsumeRecord ⇒ 表 checker_consume_record

ServiceCheckerConsumeRecordService#update （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#updateById ⇒ 表 checker_consume_record

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRecordUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerConsumeRecord

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新消费记录

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

前端调用方

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

CheckerController 11/17 在用

POST /checker/addChecker 在用管理后台 #

核销人员表-新增 · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checkerskuchecker_relationchecker_cqy_relationchecker_tickets_relationchecker_config

ControllerCheckerController#addChecker

ServiceCheckerService#addChecker （CheckerServiceImpl）

MapperCheckerMapper#queryList ⇒ 表 checker

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

MapperCheckerMapper#add ⇒ 表 checker

ServiceCheckerRelationService#add （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#insert ⇒ 表 checker_relation

ServiceCheckerCqyRelationService#add （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#insert ⇒ 表 checker_cqy_relation

ServiceCheckerTicketsRelationService#add （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#insert ⇒ 表 checker_tickets_relation

ServiceCheckerConfigService#add （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#insert ⇒ 表 checker_config

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerAddRequest

字段	类型	取值/校验	表 / 列	说明
name	String		—	名称
mobile	String		`checker`.`mobile`
password	String		`checker`.`password`
merchantId	Long		`sku`.`merchant_id`
shopId	Long		`sku`.`shop_id`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
skuIdList	List<Long[]>		—
ticketsSkuIdList	List<Long[]>		—
cqySkuIdList	List<Long[]>		—
status	Integer		`checker`.`status`
thirdId	String		`checker`.`third_id`	第三方卡种id
configList	List<String>		—
relationList	List<CheckerRelationAddRequest>		—
relationList[].thirdId	String		`checker`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addChecker

{
  "body": {
    "name": "",
    "mobile": "13800000000",
    "password": "",
    "merchantId": 1,
    "shopId": 1,
    "channelType": "1",
    "skuIdList": "",
    "ticketsSkuIdList": "",
    "cqySkuIdList": "",
    "status": 0,
    "thirdId": "",
    "configList": "",
    "relationList": [
      {
        "thirdId": "",
        "channelType": "1"
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销人员

逻辑摘要新增（checkerService.addChecker）

前端调用方

dscp-html-manage addChecker exact

POST /checker/deleteChecker 未使用管理后台 #

核销人员表-删除 · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker

ControllerCheckerController#deleteChecker

ServiceCheckerService#delete （CheckerServiceImpl）

MapperCheckerMapper#deleteById ⇒ 表 checker

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteChecker

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销人员

逻辑摘要删除（checkerService.delete）

前端调用方

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

POST /checker/faceConsume 在用App #

人脸核销 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#faceConsume
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member_facecardcard_bindcard_check

ControllerCheckerController#faceConsume

ServiceCheckerService#faceConsumeSzhNew （CheckerServiceImpl）

MapperMemberFaceMapper#selectList ⇒ 表 member_face

ServiceCardService#queryList （CardServiceImpl）

MapperCardMapper#selectList ⇒ 表 card

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

ServiceCardCheckService#get （CardCheckServiceImpl）

MapperCardCheckMapper#selectById ⇒ 表 card_check

ServiceCardCheckService#update （CardCheckServiceImpl）

MapperCardCheckMapper#updateById ⇒ 表 card_check

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

CheckerService.faceConsumeCardCheckHandlerCache.getOssService.uploadBase64OssProperties.getBucketNameObjectService.putObjectObjectService.getObjectURL

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerFaceConsumeRequest

字段	类型	必填	取值/校验	表 / 列	说明
photoBase64	String	是	必填	—	人脸图片base64
userId	Long	是	必填	—	核销员id
skuId	String	是	必填	`card_check`.`sku_id`	skuId
isReturnList	Boolean	是	必填	—	是否返回卡列表
entranceId	String	是	必填	`card_check`.`entrance_id`	入口id
platform	Integer			—	核销小程序=1 核销app=2
item	String			—

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	`card`.`card_model_name`	卡种名称
cardNumber	String	`card`.`card_number`	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
touristCheckList[].mcName	String	—	景区名称
touristCheckList[].checkTime	Date	`card_check`.`check_time`	核销时间
touristCheckList[].checkerName	String	`card_check`.`checker_name`	核销人姓名
checkerRecordId	Long	—

示例

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

POST /checker/faceConsume

{
  "body": {
    "photoBase64": "",
    "userId": 1,
    "skuId": "",
    "isReturnList": false,
    "entranceId": "",
    "platform": 0,
    "item": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "data": "",
    "cardModelName": "",
    "cardNumber": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCertType": "",
    "touristIdCardNo": "",
    "touristPhotoUrl": "https://example.com/x.png",
    "isVerify": false,
    "remainTimes": 0,
    "checkedTimes": 0,
    "touristCheckList": [
      {
        "mcName": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerName": ""
      }
    ],
    "checkerRecordId": 1
  }
}

处理逻辑

操作日志checker / 人脸核销

逻辑摘要调用 faceConsume（checkerService.faceConsume）；调用 faceConsumeSzhNew（checkerService.faceConsumeSzhNew）

内联注释

else if (request.getItem().equalsIgnoreCase("cztykt")) {
return checkerService.faceConsumeSzhNew(request, 792480139223109l);
} else if (request.getItem().equalsIgnoreCase("xym")) {
return checkerService.faceConsumeSzhNew(request, 795314886207749l);
} else if (request.getItem().equalsIgnoreCase("cxy")) {
return checkerService.faceConsumeSzhNew(request, 799996603280709l);
}
throw ChaosRes.SYS_FAIL.toException("未知卡种人脸核销");

前端调用方

writeoff faceConsume exact

POST /checker/faceConsumeCztk 未使用App #

湘约码卡人脸核销 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#faceConsumeCztk
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member_facecardcard_bindcard_check

ControllerCheckerController#faceConsumeCztk

ServiceCheckerService#faceConsumeSzhNew （CheckerServiceImpl）

MapperMemberFaceMapper#selectList ⇒ 表 member_face

ServiceCardService#queryList （CardServiceImpl）

MapperCardMapper#selectList ⇒ 表 card

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

ServiceCardCheckService#get （CardCheckServiceImpl）

MapperCardCheckMapper#selectById ⇒ 表 card_check

ServiceCardCheckService#update （CardCheckServiceImpl）

MapperCardCheckMapper#updateById ⇒ 表 card_check

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

OssService.uploadBase64OssProperties.getBucketNameObjectService.putObjectObjectService.getObjectURL

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerFaceConsumeRequest

字段	类型	必填	取值/校验	表 / 列	说明
photoBase64	String	是	必填	—	人脸图片base64
userId	Long	是	必填	—	核销员id
skuId	String	是	必填	`card_check`.`sku_id`	skuId
isReturnList	Boolean	是	必填	—	是否返回卡列表
entranceId	String	是	必填	`card_check`.`entrance_id`	入口id
platform	Integer			—	核销小程序=1 核销app=2
item	String			—

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	`card`.`card_model_name`	卡种名称
cardNumber	String	`card`.`card_number`	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
touristCheckList[].mcName	String	—	景区名称
touristCheckList[].checkTime	Date	`card_check`.`check_time`	核销时间
touristCheckList[].checkerName	String	`card_check`.`checker_name`	核销人姓名
checkerRecordId	Long	—

示例

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

POST /checker/faceConsumeCztk

{
  "body": {
    "photoBase64": "",
    "userId": 1,
    "skuId": "",
    "isReturnList": false,
    "entranceId": "",
    "platform": 0,
    "item": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "data": "",
    "cardModelName": "",
    "cardNumber": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCertType": "",
    "touristIdCardNo": "",
    "touristPhotoUrl": "https://example.com/x.png",
    "isVerify": false,
    "remainTimes": 0,
    "checkedTimes": 0,
    "touristCheckList": [
      {
        "mcName": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerName": ""
      }
    ],
    "checkerRecordId": 1
  }
}

处理逻辑

操作日志checker / 人脸核销(湘约码卡)

逻辑摘要调用 faceConsumeSzhNew（checkerService.faceConsumeSzhNew）

前端调用方

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

POST /checker/faceConsumeXym 未使用App #

人脸核销(湘约码) · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#faceConsumeXym
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member_facecardcard_bindcard_check

ControllerCheckerController#faceConsumeXym

ServiceCheckerService#faceConsumeSzhNew （CheckerServiceImpl）

MapperMemberFaceMapper#selectList ⇒ 表 member_face

ServiceCardService#queryList （CardServiceImpl）

MapperCardMapper#selectList ⇒ 表 card

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

ServiceCardCheckService#get （CardCheckServiceImpl）

MapperCardCheckMapper#selectById ⇒ 表 card_check

ServiceCardCheckService#update （CardCheckServiceImpl）

MapperCardCheckMapper#updateById ⇒ 表 card_check

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

OssService.uploadBase64OssProperties.getBucketNameObjectService.putObjectObjectService.getObjectURL

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerFaceConsumeRequest

字段	类型	必填	取值/校验	表 / 列	说明
photoBase64	String	是	必填	—	人脸图片base64
userId	Long	是	必填	—	核销员id
skuId	String	是	必填	`card_check`.`sku_id`	skuId
isReturnList	Boolean	是	必填	—	是否返回卡列表
entranceId	String	是	必填	`card_check`.`entrance_id`	入口id
platform	Integer			—	核销小程序=1 核销app=2
item	String			—

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	`card`.`card_model_name`	卡种名称
cardNumber	String	`card`.`card_number`	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
touristCheckList[].mcName	String	—	景区名称
touristCheckList[].checkTime	Date	`card_check`.`check_time`	核销时间
touristCheckList[].checkerName	String	`card_check`.`checker_name`	核销人姓名
checkerRecordId	Long	—

示例

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

POST /checker/faceConsumeXym

{
  "body": {
    "photoBase64": "",
    "userId": 1,
    "skuId": "",
    "isReturnList": false,
    "entranceId": "",
    "platform": 0,
    "item": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "data": "",
    "cardModelName": "",
    "cardNumber": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCertType": "",
    "touristIdCardNo": "",
    "touristPhotoUrl": "https://example.com/x.png",
    "isVerify": false,
    "remainTimes": 0,
    "checkedTimes": 0,
    "touristCheckList": [
      {
        "mcName": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerName": ""
      }
    ],
    "checkerRecordId": 1
  }
}

处理逻辑

操作日志checker / 人脸核销(湘约码)

逻辑摘要调用 faceConsumeSzhNew（checkerService.faceConsumeSzhNew）

前端调用方

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

POST /checker/faceStepTwo 在用App #

人脸核销第二步 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#faceStepTwo
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerCheckerController#faceStepTwo

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

CheckerService.faceStepTwoCardCheckHandlerCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　FaceStepTwoRequest

字段	类型	表 / 列	说明
channel	Integer	—	渠道
cardNumber	String	—	卡号
skuId	String	—	skuId
faceId	String	—	人脸id
userId	Long	—	核销员id
entranceId	String	—	入口id

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	—	卡种名称
cardNumber	String	—	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
touristCheckList[].mcName	String	—	景区名称
touristCheckList[].checkTime	Date	—	核销时间
touristCheckList[].checkerName	String	—	核销人姓名
checkerRecordId	Long	—

示例

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

POST /checker/faceStepTwo

{
  "body": {
    "channel": 0,
    "cardNumber": "",
    "skuId": "",
    "faceId": "",
    "userId": 1,
    "entranceId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "data": "",
    "cardModelName": "",
    "cardNumber": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCertType": "",
    "touristIdCardNo": "",
    "touristPhotoUrl": "https://example.com/x.png",
    "isVerify": false,
    "remainTimes": 0,
    "checkedTimes": 0,
    "touristCheckList": [
      {
        "mcName": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerName": ""
      }
    ],
    "checkerRecordId": 1
  }
}

处理逻辑

操作日志checker / 人脸核销第二步

逻辑摘要调用 faceStepTwo（checkerService.faceStepTwo）

前端调用方

writeoff faceStepTwo exact

POST /checker/getChecker 在用管理后台 #

核销人员表-详情 · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relationchecker_tickets_relationchecker_cqy_relationchecker_config

ControllerCheckerController#getChecker

ServiceCheckerService#getChecker （CheckerServiceImpl）

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

ServiceCheckerCqyRelationService#queryList （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectList ⇒ 表 checker_cqy_relation

ServiceCheckerConfigService#queryList （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectList ⇒ 表 checker_config

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

CheckerService.mustGetShopService.mustGetMerchantService.mustGet

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerInfoResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`checker_relation`.`id`
name	String		—
mobile	String		—
status	Integer		—
createTime	Date		—
shopName	String		—
merchantName	String		—
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
shopId	Long		`checker_relation`.`shop_id`
merchantId	Long		`checker_relation`.`merchant_id`
skuIdList	List<Long[]>		—
ticketsSkuIdList	List<Long[]>		—
cqySkuIdList	List<Long[]>		—
thirdId	String		`checker_relation`.`third_id`
relationList	List<CheckerRelationAddRequest>		—	多渠道关联列表
relationList[].thirdId	String		`checker_relation`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`
ticketsRelationList	List<CheckerTicketsRelation>		—
ticketsRelationList[].id	Long		`checker_relation`.`id`	id
ticketsRelationList[].checkerId	Long		`checker_relation`.`checker_id`	核销人员id
ticketsRelationList[].thirdId	String		`checker_relation`.`third_id`	第三方id
ticketsRelationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	类型(枚举:ChannelType)
ticketsRelationList[].merchantId	String		`checker_relation`.`merchant_id`	商户id
ticketsRelationList[].shopId	String		`checker_relation`.`shop_id`	景区id
ticketsRelationList[].ticketsId	String		`checker_tickets_relation`.`tickets_id`	门票id
ticketsRelationList[].skuId	String		`checker_relation`.`sku_id`	skuId
cqyRelationList	List<CheckerCqyRelation>		—
cqyRelationList[].id	Long		`checker_relation`.`id`	id
cqyRelationList[].checkerId	Long		`checker_relation`.`checker_id`	核销人员id
cqyRelationList[].thirdId	String		`checker_relation`.`third_id`	第三方id
cqyRelationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	类型(枚举:ChannelType)
cqyRelationList[].merchantId	String		`checker_relation`.`merchant_id`	商户id
cqyRelationList[].shopId	String		`checker_relation`.`shop_id`	景区id
cqyRelationList[].goodsId	String		`checker_relation`.`goods_id`	门票id
cqyRelationList[].skuId	String		`checker_relation`.`sku_id`	skuId
configList	List<String>		—

示例

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

POST /checker/getChecker

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "mobile": "13800000000",
    "status": 0,
    "createTime": "2026-01-01 12:00:00",
    "shopName": "",
    "merchantName": "",
    "channelType": "1",
    "shopId": 1,
    "merchantId": 1,
    "skuIdList": "",
    "ticketsSkuIdList": "",
    "cqySkuIdList": "",
    "thirdId": "",
    "relationList": [
      {
        "thirdId": "",
        "channelType": "1"
      }
    ],
    "ticketsRelationList": [
      {
        "id": 1,
        "checkerId": 1,
        "thirdId": "",
        "channelType": "1",
        "merchantId": "",
        "shopId": "",
        "ticketsId": "",
        "skuId": ""
      }
    ],
    "cqyRelationList": [
      {
        "id": 1,
        "checkerId": 1,
        "thirdId": "",
        "channelType": "1",
        "merchantId": "",
        "shopId": "",
        "goodsId": "",
        "skuId": ""
      }
    ],
    "configList": ""
  }
}

处理逻辑

逻辑摘要查询详情（checkerService.getChecker）

前端调用方

dscp-html-manage getChecker exact

POST /checker/getCheckerListByResourceId 在用管理后台 #

（无摘要） · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_resource_rulechecker_relationchecker

ControllerCheckerController#getCheckerListByResourceId

转换BeanUtils.mapList → CheckerResponse

ServiceCardResourceRuleService#get （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectById ⇒ 表 card_resource_rule

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceCheckerService#queryList （CheckerServiceImpl）

MapperCheckerMapper#selectList ⇒ 表 checker

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　List<CheckerResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`card_resource_rule`.`id`	id
serialNo	Integer		—
name	String		—
nickname	String		`checker`.`nickname`
mobile	String		`checker`.`mobile`
shopName	String		—
merchantName	String		—
skuName	String		—
createTime	Date		`checker`.`create_time`
status	Integer		`card_resource_rule`.`status`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
relationList	List<CheckerRelationAddRequest>		—
relationList[].thirdId	String		`checker_relation`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`

示例

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

POST /checker/getCheckerListByResourceId

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "serialNo": 0,
      "name": "",
      "nickname": "",
      "mobile": "13800000000",
      "shopName": "",
      "merchantName": "",
      "skuName": "",
      "createTime": "2026-01-01 12:00:00",
      "status": 0,
      "channelType": "1",
      "relationList": [
        {
          "thirdId": "",
          "channelType": "1"
        }
      ]
    }
  ]
}

处理逻辑

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

前端调用方

dscp-html-manage getCheckerListByResourceId exact

POST /checker/queryCheckerList 未使用App #

核销人员表-列表查询 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#queryCheckerList
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker

ControllerCheckerController#queryCheckerList

转换BeanUtils.map → CheckerQuery

ServiceCheckerService#queryList （CheckerServiceImpl）

MapperCheckerMapper#selectList ⇒ 表 checker

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerListRequest

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

响应参数

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

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

data 结构　List<CheckerResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`checker`.`id`	id
serialNo	Integer		—
name	String		—
nickname	String		`checker`.`nickname`
mobile	String		`checker`.`mobile`
shopName	String		—
merchantName	String		—
skuName	String		—
createTime	Date		`checker`.`create_time`
status	Integer		`checker`.`status`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
relationList	List<CheckerRelationAddRequest>		—
relationList[].thirdId	String		`checker`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—

示例

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

POST /checker/queryCheckerList

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "serialNo": 0,
      "name": "",
      "nickname": "",
      "mobile": "13800000000",
      "shopName": "",
      "merchantName": "",
      "skuName": "",
      "createTime": "2026-01-01 12:00:00",
      "status": 0,
      "channelType": "1",
      "relationList": [
        {
          "thirdId": "",
          "channelType": "1"
        }
      ]
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerPage 在用管理后台 #

核销人员表-分页查询 · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checkerchecker_relation

ControllerCheckerController#queryCheckerPage

ServiceCheckerService#queryCheckerPage （CheckerServiceImpl）

MapperCheckerMapper#queryCheckerPage ⇒ 表 checker

MapperCheckerMapper#countCheckerPage ⇒ 表 checker

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

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

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
name	String	否	可选(@MvcOptional)	—
mobile	String	否	可选(@MvcOptional)	`checker`.`mobile`
createTime	List<Date>	否	可选(@MvcOptional)	`checker`.`create_time`
status	Integer	否	可选(@MvcOptional)	`checker`.`status`
shopName	String	否	可选(@MvcOptional)	—	商铺名称
channelType	ChannelType		1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
shopId	Long	否	可选(@MvcOptional)	`checker_relation`.`shop_id`	景区id（商铺id）
merchantId	Long			`checker_relation`.`merchant_id`	商户id
scenicName	String			—

响应参数

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

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

data 结构　PageInfo<CheckerResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`checker`.`id`	id
serialNo	Integer		—
name	String		—
nickname	String		`checker`.`nickname`
mobile	String		`checker`.`mobile`
shopName	String		—
merchantName	String		—
skuName	String		—
createTime	Date		`checker`.`create_time`
status	Integer		`checker`.`status`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
relationList	List<CheckerRelationAddRequest>		—
relationList[].thirdId	String		`checker`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`

示例

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

POST /checker/queryCheckerPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "name": "",
    "mobile": "13800000000",
    "createTime": "2026-01-01 12:00:00",
    "status": 0,
    "shopName": "",
    "channelType": "1",
    "shopId": 1,
    "merchantId": 1,
    "scenicName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "serialNo": 0,
        "name": "",
        "nickname": "",
        "mobile": "13800000000",
        "shopName": "",
        "merchantName": "",
        "skuName": "",
        "createTime": "2026-01-01 12:00:00",
        "status": 0,
        "channelType": "1",
        "relationList": [
          {
            "thirdId": "",
            "channelType": "1"
          }
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 isMerchant（sessionUserService.isMerchant）；查询详情（sessionUserService.getSessionUser）；调用 isShop（sessionUserService.isShop）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

权限判断
调用服务获取分页数据（现在是基于核销员主表的分页）
处理多渠道信息
查询关联关系，设置渠道信息
设置主渠道类型
处理多渠道关联信息
构建关系列表
设置到响应对象

前端调用方

dscp-html-manage queryCheckerPage exact

POST /checker/sskConsume 未使用App #

随手扣核销 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#sskConsume
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

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

方法内调用SignUtil.vaild

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	params	Map<String, Object>	是		—

请求参数 · Body

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

响应参数

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

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

data 结构　SskAppointmentResponseVo　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	boolean	—
timestamp	Long	—

示例

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

POST /checker/sskConsume?params=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": false,
    "timestamp": 0
  }
}

处理逻辑

操作日志checker / 随手扣核销

逻辑摘要调用 vaild（SignUtil.vaild）

内联注释

解密签名
获取业务数据
子平台业务逻辑 TODO
返回结果

前端调用方

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

POST /checker/unifiedConsume 在用App #

统一核销接口 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#unifiedConsume
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_operate_log

ControllerCheckerController#unifiedConsume

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

ServiceCheckerService#unifiedConsume （CheckerServiceImpl）

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

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

LockService.tryLockRedisCacheService.getCardCheckHandlerCache.getLockService.unlock

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerConsumeRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardNo	String	是	必填	—	卡号
userId	Long	是	必填	`system_operate_log`.`user_id`	核销人员id
channel	Integer	是	必填	—	核销渠道
skuId	String	是	必填	—	skuId
entranceId	String	是	必填	—	入口id
timestamp	Long			—
remark	String			—
platform	Integer			—	核销小程序=1 核销app=2

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	—	卡种名称
cardNumber	String	—	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
touristCheckList[].mcName	String	—	景区名称
touristCheckList[].checkTime	Date	—	核销时间
touristCheckList[].checkerName	String	—	核销人姓名
checkerRecordId	Long	—

示例

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

POST /checker/unifiedConsume

{
  "body": {
    "cardNo": "",
    "userId": 1,
    "channel": 0,
    "skuId": "",
    "entranceId": "",
    "timestamp": 0,
    "remark": "",
    "platform": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "data": "",
    "cardModelName": "",
    "cardNumber": "",
    "touristName": "",
    "touristMobile": "13800000000",
    "touristCertType": "",
    "touristIdCardNo": "",
    "touristPhotoUrl": "https://example.com/x.png",
    "isVerify": false,
    "remainTimes": 0,
    "checkedTimes": 0,
    "touristCheckList": [
      {
        "mcName": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerName": ""
      }
    ],
    "checkerRecordId": 1
  }
}

处理逻辑

逻辑摘要调用 tryLock（lockService.tryLock）；调用 isSskConsume（CardChannelUtil.isSskConsume）；查询详情（redisCacheService.get）

前端调用方

writeoff Consume exact

POST /checker/updateChecker 在用管理后台 #

核销人员表-更新 · CheckerController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checkerskuchecker_relationchecker_tickets_relationchecker_cqy_relationchecker_config

ControllerCheckerController#updateChecker

ServiceCheckerService#updateChecker （CheckerServiceImpl）

MapperCheckerMapper#queryList ⇒ 表 checker

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceCheckerRelationService#delete （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#deleteById ⇒ 表 checker_relation

ServiceCheckerRelationService#add （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#insert ⇒ 表 checker_relation

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

ServiceCheckerTicketsRelationService#delete （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#deleteById ⇒ 表 checker_tickets_relation

ServiceCheckerTicketsRelationService#add （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#insert ⇒ 表 checker_tickets_relation

ServiceCheckerCqyRelationService#queryList （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectList ⇒ 表 checker_cqy_relation

ServiceCheckerCqyRelationService#delete （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#deleteById ⇒ 表 checker_cqy_relation

ServiceCheckerCqyRelationService#add （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#insert ⇒ 表 checker_cqy_relation

ServiceCheckerConfigService#queryList （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#selectList ⇒ 表 checker_config

ServiceCheckerConfigService#delete （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#deleteById ⇒ 表 checker_config

ServiceCheckerConfigService#add （CheckerConfigServiceImpl）

MapperCheckerConfigMapper#insert ⇒ 表 checker_config

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

CheckerService.mustGet

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`checker`.`id`	id
name	String		—
mobile	String		`checker`.`mobile`
password	String		`checker`.`password`
merchantId	Long		`sku`.`merchant_id`
shopId	Long		`sku`.`shop_id`
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
skuIdList	List<Long[]>		—
ticketsSkuIdList	List<Long[]>		—
cqySkuIdList	List<Long[]>		—
status	Integer		`checker`.`status`
thirdId	String		`checker`.`third_id`	第三方卡种id
configList	List<String>		—
relationList	List<CheckerRelationAddRequest>		—
relationList[].thirdId	String		`checker`.`third_id`
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_relation`.`channel_type`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateChecker

{
  "body": {
    "id": 1,
    "name": "",
    "mobile": "13800000000",
    "password": "",
    "merchantId": 1,
    "shopId": 1,
    "channelType": "1",
    "skuIdList": "",
    "ticketsSkuIdList": "",
    "cqySkuIdList": "",
    "status": 0,
    "thirdId": "",
    "configList": "",
    "relationList": [
      {
        "thirdId": "",
        "channelType": "1"
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销人员

逻辑摘要更新（checkerService.updateChecker）

前端调用方

dscp-html-manage updateChecker exact

POST /checker/updateCheckerPwd 在用管理后台 #

更新核销人员密码 · CheckerController

基本信息

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

调用链路 & 涉及数据表

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

ControllerCheckerController#updateCheckerPwd

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

CheckerService.updateCheckerPwdCheckerService.mustGet

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		—
query	password	String	是		—

请求参数 · Body

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerPwd?id=…&password=…

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销人员密码

逻辑摘要更新（checkerService.updateCheckerPwd）

前端调用方

dscp-html-manage updateCheckerPwd exact

POST /checker/version 在用App #

（无摘要） · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#version
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerController#version

ServiceCheckerReleaseService#queryList （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#selectList ⇒ 表 checker_release

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/app-api/checker/version
uat	https://dscp-uat.hn12301.net/app-api/checker/version
pro	https://dscp-uat.hn12301.net/app-api/checker/version	（仓库 .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 结构　CheckVersionResponse　（object）

字段	类型	表 / 列
version	String	`checker_release`.`version`
memo	String	`checker_release`.`memo`
status	Integer	`checker_release`.`status`

示例

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

POST /checker/version

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "version": "",
    "memo": "",
    "status": 0
  }
}

处理逻辑

逻辑摘要列表查询（checkerReleaseService.queryList）

前端调用方

writeoff version exact

POST /checker/hhFaceConsume 在用App #

怀化核销 · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#hhFaceConsume
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker

ControllerCheckerController#hhFaceConsume

ServicecheckerService#hhFaceConsume

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HuaiHuaFaceConsumeRequest

字段	类型	表 / 列
userId	Long	—
skuId	String	—
entranceId	String	—
platform	Integer	—
idNo	String	—
machineNo	String	—
name	String	—
item	String	—

响应参数

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

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

data 结构　CheckerConsumeResponse　（object）

字段	类型	表 / 列	说明
data	Object	—	核销数据
cardModelName	String	—	卡种名称
cardNumber	String	—	卡号
touristName	String	—	游客姓名
touristMobile	String	—	游客手机号
touristCertType	String	—	证件类型
touristIdCardNo	String	—	证件号码
touristPhotoUrl	String	—	游客照片
isVerify	Boolean	—	是否已核销
remainTimes	Integer	—	本景区剩余使用次数
checkedTimes	Integer	—	本景区已使用次数
touristCheckList	List<TouristCheckerConsumeRecordBean>	—	核销记录列表
checkerRecordId	Long	—

示例

请求示例

{
  "userId": 0,
  "skuId": "",
  "entranceId": "",
  "platform": 0,
  "idNo": "",
  "machineNo": "",
  "name": "",
  "item": ""
}

响应示例

{
  "data": "",
  "cardModelName": "",
  "cardNumber": "",
  "touristName": "",
  "touristMobile": "",
  "touristCertType": "",
  "touristIdCardNo": "",
  "touristPhotoUrl": "",
  "isVerify": false,
  "remainTimes": 0,
  "checkedTimes": 0,
  "touristCheckList": [],
  "checkerRecordId": 0
}

处理逻辑

逻辑摘要checkerService.hhFaceConsume；完整实现见源码 CheckerController#hhFaceConsume

前端调用方

writeoff hhFaceConsume exact

POST /checker/cardUseNotify 未使用App #

核销-用卡信息通知（App端） · CheckerController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.CheckerController#cardUseNotify
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checker

ControllerCheckerController#cardUseNotify

ServicecheckerService#cardUseNotify

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardUseNotifyRequest

字段	类型	表 / 列
name	String	—
cardNo	String	—
idNo	String	—
latitude	String	—
longitude	String	—
useDate	String	—

响应参数

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

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

data 结构　String

透传/非结构化对象，以实际返回为准

示例

请求示例

{
  "name": "",
  "cardNo": "",
  "idNo": "",
  "latitude": "",
  "longitude": "",
  "useDate": ""
}

响应示例

{ }　// String

处理逻辑

逻辑摘要checkerService.cardUseNotify；完整实现见源码 CheckerController#cardUseNotify

前端调用方

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

CheckerCqyRelationController 0/6 在用

POST /checker/addCheckerCqyRelation 未使用管理后台 #

春秋游核销人员关联表-新增 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#addCheckerCqyRelation

转换BeanUtils.map → CheckerCqyRelation ⇒ 表 checker_cqy_relation

ServiceCheckerCqyRelationService#add （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#insert ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerCqyRelationAddRequest

字段	类型	取值/校验	表 / 列	说明
checkerId	Long		`checker_cqy_relation`.`checker_id`	名称
thirdId	String		`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String		`checker_cqy_relation`.`merchant_id`	商户id
shopId	String		`checker_cqy_relation`.`shop_id`	景区id
goodsId	String		`checker_cqy_relation`.`goods_id`	门票id
skuId	String		`checker_cqy_relation`.`sku_id`	skuId

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerCqyRelation

{
  "body": {
    "checkerId": 1,
    "thirdId": "",
    "channelType": "1",
    "merchantId": "",
    "shopId": "",
    "goodsId": "",
    "skuId": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销畅游云关系

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

前端调用方

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

POST /checker/deleteCheckerCqyRelation 未使用管理后台 #

春秋游核销人员关联表-删除 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#deleteCheckerCqyRelation

ServiceCheckerCqyRelationService#delete （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#deleteById ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerCqyRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销畅游云关系

逻辑摘要删除（checkerCqyRelationService.delete）

前端调用方

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

POST /checker/getCheckerCqyRelation 未使用管理后台 #

春秋游核销人员关联表-详情 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#getCheckerCqyRelation

ServiceCheckerCqyRelationService#get （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectById ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerCqyRelationResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`checker_cqy_relation`.`id`	id
checkerId	Long		`checker_cqy_relation`.`checker_id`
thirdId	String		`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String		`checker_cqy_relation`.`merchant_id`	商户id
shopId	String		`checker_cqy_relation`.`shop_id`	景区id
goodsId	String		`checker_cqy_relation`.`goods_id`	门票id
skuId	String		`checker_cqy_relation`.`sku_id`	skuId

示例

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

POST /checker/getCheckerCqyRelation

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "checkerId": 1,
    "thirdId": "",
    "channelType": "1",
    "merchantId": "",
    "shopId": "",
    "goodsId": "",
    "skuId": ""
  }
}

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerCqyRelationList 未使用管理后台 #

春秋游核销人员关联表-列表查询 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#queryCheckerCqyRelationList

转换BeanUtils.map → CheckerCqyRelationQuery

ServiceCheckerCqyRelationService#queryList （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectList ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerCqyRelationListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
checkerId	Long			`checker_cqy_relation`.`checker_id`
thirdId	String			`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType		1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String			`checker_cqy_relation`.`merchant_id`	商户id
shopId	String			`checker_cqy_relation`.`shop_id`	景区id
goodsId	String			`checker_cqy_relation`.`goods_id`	门票id
skuId	String			`checker_cqy_relation`.`sku_id`	skuId

响应参数

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

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

data 结构　List<CheckerCqyRelationResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`checker_cqy_relation`.`id`	id
checkerId	Long		`checker_cqy_relation`.`checker_id`
thirdId	String		`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String		`checker_cqy_relation`.`merchant_id`	商户id
shopId	String		`checker_cqy_relation`.`shop_id`	景区id
goodsId	String		`checker_cqy_relation`.`goods_id`	门票id
skuId	String		`checker_cqy_relation`.`sku_id`	skuId

示例

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

POST /checker/queryCheckerCqyRelationList

{
  "body": {
    "keywords": "",
    "checkerId": 1,
    "thirdId": "",
    "channelType": "1",
    "merchantId": "",
    "shopId": "",
    "goodsId": "",
    "skuId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "checkerId": 1,
      "thirdId": "",
      "channelType": "1",
      "merchantId": "",
      "shopId": "",
      "goodsId": "",
      "skuId": ""
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerCqyRelationPage 未使用管理后台 #

春秋游核销人员关联表-分页查询 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#queryCheckerCqyRelationPage

转换BeanUtils.map → CheckerCqyRelationQuery

ServiceCheckerCqyRelationService#queryPage （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectPage ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerCqyRelationPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
checkerId	Long			`checker_cqy_relation`.`checker_id`
thirdId	String			`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType		1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String			`checker_cqy_relation`.`merchant_id`	商户id
shopId	String			`checker_cqy_relation`.`shop_id`	景区id
goodsId	String			`checker_cqy_relation`.`goods_id`	门票id
skuId	String			`checker_cqy_relation`.`sku_id`	skuId

响应参数

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

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

data 结构　PageInfo<CheckerCqyRelationResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`checker_cqy_relation`.`id`	id
checkerId	Long		`checker_cqy_relation`.`checker_id`
thirdId	String		`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String		`checker_cqy_relation`.`merchant_id`	商户id
shopId	String		`checker_cqy_relation`.`shop_id`	景区id
goodsId	String		`checker_cqy_relation`.`goods_id`	门票id
skuId	String		`checker_cqy_relation`.`sku_id`	skuId

示例

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

POST /checker/queryCheckerCqyRelationPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "checkerId": 1,
    "thirdId": "",
    "channelType": "1",
    "merchantId": "",
    "shopId": "",
    "goodsId": "",
    "skuId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "checkerId": 1,
        "thirdId": "",
        "channelType": "1",
        "merchantId": "",
        "shopId": "",
        "goodsId": "",
        "skuId": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerCqyRelation 未使用管理后台 #

春秋游核销人员关联表-更新 · CheckerCqyRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_cqy_relation

ControllerCheckerCqyRelationController#updateCheckerCqyRelation

转换BeanUtils.map → CheckerCqyRelation ⇒ 表 checker_cqy_relation

ServiceCheckerCqyRelationService#update （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#updateById ⇒ 表 checker_cqy_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerCqyRelationUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`checker_cqy_relation`.`id`	id
checkerId	Long		`checker_cqy_relation`.`checker_id`
thirdId	String		`checker_cqy_relation`.`third_id`	第三方id
channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`checker_cqy_relation`.`channel_type`	类型(枚举:ChannelType)
merchantId	String		`checker_cqy_relation`.`merchant_id`	商户id
shopId	String		`checker_cqy_relation`.`shop_id`	景区id
goodsId	String		`checker_cqy_relation`.`goods_id`	门票id
skuId	String		`checker_cqy_relation`.`sku_id`	skuId

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerCqyRelation

{
  "body": {
    "id": 1,
    "checkerId": 1,
    "thirdId": "",
    "channelType": "1",
    "merchantId": "",
    "shopId": "",
    "goodsId": "",
    "skuId": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销畅游云关系

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

前端调用方

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

CheckerRelationController 0/6 在用

POST /checker/addCheckerRelation 未使用管理后台 #

核销人员关联表-新增 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#addCheckerRelation

转换BeanUtils.map → CheckerRelation ⇒ 表 checker_relation

ServiceCheckerRelationService#add （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#insert ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerRelationAddRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销关系

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

前端调用方

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

POST /checker/deleteCheckerRelation 未使用管理后台 #

核销人员关联表-删除 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#deleteCheckerRelation

ServiceCheckerRelationService#delete （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#deleteById ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销关系

逻辑摘要删除（checkerRelationService.delete）

前端调用方

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

POST /checker/getCheckerRelation 未使用管理后台 #

核销人员关联表-详情 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#getCheckerRelation

ServiceCheckerRelationService#get （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectById ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerRelationResponse　（object）

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

示例

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

POST /checker/getCheckerRelation

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

响应示例

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

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerRelationList 未使用管理后台 #

核销人员关联表-列表查询 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#queryCheckerRelationList

转换BeanUtils.map → CheckerRelationQuery

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerRelationListRequest

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

响应参数

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

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

data 结构　List<CheckerRelationResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`checker_relation`.`id`	id

示例

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

POST /checker/queryCheckerRelationList

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerRelationPage 未使用管理后台 #

核销人员关联表-分页查询 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#queryCheckerRelationPage

转换BeanUtils.map → CheckerRelationQuery

ServiceCheckerRelationService#queryPage （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectPage ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerRelationPageRequest

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

响应参数

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

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

data 结构　PageInfo<CheckerRelationResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`checker_relation`.`id`	id

示例

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

POST /checker/queryCheckerRelationPage

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerRelation 未使用管理后台 #

核销人员关联表-更新 · CheckerRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_relation

ControllerCheckerRelationController#updateCheckerRelation

转换BeanUtils.map → CheckerRelation ⇒ 表 checker_relation

ServiceCheckerRelationService#update （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#updateById ⇒ 表 checker_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerRelationUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销关系

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

前端调用方

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

CheckerReleaseController 0/6 在用

POST /checker/addCheckerRelease 未使用管理后台 #

核销版本信息-新增 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#addCheckerRelease

转换BeanUtils.map → CheckerRelease ⇒ 表 checker_release

ServiceCheckerReleaseService#add （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#insert ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerReleaseAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerRelease

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销版本发布

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

前端调用方

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

POST /checker/deleteCheckerRelease 未使用管理后台 #

核销版本信息-删除 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#deleteCheckerRelease

ServiceCheckerReleaseService#delete （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#deleteById ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerRelease

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销版本发布

逻辑摘要删除（checkerReleaseService.delete）

前端调用方

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

POST /checker/getCheckerRelease 未使用管理后台 #

核销版本信息-详情 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#getCheckerRelease

ServiceCheckerReleaseService#get （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#selectById ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerReleaseResponse　（object）

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

示例

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

POST /checker/getCheckerRelease

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

响应示例

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

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerReleaseList 未使用管理后台 #

核销版本信息-列表查询 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#queryCheckerReleaseList

转换BeanUtils.map → CheckerReleaseQuery

ServiceCheckerReleaseService#queryList （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#selectList ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerReleaseListRequest

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

响应参数

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

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

data 结构　List<CheckerReleaseResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`checker_release`.`id`	id

示例

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

POST /checker/queryCheckerReleaseList

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerReleasePage 未使用管理后台 #

核销版本信息-分页查询 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#queryCheckerReleasePage

转换BeanUtils.map → CheckerReleaseQuery

ServiceCheckerReleaseService#queryPage （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#selectPage ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerReleasePageRequest

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

响应参数

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

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

data 结构　PageInfo<CheckerReleaseResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`checker_release`.`id`	id

示例

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

POST /checker/queryCheckerReleasePage

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerRelease 未使用管理后台 #

核销版本信息-更新 · CheckerReleaseController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_release

ControllerCheckerReleaseController#updateCheckerRelease

转换BeanUtils.map → CheckerRelease ⇒ 表 checker_release

ServiceCheckerReleaseService#update （CheckerReleaseServiceImpl）

MapperCheckerReleaseMapper#updateById ⇒ 表 checker_release

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerReleaseUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerRelease

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销版本发布

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

前端调用方

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

CheckerTicketsRelationController 0/6 在用

POST /checker/addCheckerTicketsRelation 未使用管理后台 #

核销人员单票关联表-新增 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#addCheckerTicketsRelation

转换BeanUtils.map → CheckerTicketsRelation ⇒ 表 checker_tickets_relation

ServiceCheckerTicketsRelationService#add （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#insert ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerTicketsRelationAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/addCheckerTicketsRelation

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 新增核销门票关系

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

前端调用方

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

POST /checker/deleteCheckerTicketsRelation 未使用管理后台 #

核销人员单票关联表-删除 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#deleteCheckerTicketsRelation

ServiceCheckerTicketsRelationService#delete （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#deleteById ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/deleteCheckerTicketsRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 删除核销门票关系

逻辑摘要删除（checkerTicketsRelationService.delete）

前端调用方

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

POST /checker/getCheckerTicketsRelation 未使用管理后台 #

核销人员单票关联表-详情 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#getCheckerTicketsRelation

ServiceCheckerTicketsRelationService#get （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectById ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CheckerTicketsRelationResponse　（object）

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

示例

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

POST /checker/getCheckerTicketsRelation

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

响应示例

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

处理逻辑

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

前端调用方

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

POST /checker/queryCheckerTicketsRelationList 未使用管理后台 #

核销人员单票关联表-列表查询 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#queryCheckerTicketsRelationList

转换BeanUtils.map → CheckerTicketsRelationQuery

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerTicketsRelationListRequest

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

响应参数

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

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

data 结构　List<CheckerTicketsRelationResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`checker_tickets_relation`.`id`	id

示例

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

POST /checker/queryCheckerTicketsRelationList

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/queryCheckerTicketsRelationPage 未使用管理后台 #

核销人员单票关联表-分页查询 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#queryCheckerTicketsRelationPage

转换BeanUtils.map → CheckerTicketsRelationQuery

ServiceCheckerTicketsRelationService#queryPage （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectPage ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerTicketsRelationPageRequest

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

响应参数

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

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

data 结构　PageInfo<CheckerTicketsRelationResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`checker_tickets_relation`.`id`	id

示例

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

POST /checker/queryCheckerTicketsRelationPage

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

响应示例

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

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /checker/updateCheckerTicketsRelation 未使用管理后台 #

核销人员单票关联表-更新 · CheckerTicketsRelationController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_tickets_relation

ControllerCheckerTicketsRelationController#updateCheckerTicketsRelation

转换BeanUtils.map → CheckerTicketsRelation ⇒ 表 checker_tickets_relation

ServiceCheckerTicketsRelationService#update （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#updateById ⇒ 表 checker_tickets_relation

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerTicketsRelationUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /checker/updateCheckerTicketsRelation

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

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 更新核销门票关系

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

前端调用方

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

ConsumeEndController 10/10 在用

POST /consumeEnd/countCardCheckByChecker 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#countCardCheckByChecker
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerConsumeEndController#countCardCheckByChecker

MapperCardCheckService.getMapper#count ⇒ 表 card_check

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

CardCheckService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndQueryRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`card_check`.`checker_id`
cardModelId	Long		`card_check`.`card_model_id`
ticketsId	Long		—
dateRange	Date[]		—
keyWord	String		—

响应参数

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

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

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

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

POST /consumeEnd/countCardCheckByChecker

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "keyWord": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": 0
}

处理逻辑

逻辑摘要调用 applyWrapper（cardCheckService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（cardCheckService.getMapper）

内联注释

cardCheckQuery.setPageNo(request.getPageNo());
cardCheckQuery.setPageSize(request.getPageSize());

前端调用方

writeoff countCardCheckByChecker exact

POST /consumeEnd/getCardModelList 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#getCardModelList
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_modelchecker_relationcard_resource_rule

ControllerConsumeEndController#getCardModelList

ServiceCheckerRelationService#queryList （CheckerRelationServiceImpl）

MapperCheckerRelationMapper#selectList ⇒ 表 checker_relation

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

ServiceCardModelService#queryList （CardModelServiceImpl）

MapperCardModelMapper#selectList ⇒ 表 card_model

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		`card_model`.`id`

请求参数 · Body

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

响应参数

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

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

data 结构　List<CardModel>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`card_model`.`id`	旅游卡种ID，主键
name	String		`card_model`.`name`	卡种名称
grade	ModelGrade	11一类卡，2二类卡，3公式卡2二类卡3公式卡	`card_model`.`grade`	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModelType	CardModelType	1省级旅游卡2市州旅游卡	`card_model`.`card_model_type`	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
code	Integer		`card_model`.`code`	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号。
merchantId	Long		`card_model`.`merchant_id`	所属商户
shopId	Long		`card_model`.`shop_id`	所属商铺，关联商铺表id
shopName	String		`card_model`.`shop_name`	所属商铺名称
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`card_model`.`channel`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
thirdId	String		`card_model`.`third_id`	第三方id
price	Integer		`card_model`.`price`	卡种售价
expireDate	Date		`card_model`.`expire_date`	失效日期
publishDate	Date		`card_model`.`publish_date`	发行日期
isFace	Boolean		`card_model`.`is_face`	是否需要人脸
isActiveCode	Boolean		`card_model`.`is_active_code`	是否需要激活码
isRefresh	Boolean		`card_model`.`is_refresh`	二维码是否刷新
propagateStyle	String		`card_model`.`propagate_style`	宣传卡样url地址
propagatePic	String		`card_model`.`propagate_pic`	宣传图片url地址
propagateVid	String		`card_model`.`propagate_vid`	宣传视频url地址
description	String		`card_model`.`description`	图文详情
isDeleted	Boolean		`card_model`.`is_deleted`	是否删除
createdBy	Long		`card_model`.`created_by`	创建人id
createdTime	Date		`card_model`.`created_time`	创建时间
updatedBy	Long		`card_model`.`updated_by`	更新人id
updatedTime	Date		`card_model`.`updated_time`	修改时间

示例

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

POST /consumeEnd/getCardModelList?id=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "grade": "1",
      "cardModelType": "1",
      "code": 0,
      "merchantId": 1,
      "shopId": 1,
      "shopName": "",
      "channel": "1",
      "thirdId": "",
      "price": 0,
      "expireDate": "2026-01-01 12:00:00",
      "publishDate": "2026-01-01 12:00:00",
      "isFace": false,
      "isActiveCode": false,
      "isRefresh": false,
      "propagateStyle": "",
      "propagatePic": "https://example.com/x.png",
      "propagateVid": "",
      "description": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（checkerRelationService.queryList）；列表查询（cardResourceRuleService.queryList）；列表查询（cardModelService.queryList）

前端调用方

writeoff getCardModelList exact

POST /consumeEnd/getTicketsList 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#getTicketsList
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ticketschecker_tickets_relation

ControllerConsumeEndController#getTicketsList

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

ServiceTicketsService#queryList （TicketsServiceImpl）

MapperTicketsMapper#selectList ⇒ 表 tickets

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		`tickets`.`id`

请求参数 · Body

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

响应参数

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

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

data 结构　List<Tickets>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets`.`id`	商品id，主键
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

示例

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

POST /consumeEnd/getTicketsList?id=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "tags": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "status": "1",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "price": 0,
      "unitPrice": 0,
      "openDate": "2026-01-01 12:00:00",
      "remark1": "",
      "remark2": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（checkerTicketsRelationService.queryList）；列表查询（ticketsService.queryList）

前端调用方

writeoff getTicketsList exact

POST /consumeEnd/queryCardAppointment 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#queryCardAppointment
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerConsumeEndController#queryCardAppointment

转换BeanUtils.map → PageParam

MapperCardAppointmentService.getMapper#queryPage ⇒ 表 card_appointment

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

CardAppointmentService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndQueryRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`card_appointment`.`checker_id`
cardModelId	Long		`card_appointment`.`card_model_id`
ticketsId	Long		—
dateRange	Date[]		—
keyWord	String		—

响应参数

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

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

data 结构　PageInfo<CardAppointmentResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`card_appointment`.`id`	id
cardId	Long		`card_appointment`.`card_id`	卡id，关联card卡池表id
cardModelId	Long		`card_appointment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_appointment`.`card_model_name`	卡种名称
cardNumber	String		`card_appointment`.`card_number`	卡号
memberId	Long		`card_appointment`.`member_id`	持卡人ID
name	String		`card_appointment`.`name`	持卡人姓名
phone	String		`card_appointment`.`phone`	手机号码
identityNo	String		`card_appointment`.`identity_no`	身份证号码
resourceId	Long		`card_appointment`.`resource_id`	预约景区资源id
resourceName	String		`card_appointment`.`resource_name`	预约景区
timeId	Long		`card_appointment`.`time_id`
timeName	String		`card_appointment`.`time_name`	预约景区场次名称
appointSn	String		`card_appointment`.`appoint_sn`	预约单号15位，日期+当日内顺序号
appTime	Date		`card_appointment`.`app_time`	预约时间
status	AppointmentStatus	1预约成功2已关闭3已取消4已入园	`card_appointment`.`status`	预约状态(枚举:card.AppointmentStatus)，1预约成功，2预约失败，3已取消,4已入园
appointmentStatus	String		—	预约状态(枚举:card.AppointmentStatus)，1预约成功，2预约失败，3已取消,4已入园
isDeleted	Boolean		`card_appointment`.`is_deleted`	是否删除
createdBy	Long		`card_appointment`.`created_by`	创建人
createdTime	Date		`card_appointment`.`created_time`	创建时间
checkTime	Date		`card_appointment`.`check_time`	核销时间
checkerId	Long		`card_appointment`.`checker_id`	核销人员id
checkName	String		—	核销人员
isShowQr	Boolean		`card_appointment`.`is_show_qr`

示例

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

POST /consumeEnd/queryCardAppointment

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "keyWord": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardId": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "cardNumber": "",
        "memberId": 1,
        "name": "",
        "phone": "13800000000",
        "identityNo": "",
        "resourceId": 1,
        "resourceName": "",
        "timeId": 1,
        "timeName": "2026-01-01 12:00:00",
        "appointSn": "",
        "appTime": "2026-01-01 12:00:00",
        "status": "1",
        "appointmentStatus": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkName": "",
        "isShowQr": false
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（cardAppointmentService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（cardAppointmentService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

writeoff queryCardAppointment exact

POST /consumeEnd/queryCardCheck 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#queryCardCheck
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerConsumeEndController#queryCardCheck

转换BeanUtils.map → PageParam

MapperCardCheckService.getMapper#queryPage ⇒ 表 card_check

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

CardCheckService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndQueryRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`card_check`.`checker_id`
cardModelId	Long		`card_check`.`card_model_id`
ticketsId	Long		—
dateRange	Date[]		—
keyWord	String		—

响应参数

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

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

data 结构　PageInfo<CardCheckResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`card_check`.`id`	id
cardId	Long	`card_check`.`card_id`	卡id，关联card卡池表id
cardModelId	Long	`card_check`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	`card_check`.`card_model_name`	卡种名称
entranceId	Long	`card_check`.`entrance_id`	景区入口id
entranceName	String	`card_check`.`entrance_name`	景区入口名称
cardNumber	String	`card_check`.`card_number`	卡号
memberId	Long	`card_check`.`member_id`	持卡人ID
name	String	`card_check`.`name`	持卡人姓名
phone	String	`card_check`.`phone`	手机号码
identityNo	String	`card_check`.`identity_no`	身份证号码
checkTime	Date	`card_check`.`check_time`	核销时间
checkerId	Long	`card_check`.`checker_id`	核销人id
checkerName	String	`card_check`.`checker_name`	核销人员姓名
resourceName	String	`card_check`.`resource_name`	预约景区名称
facePhoto	String	`card_check`.`face_photo`	人脸图片地址
isDeleted	Boolean	`card_check`.`is_deleted`

示例

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

POST /consumeEnd/queryCardCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "keyWord": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardId": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "entranceId": 1,
        "entranceName": "",
        "cardNumber": "",
        "memberId": 1,
        "name": "",
        "phone": "13800000000",
        "identityNo": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": "",
        "resourceName": "",
        "facePhoto": "",
        "isDeleted": false
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（cardCheckService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（cardCheckService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

核销员关联的资源

前端调用方

writeoff queryCardCheck exact

POST /consumeEnd/queryTicketsCheck 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#queryTicketsCheck
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerConsumeEndController#queryTicketsCheck

ServiceTicketsCheckService#queryPage （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#selectPage ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndQueryRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`tickets_check`.`checker_id`
cardModelId	Long		—
ticketsId	Long		`tickets_check`.`tickets_id`
dateRange	Date[]		—
keyWord	String		—

响应参数

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

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

data 结构　PageInfo<TicketsCheckResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`tickets_check`.`id`	id
orderId	Long		`tickets_check`.`order_id`	订单号，order表id
orderTouristId	Long		`tickets_check`.`order_tourist_id`	订单号，order表id
ticketsId	Long		`tickets_check`.`tickets_id`
ticketsName	String		`tickets_check`.`tickets_name`
ticketsSkuId	Long		`tickets_check`.`tickets_sku_id`	产品SKU id，sku表id
ticketsSkuIdType	String		—
useDate	String		—
ticketsSkuName	String		`tickets_check`.`tickets_sku_name`	产品SKU
checkerId	Long		`tickets_check`.`checker_id`	核销人
checkerName	String		`tickets_check`.`checker_name`	核销人姓名
checkTime	Date		`tickets_check`.`check_time`	核销时间
name	String		`tickets_check`.`name`	持卡人姓名
phone	String		`tickets_check`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_check`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_check`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_check`.`is_deleted`	是否删除
status	Integer		`tickets_check`.`status`	状态
updatedBy	String		`tickets_check`.`updated_by`
updatedTime	Date		`tickets_check`.`updated_time`
createdBy	String		`tickets_check`.`created_by`
createdTime	Date		`tickets_check`.`created_time`
qrcode	String		`tickets_check`.`qrcode`
shopId	Long		`tickets_check`.`shop_id`
shopName	String		`tickets_check`.`shop_name`

示例

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

POST /consumeEnd/queryTicketsCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "keyWord": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "orderTouristId": 1,
        "ticketsId": 1,
        "ticketsName": "",
        "ticketsSkuId": 1,
        "ticketsSkuIdType": "",
        "useDate": "2026-01-01 12:00:00",
        "ticketsSkuName": "",
        "checkerId": 1,
        "checkerName": "",
        "checkTime": "2026-01-01 12:00:00",
        "name": "",
        "phone": "13800000000",
        "idType": "1",
        "identityNo": "",
        "isDeleted": false,
        "status": 0,
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "qrcode": "",
        "shopId": 1,
        "shopName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

前端调用方

writeoff queryTicketsCheckEnd exact

POST /consumeEnd/resetCheckerPwd 在用App #

重置核销员密码 · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#resetCheckerPwd
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerConsumeEndController#resetCheckerPwd

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

CheckerService.updateCheckerPwdCheckerService.mustGet

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		—
query	password	String	是		—

请求参数 · Body

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /consumeEnd/resetCheckerPwd?id=…&password=…

响应示例

（void，无响应体）

处理逻辑

操作日志checker / 重置核销员密码

逻辑摘要更新（checkerService.updateCheckerPwd）

前端调用方

writeoff resetCheckerPwd exact

POST /consumeEnd/statCardAppointment 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#statCardAppointment
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerConsumeEndController#statCardAppointment

MapperCardAppointmentMapper#satCardAppointment ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`card_appointment`.`checker_id`
cardModelId	Long		`card_appointment`.`card_model_id`
ticketsId	Long		—
goodsId	Long		—
dateRange	Date[]		—
statType	Integer		—	1=全部数据 2=按日统计 3=按月统计 4=按年统计

响应参数

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

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

data 结构　ConsumeEndStatResponse　（object）

字段	类型	表 / 列
totalTimes	Integer	—
totalTourists	Integer	—
cardCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardCheckPageData[].dateRange	String	—
cardCheckPageData[].totalTimes	Integer	—
cardCheckPageData[].totalTourists	Integer	—
cardAppointmentPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardAppointmentPageData[].dateRange	String	—
cardAppointmentPageData[].totalTimes	Integer	—
cardAppointmentPageData[].totalTourists	Integer	—
ticketsCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
ticketsCheckPageData[].dateRange	String	—
ticketsCheckPageData[].totalTimes	Integer	—
ticketsCheckPageData[].totalTourists	Integer	—
cqyCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cqyCheckPageData[].dateRange	String	—
cqyCheckPageData[].totalTimes	Integer	—
cqyCheckPageData[].totalTourists	Integer	—

示例

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

POST /consumeEnd/statCardAppointment

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "goodsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "statType": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalTimes": 0,
    "totalTourists": 0,
    "cardCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cardAppointmentPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "ticketsCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cqyCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 satCardAppointment（cardAppointmentMapper.satCardAppointment）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

writeoff statCardAppointment exact

POST /consumeEnd/statCardCheck 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#statCardCheck
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerConsumeEndController#statCardCheck

MapperCardCheckMapper#satCardCheck ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`card_check`.`checker_id`
cardModelId	Long		`card_check`.`card_model_id`
ticketsId	Long		—
goodsId	Long		—
dateRange	Date[]		—
statType	Integer		—	1=全部数据 2=按日统计 3=按月统计 4=按年统计

响应参数

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

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

data 结构　ConsumeEndStatResponse　（object）

字段	类型	表 / 列
totalTimes	Integer	—
totalTourists	Integer	—
cardCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardCheckPageData[].dateRange	String	—
cardCheckPageData[].totalTimes	Integer	—
cardCheckPageData[].totalTourists	Integer	—
cardAppointmentPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardAppointmentPageData[].dateRange	String	—
cardAppointmentPageData[].totalTimes	Integer	—
cardAppointmentPageData[].totalTourists	Integer	—
ticketsCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
ticketsCheckPageData[].dateRange	String	—
ticketsCheckPageData[].totalTimes	Integer	—
ticketsCheckPageData[].totalTourists	Integer	—
cqyCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cqyCheckPageData[].dateRange	String	—
cqyCheckPageData[].totalTimes	Integer	—
cqyCheckPageData[].totalTourists	Integer	—

示例

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

POST /consumeEnd/statCardCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "goodsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "statType": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalTimes": 0,
    "totalTourists": 0,
    "cardCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cardAppointmentPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "ticketsCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cqyCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 satCardCheck（cardCheckMapper.satCardCheck）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

writeoff statCardCheck exact

POST /consumeEnd/statTicketsCheck 在用App #

（无摘要） · ConsumeEndController

基本信息

控制器	com.jxxx.dscp.api.controller.checker.ConsumeEndController#statTicketsCheck
所属模块	核销 `checker`
暴露渠道	App （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerConsumeEndController#statTicketsCheck

MapperTicketsCheckMapper#statTicketsCheck ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　ConsumeEndStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`tickets_check`.`checker_id`
cardModelId	Long		—
ticketsId	Long		`tickets_check`.`tickets_id`
goodsId	Long		—
dateRange	Date[]		—
statType	Integer		—	1=全部数据 2=按日统计 3=按月统计 4=按年统计

响应参数

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

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

data 结构　ConsumeEndStatResponse　（object）

字段	类型	表 / 列
totalTimes	Integer	—
totalTourists	Integer	—
cardCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardCheckPageData[].dateRange	String	—
cardCheckPageData[].totalTimes	Integer	—
cardCheckPageData[].totalTourists	Integer	—
cardAppointmentPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardAppointmentPageData[].dateRange	String	—
cardAppointmentPageData[].totalTimes	Integer	—
cardAppointmentPageData[].totalTourists	Integer	—
ticketsCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
ticketsCheckPageData[].dateRange	String	—
ticketsCheckPageData[].totalTimes	Integer	—
ticketsCheckPageData[].totalTourists	Integer	—
cqyCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cqyCheckPageData[].dateRange	String	—
cqyCheckPageData[].totalTimes	Integer	—
cqyCheckPageData[].totalTourists	Integer	—

示例

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

POST /consumeEnd/statTicketsCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "goodsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "statType": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalTimes": 0,
    "totalTourists": 0,
    "cardCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cardAppointmentPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "ticketsCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cqyCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 statTicketsCheck（ticketsCheckMapper.statTicketsCheck）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

writeoff statTicketsCheck exact

CheckerFaceLogController 1/1 在用

POST /checker/queryCheckerFaceLogPage 在用管理后台 #

人脸核销记录-分页查询 · CheckerFaceLogController

基本信息

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

调用链路 & 涉及数据表

涉及数据表checker_face_log

ControllerCheckerFaceLogController#queryCheckerFaceLogPage

ServicecheckerFaceLogService#queryPage

MapperCheckerFaceLogMapper#queryPage ⇒ 表 checker_face_log

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CheckerFaceLogPageRequest

字段	类型	表 / 列	说明
pageNo	Integer	—	当前页面
pageSize	Integer	—	每页记录数
orderBy	String	—	排序语句
userId	Long	—	核销员id
checkerName	String	—	核销员名称(模糊)
skuId	String	—	景区skuId
shopName	String	—	景区名称(模糊)
result	Integer	—	核销结果：1成功 0失败
cardNumber	String	—
phone	String	—
createdTimeRange	Date[]	—	操作时间范围 [开始, 结束]
keywords	String	—	关键字

响应参数

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

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

data 结构　CheckerFaceLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	—	主键id
userId	Long	—	核销员id
checkerName	String	—	核销员名称
skuId	String	—	景区skuId
shopName	String	—	景区名称
faceImgUrl	String	—	核销时上传的人脸图片地址
threshold	Double	—	人脸搜索对比阈值
confidence	Double	—	搜索命中的实际置信度
matchFaceId	String	—	命中的阿里云人脸FaceId
matchFaceUrl	String	—	命中的注册人脸照片地址(对比对象)
matchName	String	—	命中的注册人员姓名(对比对象)
matchCardId	Long	—	命中人脸绑定的卡id
matchIdentityNo	String	—	命中的身份证号(核销按该证件号查 card_bind)
cardNumber	String	—	命中人脸绑定的卡号
phone	String	—	命中人脸绑定的手机号
result	Integer	—	核销结果：1成功 0失败
failReason	String	—	失败/不通过原因
searchResponse	String	—	searchFace 返回的完整信息(JSON字符串)
createdTime	Date	—	操作时间

示例

请求示例

{
  "pageNo": 0,
  "pageSize": 0,
  "orderBy": "",
  "userId": 0,
  "checkerName": "",
  "skuId": "",
  "shopName": "",
  "result": 0,
  "cardNumber": "",
  "phone": "",
  "createdTimeRange": "",
  "keywords": ""
}

响应示例

{
  "id": 0,
  "userId": 0,
  "checkerName": "",
  "skuId": "",
  "shopName": "",
  "faceImgUrl": "",
  "threshold": "0.00",
  "confidence": "0.00",
  "matchFaceId": "",
  "matchFaceUrl": "",
  "matchName": "",
  "matchCardId": 0,
  "matchIdentityNo": "",
  "cardNumber": "",
  "phone": "",
  "result": 0,
  "failReason": "",
  "searchResponse": "",
  "createdTime": ""
}

处理逻辑

逻辑摘要checkerFaceLogService.queryPage；完整实现见源码 CheckerFaceLogController#queryCheckerFaceLogPage

前端调用方

dscp-html-manage queryCheckerFaceLogPage exact