估算 estimation

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

EstimationCardCheckDetailController 1/1 在用

POST /estimation/queryEstimationCardCheckDetailPage 在用管理后台 #

旅游卡结算测算刷卡明细-分页查询 · EstimationCardCheckDetailController

基本信息

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

调用链路 & 涉及数据表

涉及数据表settlement_card_check_detail

ControllerEstimationCardCheckDetailController#queryEstimationCardCheckDetailPage

转换BeanUtils.map → EstimationCardCheckDetailQuery

ServiceEstimationCardCheckDetailService#queryPage （SettlementCardCheckDetailServiceImpl）

MapperSettlementCardCheckDetailMapper#selectPage ⇒ 表 settlement_card_check_detail

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardCheckDetailPageRequest

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

响应参数

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

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

data 结构　PageInfo<EstimationCardCheckDetailResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
cardModelName	String	—	所属卡种
sceneryName	String	`settlement_card_check_detail`.`scenery_name`	景区名称
touristName	String	`settlement_card_check_detail`.`tourist_name`	持卡人姓名
touristPhone	String	`settlement_card_check_detail`.`tourist_phone`	持卡人手机
cardNumber	String	`settlement_card_check_detail`.`card_number`	旅游卡卡号
checkTime	Date	`settlement_card_check_detail`.`check_time`	刷卡时间
checkerId	Long	`settlement_card_check_detail`.`checker_id`	核销人id
checkerName	String	—	核销人

示例

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

POST /estimation/queryEstimationCardCheckDetailPage

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "cardModelName": "",
        "sceneryName": "",
        "touristName": "",
        "touristPhone": "13800000000",
        "cardNumber": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryEstimationCardCheckDetailPage exact

EstimationCardController 7/7 在用

POST /estimation/calcEstimationCard 在用管理后台 #

旅游卡结算测算单-计算数据 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card_resource_rule

ControllerEstimationCardController#calcEstimationCard

转换BeanUtils.map → SettlementCardDetailCalcRequest

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

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

EstimationCardService.checkEstimationPeriodCardModelCache.getSettlementHandlerCache.getCacheService.put

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card_resource_rule`.`card_model_id`	卡种id
profit	Long	是	必填	—	单张卡分润金额，单位为分
issueNum	Integer	是	必填	—	结算周期内卡种发行量
estimationPeriod	Date[]	是	必填	—	结算起止时间

响应参数

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

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

data 结构　EstimationCardInfoResponse　（object）

字段	类型	表 / 列	说明
id	Long	`card_resource_rule`.`id`	id
cardModelName	String	—	卡种名称
estimationPeriod	String	—	结算起止时间
totalAmount	Long	—	实际结算金额，单位为分
profit	Long	—	单张卡分润金额，单位为分
issueNum	Integer	—	卡种发行量
checkNum	Long	—	累计刷卡次数

示例

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

POST /estimation/calcEstimationCard

{
  "body": {
    "cardModelId": 1,
    "profit": 0,
    "issueNum": 0,
    "estimationPeriod": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelName": "",
    "estimationPeriod": "",
    "totalAmount": 0,
    "profit": 0,
    "issueNum": 0,
    "checkNum": 0
  }
}

处理逻辑

操作日志estimation / 计算测算单

逻辑摘要调用 checkEstimationPeriod（estimationCardService.checkEstimationPeriod）；列表查询（cardResourceRuleService.queryList）；调用 put（cacheService.put）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

TODO 检查结算时间是否冲突
estimationCardService.checkEstimationPeriod();
查询卡种资源结算规则
计算各资源结算明细
设置虚拟id，供核销记录查询使用
将计算结果放入缓存中，保留两个小时，超时后需要重新计算
组织响应信息
处理异常

前端调用方

dscp-html-manage calcEstimationCard exact

POST /estimation/getEstimationCard 在用管理后台 #

旅游卡结算测算单-详情 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

涉及数据表estimation_card

ControllerEstimationCardController#getEstimationCard

ServiceEstimationCardService#get （EstimationCardServiceImpl）

MapperEstimationCardMapper#selectById ⇒ 表 estimation_card

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

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

响应参数

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

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

data 结构　EstimationCardInfoResponse　（object）

字段	类型	表 / 列	说明
id	Long	`estimation_card`.`id`	id
cardModelName	String	—	卡种名称
estimationPeriod	String	—	结算起止时间
totalAmount	Long	`estimation_card`.`total_amount`	实际结算金额，单位为分
profit	Long	`estimation_card`.`profit`	单张卡分润金额，单位为分
issueNum	Integer	`estimation_card`.`issue_num`	卡种发行量
checkNum	Long	`estimation_card`.`check_num`	累计刷卡次数

示例

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

POST /estimation/getEstimationCard

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelName": "",
    "estimationPeriod": "",
    "totalAmount": 0,
    "profit": 0,
    "issueNum": 0,
    "checkNum": 0
  }
}

处理逻辑

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

前端调用方

dscp-html-manage getEstimationCard exact

POST /estimation/getEstimationCardIssueNum 在用管理后台 #

旅游卡结算测算单-查询结算周期内卡种发行量 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

涉及数据表card

ControllerEstimationCardController#getEstimationCardIssueNum

MapperCardService.getMapper#count ⇒ 表 card

ServiceCardService#count （CardServiceImpl）

MapperCardMapper#selectCount ⇒ 表 card

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardIssueNumGetRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card`.`card_model_id`	卡种id
estimationPeriod	Date[]	是	必填	—	结算起止时间

