旅游卡 card

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

CardAppointmentController 5/11 在用

POST /cardAppointment/addCardAppointment 未使用小程序 #

景区预约 · CardAppointmentController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardAppointmentController#addCardAppointment
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointmentcardcard_resource_calendercard_resource_calender_time_slotcard_resource_rulecard_package_rulecard_package_rule_resourcecard_package_rule_resource_packetcard_bindorder

ControllerCardAppointmentController#addCardAppointment

ServiceCardAppointmentService#addCardAppointment （CardAppointmentServiceImpl）

转换BeanUtils.map → CardAppointment ⇒ 表 card_appointment

MapperCardService.getMapper#selectOne ⇒ 表 card

MapperCardAppointmentService.getMapper#count ⇒ 表 card_appointment

MapperCardResourceCalenderService.getMapper#selectOne ⇒ 表 card_resource_calender

MapperCardResourceCalenderTimeSlotService.getMapper#get ⇒ 表 card_resource_calender_time_slot

ServiceCardResourceRuleService#get （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectById ⇒ 表 card_resource_rule

ServiceCardService#get （CardServiceImpl）

MapperCardMapper#selectById ⇒ 表 card

ServiceCardPackageRuleService#queryList （CardPackageRuleServiceImpl）

MapperCardPackageRuleMapper#selectList ⇒ 表 card_package_rule

ServiceCardPackageRuleResourceService#queryList （CardPackageRuleResourceServiceImpl）

MapperCardPackageRuleResourceMapper#selectList ⇒ 表 card_package_rule_resource

ServiceCardPackageRuleResourcePacketService#queryList （CardPackageRuleResourcePacketServiceImpl）

MapperCardPackageRuleResourcePacketMapper#selectList ⇒ 表 card_package_rule_resource_packet

ServiceCardResourceCalenderTimeSlotService#get （CardResourceCalenderTimeSlotServiceImpl）

MapperCardResourceCalenderTimeSlotMapper#selectById ⇒ 表 card_resource_calender_time_slot

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

ServiceCardResourceCalenderService#updateStock （CardResourceCalenderServiceImpl）

MapperCardResourceCalenderMapper#updateStock ⇒ 表 card_resource_calender

ServiceCardResourceCalenderTimeSlotService#updateStock （CardResourceCalenderTimeSlotServiceImpl）

MapperCardResourceCalenderTimeSlotMapper#updateStock ⇒ 表 card_resource_calender_time_slot

ServiceOrderService#add （OrderServiceImpl）

MapperOrderMapper#insert ⇒ 表 order

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

CardModelCache.getCardPackageRuleResourcePacketService.getGroupsChaosTransactionTemplate.executeSkuCache.getShopCache.getGoodsCache.getMemberCache.getSessionMemberService.getSessionId

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
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`	卡号
resourceId	Long			`card_appointment`.`resource_id`	预约景区资源rule_id
timeId	Long			`card_appointment`.`time_id`	预约景区场次id
resourceName	String			`card_appointment`.`resource_name`	预约景区名称
appTime	Date			`card_appointment`.`app_time`	预约时间

响应参数

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

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

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

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

POST /cardAppointment/addCardAppointment

{
  "body": {
    "cardId": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "cardNumber": "",
    "resourceId": 1,
    "timeId": 1,
    "resourceName": "",
    "appTime": "2026-01-01 12:00:00"
  }
}

响应示例

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

处理逻辑

操作日志card / 新增预约

逻辑摘要新增（cardAppointmentService.addCardAppointment）；查询详情（sessionService.getSessionId）

前端调用方

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

POST /cardAppointment/cancelCardAppointment 在用管理后台 #

取消预约 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_resource_calendercard_resource_calender_time_slotopenapi_nydm_orderopenapi_xjhlc_orderopenapi_ybx_orderopenapi_ybx_ticketopenapi_pft_record

ControllerCardAppointmentController#cancelCardAppointment

ServiceCardAppointmentService#cancelCardAppointment （CardAppointmentServiceImpl）

MapperCardResourceCalenderService.getMapper#selectOne ⇒ 表 card_resource_calender

ServiceCardResourceCalenderService#updateStock （CardResourceCalenderServiceImpl）

MapperCardResourceCalenderMapper#updateStock ⇒ 表 card_resource_calender

ServiceCardResourceCalenderTimeSlotService#get （CardResourceCalenderTimeSlotServiceImpl）

MapperCardResourceCalenderTimeSlotMapper#selectById ⇒ 表 card_resource_calender_time_slot

ServiceCardResourceCalenderTimeSlotService#updateStock （CardResourceCalenderTimeSlotServiceImpl）

MapperCardResourceCalenderTimeSlotMapper#updateStock ⇒ 表 card_resource_calender_time_slot

ServiceOpenapiNydmOrderService#get （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#selectById ⇒ 表 openapi_nydm_order

ServiceOpenapiNydmOrderService#update （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#updateById ⇒ 表 openapi_nydm_order

ServiceOpenapiXjhlcOrderService#get （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#selectById ⇒ 表 openapi_xjhlc_order

ServiceOpenapiYbxOrderService#get （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#selectById ⇒ 表 openapi_ybx_order

ServiceOpenapiYbxTicketService#queryList （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#selectList ⇒ 表 openapi_ybx_ticket

ServiceOpenapiYbxOrderService#update （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#updateById ⇒ 表 openapi_ybx_order

ServiceOpenapiYbxTicketService#update （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#updateById ⇒ 表 openapi_ybx_ticket

ServiceOpenapiPftRecordService#get （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#selectById ⇒ 表 openapi_pft_record

ServiceOpenapiPftRecordService#update （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#updateById ⇒ 表 openapi_pft_record

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

ChaosTransactionTemplate.executeNydmService.returnTicketOpenapiNydmOrderService.mustGetOpenapiNydmOrderService.updateXjhlcService.cancelOrderOpenapiXjhlcOrderService.getOpenapiXjhlcOrderService.updateCardAppointmentService.getCardAppointmentService.cancelCardAppointmentYouBaoXingService.refundPftService.orderChangeProRestTemplate.postForObjectSessionMemberService.getSessionId

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAppointment/cancelCardAppointment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 取消预约

逻辑摘要调用 cancelCardAppointment（cardAppointmentService.cancelCardAppointment）；查询详情（sessionService.getSessionId）

前端调用方

dscp-html-manage cancelCardAppointment exact

POST /cardAppointment/cardAppointmentPage 未使用小程序 #

查询用户的预约记录 · CardAppointmentController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardAppointmentController#cardAppointmentPage
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointmentcard

ControllerCardAppointmentController#cardAppointmentPage

ServiceCardAppointmentService#queryPage （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#selectPage ⇒ 表 card_appointment

ServiceCardService#get （CardServiceImpl）

MapperCardMapper#selectById ⇒ 表 card

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

SessionMemberService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/mp-api/cardAppointment/cardAppointmentPage
uat	https://dscp-uat.hn12301.net/mp-api/cardAppointment/cardAppointmentPage
pro	https://dscp-uat.hn12301.net/mp-api/cardAppointment/cardAppointmentPage	（仓库 .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 结构　PageInfo<CardAppointmentPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	String		`card_appointment`.`id`	id
cardId	String		`card_appointment`.`card_id`	卡ID
cardNumber	String		`card_appointment`.`card_number`	卡号
resourceName	String		`card_appointment`.`resource_name`	预约景区
resourceId	String		`card_appointment`.`resource_id`
appTime	Date		`card_appointment`.`app_time`	预约时间
status	String		`card_appointment`.`status`
createdTime	Date		`card_appointment`.`created_time`	预约下单时间
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`card_appointment`.`channel`	发卡渠道（1=北京；2=三省卡；3=数字平台；4=质惠游）
thirdId	String		`card_appointment`.`third_id`	卡种id

示例

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

POST /cardAppointment/cardAppointmentPage

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": "",
        "cardId": "",
        "cardNumber": "",
        "resourceName": "",
        "resourceId": "",
        "appTime": "2026-01-01 12:00:00",
        "status": "",
        "createdTime": "2026-01-01 12:00:00",
        "channel": "1",
        "thirdId": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

前端调用方

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

POST /cardAppointment/deleteCardAppointment 在用管理后台 #

预约记录表-删除 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerCardAppointmentController#deleteCardAppointment

ServiceCardAppointmentService#update （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#updateById ⇒ 表 card_appointment

ServiceCardAppointmentService#delete （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#deleteById ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAppointment/deleteCardAppointment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 删除预约

逻辑摘要更新（cardAppointmentService.update）；删除（cardAppointmentService.delete）

前端调用方

dscp-html-manage deleteCardAppointment exact

ANY /cardAppointment/exportCardAppointment 未使用管理后台 #

（无摘要） · CardAppointmentController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardAppointmentController#exportCardAppointment
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_appointmentchecker

ControllerCardAppointmentController#exportCardAppointment

转换BeanUtils.map → CardAppointmentQuery

MapperCardAppointmentService.getMapper#queryList ⇒ 表 card_appointment

ServiceCheckerService#get （CheckerServiceImpl）

MapperCheckerMapper#selectById ⇒ 表 checker

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

CardAppointmentService.applyWrapperSessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShopMemberCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

ANY /cardAppointment/exportCardAppointment

响应示例

（void，无响应体）

处理逻辑

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

内联注释

Card查询已做全局数据权限，会自动拼接权限sql
wrapper.exists("SELECT 1 FROM card c WHERE c.id = card_id");
卡状态

前端调用方

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

POST /cardAppointment/getCardAppointment 在用管理后台 #

预约记录表-详情 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

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

ControllerCardAppointmentController#getCardAppointment

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

CardAppointmentService.getCardAppointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardAppointmentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		—	id
cardId	Long		—	卡id，关联card卡池表id
cardModelId	Long		—	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		—	卡种名称
cardNumber	String		—	卡号
memberId	Long		—	持卡人ID
name	String		—	持卡人姓名
phone	String		—	手机号码
identityNo	String		—	身份证号码
resourceId	Long		—	预约景区资源id
resourceName	String		—	预约景区
timeId	Long		—
timeName	String		—	预约景区场次名称
appointSn	String		—	预约单号15位，日期+当日内顺序号
appTime	Date		—	预约时间
status	AppointmentStatus	1预约成功2已关闭3已取消4已入园	—	预约状态(枚举:card.AppointmentStatus)，1预约成功，2预约失败，3已取消,4已入园
appointmentStatus	String		—	预约状态(枚举:card.AppointmentStatus)，1预约成功，2预约失败，3已取消,4已入园
isDeleted	Boolean		—	是否删除
createdBy	Long		—	创建人
createdTime	Date		—	创建时间
checkTime	Date		—	核销时间
checkerId	Long		—	核销人员id
checkName	String		—	核销人员
isShowQr	Boolean		—

示例

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

POST /cardAppointment/getCardAppointment

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "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
  }
}

处理逻辑

逻辑摘要查询详情（cardAppointmentService.getCardAppointment）

前端调用方

dscp-html-manage getCardAppointment exact

POST /cardAppointment/queryCardAppointmentList 未使用管理后台 #

预约记录表-列表查询 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerCardAppointmentController#queryCardAppointmentList

转换BeanUtils.map → CardAppointmentQuery

ServiceCardAppointmentService#queryList （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#selectList ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentListRequest

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

响应参数

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

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

data 结构　List<CardAppointmentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
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 /cardAppointment/queryCardAppointmentList

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "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
    }
  ]
}

处理逻辑

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

前端调用方

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

POST /cardAppointment/queryCardAppointmentPage 在用管理后台 #

预约记录表-分页查询 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointmentcard_modelsystem_user_rolesystem_rolechecker

ControllerCardAppointmentController#queryCardAppointmentPage

转换BeanUtils.map → CardAppointmentQuery

转换BeanUtils.map → PageParam

MapperCardAppointmentService.getMapper#queryPage ⇒ 表 card_appointment

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceUserRoleService#get （UserRoleServiceImpl）

MapperUserRoleMapper#selectById ⇒ 表 system_user_role

ServiceRoleService#get （RoleServiceImpl）

MapperRoleMapper#selectById ⇒ 表 system_role

ServiceCheckerService#get （CheckerServiceImpl）

MapperCheckerMapper#selectById ⇒ 表 checker

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

CardAppointmentService.applyWrapperSessionUserService.getSessionUserSessionUserService.isMerchantSessionUserService.isShopMemberCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelName	String	否	可选(@MvcOptional)	`card_appointment`.`card_model_name`	卡种名称
cardModelIds	List<Long>	否	可选(@MvcOptional)	—	卡种ID列表，用于按多个卡种过滤
cardNumber	String	否	可选(@MvcOptional)	`card_appointment`.`card_number`	卡号
phone	String	否	可选(@MvcOptional)	`card_appointment`.`phone`	手机号码
identityNo	String	否	可选(@MvcOptional)	`card_appointment`.`identity_no`	身份证号码
resourceName	String	否	可选(@MvcOptional)	`card_appointment`.`resource_name`	景区名称
appTimeRange	Date[]			—	预约时间范围
status	AppointmentStatus	否	1预约成功2已关闭3已取消4已入园	`card_appointment`.`status`	预约状态(枚举:card.AppointmentStatus)，1预约成功，2预约失败，3已取消,4已入园
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（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 /cardAppointment/queryCardAppointmentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelName": "",
    "cardModelIds": "",
    "cardNumber": "",
    "phone": "13800000000",
    "identityNo": "",
    "resourceName": "",
    "appTimeRange": "2026-01-01 12:00:00",
    "status": "1",
    "keywords": ""
  }
}

响应示例

{
  "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
  }
}

处理逻辑

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

内联注释

Card查询已做全局数据权限，会自动拼接权限sql
wrapper.exists("SELECT 1 FROM card c WHERE c.id = card_id");
卡状态

前端调用方

dscp-html-manage queryCardAppointmentPage exact

POST /cardAppointment/showCardAppointment 在用管理后台 #

（无摘要） · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerCardAppointmentController#showCardAppointment

ServiceCardAppointmentService#get （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#selectById ⇒ 表 card_appointment

ServiceCardAppointmentService#update （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#updateById ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAppointment/showCardAppointment

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

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（cardAppointmentService.get）；更新（cardAppointmentService.update）

前端调用方

dscp-html-manage showCardAppointment exact

POST /cardAppointment/test/verifyFace 未使用H5 #

人脸核销测试方法 · CardAppointmentController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardAppointmentController#verifyFace
所属模块	旅游卡 `card`
暴露渠道	H5 （@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member_facecardcard_resource_rulecard_bindcard_appointmentcard_check

ControllerCardAppointmentController#verifyFace

MapperMemberFaceService.getMapper#selectList ⇒ 表 member_face

MapperCardService.getMapper#selectById ⇒ 表 card

MapperCardResourceRuleService.getMapper#selectOne ⇒ 表 card_resource_rule

MapperCardBindService.getMapper#selectList ⇒ 表 card_bind

MapperCardAppointmentService.getMapper#selectOne ⇒ 表 card_appointment

MapperCardCheckService.getMapper#count ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	skuId	Long			`card_resource_rule`.`sku_id`
query	isReturnList	Boolean			—

请求参数 · Body

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAppointment/test/verifyFace?skuId=…&isReturnList=…

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（memberFaceService.getMapper）；调用 isEmpty（CollectionUtils.isEmpty）；查询详情（cardService.getMapper）

内联注释

根据人脸库人员ID查询出用户绑定的卡
cardId列表
确定卡资源信息
用户的卡id集合
当前时间
先查询出用户所有可用的卡列表
过滤没有预约的卡
查询旅游卡预约信息

前端调用方

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

POST /cardAppointment/updateCardAppointment 未使用管理后台 #

预约记录表-更新 · CardAppointmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerCardAppointmentController#updateCardAppointment

转换BeanUtils.map → CardAppointment ⇒ 表 card_appointment

ServiceCardAppointmentService#update （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#updateById ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAppointment/updateCardAppointment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 更新预约

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

前端调用方

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

CardAppointmentPaymentController 1/6 在用

POST /card/addCardAppointmentPayment 未使用管理后台 #

预约支付流水表-新增 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#addCardAppointmentPayment

转换BeanUtils.map → CardAppointmentPayment ⇒ 表 card_appointment_payment

ServiceCardAppointmentPaymentService#add （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#insert ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentPaymentAddRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /card/addCardAppointmentPayment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 新增预约支付

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

前端调用方

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

POST /card/deleteCardAppointmentPayment 未使用管理后台 #

预约支付流水表-删除 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#deleteCardAppointmentPayment

ServiceCardAppointmentPaymentService#delete （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#deleteById ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /card/deleteCardAppointmentPayment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 删除预约支付

逻辑摘要删除（cardAppointmentPaymentService.delete）

前端调用方

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

POST /card/getCardAppointmentPayment 未使用管理后台 #

预约支付流水表-详情 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#getCardAppointmentPayment

ServiceCardAppointmentPaymentService#get （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#selectById ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardAppointmentPaymentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_appointment_payment`.`id`	id
appointmentId	Long		`card_appointment_payment`.`appointment_id`	预约id
cardModelId	Long		`card_appointment_payment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_appointment_payment`.`card_model_name`	卡种名称
thirdId	String		`card_appointment_payment`.`third_id`	卡种第三方类型
cardNumber	String		`card_appointment_payment`.`card_number`	卡号
resourceId	Long		`card_appointment_payment`.`resource_id`	预约景区资源id,关联card_resource_rule卡种资源表id
resourceName	String		`card_appointment_payment`.`resource_name`	预约景区资源,冗余字段
timeId	Long		`card_appointment_payment`.`time_id`	预约景区场次id,关联card_resource_calender_time_slot表id
timeName	String		`card_appointment_payment`.`time_name`	预约景区场次名称
appTime	Date		`card_appointment_payment`.`app_time`	预约时间
name	String		`card_appointment_payment`.`name`	持卡人姓名
phone	String		`card_appointment_payment`.`phone`	手机号码
identityNo	String		`card_appointment_payment`.`identity_no`	身份证号码
channel	Integer		`card_appointment_payment`.`channel`	渠道
orderNo	String		`card_appointment_payment`.`order_no`	订单号
orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	`card_appointment_payment`.`order_type`	订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡
orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	`card_appointment_payment`.`order_source`	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`card_appointment_payment`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderPhone	String		`card_appointment_payment`.`order_phone`	下单人手机
paymentMode	PaymentMode	1积分2优惠券3微信4支付宝5工商银行6其他7湘工惠	`card_appointment_payment`.`payment_mode`	交易方式(枚举:PaymentMode)，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他
paymentAmount	Integer		`card_appointment_payment`.`payment_amount`	交易金额
paymentCurrency	Integer		`card_appointment_payment`.`payment_currency`	交易币种（1=人民币）
transactionNo	String		`card_appointment_payment`.`transaction_no`	支付中心otg的交易流水
payTime	Date		`card_appointment_payment`.`pay_time`	支付时间
refundNo	String		`card_appointment_payment`.`refund_no`	退款单号
refundAmount	Integer		`card_appointment_payment`.`refund_amount`	退款交易金额
refundCurrency	Integer		`card_appointment_payment`.`refund_currency`	退款交易币种（1=人民币）
refundTransactionNo	String		`card_appointment_payment`.`refund_transaction_no`	支付中心otg的交易流水
refundTime	Date		`card_appointment_payment`.`refund_time`	退款时间
remark	String		`card_appointment_payment`.`remark`	备注(如:积分抵扣，优惠券抵扣)
status	Integer		`card_appointment_payment`.`status`	状态(1=成功 )
updatedBy	String		`card_appointment_payment`.`updated_by`
updatedTime	Date		`card_appointment_payment`.`updated_time`
createdBy	String		`card_appointment_payment`.`created_by`
createdTime	Date		`card_appointment_payment`.`created_time`	交易时间