响应参数

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

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

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

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

POST /estimation/getEstimationCardIssueNum

{
  "body": {
    "cardModelId": 1,
    "estimationPeriod": ""
  }
}

响应示例

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

处理逻辑

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

前端调用方

dscp-html-manage getEstimationCardIssueNum exact

POST /estimation/queryEstimationCardCalcDetailPage 在用管理后台 #

旅游卡结算测算单-计算明细分页查询 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

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

ControllerEstimationCardController#queryEstimationCardCalcDetailPage

转换BeanUtils.map → EstimationCardAddRequest

转换BeanUtils.map → EstimationCardDetailListResponse

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

CacheService.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardCalcDetailQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	是	必填	—	卡种id
estimationPeriod	Date[]	是	必填	—	结算起止时间

响应参数

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

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

data 结构　PageInfo<EstimationCardDetailListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		—	id
cardModelName	String		—	卡种名称
estimationPeriod	String		—	结算起止时间
sceneryName	String		—	资源名称
settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	—	结算方式(枚举:card.SettlementWay)
ticketPriceInfo	List<SettlementTicketPriceInfo>		—	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		—	结算系数
ticketPriceInfo[].settlementAmount	Long		—	结算金额
estimationFactor	Double		—	结算系数
settlementAmount	Long		—	结算金额，单位为分
increaseAmount	Long		—	增加金额，单位为分
decreaseAmount	Long		—	扣减金额，单位为分
settlementAmountActual	Long		—	实际结算金额，单位为分

示例

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

POST /estimation/queryEstimationCardCalcDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "estimationPeriod": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardModelName": "",
        "estimationPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "estimationFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

获取缓存中的数据

前端调用方

dscp-html-manage queryEstimationCardCalcDetailPage exact

POST /estimation/queryEstimationCardCheckCalcDetailPage 在用管理后台 #

旅游卡结算测算单-计算明细分页查询 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

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

ControllerEstimationCardController#queryEstimationCardCheckCalcDetailPage

转换BeanUtils.map → EstimationCardAddRequest

转换BeanUtils.map → EstimationCardCheckDetailResponse

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

CacheService.getCheckerCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardCheckCalcDetailQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	是	必填	—	卡种id
estimationPeriod	Date[]	是	必填	—	结算起止时间
id	Long	是	必填	—	id

响应参数

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

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

data 结构　PageInfo<EstimationCardCheckDetailResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
cardModelName	String	—	所属卡种
sceneryName	String	—	景区名称
touristName	String	—	持卡人姓名
touristPhone	String	—	持卡人手机
cardNumber	String	—	旅游卡卡号
checkTime	Date	—	刷卡时间
checkerId	Long	—	核销人id
checkerName	String	—	核销人

示例

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

POST /estimation/queryEstimationCardCheckCalcDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "estimationPeriod": "",
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "cardModelName": "",
        "sceneryName": "",
        "touristName": "",
        "touristPhone": "13800000000",
        "cardNumber": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

获取缓存中的数据

前端调用方

dscp-html-manage queryEstimationCardCheckCalcDetailPage exact

POST /estimation/queryEstimationCardPage 在用管理后台 #

旅游卡结算测算单-分页查询 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

涉及数据表estimation_card

ControllerEstimationCardController#queryEstimationCardPage

转换BeanUtils.map → EstimationCardQuery

转换BeanUtils.map → PageParam

MapperEstimationCardService.getMapper#queryPage ⇒ 表 estimation_card

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