示例

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

POST /card/getCardAppointmentPayment

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "appointmentId": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "thirdId": "",
    "cardNumber": "",
    "resourceId": 1,
    "resourceName": "",
    "timeId": 1,
    "timeName": "2026-01-01 12:00:00",
    "appTime": "2026-01-01 12:00:00",
    "name": "",
    "phone": "13800000000",
    "identityNo": "",
    "channel": 0,
    "orderNo": "",
    "orderType": "1",
    "orderSource": "1",
    "payStatus": "1",
    "orderPhone": "13800000000",
    "paymentMode": "1",
    "paymentAmount": 0,
    "paymentCurrency": 0,
    "transactionNo": "",
    "payTime": "2026-01-01 12:00:00",
    "refundNo": "",
    "refundAmount": 0,
    "refundCurrency": 0,
    "refundTransactionNo": "",
    "refundTime": "2026-01-01 12:00:00",
    "remark": "",
    "status": 0,
    "updatedBy": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "createdBy": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

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

前端调用方

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

POST /card/queryCardAppointmentPaymentList 未使用管理后台 #

预约支付流水表-列表查询 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#queryCardAppointmentPaymentList

转换BeanUtils.map → CardAppointmentPaymentQuery

ServiceCardAppointmentPaymentService#queryList （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#selectList ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentPaymentListRequest

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

响应参数

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

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

data 结构　List<CardAppointmentPaymentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`card_appointment_payment`.`id`	id
appointmentId	Long		`card_appointment_payment`.`appointment_id`	预约id
cardModelId	Long		`card_appointment_payment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_appointment_payment`.`card_model_name`	卡种名称
thirdId	String		`card_appointment_payment`.`third_id`	卡种第三方类型
cardNumber	String		`card_appointment_payment`.`card_number`	卡号
resourceId	Long		`card_appointment_payment`.`resource_id`	预约景区资源id,关联card_resource_rule卡种资源表id
resourceName	String		`card_appointment_payment`.`resource_name`	预约景区资源,冗余字段
timeId	Long		`card_appointment_payment`.`time_id`	预约景区场次id,关联card_resource_calender_time_slot表id
timeName	String		`card_appointment_payment`.`time_name`	预约景区场次名称
appTime	Date		`card_appointment_payment`.`app_time`	预约时间
name	String		`card_appointment_payment`.`name`	持卡人姓名
phone	String		`card_appointment_payment`.`phone`	手机号码
identityNo	String		`card_appointment_payment`.`identity_no`	身份证号码
channel	Integer		`card_appointment_payment`.`channel`	渠道
orderNo	String		`card_appointment_payment`.`order_no`	订单号
orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	`card_appointment_payment`.`order_type`	订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡
orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	`card_appointment_payment`.`order_source`	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`card_appointment_payment`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderPhone	String		`card_appointment_payment`.`order_phone`	下单人手机
paymentMode	PaymentMode	1积分2优惠券3微信4支付宝5工商银行6其他7湘工惠	`card_appointment_payment`.`payment_mode`	交易方式(枚举:PaymentMode)，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他
paymentAmount	Integer		`card_appointment_payment`.`payment_amount`	交易金额
paymentCurrency	Integer		`card_appointment_payment`.`payment_currency`	交易币种（1=人民币）
transactionNo	String		`card_appointment_payment`.`transaction_no`	支付中心otg的交易流水
payTime	Date		`card_appointment_payment`.`pay_time`	支付时间
refundNo	String		`card_appointment_payment`.`refund_no`	退款单号
refundAmount	Integer		`card_appointment_payment`.`refund_amount`	退款交易金额
refundCurrency	Integer		`card_appointment_payment`.`refund_currency`	退款交易币种（1=人民币）
refundTransactionNo	String		`card_appointment_payment`.`refund_transaction_no`	支付中心otg的交易流水
refundTime	Date		`card_appointment_payment`.`refund_time`	退款时间
remark	String		`card_appointment_payment`.`remark`	备注(如:积分抵扣，优惠券抵扣)
status	Integer		`card_appointment_payment`.`status`	状态(1=成功 )
updatedBy	String		`card_appointment_payment`.`updated_by`
updatedTime	Date		`card_appointment_payment`.`updated_time`
createdBy	String		`card_appointment_payment`.`created_by`
createdTime	Date		`card_appointment_payment`.`created_time`	交易时间

示例

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

POST /card/queryCardAppointmentPaymentList

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "appointmentId": 1,
      "cardModelId": 1,
      "cardModelName": "",
      "thirdId": "",
      "cardNumber": "",
      "resourceId": 1,
      "resourceName": "",
      "timeId": 1,
      "timeName": "2026-01-01 12:00:00",
      "appTime": "2026-01-01 12:00:00",
      "name": "",
      "phone": "13800000000",
      "identityNo": "",
      "channel": 0,
      "orderNo": "",
      "orderType": "1",
      "orderSource": "1",
      "payStatus": "1",
      "orderPhone": "13800000000",
      "paymentMode": "1",
      "paymentAmount": 0,
      "paymentCurrency": 0,
      "transactionNo": "",
      "payTime": "2026-01-01 12:00:00",
      "refundNo": "",
      "refundAmount": 0,
      "refundCurrency": 0,
      "refundTransactionNo": "",
      "refundTime": "2026-01-01 12:00:00",
      "remark": "",
      "status": 0,
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /card/queryCardAppointmentPaymentPage 在用管理后台 #

预约支付流水表-分页查询 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#queryCardAppointmentPaymentPage

转换BeanUtils.map → CardAppointmentPaymentQuery

ServiceCardAppointmentPaymentService#queryPage （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#selectPage ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentPaymentPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
cardNumber	String			`card_appointment_payment`.`card_number`
orderNo	String			`card_appointment_payment`.`order_no`
resourceName	String			`card_appointment_payment`.`resource_name`
cardModelName	String			`card_appointment_payment`.`card_model_name`
phone	String			`card_appointment_payment`.`phone`

响应参数

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

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

data 结构　PageInfo<CardAppointmentPaymentResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`card_appointment_payment`.`id`	id
appointmentId	Long		`card_appointment_payment`.`appointment_id`	预约id
cardModelId	Long		`card_appointment_payment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_appointment_payment`.`card_model_name`	卡种名称
thirdId	String		`card_appointment_payment`.`third_id`	卡种第三方类型
cardNumber	String		`card_appointment_payment`.`card_number`	卡号
resourceId	Long		`card_appointment_payment`.`resource_id`	预约景区资源id,关联card_resource_rule卡种资源表id
resourceName	String		`card_appointment_payment`.`resource_name`	预约景区资源,冗余字段
timeId	Long		`card_appointment_payment`.`time_id`	预约景区场次id,关联card_resource_calender_time_slot表id
timeName	String		`card_appointment_payment`.`time_name`	预约景区场次名称
appTime	Date		`card_appointment_payment`.`app_time`	预约时间
name	String		`card_appointment_payment`.`name`	持卡人姓名
phone	String		`card_appointment_payment`.`phone`	手机号码
identityNo	String		`card_appointment_payment`.`identity_no`	身份证号码
channel	Integer		`card_appointment_payment`.`channel`	渠道
orderNo	String		`card_appointment_payment`.`order_no`	订单号
orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	`card_appointment_payment`.`order_type`	订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡
orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	`card_appointment_payment`.`order_source`	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`card_appointment_payment`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderPhone	String		`card_appointment_payment`.`order_phone`	下单人手机
paymentMode	PaymentMode	1积分2优惠券3微信4支付宝5工商银行6其他7湘工惠	`card_appointment_payment`.`payment_mode`	交易方式(枚举:PaymentMode)，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他
paymentAmount	Integer		`card_appointment_payment`.`payment_amount`	交易金额
paymentCurrency	Integer		`card_appointment_payment`.`payment_currency`	交易币种（1=人民币）
transactionNo	String		`card_appointment_payment`.`transaction_no`	支付中心otg的交易流水
payTime	Date		`card_appointment_payment`.`pay_time`	支付时间
refundNo	String		`card_appointment_payment`.`refund_no`	退款单号
refundAmount	Integer		`card_appointment_payment`.`refund_amount`	退款交易金额
refundCurrency	Integer		`card_appointment_payment`.`refund_currency`	退款交易币种（1=人民币）
refundTransactionNo	String		`card_appointment_payment`.`refund_transaction_no`	支付中心otg的交易流水
refundTime	Date		`card_appointment_payment`.`refund_time`	退款时间
remark	String		`card_appointment_payment`.`remark`	备注(如:积分抵扣，优惠券抵扣)
status	Integer		`card_appointment_payment`.`status`	状态(1=成功 )
updatedBy	String		`card_appointment_payment`.`updated_by`
updatedTime	Date		`card_appointment_payment`.`updated_time`
createdBy	String		`card_appointment_payment`.`created_by`
createdTime	Date		`card_appointment_payment`.`created_time`	交易时间

示例

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

POST /card/queryCardAppointmentPaymentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "cardNumber": "",
    "orderNo": "",
    "resourceName": "",
    "cardModelName": "",
    "phone": "13800000000"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "appointmentId": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "thirdId": "",
        "cardNumber": "",
        "resourceId": 1,
        "resourceName": "",
        "timeId": 1,
        "timeName": "2026-01-01 12:00:00",
        "appTime": "2026-01-01 12:00:00",
        "name": "",
        "phone": "13800000000",
        "identityNo": "",
        "channel": 0,
        "orderNo": "",
        "orderType": "1",
        "orderSource": "1",
        "payStatus": "1",
        "orderPhone": "13800000000",
        "paymentMode": "1",
        "paymentAmount": 0,
        "paymentCurrency": 0,
        "transactionNo": "",
        "payTime": "2026-01-01 12:00:00",
        "refundNo": "",
        "refundAmount": 0,
        "refundCurrency": 0,
        "refundTransactionNo": "",
        "refundTime": "2026-01-01 12:00:00",
        "remark": "",
        "status": 0,
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryCardAppointmentPaymentPage exact

POST /card/updateCardAppointmentPayment 未使用管理后台 #

预约支付流水表-更新 · CardAppointmentPaymentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerCardAppointmentPaymentController#updateCardAppointmentPayment

转换BeanUtils.map → CardAppointmentPayment ⇒ 表 card_appointment_payment

ServiceCardAppointmentPaymentService#update （CardAppointmentPaymentServiceImpl）

MapperCardAppointmentPaymentMapper#updateById ⇒ 表 card_appointment_payment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAppointmentPaymentUpdateRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /card/updateCardAppointmentPayment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 更新预约支付

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

前端调用方

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

CardAssignmentController 4/8 在用

POST /cardAssignment/addCardAssignment 在用管理后台 #

卡分配管理表-新增 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignment

ControllerCardAssignmentController#addCardAssignment

转换BeanUtils.map → CardAssignment ⇒ 表 card_assignment

转换BeanUtils.map → CardAssignmentResponse

ServiceCardAssignmentService#add （CardAssignmentServiceImpl）

MapperCardAssignmentMapper#insert ⇒ 表 card_assignment

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

SessionUserService.getSessionIdCardModelCache.getMerchantCache.getShopCache.getRedissonClient.getTopic

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAssignmentAddRequest

字段	类型	取值/校验	表 / 列	说明
cardModelId	Long		`card_assignment`.`card_model_id`	@NotNull(message = "旅游卡种ID，关联旅游卡种表ID不能为空")
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	@NotNull(message = "卡类型，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)不能为空")
assignmentType	AssignmentType	1商户2商铺3个人	`card_assignment`.`assignment_type`	@NotNull(message = "分配对象类型，1商户，2商铺不能为空")
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card_assignment`.`business_id`	@NotNull(message = "分配对象(商户/商铺ID)不能为空")
businessName	String		`card_assignment`.`business_name`	商户/商铺名称
batchCode	String		`card_assignment`.`batch_code`	卡批次号
segmentMin	String		`card_assignment`.`segment_min`	分配卡号段开始
segmentMax	String		`card_assignment`.`segment_max`	分配卡号段结束
numbers	Integer		`card_assignment`.`numbers`	@NotNull(message = "分配数量不能为空")
applicant	String		`card_assignment`.`applicant`	@NotEmpty(message = "申请人不能为空")
remarks	String		`card_assignment`.`remarks`	备注
status	AssignmentStatus	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_assignment`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_assignment`.`task_start_time`	分配任务开始时间
taskEndTime	Date		`card_assignment`.`task_end_time`	分配任务结束时间
createdBy	Long		`card_assignment`.`created_by`	创建人id

响应参数

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

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

data 结构　CardAssignmentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_assignment`.`id`	id，主键
cardModelId	Long		`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card_assignment`.`business_id`	分配对象(商户/商铺ID)
batchCode	String		`card_assignment`.`batch_code`	卡批次号
segmentMin	String		`card_assignment`.`segment_min`	分配卡号段开始
segmentMax	String		`card_assignment`.`segment_max`	分配卡号段结束
numbers	Integer		`card_assignment`.`numbers`	分配数量
applicant	String		`card_assignment`.`applicant`	申请人
remarks	String		`card_assignment`.`remarks`	备注
status	AssignmentStatus	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_assignment`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_assignment`.`task_start_time`	分配任务开始时间
taskEndTime	Date		`card_assignment`.`task_end_time`	分配任务结束时间

示例

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

POST /cardAssignment/addCardAssignment