EstimationCardService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
estimationNo	String	否	可选(@MvcOptional)	`estimation_card`.`estimation_no`	结算测算单号
cardModelName	String	否	可选(@MvcOptional)	—	卡种名称
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	创建时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　PageInfo<EstimationCardPageResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`estimation_card`.`id`	id
estimationNo	String	`estimation_card`.`estimation_no`	结算单号
cardModelId	Long	`estimation_card`.`card_model_id`	卡种编号
cardModelName	String	—	卡种名称
startTime	Date	`estimation_card`.`start_time`	开始时间
endTime	Date	`estimation_card`.`end_time`	结束时间
sceneryNum	Integer	`estimation_card`.`scenery_num`	结算景区数量
totalAmount	Long	`estimation_card`.`total_amount`	结算总金额，单位为分
createdTime	Date	`estimation_card`.`created_time`	创建时间

示例

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

POST /estimation/queryEstimationCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "estimationNo": "",
    "cardModelName": "",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "estimationNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "startTime": "2026-01-01 12:00:00",
        "endTime": "2026-01-01 12:00:00",
        "sceneryNum": 0,
        "totalAmount": 0,
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryEstimationCardPage exact

POST /estimation/submitEstimationCard 在用管理后台 #

旅游卡结算测算单-提交 · EstimationCardController

基本信息

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

调用链路 & 涉及数据表

涉及数据表estimation_card_detailestimation_card_check_detailestimation_card

ControllerEstimationCardController#submitEstimationCard

转换BeanUtils.map → EstimationCardDetail ⇒ 表 estimation_card_detail

转换BeanUtils.map → EstimationCardCheckDetail ⇒ 表 estimation_card_check_detail

ServiceEstimationCardService#add （EstimationCardServiceImpl）

MapperEstimationCardMapper#insert ⇒ 表 estimation_card

ServiceEstimationCardDetailService#add （EstimationCardDetailServiceImpl）

MapperEstimationCardDetailMapper#insert ⇒ 表 estimation_card_detail

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

CacheService.getChaosTransactionTemplate.executeSessionUserService.getSessionIdEstimationCardCheckDetailService.addList

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`estimation_card_detail`.`card_model_id`	卡种id
profit	Long	是	必填	`estimation_card`.`profit`	单张卡分润金额，单位为分
issueNum	Integer	是	必填	`estimation_card`.`issue_num`	结算周期内卡种发行量
estimationPeriod	Date[]	是	必填	—	结算起止时间

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /estimation/submitEstimationCard

{
  "body": {
    "cardModelId": 1,
    "profit": 0,
    "issueNum": 0,
    "estimationPeriod": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志estimation / 提交测算单

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

内联注释

获取缓存中的数据
新增结算单
新增结算明细
清空临时id
新增结算核销明细
回滚事务
处理异常

前端调用方

dscp-html-manage submitEstimationCard exact

EstimationCardDetailController 1/1 在用

POST /estimation/queryEstimationCardDetailPage 在用管理后台 #

旅游卡结算测算明细-分页查询 · EstimationCardDetailController

基本信息

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

调用链路 & 涉及数据表

涉及数据表estimation_card_detail

ControllerEstimationCardDetailController#queryEstimationCardDetailPage

转换BeanUtils.map → EstimationCardDetailQuery

ServiceEstimationCardDetailService#queryPage （EstimationCardDetailServiceImpl）

MapperEstimationCardDetailMapper#selectPage ⇒ 表 estimation_card_detail

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　EstimationCardDetailPageRequest

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

响应参数

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

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

data 结构　PageInfo<EstimationCardDetailListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`estimation_card_detail`.`id`	id
cardModelName	String		—	卡种名称
estimationPeriod	String		—	结算起止时间
sceneryName	String		`estimation_card_detail`.`scenery_name`	资源名称
settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`estimation_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
ticketPriceInfo	List<SettlementTicketPriceInfo>		`estimation_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`estimation_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`estimation_card_detail`.`settlement_amount`	结算金额
estimationFactor	Double		—	结算系数
settlementAmount	Long		`estimation_card_detail`.`settlement_amount`	结算金额，单位为分
increaseAmount	Long		`estimation_card_detail`.`increase_amount`	增加金额，单位为分
decreaseAmount	Long		`estimation_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementAmountActual	Long		`estimation_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分

示例

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

POST /estimation/queryEstimationCardDetailPage

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardModelName": "",
        "estimationPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "estimationFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryEstimationCardDetailPage exact