{
  "body": {
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "businessName": "",
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00",
    "createdBy": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志card / 新增卡分配

逻辑摘要查询详情（sessionService.getSessionId）；新增（cardAssignmentService.add）；查询详情（redissonClient.getTopic）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

默认任务状态
创建人
旅游卡名称
如果不是赠卡类型
设置商户商铺信息
分配卡发布redis消息

前端调用方

dscp-html-manage getAddCardAssignment exact

POST /cardAssignment/deleteCardAssignment 未使用管理后台 #

卡分配管理表-删除 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignment

ControllerCardAssignmentController#deleteCardAssignment

ServiceCardAssignmentService#delete （CardAssignmentServiceImpl）

MapperCardAssignmentMapper#deleteById ⇒ 表 card_assignment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAssignment/deleteCardAssignment

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 删除卡分配

逻辑摘要删除（cardAssignmentService.delete）

前端调用方

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

ANY /cardAssignment/downloadCardAssignment 未使用管理后台 #

下载分配完成的卡列表 · CardAssignmentController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardAssignmentController#downloadCardAssignment
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_stockcard_assignment

ControllerCardAssignmentController#downloadCardAssignment

MapperCardStockService.getMapper#selectList ⇒ 表 card_stock

ServiceCardAssignmentService#get （CardAssignmentServiceImpl）

MapperCardAssignmentMapper#selectById ⇒ 表 card_assignment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

ANY /cardAssignment/downloadCardAssignment

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（cardAssignmentService.get）；查询详情（cardStockService.getMapper）；调用 write（ExcelUtils.write）

内联注释

查询分配信息
查询卡分配数据
组装导出数据
序号

前端调用方

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

POST /cardAssignment/getCardAssignment 在用管理后台 #

卡分配管理表-详情 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignment

ControllerCardAssignmentController#getCardAssignment

ServiceCardAssignmentService#get （CardAssignmentServiceImpl）

MapperCardAssignmentMapper#selectById ⇒ 表 card_assignment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardAssignmentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_assignment`.`id`	id，主键
cardModelId	Long		`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card_assignment`.`business_id`	分配对象(商户/商铺ID)
batchCode	String		`card_assignment`.`batch_code`	卡批次号
segmentMin	String		`card_assignment`.`segment_min`	分配卡号段开始
segmentMax	String		`card_assignment`.`segment_max`	分配卡号段结束
numbers	Integer		`card_assignment`.`numbers`	分配数量
applicant	String		`card_assignment`.`applicant`	申请人
remarks	String		`card_assignment`.`remarks`	备注
status	AssignmentStatus	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_assignment`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_assignment`.`task_start_time`	分配任务开始时间
taskEndTime	Date		`card_assignment`.`task_end_time`	分配任务结束时间

示例

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

POST /cardAssignment/getCardAssignment

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

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

前端调用方

dscp-html-manage getCardAssignmentDetail exact

POST /cardAssignment/queryCardAssignmentList 未使用管理后台 #

卡分配管理表-列表查询 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignment

ControllerCardAssignmentController#queryCardAssignmentList

转换BeanUtils.map → CardAssignmentQuery

MapperCardAssignmentService.getMapper#queryList ⇒ 表 card_assignment

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

CardAssignmentService.applyWrapperSessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAssignmentListRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	否	可选(@MvcOptional)	`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	否	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	否	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	否	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long	否	可选(@MvcOptional)	`card_assignment`.`business_id`	分配对象(商户/商铺ID)
numbers	Integer	否	可选(@MvcOptional)	`card_assignment`.`numbers`	分配数量
applicant	String	否	可选(@MvcOptional)	`card_assignment`.`applicant`	申请人
status	AssignmentStatus	否	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　List<CardAssignmentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`card_assignment`.`id`	id，主键
cardModelId	Long		`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card_assignment`.`business_id`	分配对象(商户/商铺ID)
batchCode	String		`card_assignment`.`batch_code`	卡批次号
segmentMin	String		`card_assignment`.`segment_min`	分配卡号段开始
segmentMax	String		`card_assignment`.`segment_max`	分配卡号段结束
numbers	Integer		`card_assignment`.`numbers`	分配数量
applicant	String		`card_assignment`.`applicant`	申请人
remarks	String		`card_assignment`.`remarks`	备注
status	AssignmentStatus	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_assignment`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_assignment`.`task_start_time`	分配任务开始时间
taskEndTime	Date		`card_assignment`.`task_end_time`	分配任务结束时间

示例

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

POST /cardAssignment/queryCardAssignmentList

{
  "body": {
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "numbers": 0,
    "applicant": "",
    "status": "1",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "cardModelId": 1,
      "cardType": "1",
      "assignmentType": "1",
      "distributionType": "1",
      "businessId": 1,
      "batchCode": "",
      "segmentMin": "",
      "segmentMax": "",
      "numbers": 0,
      "applicant": "",
      "remarks": "",
      "status": "1",
      "attach": "",
      "taskStatus": "1",
      "taskStartTime": "2026-01-01 12:00:00",
      "taskEndTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

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

前端调用方

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

POST /cardAssignment/queryCardAssignmentPage 在用管理后台 #

卡分配管理表-分页查询 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignmentcard_modelsystem_usermember

ControllerCardAssignmentController#queryCardAssignmentPage

转换BeanUtils.map → CardAssignmentQuery

转换BeanUtils.map → PageParam

MapperCardAssignmentService.getMapper#queryPage ⇒ 表 card_assignment

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

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

CardAssignmentService.applyWrapperSessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShopCardModelCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAssignmentPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	否	可选(@MvcOptional)	`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	否	可选(@MvcOptional)	`card_assignment`.`card_model_name`	卡种名称
cardType	CardType	否	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	否	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	否	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long	否	可选(@MvcOptional)	`card_assignment`.`business_id`	分配对象(商户/商铺ID)
businessName	String	否	可选(@MvcOptional)	`card_assignment`.`business_name`	商户/商铺
numbers	Integer	否	可选(@MvcOptional)	`card_assignment`.`numbers`	分配数量
applicant	String	否	可选(@MvcOptional)	`card_assignment`.`applicant`	申请人
status	AssignmentStatus	否	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
createdBy	Long			`card_assignment`.`created_by`	创建人ID
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　PageInfo<CardAssignmentPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`card_assignment`.`id`	id，主键
cardModelId	Long		`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_assignment`.`card_model_name`	旅游卡名称
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	`card_assignment`.`distribution_type`	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card_assignment`.`business_id`	分配对象(商户/商铺ID)
businessName	String		`card_assignment`.`business_name`	分配对象
batchCode	String		`card_assignment`.`batch_code`	卡批次号
numbers	Integer		`card_assignment`.`numbers`	分配数量
applicant	String		`card_assignment`.`applicant`	申请人
remarks	String		`card_assignment`.`remarks`	备注
status	AssignmentStatus	1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
type	String		—	卡类型
assignmentStatus	String		—	分配状态
createdTime	Date		`card_assignment`.`created_time`	创建时间
createdBy	Long		`card_assignment`.`created_by`	创建人ID
createdName	String		—	创建人

示例

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

POST /cardAssignment/queryCardAssignmentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "cardModelName": "",
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "businessName": "",
    "numbers": 0,
    "applicant": "",
    "status": "1",
    "createdBy": 0,
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "cardType": "1",
        "assignmentType": "1",
        "distributionType": "1",
        "businessId": 1,
        "businessName": "",
        "batchCode": "",
        "numbers": 0,
        "applicant": "",
        "remarks": "",
        "status": "1",
        "attach": "",
        "type": "",
        "assignmentStatus": "",
        "createdTime": "2026-01-01 12:00:00",
        "createdBy": 0,
        "createdName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

创建人

前端调用方

dscp-html-manage getQueryCardAssignmentPage exact

POST /cardAssignment/resignCardAssignment 在用管理后台 #

（无摘要） · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表cardsystem_operate_log

ControllerCardAssignmentController#resignCardAssignment

MapperCardService.getMapper#queryList ⇒ 表 card

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

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

CardService.applyWrapperMerchantCache.getShopCache.getCardService.updateListSessionUserService.getSessionId

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAssignmentAddRequest

字段	类型	取值/校验	表 / 列	说明
cardModelId	Long		`card`.`card_model_id`	@NotNull(message = "旅游卡种ID，关联旅游卡种表ID不能为空")
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card`.`card_type`	@NotNull(message = "卡类型，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)不能为空")
assignmentType	AssignmentType	1商户2商铺3个人	`card`.`assignment_type`	@NotNull(message = "分配对象类型，1商户，2商铺不能为空")
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	—	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card`.`business_id`	@NotNull(message = "分配对象(商户/商铺ID)不能为空")
businessName	String		`card`.`business_name`	商户/商铺名称
batchCode	String		—	卡批次号
segmentMin	String		—	分配卡号段开始
segmentMax	String		—	分配卡号段结束
numbers	Integer		—	@NotNull(message = "分配数量不能为空")
applicant	String		—	@NotEmpty(message = "申请人不能为空")
remarks	String		—	备注
status	AssignmentStatus	1分配成功2分配失败	—	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		—	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	—	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		—	分配任务开始时间
taskEndTime	Date		—	分配任务结束时间
createdBy	Long		`card`.`created_by`	创建人id

响应参数

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

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

data 结构　CardAssignmentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card`.`id`	id，主键
cardModelId	Long		`card`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	1商户2商铺3个人	`card`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
distributionType	DistributionType	1手动分配2自动分配3赠卡分配	—	分配类型(枚举:card.DistributionType)，1手动分配，2自动分配,3赠卡分配
businessId	Long		`card`.`business_id`	分配对象(商户/商铺ID)
batchCode	String		—	卡批次号
segmentMin	String		—	分配卡号段开始
segmentMax	String		—	分配卡号段结束
numbers	Integer		—	分配数量
applicant	String		—	申请人
remarks	String		—	备注
status	AssignmentStatus	1分配成功2分配失败	—	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String		—	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	—	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		—	分配任务开始时间
taskEndTime	Date		—	分配任务结束时间

示例

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

POST /cardAssignment/resignCardAssignment

{
  "body": {
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "businessName": "",
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00",
    "createdBy": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "distributionType": "1",
    "businessId": 1,
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要调用 toJsonStr（JSONUtil.toJsonStr）；调用 applyWrapper（cardService.applyWrapper）；查询详情（cardService.getMapper）

内联注释

批量修改

前端调用方

dscp-html-manage resignCardAssignment exact

POST /cardAssignment/updateCardAssignment 未使用管理后台 #

卡分配管理表-更新 · CardAssignmentController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_assignment

ControllerCardAssignmentController#updateCardAssignment

转换BeanUtils.map → CardAssignment ⇒ 表 card_assignment

ServiceCardAssignmentService#update （CardAssignmentServiceImpl）

MapperCardAssignmentMapper#updateById ⇒ 表 card_assignment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardAssignmentUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`card_assignment`.`id`	id，主键
cardModelId	Long	是	必填	`card_assignment`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardType	CardType	是	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_assignment`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	是	1商户2商铺3个人	`card_assignment`.`assignment_type`	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
businessId	Long	是	必填	`card_assignment`.`business_id`	分配对象(商户/商铺ID)
batchCode	String			`card_assignment`.`batch_code`	卡批次号
segmentMin	String			`card_assignment`.`segment_min`	分配卡号段开始
segmentMax	String			`card_assignment`.`segment_max`	分配卡号段结束
numbers	Integer	是	必填	`card_assignment`.`numbers`	分配数量
applicant	String	是	必填	`card_assignment`.`applicant`	申请人
remarks	String			`card_assignment`.`remarks`	备注
status	AssignmentStatus		1分配成功2分配失败	`card_assignment`.`status`	分配状态(枚举:card.AssignmentStatus)，1分配成功，2分配失败
attach	String			`card_assignment`.`attach`	附件地址，当卡类型为2时该字段有值
taskStatus	TaskStatus		1未开始2中断3处理完成	`card_assignment`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date			`card_assignment`.`task_start_time`	分配任务开始时间
taskEndTime	Date			`card_assignment`.`task_end_time`	分配任务结束时间

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardAssignment/updateCardAssignment

{
  "body": {
    "id": 1,
    "cardModelId": 1,
    "cardType": "1",
    "assignmentType": "1",
    "businessId": 1,
    "batchCode": "",
    "segmentMin": "",
    "segmentMax": "",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "attach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 更新卡分配

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

前端调用方

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

CardBatchController 3/9 在用

POST /cardBatch/addCardBatch 在用管理后台 #

卡批次表-新增 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batch

ControllerCardBatchController#addCardBatch

转换BeanUtils.map → CardBatch ⇒ 表 card_batch

转换BeanUtils.map → CardBatchResponse

ServiceCardBatchService#maxBatchCode （CardBatchServiceImpl）

MapperCardBatchMapper#maxBatchCode ⇒ 表 card_batch

ServiceCardBatchService#add （CardBatchServiceImpl）

MapperCardBatchMapper#insert ⇒ 表 card_batch

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

CardModelCache.getSessionUserService.getSessionIdRedissonClient.getTopic

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBatchAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String			`card_batch`.`card_model_name`	旅游卡名称
batchCode	String			`card_batch`.`batch_code`	卡批次号
cardType	CardType		1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer	是	必填	`card_batch`.`numbers`	制卡数量
applicant	String	是	必填	`card_batch`.`applicant`	申请人
remarks	String			`card_batch`.`remarks`	备注
status	MakeStatus		1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean			`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String			`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
taskStatus	TaskStatus		1未开始2中断3处理完成	`card_batch`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date			`card_batch`.`task_start_time`	制卡任务开始时间
taskEndTime	Date			`card_batch`.`task_end_time`	制卡任务结束时间

响应参数

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

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

data 结构　CardBatchResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_batch`.`id`	ID，主键
cardModelId	Long		`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_batch`.`card_model_name`	旅游卡名称
batchCode	String		`card_batch`.`batch_code`	卡批次号
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer		`card_batch`.`numbers`	制卡数量
applicant	String		`card_batch`.`applicant`	申请人
remarks	String		`card_batch`.`remarks`	备注
status	MakeStatus	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean		`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String		`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_batch`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_batch`.`task_start_time`	制卡任务开始时间
taskEndTime	Date		`card_batch`.`task_end_time`	制卡任务结束时间

示例

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

POST /cardBatch/addCardBatch

{
  "body": {
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "isUpload": false,
    "chipAttach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "isUpload": false,
    "chipAttach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

操作日志card / 新增卡批次

逻辑摘要调用 maxBatchCode（cardBatchService.maxBatchCode）；查询详情（sessionService.getSessionId）；新增（cardBatchService.add）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

生成卡批次号，批次号规则:年(取年后2 位数) +月 (2 位数)+当月生产流水号 (2 位数起批次号如: 231201
新增默认制卡状态“制作中”
旅游卡种名称
如果是实体卡（有芯片）
设置商户、商铺信息
制卡发布redis消息

前端调用方

dscp-html-manage addCardZhiBatch exact

POST /cardBatch/deleteCardBatch 未使用管理后台 #

卡批次表-删除 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batch

ControllerCardBatchController#deleteCardBatch

ServiceCardBatchService#delete （CardBatchServiceImpl）

MapperCardBatchMapper#deleteById ⇒ 表 card_batch

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardBatch/deleteCardBatch

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 删除卡批次

逻辑摘要删除（cardBatchService.delete）

前端调用方

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

ANY /cardBatch/downloadCardBatch 未使用管理后台 #

下载制卡批次 · CardBatchController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBatchController#downloadCardBatch
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_batchcard_stock

ControllerCardBatchController#downloadCardBatch

ServiceCardBatchService#get （CardBatchServiceImpl）

MapperCardBatchMapper#selectById ⇒ 表 card_batch

ServiceCardStockService#queryList （CardStockServiceImpl）

MapperCardStockMapper#selectList ⇒ 表 card_stock

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

ANY /cardBatch/downloadCardBatch

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（cardBatchService.get）；列表查询（cardStockService.queryList）；调用 write（ExcelUtils.write）

内联注释

查询卡批次
查询出制卡批次的所有卡
组装导出数据
序号

前端调用方

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

ANY /cardBatch/downloadCardStockChip 未使用管理后台 #

下载卡批次芯片码 · CardBatchController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBatchController#downloadCardStockChip
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_stockcard_batch

ControllerCardBatchController#downloadCardStockChip

MapperCardStockService.getMapper#selectList ⇒ 表 card_stock

ServiceCardBatchService#get （CardBatchServiceImpl）

MapperCardBatchMapper#selectById ⇒ 表 card_batch

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

ANY /cardBatch/downloadCardStockChip

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（cardBatchService.get）；查询详情（cardStockService.getMapper）；调用 write（ExcelUtils.write）

内联注释

查询卡批次
查询卡批次中的所有上传芯片码的卡
组装导出数据
序号

前端调用方

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

POST /cardBatch/getCardBatch 在用管理后台 #

卡批次表-详情 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batch

ControllerCardBatchController#getCardBatch

ServiceCardBatchService#get （CardBatchServiceImpl）

MapperCardBatchMapper#selectById ⇒ 表 card_batch

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardBatchResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_batch`.`id`	ID，主键
cardModelId	Long		`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_batch`.`card_model_name`	旅游卡名称
batchCode	String		`card_batch`.`batch_code`	卡批次号
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer		`card_batch`.`numbers`	制卡数量
applicant	String		`card_batch`.`applicant`	申请人
remarks	String		`card_batch`.`remarks`	备注
status	MakeStatus	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean		`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String		`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_batch`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_batch`.`task_start_time`	制卡任务开始时间
taskEndTime	Date		`card_batch`.`task_end_time`	制卡任务结束时间

示例

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

POST /cardBatch/getCardBatch

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "isUpload": false,
    "chipAttach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

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

前端调用方

dscp-html-manage getCardZhiBatch exact

ANY /cardBatch/importCardStockChip 未使用管理后台 #

上传卡批次芯片码 · CardBatchController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBatchController#importCardStockChip
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_batchcard_stock

ControllerCardBatchController#importCardStockChip

ServiceCardBatchService#get （CardBatchServiceImpl）

MapperCardBatchMapper#selectById ⇒ 表 card_batch

ServiceCardStockService#handlerImportData （CardStockServiceImpl）

MapperCardStockMapper#selectOne ⇒ 表 card_stock

MapperCardStockMapper#updateList ⇒ 表 card_stock

MapperCardBatchMapper#updateById ⇒ 表 card_batch

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

ChaosTransactionTemplate.execute

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body

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

响应参数

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

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

data 结构　CardStockChipUploadResponse　（object）

字段	类型	表 / 列	说明
correctNum	Integer	—	正确个数
errorNum	Integer	—	错误个数
errorResult	List<CardStockChipImportErrorResult>	—	错误集合列表
errorResult[].number	Integer	—	行号
errorResult[].cardNumber	String	`card_stock`.`card_number`	卡号
errorResult[].errorMsg	String	—	错误详情

示例

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

ANY /cardBatch/importCardStockChip?file=…&id=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "correctNum": 0,
    "errorNum": 0,
    "errorResult": [
      {
        "number": 0,
        "cardNumber": "",
        "errorMsg": ""
      }
    ]
  }
}

处理逻辑

操作日志card / 导入卡库存芯片

逻辑摘要查询详情（cardBatchService.get）；调用 handlerImportData（cardStockService.handlerImportData）；调用 read（ExcelUtils.read）

内联注释

查询卡批次
总结果结合
总数集合
处理导入数据

前端调用方

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

POST /cardBatch/queryCardBatchList 未使用管理后台 #

卡批次表-列表查询 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batch

ControllerCardBatchController#queryCardBatchList

转换BeanUtils.map → CardBatchQuery

MapperCardBatchService.getMapper#queryList ⇒ 表 card_batch

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

CardBatchService.applyWrapperSessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBatchListRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	否	可选(@MvcOptional)	`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	否	可选(@MvcOptional)	`card_batch`.`card_model_name`	旅游卡名称
batchCode	String	否	可选(@MvcOptional)	`card_batch`.`batch_code`	卡批次号
cardType	CardType	否	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer	否	可选(@MvcOptional)	`card_batch`.`numbers`	制卡数量
applicant	String	否	可选(@MvcOptional)	`card_batch`.`applicant`	申请人
status	MakeStatus	否	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean	否	可选(@MvcOptional)	`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　List<CardBatchResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`card_batch`.`id`	ID，主键
cardModelId	Long		`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_batch`.`card_model_name`	旅游卡名称
batchCode	String		`card_batch`.`batch_code`	卡批次号
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer		`card_batch`.`numbers`	制卡数量
applicant	String		`card_batch`.`applicant`	申请人
remarks	String		`card_batch`.`remarks`	备注
status	MakeStatus	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean		`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String		`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
taskStatus	TaskStatus	1未开始2中断3处理完成	`card_batch`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date		`card_batch`.`task_start_time`	制卡任务开始时间
taskEndTime	Date		`card_batch`.`task_end_time`	制卡任务结束时间

示例

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

POST /cardBatch/queryCardBatchList

{
  "body": {
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "status": "1",
    "isUpload": false,
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "cardModelId": 1,
      "cardModelName": "",
      "batchCode": "",
      "cardType": "1",
      "numbers": 0,
      "applicant": "",
      "remarks": "",
      "status": "1",
      "isUpload": false,
      "chipAttach": "",
      "taskStatus": "1",
      "taskStartTime": "2026-01-01 12:00:00",
      "taskEndTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

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

前端调用方

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

POST /cardBatch/queryCardBatchPage 在用管理后台 #

卡批次表-分页查询 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batchcard_model

ControllerCardBatchController#queryCardBatchPage

转换BeanUtils.map → CardBatchQuery

转换BeanUtils.map → PageParam

MapperCardBatchService.getMapper#queryPage ⇒ 表 card_batch

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

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

CardBatchService.applyWrapperSessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBatchPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	否	可选(@MvcOptional)	`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String	否	可选(@MvcOptional)	`card_batch`.`card_model_name`	旅游卡名称
batchCode	String	否	可选(@MvcOptional)	`card_batch`.`batch_code`	卡批次号
cardType	CardType	否	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer	否	可选(@MvcOptional)	`card_batch`.`numbers`	制卡数量
applicant	String	否	可选(@MvcOptional)	`card_batch`.`applicant`	申请人
status	MakeStatus	否	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean	否	可选(@MvcOptional)	`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字
createdTimeRange	Date[]	否	可选(@MvcOptional)	—

响应参数

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

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

data 结构　PageInfo<CardBatchPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`card_batch`.`id`	ID，主键
cardModelId	Long		`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_batch`.`card_model_name`	卡种名称
batchCode	String		`card_batch`.`batch_code`	卡批次号
cardType	CardType	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer		`card_batch`.`numbers`	制卡数量
applicant	String		`card_batch`.`applicant`	申请人
remarks	String		`card_batch`.`remarks`	备注
status	MakeStatus	1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean		`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String		`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
type	String		—	卡类型
makeStatus	String		—	制卡状态
createdTime	Date		`card_batch`.`created_time`	创建时间

示例

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

POST /cardBatch/queryCardBatchPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "status": "1",
    "isUpload": false,
    "idList": "",
    "keywords": "",
    "createdTimeRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "batchCode": "",
        "cardType": "1",
        "numbers": 0,
        "applicant": "",
        "remarks": "",
        "status": "1",
        "isUpload": false,
        "chipAttach": "",
        "type": "",
        "makeStatus": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

卡类型
制卡状态

前端调用方

dscp-html-manage queryCardBatchPage exact

POST /cardBatch/updateCardBatch 未使用管理后台 #

卡批次表-更新 · CardBatchController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_batch

ControllerCardBatchController#updateCardBatch

转换BeanUtils.map → CardBatch ⇒ 表 card_batch

ServiceCardBatchService#update （CardBatchServiceImpl）

MapperCardBatchMapper#updateById ⇒ 表 card_batch

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBatchUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`card_batch`.`id`	ID，主键
cardModelId	Long	是	必填	`card_batch`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String			`card_batch`.`card_model_name`	旅游卡名称
batchCode	String			`card_batch`.`batch_code`	卡批次号
cardType	CardType		1电子卡2实体卡(带芯片)3实体卡(不带芯片)	`card_batch`.`card_type`	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
numbers	Integer	是	必填	`card_batch`.`numbers`	制卡数量
applicant	String	是	必填	`card_batch`.`applicant`	申请人
remarks	String			`card_batch`.`remarks`	备注
status	MakeStatus		1制卡中2制卡完成	`card_batch`.`status`	状态(枚举:card.MakeStatus)，1制卡中，2制卡完成
isUpload	Boolean			`card_batch`.`is_upload`	是否上传芯片码，当卡类型为2时该字段有值
chipAttach	String			`card_batch`.`chip_attach`	芯片码附件下载地址，当卡类型为2时该字段有值
taskStatus	TaskStatus		1未开始2中断3处理完成	`card_batch`.`task_status`	任务状态(枚举:card.TaskStatus)，1未开始，2中断，3处理完成
taskStartTime	Date			`card_batch`.`task_start_time`	制卡任务开始时间
taskEndTime	Date			`card_batch`.`task_end_time`	制卡任务结束时间

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardBatch/updateCardBatch

{
  "body": {
    "id": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "batchCode": "",
    "cardType": "1",
    "numbers": 0,
    "applicant": "",
    "remarks": "",
    "status": "1",
    "isUpload": false,
    "chipAttach": "",
    "taskStatus": "1",
    "taskStartTime": "2026-01-01 12:00:00",
    "taskEndTime": "2026-01-01 12:00:00"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 更新卡批次

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

前端调用方

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

CardBindController 4/7 在用

POST /cardBind/addCardBind 未使用小程序 #

持卡人 - 绑定 · CardBindController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBindController#addCardBind
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_bindmembercardmember_contactsopenapi_pingan_record

ControllerCardBindController#addCardBind

ServiceCardBindService#addCardBind （CardBindServiceImpl）

转换BeanUtils.map → CardBind ⇒ 表 card_bind

MapperMemberService.getMapper#selectOne ⇒ 表 member

ServiceCardService#get （CardServiceImpl）

MapperCardMapper#selectById ⇒ 表 card

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceCardService#update （CardServiceImpl）

MapperCardMapper#updateById ⇒ 表 card

ServiceMemberContactsService#queryList （MemberContactsServiceImpl）

MapperMemberContactsMapper#selectList ⇒ 表 member_contacts

ServiceMemberContactsService#add （MemberContactsServiceImpl）

MapperMemberContactsMapper#insert ⇒ 表 member_contacts

ServiceOpenapiPinganRecordService#add （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#insert ⇒ 表 openapi_pingan_record

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

AuthService.getAuthValueChaosTransactionTemplate.executeCardModelRuleService.mustGetCardModelCache.getSessionMemberService.getSessionId

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBindAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardId	Long			`card_bind`.`card_id`	卡id，关联card卡池表id
cardNumber	String	是	必填	`card_bind`.`card_number`	卡号
activeCode	String	是	必填	`card`.`active_code`	激活码规则:5 位随机激活码，包含大写字母和数字。··大写字母不包括 0 和1。
binderType	BinderType	是	1本人2亲友	`card_bind`.`binder_type`	绑定人类型(枚举:card.BinderType)，1本人，2亲友
name	String	是	必填	`card_bind`.`name`	姓名
phone	String	是	必填	`card_bind`.`phone`	手机号码
smsCode	String			—	短信验证码
idType	IdType	是	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`card_bind`.`id_type`	证件类型
identityNo	String	是	必填	`card_bind`.`identity_no`	身份证号码
photo	String			`card_bind`.`photo`	@NotNull(message = "人脸照片不能为空")
bindSource	String			`card_bind`.`bind_source`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardBind/addCardBind

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardId": 1,
    "cardNumber": "",
    "activeCode": "",
    "binderType": "1",
    "name": "",
    "phone": "13800000000",
    "smsCode": "",
    "idType": "1",
    "identityNo": "",
    "photo": "",
    "bindSource": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 新增卡绑定

逻辑摘要新增（cardBindService.addCardBind）；查询详情（sessionService.getSessionId）

前端调用方

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

POST /cardBind/getCardBind 在用管理后台 #

持卡人-详情 · CardBindController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bind

ControllerCardBindController#getCardBind

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardBindResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`card_bind`.`id`	id，主键
cardId	Long		`card_bind`.`card_id`	卡id，关联card卡池表id
cardModelId	Long		`card_bind`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_bind`.`card_model_name`	卡种名称
cardNumber	String		`card_bind`.`card_number`	卡号
memberId	Long		`card_bind`.`member_id`	持卡人ID
name	String		`card_bind`.`name`	持卡人姓名
photo	String		`card_bind`.`photo`	人脸图片地址
phone	String		`card_bind`.`phone`	手机号码
identityNo	String		`card_bind`.`identity_no`	身份证号码
bindTime	Date		`card_bind`.`bind_time`	绑定时间
expiresTime	Date		`card_bind`.`expires_time`	到期时间
state	CardState	1待销售2待激活3已激活4已绑定5已禁用6已过期7已无效8已锁定	`card_bind`.`state`	卡绑定状态(枚举:card.BindState)，1待激活，2已激活，3已禁用，4已过期，5已失效，6已锁定
isDeleted	Boolean		`card_bind`.`is_deleted`	是否删除
createdBy	Long		`card_bind`.`created_by`	创建人
createdTime	Date		`card_bind`.`created_time`	创建时间
updatedBy	Long		`card_bind`.`updated_by`	修改人
updatedTime	Date		`card_bind`.`updated_time`	修改时间

示例

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

POST /cardBind/getCardBind

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardId": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "cardNumber": "",
    "memberId": 1,
    "name": "",
    "photo": "",
    "phone": "13800000000",
    "identityNo": "",
    "bindTime": "2026-01-01 12:00:00",
    "expiresTime": "2026-01-01 12:00:00",
    "state": "1",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

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

前端调用方

dscp-html-manage getCardBind exact

POST /cardBind/getMemberCardBind 未使用小程序 #

查询用户绑定的卡-详情 · CardBindController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBindController#getMemberCardBind
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_bind

ControllerCardBindController#getMemberCardBind

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　MemberCardBindResponse　（object）

字段	类型	表 / 列	说明
id	Long	`card_bind`.`id`	id，主键
cardId	Long	`card_bind`.`card_id`	卡ID
cardModelName	String	`card_bind`.`card_model_name`	卡种名称
cardNumber	String	`card_bind`.`card_number`	卡号
name	String	`card_bind`.`name`	持卡人姓名
photo	String	`card_bind`.`photo`	人脸图片地址
phone	String	`card_bind`.`phone`	手机号码
identityNo	String	`card_bind`.`identity_no`	身份证号码
expiresTime	Date	`card_bind`.`expires_time`	到期时间

示例

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

POST /cardBind/getMemberCardBind

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardId": 1,
    "cardModelName": "",
    "cardNumber": "",
    "name": "",
    "photo": "",
    "phone": "13800000000",
    "identityNo": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

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

前端调用方

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

POST /cardBind/queryCardBindPage 在用管理后台 #

持卡人-分页查询 · CardBindController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bindcard_model

ControllerCardBindController#queryCardBindPage

转换BeanUtils.map → CardBindQuery

转换BeanUtils.map → PageParam

MapperCardBindService.getMapper#queryPage ⇒ 表 card_bind

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

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

CardBindService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBindPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardNumber	String	否	可选(@MvcOptional)	`card_bind`.`card_number`	卡号，规则参照card_number_rule
cardModelId	Long	否	可选(@MvcOptional)	`card_bind`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelIds	List<Long>	否	可选(@MvcOptional)	—	卡种ID列表，用于按多个卡种过滤
cardModelName	String	否	可选(@MvcOptional)	`card_bind`.`card_model_name`	卡种名称
cardType	CardType	否	1电子卡2实体卡(带芯片)3实体卡(不带芯片)	—	卡类型(枚举:card.CardType)，1电子卡，2实体卡(带芯片)，3实体卡(不带芯片)
assignmentType	AssignmentType	否	1商户2商铺3个人	—	分配对象类型(枚举:card.AssignmentType)，1商户，2商铺
businessId	Long	否	可选(@MvcOptional)	—	分配对象(商户/商铺ID)
state	CardState	否	1待销售2待激活3已激活4已绑定5已禁用6已过期7已无效8已锁定	`card_bind`.`state`	卡状态(枚举:card.CardState)，1待售，2待绑定，3正常，4挂失，5过期，6损坏，7冻结
validityStart	Date	否	可选(@MvcOptional)	—	有效期起始
validityEnd	Date	否	可选(@MvcOptional)	—	有效期截止
isActive	Boolean	否	可选(@MvcOptional)	—	是否激活
activeTime	Date	否	可选(@MvcOptional)	—	激活时间
activeBy	Long	否	可选(@MvcOptional)	—	激活人，关联用户表id
isBind	Boolean	否	可选(@MvcOptional)	—	是否绑定
bindBy	Long	否	可选(@MvcOptional)	—	绑定人，关联用户表id
bindTime	Date	否	可选(@MvcOptional)	`card_bind`.`bind_time`	绑定时间
phone	String	否	可选(@MvcOptional)	`card_bind`.`phone`	手机号码
identityNo	String	否	可选(@MvcOptional)	`card_bind`.`identity_no`	身份证号码
idList	List<Long>	否	可选(@MvcOptional)	—	id列表
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　PageInfo<CardBindPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`card_bind`.`id`	ID，主键
cardId	Long		`card_bind`.`card_id`	卡id，关联card卡池表id
cardModelId	Long		`card_bind`.`card_model_id`	旅游卡种ID，关联旅游卡种表ID
cardModelName	String		`card_bind`.`card_model_name`	卡种名称
cardNumber	String		`card_bind`.`card_number`	卡号
memberId	Long		`card_bind`.`member_id`	持卡人ID
name	String		`card_bind`.`name`	持卡人姓名
phone	String		`card_bind`.`phone`	手机号码
photo	String		`card_bind`.`photo`
identityNo	String		`card_bind`.`identity_no`	身份证号码
bindTime	Date		`card_bind`.`bind_time`	绑定时间
expiresTime	Date		`card_bind`.`expires_time`	到期时间
state	CardState	1待销售2待激活3已激活4已绑定5已禁用6已过期7已无效8已锁定	`card_bind`.`state`	卡绑定状态(枚举:card.BindState)，1待激活，2已激活，3已禁用，4已过期，5已失效，6已锁定
bindState	String		—	卡绑定状态(枚举:card.BindState)，1待激活，2已激活，3已禁用，4已过期，5已失效，6已锁定
isDeleted	Boolean		`card_bind`.`is_deleted`	是否删除
createdBy	Long		`card_bind`.`created_by`	创建人
createdTime	Date		`card_bind`.`created_time`	创建时间
updatedBy	Long		`card_bind`.`updated_by`	修改人
updatedTime	Date		`card_bind`.`updated_time`	修改时间

示例

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

POST /cardBind/queryCardBindPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardNumber": "",
    "cardModelId": 1,
    "cardModelIds": "",
    "cardModelName": "",
    "cardType": "1",
    "assignmentType": "1",
    "businessId": 1,
    "state": "1",
    "validityStart": "2026-01-01 12:00:00",
    "validityEnd": "2026-01-01 12:00:00",
    "isActive": false,
    "activeTime": "2026-01-01 12:00:00",
    "activeBy": 0,
    "isBind": false,
    "bindBy": 0,
    "bindTime": "2026-01-01 12:00:00",
    "phone": "13800000000",
    "identityNo": "",
    "idList": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardId": 1,
        "cardModelId": 1,
        "cardModelName": "",
        "cardNumber": "",
        "memberId": 1,
        "name": "",
        "phone": "13800000000",
        "photo": "",
        "identityNo": "",
        "bindTime": "2026-01-01 12:00:00",
        "expiresTime": "2026-01-01 12:00:00",
        "state": "1",
        "bindState": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

Card查询已做全局数据权限，会自动拼接权限sql
wrapper.exists("SELECT 1 FROM card c WHERE c.id = card_id");
卡状态

前端调用方

dscp-html-manage queryCardBindPage exact

POST /cardBind/queryMemberCardBindPage 未使用小程序 #

查询用户绑定的卡列表 · CardBindController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardBindController#queryMemberCardBindPage
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

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

ControllerCardBindController#queryMemberCardBindPage

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

CardBindService.queryMemberCardBindPageSessionMemberService.getSessionId

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body

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

响应参数

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

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

data 结构　List<MemberCardBindListResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		—	主键id
cardId	Long		—	卡id
cardModelId	Long		—	旅游卡种ID
cardModelName	String		—
memberId	Long		—
binderType	BinderType	1本人2亲友	—	绑定人类型(枚举:card.BinderType)，1本人，2亲友
name	String		—	持卡人姓名
photo	String		—	人脸图片地址
phone	String		—	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	—	证件类型
identityNo	String		—	身份证号码
bindTime	Date		—	绑定时间
cardNumber	String		—	卡号，规则参照card_number_rule
state	CardState	1待销售2待激活3已激活4已绑定5已禁用6已过期7已无效8已锁定	—	卡状态(枚举:card.CardState)，1待销售,2待激活,3已激活,4已绑定,5禁用,6过期,7无效, 8锁定
expiresTime	Date		—	有效期截止
propagateStyle	String		—	宣传卡样url地址
isDeleted	Boolean		—

示例

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

POST /cardBind/queryMemberCardBindPage

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "cardId": 1,
      "cardModelId": 1,
      "cardModelName": "",
      "memberId": 1,
      "binderType": "1",
      "name": "",
      "photo": "",
      "phone": "13800000000",
      "idType": "1",
      "identityNo": "",
      "bindTime": "2026-01-01 12:00:00",
      "cardNumber": "",
      "state": "1",
      "expiresTime": "2026-01-01 12:00:00",
      "propagateStyle": "",
      "isDeleted": false
    }
  ]
}

处理逻辑

逻辑摘要分页查询（cardBindService.queryMemberCardBindPage）；查询详情（sessionService.getSessionId）

前端调用方

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

POST /cardBind/updateCardBindBy 在用管理后台 #

持卡人- 修改绑定人信息 · CardBindController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bindcardmembersystem_operate_log

ControllerCardBindController#updateCardBindBy

转换BeanUtils.map → CardBind ⇒ 表 card_bind

ServiceCardBindService#update （CardBindServiceImpl）

MapperCardBindMapper#updateById ⇒ 表 card_bind

ServiceCardService#get （CardServiceImpl）

MapperCardMapper#selectById ⇒ 表 card

ServiceCardService#update （CardServiceImpl）

MapperCardMapper#updateById ⇒ 表 card

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

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

ChaosTransactionTemplate.executeSessionMemberService.getSessionId

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardBindUpdateRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
id	Long		`card_bind`.`id`	ID，主键
cardId	Long		`card_bind`.`card_id`	卡id
name	String		`card_bind`.`name`	姓名
phone	String		`card_bind`.`phone`	手机号码
identityNo	String		`card_bind`.`identity_no`	身份证号码
memberId	Long		`card_bind`.`member_id`	用户id
cardNo	String		—

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardBind/updateCardBindBy

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "id": 1,
    "cardId": 1,
    "name": "",
    "phone": "13800000000",
    "identityNo": "",
    "memberId": 1,
    "cardNo": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 execute（newTransactionTemplate.execute）；更新（cardBindService.update）；查询详情（cardService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

修改卡绑定人信息
修改卡信息
修改用户信息
回滚事务
处理异常
增加操作日志

前端调用方

dscp-html-manage updateCardBindBy exact

POST /cardBind/resetCardFace 在用管理后台 #

卡绑定-重置人脸 · CardBindController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_bindmember_face

ControllerCardBindController#resetCardFace

ServicecardBindService#get

MapperCardBindMapper#get ⇒ 表 card_bind

ServicecardBindService#update

MapperCardBindMapper#update ⇒ 表 card_bind

ServicememberFaceService#queryList

MapperMemberFaceMapper#queryList ⇒ 表 member_face

ServicememberFaceService#delete

MapperMemberFaceMapper#delete ⇒ 表 member_face

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

（void，无响应体）

示例

请求示例

{
  "id": 0
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 重置人脸

逻辑摘要cardBindService.get；cardBindService.update；memberFaceService.queryList；memberFaceService.delete；完整实现见源码 CardBindController#resetCardFace

前端调用方

dscp-html-manage resetCardFace exact

CardCheckController 6/14 在用

POST /cardCheck/addCardCheck 未使用管理后台 #

入园记录表-新增 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#addCardCheck

转换BeanUtils.map → CardCheck ⇒ 表 card_check

ServiceCardCheckService#add （CardCheckServiceImpl）

MapperCardCheckMapper#insert ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
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`	卡种名称
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`	核销人员姓名

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardCheck/addCardCheck

{
  "body": {
    "cardId": 1,
    "cardModelId": 1,
    "cardModelName": "",
    "cardNumber": "",
    "memberId": 1,
    "name": "",
    "phone": "13800000000",
    "identityNo": "",
    "checkTime": "2026-01-01 12:00:00",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 新增核销记录

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

前端调用方

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

POST /cardCheck/cardCheckFootPrintList 未使用小程序 #

入园记录 - 我的足迹 · CardCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardCheckController#cardCheckFootPrintList
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#cardCheckFootPrintList

ServiceCardCheckService#queryList （CardCheckServiceImpl）

MapperCardCheckMapper#selectList ⇒ 表 card_check

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

SessionMemberService.getSessionIdCardResourceRuleService.mustGetSkuCache.getShopCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body

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

响应参数

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

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

data 结构　List<CardCheckFootPrintListResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
resourceId	Long	`card_check`.`resource_id`	景区资源id,关联card_resource_rule卡种资源表id
resourceName	String	`card_check`.`resource_name`	预约景区名称
checkTime	Date	`card_check`.`check_time`	核销时间
lng	String	—	经度
lat	String	—	纬度

示例

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

POST /cardCheck/cardCheckFootPrintList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "resourceId": 1,
      "resourceName": "",
      "checkTime": "2026-01-01 12:00:00",
      "lng": "",
      "lat": ""
    }
  ]
}

处理逻辑

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

内联注释

Sku sku = skuCache.get(cardResourceRule.getGoodsId());
商铺信息
经度
纬度

前端调用方

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

POST /cardCheck/cardCheckPage 未使用小程序 #

卡入园记录 · CardCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardCheckController#cardCheckPage
所属模块	旅游卡 `card`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#cardCheckPage

转换BeanUtils.map → CardCheckQuery

ServiceCardCheckService#queryPage （CardCheckServiceImpl）

MapperCardCheckMapper#selectPage ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckPageListRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardId	Long	否	可选(@MvcOptional)	`card_check`.`card_id`	卡种id

响应参数

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

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

data 结构　PageInfo<CardCheckPageResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`card_check`.`id`	id
cardModelName	String	`card_check`.`card_model_name`	卡种名称
cardNumber	String	`card_check`.`card_number`	卡号
name	String	`card_check`.`name`	持卡人姓名
identityNo	String	`card_check`.`identity_no`	身份证号码
checkTime	Date	`card_check`.`check_time`	核销时间
resourceName	String	`card_check`.`resource_name`	预约景区名称

示例

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

POST /cardCheck/cardCheckPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardModelName": "",
        "cardNumber": "",
        "name": "",
        "identityNo": "",
        "checkTime": "2026-01-01 12:00:00",
        "resourceName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

前端调用方

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

POST /cardCheck/deleteCardCheck 在用管理后台 #

入园记录表-删除 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_checkcard_resource_rulechecker_consume_recordcard_appointment

ControllerCardCheckController#deleteCardCheck

ServiceCardCheckService#get （CardCheckServiceImpl）

MapperCardCheckMapper#selectById ⇒ 表 card_check

ServiceCardCheckService#update （CardCheckServiceImpl）

MapperCardCheckMapper#updateById ⇒ 表 card_check

ServiceCardResourceRuleService#get （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectById ⇒ 表 card_resource_rule

ServiceCheckerConsumeRecordService#queryList （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#selectList ⇒ 表 checker_consume_record

ServiceCheckerConsumeRecordService#update （CheckerConsumeRecordServiceImpl）

MapperCheckerConsumeRecordMapper#updateById ⇒ 表 checker_consume_record

ServiceCardAppointmentService#get （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#selectById ⇒ 表 card_appointment

ServiceCardAppointmentService#update （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#updateById ⇒ 表 card_appointment

ServiceCardCheckService#delete （CardCheckServiceImpl）

MapperCardCheckMapper#deleteById ⇒ 表 card_check

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

SessionUserService.getSessionUser

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardCheck/deleteCardCheck

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

响应示例

（void，无响应体）

处理逻辑

操作日志card / 删除核销记录

逻辑摘要查询详情（cardCheckService.get）；查询详情（sessionUserService.getSessionUser）；更新（cardCheckService.update）

内联注释

cardCheckService.delete(CardCheck.builder().id(request.getId()).build());

前端调用方

dscp-html-manage deleteCardCheck exact

ANY /cardCheck/exportCardCheck 未使用管理后台 #

导出入园记录列表 · CardCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.card.CardCheckController#exportCardCheck
所属模块	旅游卡 `card`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表card_checkcard_model

ControllerCardCheckController#exportCardCheck

转换BeanUtils.map → CardCheckQuery

MapperCardCheckService.getMapper#queryList ⇒ 表 card_check

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

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

CardCheckService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

ANY /cardCheck/exportCardCheck

响应示例

（void，无响应体）

处理逻辑

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

内联注释

Card查询已做全局数据权限，会自动拼接权限sql
wrapper.exists("SELECT 1 FROM card c WHERE c.id = card_id");
组装导出数据
序号

前端调用方

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

POST /cardCheck/getCardCheck 未使用管理后台 #

入园记录表-详情 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#getCardCheck

ServiceCardCheckService#get （CardCheckServiceImpl）

MapperCardCheckMapper#selectById ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　CardCheckResponse　（object）

字段	类型	表 / 列	说明
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 /cardCheck/getCardCheck

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "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
  }
}

处理逻辑

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

前端调用方

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

POST /cardCheck/importCardCheck 未使用管理后台 #

【入园记录】增加补录导入功能 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_modelcard_resource_rulesku_entrancecardcard_bindcard_check

ControllerCardCheckController#importCardCheck

ServiceCardCheckService#handlerImportData （CardCheckServiceImpl）

MapperCardModelMapper#selectOne ⇒ 表 card_model

MapperCardResourceRuleMapper#selectOne ⇒ 表 card_resource_rule

MapperSkuEntranceMapper#selectOne ⇒ 表 sku_entrance

MapperCardMapper#selectOne ⇒ 表 card

MapperCardBindMapper#selectOne ⇒ 表 card_bind

MapperCardCheckMapper#count ⇒ 表 card_check

MapperCardCheckMapper#addList ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	file	MultipartFile	是		—

请求参数 · Body

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

响应参数

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

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

data 结构　CardCheckImportResponse　（object）

字段	类型	表 / 列	说明
correctNum	Integer	—	正确个数
errorNum	Integer	—	错误个数
errorResult	List<CardCheckImportErrorResult>	—	错误集合列表
errorResult[].number	String	—	行号
errorResult[].cardNumber	String	`card`.`card_number`	卡号
errorResult[].errorMsg	String	—	错误详情

示例

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

POST /cardCheck/importCardCheck?file=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "correctNum": 0,
    "errorNum": 0,
    "errorResult": [
      {
        "number": "",
        "cardNumber": "",
        "errorMsg": ""
      }
    ]
  }
}

处理逻辑

操作日志card / 导入核销记录

逻辑摘要调用 handlerImportData（cardCheckService.handlerImportData）；调用 read（ExcelUtils.read）

内联注释

总结果结合
总数集合
处理导入数据

前端调用方

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

POST /cardCheck/queryCardCheckCount 在用管理后台 #

查询当前卡累计游玩次数 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#queryCardCheckCount

ServiceCardCheckService#count （CardCheckServiceImpl）

MapperCardCheckMapper#selectCount ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckListRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardId	Long	否	可选(@MvcOptional)	`card_check`.`card_id`	卡id
cardNumber	String	否	可选(@MvcOptional)	`card_check`.`card_number`	卡号

响应参数

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

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

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

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

POST /cardCheck/queryCardCheckCount

{
  "body": {
    "cardId": 1,
    "cardNumber": ""
  }
}

响应示例

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

处理逻辑

逻辑摘要调用 count（cardCheckService.count）

前端调用方

dscp-html-manage queryCardCheckCount exact

POST /cardCheck/queryCardCheckList 未使用管理后台 #

入园记录表-列表查询 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_check

ControllerCardCheckController#queryCardCheckList

转换BeanUtils.map → CardCheckQuery

ServiceCardCheckService#queryList （CardCheckServiceImpl）

MapperCardCheckMapper#selectList ⇒ 表 card_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckListRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardId	Long	否	可选(@MvcOptional)	`card_check`.`card_id`	卡id
cardNumber	String	否	可选(@MvcOptional)	`card_check`.`card_number`	卡号

响应参数

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

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

data 结构　List<CardCheckResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
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 /cardCheck/queryCardCheckList

{
  "body": {
    "cardId": 1,
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "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
    }
  ]
}

处理逻辑

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

前端调用方

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

POST /cardCheck/queryCardCheckPage 在用管理后台 #

入园记录表-分页查询 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_checkcard_modelsystem_user_rolesystem_rolemember_face

ControllerCardCheckController#queryCardCheckPage

转换BeanUtils.map → CardCheckQuery

转换BeanUtils.map → PageParam

MapperCardCheckService.getMapper#queryPage ⇒ 表 card_check

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceUserRoleService#get （UserRoleServiceImpl）

MapperUserRoleMapper#selectById ⇒ 表 system_user_role

ServiceRoleService#get （RoleServiceImpl）

MapperRoleMapper#selectById ⇒ 表 system_role

ServiceMemberFaceService#get （MemberFaceServiceImpl）

MapperMemberFaceMapper#selectById ⇒ 表 member_face

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

SessionUserService.isMerchantSessionUserService.isShopCardCheckService.applyWrapperSessionUserService.getSessionUser

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelName	String	否	可选(@MvcOptional)	`card_check`.`card_model_name`	卡种名称
cardModelIds	List<Long>	否	可选(@MvcOptional)	—	卡种ID列表，用于按多个卡种过滤
cardNumber	String	否	可选(@MvcOptional)	`card_check`.`card_number`	卡号
phone	String	否	可选(@MvcOptional)	`card_check`.`phone`	手机号码
identityNo	String	否	可选(@MvcOptional)	`card_check`.`identity_no`	身份证号码
checkTimeRange	Date[]			—	核销时间范围
resourceName	String	否	可选(@MvcOptional)	`card_check`.`resource_name`	预约景区名称
resourceId	Long	否	可选(@MvcOptional)	`card_check`.`resource_id`	景区资源id
entranceId	Long	否	可选(@MvcOptional)	`card_check`.`entrance_id`	景区入口ID
keywords	String	否	可选(@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 /cardCheck/queryCardCheckPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelName": "",
    "cardModelIds": "",
    "cardNumber": "",
    "phone": "13800000000",
    "identityNo": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "resourceName": "",
    "resourceId": 1,
    "entranceId": 1,
    "keywords": ""
  }
}

响应示例

{
  "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
  }
}

处理逻辑

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

内联注释

if (!sessionUserService.isMerchant() && !sessionUserService.isShop()) {
query.setAllDeleated(Arrays.asList(true, false));
} else {
}
Card查询已做全局数据权限，会自动拼接权限sql
wrapper.exists("SELECT 1 FROM card c WHERE c.id = card_id");
夸商户商铺角色数据权限
cardCheckPage.getList().stream().forEach(cardCheck -> {

前端调用方

dscp-html-manage queryCardCheckPage exact

POST /cardCheck/queryCardUsePage 在用管理后台 #

查询卡的使用记录 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_checkcard_appointment

ControllerCardCheckController#queryCardUsePage

转换BeanUtils.map → CardCheckQuery

ServiceCardCheckService#queryPage （CardCheckServiceImpl）

MapperCardCheckMapper#selectPage ⇒ 表 card_check

ServiceCardAppointmentService#get （CardAppointmentServiceImpl）

MapperCardAppointmentMapper#selectById ⇒ 表 card_appointment

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardUsePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardId	String	否	可选(@MvcOptional)	`card_check`.`card_id`	卡Id
cardNumber	String	否	可选(@MvcOptional)	`card_check`.`card_number`	卡号

响应参数

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

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

data 结构　PageInfo<CardUsePageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
appointmentId	Long		`card_check`.`appointment_id`	预约id
resourceName	String		`card_check`.`resource_name`	预约景区名称
appointmentTime	Date		—	预约下单时间
appTime	Date		`card_appointment`.`app_time`	游玩时间
status	AppointmentStatus	1预约成功2已关闭3已取消4已入园	`card_appointment`.`status`	状态
checkTime	Date		`card_check`.`check_time`	核销时间

示例

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

POST /cardCheck/queryCardUsePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardId": "",
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "appointmentId": 1,
        "resourceName": "",
        "appointmentTime": "2026-01-01 12:00:00",
        "appTime": "2026-01-01 12:00:00",
        "status": "1",
        "checkTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

游玩时间
预约时间
预约状态

前端调用方

dscp-html-manage queryCardUsePage exact

POST /cardCheck/singleRecordCardCheck 在用管理后台 #

【入园记录-增加单条补录功能】 · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_resource_rulesystem_operate_log

ControllerCardCheckController#singleRecordCardCheck

ServiceCardResourceRuleService#get （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectById ⇒ 表 card_resource_rule

ServiceCheckerService#unifiedConsume （CheckerServiceImpl）

ServiceSystemOperateLogService#add （SystemOperateLogServiceImpl）

MapperSystemOperateLogMapper#insert ⇒ 表 system_operate_log

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

CardCheckHandlerCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　CardCheckSingleRecordRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card_resource_rule`.`card_model_id`	卡种id
resourceId	Long	是	必填	—	资源id
entranceId	Long			—	景区入口id
cardNumber	String	是	必填	—	卡号
checkTime	Date			—	@NotNull(message = "入园时间不能为空")
checkerId	Long			—	@NotNull(message = "和校园不能为空")

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /cardCheck/singleRecordCardCheck

{
  "body": {
    "cardModelId": 1,
    "resourceId": 1,
    "entranceId": 1,
    "cardNumber": "",
    "checkTime": "2026-01-01 12:00:00",
    "checkerId": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志card / 单记录核销

逻辑摘要查询详情（CardChannelUtil.getCardChannel）；查询详情（cardResourceRuleService.get）；调用 unifiedConsume（checkerService.unifiedConsume）

内联注释

直接调用核销接口
if (cardNo.length() == 16 || cardNo.length() == 20 || cardNo.length() == 19) {
consumeRequest.setChannel(ChannelType.Channel_SSYKT.getValue());
// 2024温泉联票-惠享版
consumeRequest.setChannel(ChannelType.Channel_ZHY.getValue());
// 2024温泉联票-尊享版
} else {
consumeRequest.setChannel(ChannelType.Channel_SZH.getValue());

前端调用方

dscp-html-manage singleRecordCardCheck exact

POST /cardCheck/singleRecordCardCheckSzh 在用管理后台 #

单记录核销(深圳) · CardCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_checkcard_appointmentcardcard_bindcard_resource_rulesku_entrancecard_modelcard_resource_calendercard_resource_calender_time_slotcard_package_rulecard_package_rule_resourcecard_package_rule_resource_packetorder

ControllerCardCheckController#singleRecordCardCheckSzh

MapperCardCheckService.getMapper#count ⇒ 表 card_check

MapperCardAppointmentService.getMapper#selectOne ⇒ 表 card_appointment

ServiceCardService#get （CardServiceImpl）

MapperCardMapper#selectById ⇒ 表 card

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

ServiceCardResourceRuleService#get （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectById ⇒ 表 card_resource_rule

ServiceSkuEntranceService#get （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#selectById ⇒ 表 sku_entrance